Von Version < 2.6 >
bearbeitet von rth
am 18.03.2020, 13:00
Auf Version < 10.4 >
bearbeitet von rth
am 18.03.2020, 16:02
< >
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,13 +1,45 @@
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.
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 -== Plugin-Aktion: d.3 DMS: Dokument importieren ==
5 +== Aktions-Plugin: //d.3 DMS: Dokument importieren// ==
6 6  
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ö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.
7 7  
10 +Die Konfigurationsoberfläche des Aktions-Plugins ist in einzelne Bereiche unterteilt, die nachfolgend kurz beschrieben werden.
8 8  
9 -== Konfiguration des Plugins ==
12 +=== Globale d.3 Server-Konfiguration übersteuern ===
10 10  
14 +{{figure image="plugin_config.png"}}
15 +Einstellungen zum Übersteuern der global definierten Verbindungsparameter
16 +{{/figure}}
17 +
18 +In diesem Bereich besteht die Möglichkeit die global am Plugin-Bundle registrierten Eigenschaften für den anzubindenden d.3 Server und deren Authentifizierungs-Informationen formular-prozess-spezifisch zu übersteuern.
19 +Es können Platzhalter (Auswahlmöglichkeit über Button [[image:icon_placeholder.png]]) für einzelne Einstellungen verwendet werden.
20 +Wenn für eine Einstellung kein Wert festgelegt ist, werden die global am Plugin-Bundle hinterlegten Einstellungen verwendet.
21 +
22 +; IP-Adresse
23 +: IP-Adresse, unter welcher der d.3 Server erreichbar ist
24 +; Port
25 +: Port, unter dem der d.3 Servers angesprochen werden kann
26 +; Archiv
27 +: Kürzel für das genutzte Archiv auf dem d.3 Server
28 +; Sprache
29 +: Kürzel für die zu verwendende Sprache. Format muss zweistellig sein (z.B.: //de// bzw. //en//).
30 +; Nutzer
31 +: Nutzer-Account für den Zugriff auf den d.3 Server
32 +; Passwort
33 +: Das zum Nutzer-Account zugehörige Passwort
34 +; Nutzergruppe
35 +: Nutzerguppe der der Nutzer angehört. Diese Angabe wird **zwingend** benötigt, wenn von einem Dokument eine neue Version erzeugt werden soll.
36 +; Endpoint URL
37 +: Endpoint-URL zum angebundenen d.3 Server.
38 +
39 +Über den [[image:btn_check.png]]-Button kann die Erreichbarkeit des d.3 Systems geprüft werden.
40 +
41 +== Globale Plugin-Einstellungen ==
42 +
11 11  {{info}}
12 12  Dieser Abschnitt ist nur für {{formcycle/}}-Administratoren relevant, die das Plugin-Bundle initial im System einrichten.
13 13  {{/info}}
... ... @@ -20,54 +20,72 @@
20 20  
21 21  === Konfiguration der Plugin-Bundle Properties ===
22 22  
23 -|=Property-Key|=Pflichtfeld|=Bedeutung
24 -|(% colspan="3" %)//Einstellungen für die Anbindung des d.3 Webservice//
25 -|dms.webservice.url|ja|Endpoint-URL zum d.3 Webservice
26 -|dms.webservice.connection.timeout|nein|(((
27 -Wert für Connection-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice.
28 -(Standardwert: //10000,// dies entspricht 10 Sekunden)
29 -)))
30 -|dms.webservice.read.timeout|nein|(((
31 -Wert für Read-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice.
32 -(Standardwert: //30000, //dies entspricht 30 Sekunden)
33 -)))
34 -|(% colspan="3" %)//Einstellungen für den verwendeten d.3 Server//
35 -|d3.server.ip|ja|IP-Adresse des anzubinden d.3 Systems.
36 -|d3.server.port|ja|Port, über den das anzubindende d.3 System erreichbar ist.
37 -|d3.server.archive|ja|Kürzel mit dem das Repository bzw. Archive des anzubindenden d.3 Systems angesprochen werden kann.
38 -|d3.server.language|ja|Kürzel für die zu verwendende Sprache. Format muss zweistellig sein (z.B.: //de// bzw. //en//).
39 -|d3.server.login|ja|(((
40 -Nutzer-Login, um Zugriff zum d.3 System zu erhalten.
55 +{{figure image="plugin_bundle_config.png"}}
56 +Globale Einstellungen am Plugin-Bundle
57 +{{/figure}}
41 41  
59 +Ü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.
60 +
61 +==== Einstellungen für die Anbindung des d.3 Webservice ====
62 +
63 +; dms.webservice.url (Pflichtfeld)
64 +: Endpoint-URL zum d.3 SOAP-Webservice. Die Angabe muss in der Form
65 +
66 +: **//http:~/~/<host>:<port>/ws/servicesD3WService.wsdl//**
67 +
68 +: erfolgen.
69 +; dms.webservice.connection.timeout
70 +: Wert für Connection-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice.
71 +: (Standardwert: //10000,// dies entspricht 10 Sekunden)
72 +; dms.webservice.read.timeout
73 +: Wert für Read-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice.
74 +: (Standardwert: //30000, //dies entspricht 30 Sekunden)
75 +
76 +==== Einstellungen für den verwendeten d.3 Server ====
77 +
78 +; d3.server.ip (Pflichtfeld)
79 +: IP-Adresse des anzubinden d.3 Systems.
80 +; d3.server.port (Pflichtfeld)
81 +: Port, über den das anzubindende d.3 System erreichbar ist.
82 +; d3.server.archive (Pflichtfeld)
83 +: Kürzel mit dem das Repository bzw. Archive des anzubindenden d.3 Systems angesprochen werden kann.
84 +; d3.server.language (Pflichtfeld)
85 +: Kürzel für die zu verwendende Sprache. Format muss zweistellig sein (z.B.: //de// bzw. //en//).
86 +; d3.server.login (Pflichtfeld)
87 +: Nutzer-Login, um Zugriff zum d.3 System zu erhalten.
88 +
42 42  {{info}}
43 43  Alle nutzerabhängigen Webservice-Funktionen, verwenden ebenfalls diesen Login.
44 44  {{/info}}
45 -)))
46 -|d3.server.pwd|ja|Nutzer-Passwort für den Zugriff zum d.3 System.
47 -|d3.user.group|nein|(((
48 -d.3-Nutzergruppe, welchem der Nutzer-Login angehört.
49 49  
93 +; d3.server.pwd (Pflichtfeld)
94 +: Nutzer-Passwort für den Zugriff zum d.3 System.
95 +; d3.user.group
96 +: d.3-Nutzergruppe, welchem der Nutzer-Login angehört.
97 +
50 50  {{info}}
51 51  Diese Angabe ist notwendig, wenn für ein bestehendes Dokument eine neue Version im d.3 System erzeugt werden soll.
52 52  Das Dokument muss dann gegebenenfalls in den „Bearbeiten“-Status überführt werden und dies geht nur durch Angabe einer Nutzergruppe.
53 53  {{/info}}
54 -)))
55 -|(% colspan="3" %)//Einstellungen für das Statusverarbeitungs-Plugin "Dokument importieren"//
56 -|d3.import.doc.types|nein|(((
57 -Definiert eine Auflistung von d.3 Objekt-Typen, welche als Auswahl innerhalb des Aktions-Plugins dargestellt werden.
58 -Ein Objekttyp definiert sich über sein, im d.3 DMS festgelegtes, Dokument-Kürzel.
59 -\\Ein Listenwert besteht immer aus Dokument-Kürzel und Anzeige-Name und ist nach folgender Bildungsvorschrift zu hinterlegen:
60 -\\**<Dokument-Kürzel aus d.3>:<Anzeigename in Auswahlliste>,...**
61 61  
62 -Einzelne Listenwerte sind durch Komma zu trennen.
63 -)))
64 -|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.
65 -|d3.initial.docfield.config.mapping|nein|(((
66 -Definiert die Auflistung der Zuordnungen, welche für die Definition eines Metadatums in der Plugin-Oberfläche herangezogen werden.
67 -Es ist immer eine //Eigenschaft// zu einer d.3 //Datenfeld-Nummer// zuzuordnen, welche die Eigenschaft auf dem angebundenen d.3 System enthält.
103 +==== Einstellungen für das Statusverarbeitungs-Plugin "Dokument importieren" ====
68 68  
69 -Folgende Eigenschaften sind zuzuordnen:
105 +; d3.import.doc.types
106 +: Definiert eine Auflistung von d.3 Objekt-Typen, welche als Auswahl innerhalb des Aktions-Plugins dargestellt werden.
107 +: Ein Objekttyp definiert sich über sein, im d.3 DMS festgelegtes, Dokument-Kürzel.
108 +: Ein Listenwert besteht immer aus Dokument-Kürzel und Anzeige-Name und ist nach folgender Bildungsvorschrift zu hinterlegen:
70 70  
110 +: **//<Dokument-Kürzel aus d.3>//~://<Anzeigename in Auswahlliste>//,...**
111 +
112 +: Einzelne Listenwerte sind durch Komma zu trennen.
113 +; d3.initial.docfield.config.doc.type
114 +: Definiert ein d.3 Dokumenttyp-Kürzel, welches Daten für die initiale Erstellung von Dokument-Metadaten-Feldern enthält.
115 +; d3.initial.docfield.config.mapping
116 +: Definiert die Auflistung der Zuordnungen, welche für die Definition eines Metadatums in der Plugin-Oberfläche herangezogen werden.
117 +: Es ist immer eine //Eigenschaft// zu einer d.3 //Datenfeld-Nummer// zuzuordnen, welche die Eigenschaft auf dem angebundenen d.3 System enthält.
118 +
119 +: Folgende Eigenschaften sind zuzuordnen:
120 +
71 71  * Dokumentart
72 72  * Kuerzel
73 73  * Datenfeld-Bezeichnung
... ... @@ -74,9 +74,8 @@
74 74  * Datenfeld-Nummer
75 75  * Datenfeld-Typ
76 76  
77 -Die Konfiguration ist nach folgender Bildungsvorschrift zu hinterlegen:
78 -
79 -**<Eigenschaft>:<d.3 DocField-Nummer, in der die Eigenschaft definiert ist>,...**
80 -
81 -(Standardwert: //Dokumentart:1,Kuerzel:2, DatenfeldBezeichnung:3,DatenfeldNummer:4,DatenfeldTyp:5//)
82 -)))
127 +: Die Konfiguration ist nach folgender Bildungsvorschrift zu hinterlegen:
128 +
129 +: **//<Eigenschaft>//~://<d.3 DocField-Nummer, in der die Eigenschaft definiert ist>//,...**
130 +
131 +: (Standardwert: //Dokumentart:1,Kuerzel:2, DatenfeldBezeichnung:3,DatenfeldNummer:4,DatenfeldTyp:5//)
btn_check.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +607 bytes
Inhalt
icon_add.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +239 bytes
Inhalt
icon_copy.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +414 bytes
Inhalt
icon_del.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +330 bytes
Inhalt
icon_placeholder.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +448 bytes
Inhalt
icon_update.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +462 bytes
Inhalt
plugin_bundle_config.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +49.4 KB
Inhalt
plugin_config.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +14.9 KB
Inhalt
Copyright 2000-2024