Ceyoniq: Nscale-Plugin

Über das kostenpflichtige //ceyoniq// Plugin ist es möglich das //Nscale// DMS System an {{formcycle/}} anzubinden.

{{info}}
Auf Seiten des //Nscale// Dokumenten Management Systems ist mindestens die Version 8.2 der REST Schnittstelle notwendig. Weiterhin muss die Nscale-Lizenz einen Zugriff auf die REST API zulassen.
{{/info}}

Die Installation erfolgt unter Mandant > [[Plugins>>doc:Formcycle.UserInterface.Client.Plugins]].

{{panel title="Konfiguration der Verbindungseinstellungen zum Nscale System" initial="hidden" triggerable="true"}}

(((
Die nachfolgenden Einstellungen sind durch einen Administrator, der die Rechte zum Konfigurieren von Plugins besitzt, vorzunehmen. Das Plugin kann nur im Bereich eines Mandanten installiert werden.
)))

(((
Folgende Eigenschaften für die Anbindung des Nscale Systems können definiert werden:

)))

; Nscale REST-Endpoint URL {{id name="bundle_prop_endpoint_url"/}}
: Absolute URL zu einem Webservice-Endpoint im //Nscale// DMS-System
; Basic-Auth Account
: Login für eine Basic-Auth Kommunikation
; Basic-Auth Passwort
: Passwort für eine Basic-Auth Kommunikation
; KeyStore Name (.p12 Datei)
: Name einer Datei-Ressource, welche einen Keystore im PKCS12 Format enthält. Dieser Keystore kann verwendet werden, um SSL-Zertifikate für die Kommunikation mit dem //Nscale// REST-Webservice verfügbar zu machen, wenn diese beispielsweise nicht im Standard-JAVA-Truststore verfügbar sind.
; KeyStore Passwort
: Passwort für den Zugriff auf den Keystore
; Connection Timeout (Pflichtangabe)
: Wert für ein Connection-Timeout Sekunden. (Standardwert: _10 s_)
; Read Timeout (Read-Timeout)
: Wert für ein Read-Timeout in Sekunden. (Standardwert: _30 s_)

== Aktions-Plugin //Nscale Upload// ==

Für die Übermittlung von Dateien in das Nscale DMS steht das Aktions-Plugin **Nscale Upload** im Workflow zur Verfügung.
Im Vorfeld ist dafür innerhalb der Aktion ein Ablageordner aus dem Nscale-System zu definieren.
Die dafür notwendige Konfigurationsoberfläche des Plugins ist in einzelne Funktionsbereiche unterteilt, die nachfolgend beschrieben werden.

=== Nscale System Konfiguration ===

=== Daten für die Übermittlung an das DMS ===

Mit dem Konfigurations-Parameter **Dateien** können die zu übertragenden Dateien festgelegt werden.
Die Dateien können dabei aus folgenden Bereichen stammen:

* Formular-Uploads
* Dateien aus dateibereitstellenden Aktionen
* Datei-Ressourcen des Mandanten
* Datei-Ressourcen des Formulars
* Dateien aus externen Quellen
* Anhänge aus dem aktuellen Vorgang, welche mittels Dateinamen-Suche ermittelt wurden

=== Rückgabewerte ===

Wenn Dateien und Metadaten erfolgreich an das //Nscale// DMS übermittelt werden konnten, terminiert die Plugin-Aktion normal.

Es wird dabei folgende Rückgabewerte durch die Plugin-Aktion zur Verfügung gestellt:

Fehler, während der Plugin-Verarbeitung, werden in folgende Typen unterschieden:

* AUTHORIZATION_FAILED: Tritt auf, wenn mit den hinterlegten Login-Daten keine erfolgreiche Authentifizierung am //Nscale//System durchgeführt werden konnte.
* NO_FORM_TYPE: Tritt auf, wenn der **FormType** zur Laufzeit nicht ermittelt werden konnte. Beispielsweise, wenn dieser aus einem Platzhalter stammt, welcher zur Laufzeit nicht ermittelt werden konnte oder keinen Wert enthielt.
* SERVICE_ERROR: Tritt auf, wenn der //Nscale// Webservice einen Fehler zurück lieferte.
* INTERNAL_ERROR: Tritt auf, wenn es bei der Verarbeitung zu einer Ausnahme kam, welche nicht mit den anderen Fehler-Typen bereits verarbeitet wurde.