... |
... |
@@ -66,6
+66,8 @@ |
66 |
66 |
{{info title="Hinweis:"}} |
67 |
67 |
Die Angabe einer Dokument-Nummer ist nur sinnvoll, wenn es sich bei den "zu importierenden Dokumenten" um eine einzelne Datei handelt. |
68 |
68 |
{{/info}} |
|
69 |
+ |
|
70 |
+ |
69 |
69 |
==== Interaktionsmöglichkeiten innerhalb der Konfigurations-Tabelle //Dokument Metadaten// ==== |
70 |
70 |
|
71 |
71 |
|
... |
... |
@@ -118,56
+118,6 @@ |
118 |
118 |
|Geld|Unterstützt werden zweistellige Fließkommazahlen. Als Dezimaltrennzeichen muss ein Komma angegeben werden. (z.B.: //123,50//) |
119 |
119 |
|Numerisch|Unterstützt werden positive und negative Fließkommazahlenwerte. Als Dezimaltrennzeichen muss ein Komma angegeben werden. (z.B. //-123,45//) |
120 |
120 |
|
121 |
|
-=== Allgemeine Rückgabewerte === |
122 |
|
- |
123 |
|
-{{figure image="plugin_result.png"}} |
124 |
|
-Konfiguration der Rückgabewerte |
125 |
|
-{{/figure}} |
126 |
|
- |
127 |
|
-In diesem Bereich werden die vom Plugin als Ergebnis des DMS Datei-Upload Prozesses zurückgelieferten Parameter aufgeführt. Für die einzelnen Parameter kann ein Alias vergeben werden. In weiteren Aktionen kann auf den entsprechenden Rückgabeparameter per Platzhalter-Syntax zugegriffen werden. Der Platzhalter wird dabei nach dem folgenden Muster gebildet: |
128 |
|
- |
129 |
|
-{{code}} |
130 |
|
- |
131 |
|
-[%$<Plugin-Name>.RESULT[0].<Name oder vergebener Alias der Rückgabeparameters>%] |
132 |
|
-{{/code}} |
133 |
|
- |
134 |
|
-; ResultCode |
135 |
|
-: Enthält einen Zahlenwert, welchen den Abarbeitungs- bzw. Fehlerstatus des Plugins wiedergibt. |
136 |
|
-; ResultMessage |
137 |
|
-: Enthält eine Klartextmeldung, welche den zurückgelieferten //ResultCode// näher erläutert. |
138 |
|
-; ResultDocumentID |
139 |
|
-: Enthält die vom d.3 System zurückgelieferte Dokument-ID, wenn das Dokument erfolgreich im d.3 System abgelegt werden konnte, sonst den Wert -1. |
140 |
|
- |
141 |
|
-{{info}} |
142 |
|
-Über den [[image:icon_copy.png]] Button kann der aus dem Namen oder Alias erzeugte Platzhalter einfach in die Zwischenablage kopiert |
143 |
|
-und an anderer Stelle, z.B.: im Text einer E-Mail-Aktion, eingefügt werden. |
144 |
|
-{{/info}} |
145 |
|
- |
146 |
|
-Wenn mehrere Dateien gleichzeitig an das DMS übertragen werden, so wird für jede Datei ein entsprechender //ResultCode//, //ResultMessage// und //ResultDocumentID// zurückgeliefert. Um auf die //ResultDocumentID// (einer Plugin-Aktion mit Namen "D3DMSUpload") der dritten übertragenen Datei zuzugreifen muss dann beispielsweise folgender Platzhalter benutzt werden: |
147 |
|
- |
148 |
|
-{{code}} |
149 |
|
- |
150 |
|
-[%$D3DMSUpload.RESULT[2].ResultDocumentID%] |
151 |
|
-{{/code}} |
152 |
|
- |
153 |
|
-Bei gleichzeitiger Übertragung mehrerer Dateien ist es manchmal sinnvoll den Gesamtstatus zu erfragen, um beispielsweise zu wissen, ob ein Fehler beim Import einer Datei aufgetreten ist. |
154 |
|
-Dies kann über den Platzhalter |
155 |
|
- |
156 |
|
-{{code}} |
157 |
|
- |
158 |
|
-[%$<Name der Plugin-Aktion>.SUCCESS%] |
159 |
|
-{{/code}} |
160 |
|
-erfolgen. Dieser liefert "true" zurück, wenn alle Dateien erfolgreich an das DMS übermittelt werden konnten, sonst "false". |
161 |
|
-Der Platzhalter |
162 |
|
-{{code}} |
163 |
|
- |
164 |
|
-[%$<Name der Plugin-Aktion>.COUNT%] |
165 |
|
-{{/code}} |
166 |
|
-wiederum kann genutzt werden, wenn man die Gesamtanzahl der zurückgelieferten Ergebnisse wissen möchte. |
167 |
|
- |
168 |
|
-Die nachfolgende Tabelle liefert eine Übersicht über alle vom Plugin zurückgelieferten Status- bzw. Fehlercodes: |
169 |
|
- |
170 |
|
- |
171 |
171 |
== Globale Plugin-Einstellungen == |
172 |
172 |
|
173 |
173 |
{{info}} |