... |
... |
@@ -1,14
+1,15 @@ |
1 |
1 |
{{content/}} |
2 |
2 |
|
3 |
|
-Über das d.3 DMS 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. |
|
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. |
4 |
4 |
|
5 |
5 |
== Aktions-Plugin: //d.3 DMS: Dokument importieren// == |
6 |
6 |
|
7 |
7 |
Für die Übermittlung von Dokumenten an das d.3 System steht das Aktions-Plugin **d.3 DMS: Dokument importieren** zur Verfügung. |
8 |
|
-Dieses ermöglich es, Dateien, welche über eine [[(Datei-)bereitstellende Aktion>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WebHome||target="_blank"]] in der Statusverarbeitung verfügbar sind, in ein d.3 DMS zu überführen. |
|
8 |
+Dieses ermöglicht es, Dateien, welche über eine [[(Datei-)bereitstellende Aktion>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WebHome||target="_blank"]] in der Statusverarbeitung verfügbar sind, in ein d.3 DMS zu überführen. |
9 |
9 |
|
|
10 |
+Die Konfigurationsoberfläche des Aktions-Plugins ist in einzelne Bereiche unterteilt, die nachfolgend kurz beschrieben werden. |
10 |
10 |
|
11 |
|
-== Konfiguration des Plugins == |
|
12 |
+== Globale Plugin-Einstellungen == |
12 |
12 |
|
13 |
13 |
{{info}} |
14 |
14 |
Dieser Abschnitt ist nur für {{formcycle/}}-Administratoren relevant, die das Plugin-Bundle initial im System einrichten. |
... |
... |
@@ -22,54
+22,72 @@ |
22 |
22 |
|
23 |
23 |
=== Konfiguration der Plugin-Bundle Properties === |
24 |
24 |
|
25 |
|
-|=Property-Key|=Pflichtfeld|=Bedeutung |
26 |
|
-|(% colspan="3" %)//Einstellungen für die Anbindung des d.3 Webservice// |
27 |
|
-|dms.webservice.url|ja|Endpoint-URL zum d.3 Webservice |
28 |
|
-|dms.webservice.connection.timeout|nein|((( |
29 |
|
-Wert für Connection-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice. |
30 |
|
-(Standardwert: //10000,// dies entspricht 10 Sekunden) |
31 |
|
-))) |
32 |
|
-|dms.webservice.read.timeout|nein|((( |
33 |
|
-Wert für Read-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice. |
34 |
|
-(Standardwert: //30000, //dies entspricht 30 Sekunden) |
35 |
|
-))) |
36 |
|
-|(% colspan="3" %)//Einstellungen für den verwendeten d.3 Server// |
37 |
|
-|d3.server.ip|ja|IP-Adresse des anzubinden d.3 Systems. |
38 |
|
-|d3.server.port|ja|Port, über den das anzubindende d.3 System erreichbar ist. |
39 |
|
-|d3.server.archive|ja|Kürzel mit dem das Repository bzw. Archive des anzubindenden d.3 Systems angesprochen werden kann. |
40 |
|
-|d3.server.language|ja|Kürzel für die zu verwendende Sprache. Format muss zweistellig sein (z.B.: //de// bzw. //en//). |
41 |
|
-|d3.server.login|ja|((( |
42 |
|
-Nutzer-Login, um Zugriff zum d.3 System zu erhalten. |
|
26 |
+{{figure image="plugin_bundle_config.png"}} |
|
27 |
+Globale Einstellungen am Plugin-Bundle |
|
28 |
+{{/figure}} |
43 |
43 |
|
|
30 |
+Über die nachfolgend beschriebenen Einstellungen wird das Plugin ein d.3 System angeschlossen. Die Verbindung erfolgt dabei über einen SOAP-Webservice, welcher vom d.3 System zu Verfügung gestellt wird. |
|
31 |
+ |
|
32 |
+==== Einstellungen für die Anbindung des d.3 Webservice ==== |
|
33 |
+ |
|
34 |
+; dms.webservice.url (Pflichtfeld) |
|
35 |
+: Endpoint-URL zum d.3 SOAP-Webservice. Die Angabe muss in der Form |
|
36 |
+ |
|
37 |
+: **//http://<host>:<port>/ws/servicesD3WService.wsdl//** |
|
38 |
+ |
|
39 |
+: erfolgen. |
|
40 |
+; dms.webservice.connection.timeout |
|
41 |
+: Wert für Connection-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice. |
|
42 |
+: (Standardwert: //10000,// dies entspricht 10 Sekunden) |
|
43 |
+; dms.webservice.read.timeout |
|
44 |
+: Wert für Read-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice. |
|
45 |
+: (Standardwert: //30000, //dies entspricht 30 Sekunden) |
|
46 |
+ |
|
47 |
+==== Einstellungen für den verwendeten d.3 Server ==== |
|
48 |
+ |
|
49 |
+; d3.server.ip (Pflichtfeld) |
|
50 |
+: IP-Adresse des anzubinden d.3 Systems. |
|
51 |
+; d3.server.port (Pflichtfeld) |
|
52 |
+: Port, über den das anzubindende d.3 System erreichbar ist. |
|
53 |
+; d3.server.archive (Pflichtfeld) |
|
54 |
+: Kürzel mit dem das Repository bzw. Archive des anzubindenden d.3 Systems angesprochen werden kann. |
|
55 |
+; d3.server.language (Pflichtfeld) |
|
56 |
+: Kürzel für die zu verwendende Sprache. Format muss zweistellig sein (z.B.: //de// bzw. //en//). |
|
57 |
+; d3.server.login (Pflichtfeld) |
|
58 |
+: Nutzer-Login, um Zugriff zum d.3 System zu erhalten. |
|
59 |
+ |
44 |
44 |
{{info}} |
45 |
45 |
Alle nutzerabhängigen Webservice-Funktionen, verwenden ebenfalls diesen Login. |
46 |
46 |
{{/info}} |
47 |
|
-))) |
48 |
|
-|d3.server.pwd|ja|Nutzer-Passwort für den Zugriff zum d.3 System. |
49 |
|
-|d3.user.group|nein|((( |
50 |
|
-d.3-Nutzergruppe, welchem der Nutzer-Login angehört. |
51 |
51 |
|
|
64 |
+; d3.server.pwd (Pflichtfeld) |
|
65 |
+: Nutzer-Passwort für den Zugriff zum d.3 System. |
|
66 |
+; d3.user.group |
|
67 |
+: d.3-Nutzergruppe, welchem der Nutzer-Login angehört. |
|
68 |
+ |
52 |
52 |
{{info}} |
53 |
53 |
Diese Angabe ist notwendig, wenn für ein bestehendes Dokument eine neue Version im d.3 System erzeugt werden soll. |
54 |
54 |
Das Dokument muss dann gegebenenfalls in den „Bearbeiten“-Status überführt werden und dies geht nur durch Angabe einer Nutzergruppe. |
55 |
55 |
{{/info}} |
56 |
|
-))) |
57 |
|
-|(% colspan="3" %)//Einstellungen für das Statusverarbeitungs-Plugin "Dokument importieren"// |
58 |
|
-|d3.import.doc.types|nein|((( |
59 |
|
-Definiert eine Auflistung von d.3 Objekt-Typen, welche als Auswahl innerhalb des Aktions-Plugins dargestellt werden. |
60 |
|
-Ein Objekttyp definiert sich über sein, im d.3 DMS festgelegtes, Dokument-Kürzel. |
61 |
|
-\\Ein Listenwert besteht immer aus Dokument-Kürzel und Anzeige-Name und ist nach folgender Bildungsvorschrift zu hinterlegen: |
62 |
|
-\\**<Dokument-Kürzel aus d.3>:<Anzeigename in Auswahlliste>,...** |
63 |
63 |
|
64 |
|
-Einzelne Listenwerte sind durch Komma zu trennen. |
65 |
|
-))) |
66 |
|
-|d3.initial.docfield.config.doc.type|nein|Definiert ein d.3 Dokumenttyp-Kürzel, welches Daten für die initiale Erstellung von Dokument-Metadaten-Feldern enthält. |
67 |
|
-|d3.initial.docfield.config.mapping|nein|((( |
68 |
|
-Definiert die Auflistung der Zuordnungen, welche für die Definition eines Metadatums in der Plugin-Oberfläche herangezogen werden. |
69 |
|
-Es ist immer eine //Eigenschaft// zu einer d.3 //Datenfeld-Nummer// zuzuordnen, welche die Eigenschaft auf dem angebundenen d.3 System enthält. |
|
74 |
+==== Einstellungen für das Statusverarbeitungs-Plugin "Dokument importieren" ==== |
70 |
70 |
|
71 |
|
-Folgende Eigenschaften sind zuzuordnen: |
|
76 |
+; d3.import.doc.types |
|
77 |
+: Definiert eine Auflistung von d.3 Objekt-Typen, welche als Auswahl innerhalb des Aktions-Plugins dargestellt werden. |
|
78 |
+: Ein Objekttyp definiert sich über sein, im d.3 DMS festgelegtes, Dokument-Kürzel. |
|
79 |
+: Ein Listenwert besteht immer aus Dokument-Kürzel und Anzeige-Name und ist nach folgender Bildungsvorschrift zu hinterlegen: |
72 |
72 |
|
|
81 |
+: **//<Dokument-Kürzel aus d.3>//://<Anzeigename in Auswahlliste>//,...** |
|
82 |
+ |
|
83 |
+: Einzelne Listenwerte sind durch Komma zu trennen. |
|
84 |
+; d3.initial.docfield.config.doc.type |
|
85 |
+: Definiert ein d.3 Dokumenttyp-Kürzel, welches Daten für die initiale Erstellung von Dokument-Metadaten-Feldern enthält. |
|
86 |
+; d3.initial.docfield.config.mapping |
|
87 |
+: Definiert die Auflistung der Zuordnungen, welche für die Definition eines Metadatums in der Plugin-Oberfläche herangezogen werden. |
|
88 |
+: Es ist immer eine //Eigenschaft// zu einer d.3 //Datenfeld-Nummer// zuzuordnen, welche die Eigenschaft auf dem angebundenen d.3 System enthält. |
|
89 |
+ |
|
90 |
+: Folgende Eigenschaften sind zuzuordnen: |
|
91 |
+ |
73 |
73 |
* Dokumentart |
74 |
74 |
* Kuerzel |
75 |
75 |
* Datenfeld-Bezeichnung |
... |
... |
@@ -76,9
+76,8 @@ |
76 |
76 |
* Datenfeld-Nummer |
77 |
77 |
* Datenfeld-Typ |
78 |
78 |
|
79 |
|
-Die Konfiguration ist nach folgender Bildungsvorschrift zu hinterlegen: |
80 |
|
- |
81 |
|
-**<Eigenschaft>:<d.3 DocField-Nummer, in der die Eigenschaft definiert ist>,...** |
82 |
|
- |
83 |
|
-(Standardwert: //Dokumentart:1,Kuerzel:2, DatenfeldBezeichnung:3,DatenfeldNummer:4,DatenfeldTyp:5//) |
84 |
|
-))) |
|
98 |
+: Die Konfiguration ist nach folgender Bildungsvorschrift zu hinterlegen: |
|
99 |
+ |
|
100 |
+: **//<Eigenschaft>//~://<d.3 DocField-Nummer, in der die Eigenschaft definiert ist>//,...** |
|
101 |
+ |
|
102 |
+: (Standardwert: //Dokumentart:1,Kuerzel:2, DatenfeldBezeichnung:3,DatenfeldNummer:4,DatenfeldTyp:5//) |