Änderungen von Dokument d.3: DMS-Plugin
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Zusammenfassung
-
Seiteneigenschaften (4 geändert, 0 hinzugefügt, 0 gelöscht)
Details
- Seiteneigenschaften
-
- Titel
-
... ... @@ -1,1 +1,1 @@ 1 -d.3 DMS 1 +d.3: DMS-Plugin - Übergeordnete Seite
-
... ... @@ -1,1 +1,1 @@ 1 - Formcycle.PluginDocumentation.WebHome1 +WebHome - Dokument-Autor
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki.r th1 +XWiki.gru - Inhalt
-
... ... @@ -1,6 +1,8 @@ 1 +[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-d3&fileid=2596||target="_blank"]] (erfordert Anmeldung) 2 + 1 1 {{content/}} 2 2 3 -Über das d.3 DMS (**D**okumenten **M**angement **S**ystem) Plugin ist es möglich Dokumente aus {{formcycle/}} an das d.3 DMS zu übermitteln. Das Plugin nutzt dafür die vom d.3 System bereitgestellte [[SOAP>>https://de.wikipedia.org/wiki/SOAP||rel="noopener noreferrer" target="_blank" title="Simple Object Access Protocol"]]-Webservice Schnittstelle. 5 +Über das kostenpflichtige d.3 DMS (**D**okumenten **M**angement **S**ystem) Plugin ist es möglich Dokumente aus {{formcycle/}} an das d.3 DMS zu übermitteln. Das Plugin nutzt dafür die vom d.3 System bereitgestellte [[SOAP>>https://de.wikipedia.org/wiki/SOAP||rel="noopener noreferrer" target="_blank" title="Simple Object Access Protocol"]]-Webservice Schnittstelle. 4 4 5 5 == Aktions-Plugin: //d.3 DMS: Dokument importieren// == 6 6 ... ... @@ -66,6 +66,7 @@ 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}} 71 + 69 69 ==== Interaktionsmöglichkeiten innerhalb der Konfigurations-Tabelle //Dokument Metadaten// ==== 70 70 71 71 ... ... @@ -128,7 +128,7 @@ 128 128 129 129 {{code}} 130 130 131 -[%$<Plugin- Name>.RESULT[0].<Name oder vergebener Alias der Rückgabeparameters>%]134 +[%$<Name der Plugin-Aktion>.RESULT[0].<Name oder vergebener Alias der Rückgabeparameters>%] 132 132 {{/code}} 133 133 134 134 ; ResultCode ... ... @@ -138,12 +138,49 @@ 138 138 ; ResultDocumentID 139 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 140 141 -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 der dritten übertragenen Datei zuzugreifen muss dann beispielsweise folgender Platzhalter benutzt werden: [%$D3DMSUpload.RESULT[2].ResultDocumentID%] 144 +{{info}} 145 +Über den [[image:icon_copy.png]] Button kann der aus dem Namen oder Alias erzeugte Platzhalter einfach in die Zwischenablage kopiert 146 +und an anderer Stelle, z.B.: im Text einer E-Mail-Aktion, eingefügt werden. 147 +{{/info}} 148 + 149 +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: 150 + 151 +{{code}} 152 + 153 +[%$D3DMSUpload.RESULT[2].ResultDocumentID%] 154 +{{/code}} 155 + 142 142 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. 143 -Dies kann über den Platzhalter [%$<Name der Plugin-Aktion>.SUCCESS%] erfolgen. Dieser liefert „true“ zurück, wenn alle Dateien erfolgreich an das DMS übermittelt werden konnten, sonst „false“. 144 -Der Platzhalter [%$<Name der Plugin-Aktion>.COUNT%] wiederrum kann genutzt werden, wenn man die Gesamtanzahl der zurückgelieferten Ergebnisse wissen möchte. 157 +Dies kann über den Platzhalter 158 + 159 +{{code}} 160 + 161 +[%$<Name der Plugin-Aktion>.SUCCESS%] 162 +{{/code}} 163 + 164 +erfolgen. Dieser liefert "true" zurück, wenn alle Dateien erfolgreich an das DMS übermittelt werden konnten, sonst "false". 165 +Der Platzhalter 166 + 167 +{{code}} 168 + 169 +[%$<Name der Plugin-Aktion>.COUNT%] 170 +{{/code}} 171 + 172 +wiederum kann genutzt werden, wenn man die Gesamtanzahl der zurückgelieferten Ergebnisse wissen möchte. 173 + 145 145 Die nachfolgende Tabelle liefert eine Übersicht über alle vom Plugin zurückgelieferten Status- bzw. Fehlercodes: 146 146 176 +|=Status / Fehlercode|=Bedeutung 177 +|0|Das Plugin wurde fehlerfrei ausgeführt. 178 +|10|Die Authentifizierung am d.3 DMS ist fehlgeschlagen, überprüfen Sie bitte die Eigenschaften des anzusprechenden d.3 Servers. 179 +|20|Der d.3 DMS-Webservice konnte aufgrund fehlender Pflicht-Parameter (//…Name der fehlenden Pflichtparameter…//) nicht aufgerufen werden. 180 +|21|Fehler beim Einlesen des zu importierenden Dokuments 181 +|22|Es konnte keine Dokument für einen Import ermittelt werden. 182 +|23|Folgende Dokument-Metadaten beinhalten fehlerhafte Werte: …//Auflistung der fehlerhaften Werte// 183 +|24|Fehler beim Erzeugen einer neuen Dokument Version. 184 +|30|Es konnte keine Verbindung zum d.3 DMS Webservice aufgebaut werden. 185 +|31|Aufruf einer Webservice-Methode lieferte Fehler: ...//Detaillierte Fehlermeldung aus d.3 System// 186 +|40|In FORMCYCLE ist ein nicht näher spezifizierter Fehler aufgetreten. 147 147 148 148 == Globale Plugin-Einstellungen == 149 149 ... ... @@ -249,5 +249,4 @@ 249 249 : (Standardwert: //Dokumentart:1,Kuerzel:2, DatenfeldBezeichnung:3,DatenfeldNummer:4,DatenfeldTyp:5//) 250 250 251 251 252 - 253 253