d.3 DMS Plugin
Über das d.3 DMS (Dokumenten Mangement System) Plugin ist es möglich Dokumente aus Xima® Formcycle an das d.3 DMS zu übermitteln. Das Plugin nutzt dafür die vom d.3 System bereitgestellte SOAP-Webservice Schnittstelle.
Aktions-Plugin: d.3 DMS: Dokument importieren
Für die Übermittlung von Dokumenten an das d.3 System steht das Aktions-Plugin d.3 DMS: Dokument importieren zur Verfügung.
Dieses ermöglicht es, Dateien, welche über eine (Datei-)bereitstellende Aktion in der Statusverarbeitung verfügbar sind, in ein d.3 DMS zu überführen.
Die Konfigurationsoberfläche des Aktions-Plugins ist in einzelne Bereiche unterteilt, die nachfolgend kurz beschrieben werden.
Globale d.3 Server-Konfiguration übersteuern
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.
Wenn für eine Eigenschaft kein Wert festgelegt ist, werden die global am Plugin-Bundle hinterlegten Einstellungen verwendet.
Es können Platzhalter (Auswahlmöglichkeit über Button ) für einzelne Einstellungen verwendet werden.
- IP-Adresse
- IP-Adresse, unter welcher der d.3 Server erreichbar ist
- Port
- Port, unter dem der d.3 Servers angesprochen werden kann
- Archiv
- Kürzel für das genutzte Archiv auf dem d.3 Server
- Sprache
- Kürzel für die zu verwendende Sprache. Format muss zweistellig sein (z.B.: de bzw. en).
- Nutzer
- Nutzer-Account für den Zugriff auf den d.3 Server
- Passwort
- Das zum Nutzer-Account zugehörige Passwort
- Nutzergruppe
- Nutzerguppe der der Nutzer angehört. Diese Angabe wird zwingend benötigt, wenn von einem Dokument eine neue Version erzeugt werden soll.
- Endpoint URL
- Endpoint-URL zum angebundenen d.3 Server.
Einstellungen für den DMS Dokumentimport
- Zu importierende(s) Dokument(e) (Pflichtfeld)
- Dokument-Typ (Pflichtfeld)
;
Globale Plugin-Einstellungen
Das d.3 DMS Plugin-Bundle kann sowohl im System- als auch im Mandant-Kontext installiert werden.
Die Menüpunkte für die jeweiligen Kontexte sind:
- System-Kontext: System > Systemplugins
- Mandant-Kontext: Mandant > Plugins
Konfiguration der Plugin-Bundle Properties
Ü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.
Einstellungen für die Anbindung des d.3 Webservice
- dms.webservice.url (Pflichtfeld)
- Endpoint-URL zum d.3 SOAP-Webservice. Die Angabe muss in der Form
- http://<host>:<port>/ws/servicesD3WService.wsdl
- erfolgen.
- dms.webservice.connection.timeout
- Wert für Connection-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice.
- (Standardwert: 10000, dies entspricht 10 Sekunden)
- dms.webservice.read.timeout
- Wert für Read-Timeout in Millisekunden, bei der Kommunikation mit dem d.3 Webservice.
- (Standardwert: 30000, dies entspricht 30 Sekunden)
Einstellungen für den verwendeten d.3 Server
- d3.server.ip (Pflichtfeld)
- IP-Adresse des anzubinden d.3 Systems.
- d3.server.port (Pflichtfeld)
- Port, über den das anzubindende d.3 System erreichbar ist.
- d3.server.archive (Pflichtfeld)
- Kürzel mit dem das Repository bzw. Archive des anzubindenden d.3 Systems angesprochen werden kann.
- d3.server.language (Pflichtfeld)
- Kürzel für die zu verwendende Sprache. Format muss zweistellig sein (z.B.: de bzw. en).
- d3.server.login (Pflichtfeld)
- Nutzer-Login, um Zugriff zum d.3 System zu erhalten.
- d3.server.pwd (Pflichtfeld)
- Nutzer-Passwort für den Zugriff zum d.3 System.
- d3.user.group
- d.3-Nutzergruppe, welchem der Nutzer-Login angehört.
Einstellungen für das Statusverarbeitungs-Plugin "Dokument importieren"
- d3.import.doc.types
- Definiert eine Auflistung von d.3 Objekt-Typen, welche als Auswahl innerhalb des Aktions-Plugins dargestellt werden.
- Ein Objekttyp definiert sich über sein, im d.3 DMS festgelegtes, Dokument-Kürzel.
- Ein Listenwert besteht immer aus Dokument-Kürzel und Anzeige-Name und ist nach folgender Bildungsvorschrift zu hinterlegen:
- <Dokument-Kürzel aus d.3>:<Anzeigename in Auswahlliste>,...
- Einzelne Listenwerte sind durch Komma zu trennen.
- d3.initial.docfield.config.doc.type
- Definiert ein d.3 Dokumenttyp-Kürzel, welches Daten für die initiale Erstellung von Dokument-Metadaten-Feldern enthält.
- d3.initial.docfield.config.mapping
- Definiert die Auflistung der Zuordnungen, welche für die Definition eines Metadatums in der Plugin-Oberfläche herangezogen werden.
- Es ist immer eine Eigenschaft zu einer d.3 Datenfeld-Nummer zuzuordnen, welche die Eigenschaft auf dem angebundenen d.3 System enthält.
- Folgende Eigenschaften sind zuzuordnen:
- Dokumentart
- Kuerzel
- Datenfeld-Bezeichnung
- Datenfeld-Nummer
- Datenfeld-Typ
- Die Konfiguration ist nach folgender Bildungsvorschrift zu hinterlegen:
- <Eigenschaft>:<d.3 DocField-Nummer, in der die Eigenschaft definiert ist>,...
- (Standardwert: Dokumentart:1,Kuerzel:2, DatenfeldBezeichnung:3,DatenfeldNummer:4,DatenfeldTyp:5)