| ... |
... |
@@ -36,9 +36,9 @@ |
| 36 |
36 |
; KeyStore Passwort |
| 37 |
37 |
: Passwort für den Zugriff auf den Keystore |
| 38 |
38 |
; Connection Timeout (Pflichtangabe) |
| 39 |
|
-: Wert für ein Connection-Timeout Sekunden. (Standardwert: _10 s_) |
|
39 |
+: Wert für ein Connection-Timeout Sekunden. (Standardwert: 10 s) |
| 40 |
40 |
; Read Timeout (Read-Timeout) |
| 41 |
|
-: Wert für ein Read-Timeout in Sekunden. (Standardwert: _30 s_) |
|
41 |
+: Wert für ein Read-Timeout in Sekunden. (Standardwert: 30 s) |
| 42 |
42 |
|
| 43 |
43 |
{{/panel}} |
| 44 |
44 |
|
| ... |
... |
@@ -50,10 +50,40 @@ |
| 50 |
50 |
|
| 51 |
51 |
=== Nscale System Konfiguration === |
| 52 |
52 |
|
|
53 |
+{{figure image="nscale_system_config.png"}} |
|
54 |
+Beispielkonfiguration mit fest definierten Ablageordner aus dem Nscale-System |
|
55 |
+{{/figure}} |
| 53 |
53 |
|
|
57 |
+{{figure image="nscale_system_config_2.png"}} |
|
58 |
+Beispielkonfiguration zum Ermitteln eines Ablageordners aus dem Nscale-System zur Laufzeit. In den Abfrage-Werten können Platzhalter verwendet werden. |
|
59 |
+{{/figure}} |
| 54 |
54 |
|
|
61 |
+In diesem Bereich wird die Festlegung für den Datei-Ablageordner im //Nscale //System getroffen. |
|
62 |
+Dies geschieht in folgenden Schritten: |
|
63 |
+ |
|
64 |
+* Festlegung eines **DocArea Name**, welche den Zielablageordner beinhaltet muss. |
|
65 |
+Die Werte innerhalb der DocArea-Auswahlliste werden automatisch beim der Anzeige der Workflow-Aktions-Eigenschaften ermittelt. |
|
66 |
+Sollte keine Verbindung zum konfigurierten //Nscale //System möglich sein, erscheint eine entsprechende Fehlermeldung. |
|
67 |
+* Festlegung über "**Ablageordner per Nscale-Abfrage festlegen?**", ob ein fest definierter //Nscale// Ordner als Ziel-Ordner definiert werden soll oder ob die Bestimmung des Zielordner zur Laufzeit erfolgt. |
|
68 |
+* Ist "**Ablageordner per Nscale-Abfrage festlegen?**" nicht ausgewählt, so ist der //Nscale //Ablageordner aus dem Feld **Ablageordner **auszuwählen. |
|
69 |
+Das Auswahlfeld wird automatisch bei der Festlegung der DocArea befüllt. |
|
70 |
+* Ist "**Ablageordner per Nscale-Abfrage festlegen?"** ausgewählt, so erscheint automatisch eine Tabelle für die Auswahl der **Suchparameter für Nscale Ablageordner**. |
|
71 |
+Diese Tabelle dient der Definition von Suchparametern zum Ausfinden eines konkreten //Nscale //Ablageordners zum Ausführungszeit der Plugin-Aktion. |
|
72 |
+Dafür sind unter Umständen bereits Parameter vorgegeben, welche mit Werten belegt werden können, oder es können eigene Suchparameter über das [[image:icon_add.png]] hinzugefügt werden. |
|
73 |
+Über den Button [[image:icon_del.png]] lassen sich Parameter aus der Abfrage entfernen. Auf die zu suchenden Ablageordner müssen alle definierten Sucheigenschaften zutreffen. |
|
74 |
+Ein Klick auf den **Ablageordner suchen** Button führt eine Suche im //Nscale //System mit den definierten Parameter durch. |
|
75 |
+Damit lässt sich im Vorfeld ermitteln, ob zur Laufzeit auch ein Ordner aus dem //Nscale //System ermittelt werden kann. |
|
76 |
+{{info}}Hinweise: Platzhalter in den Abfrage-Parametern können nur zur Laufzeit aufgelöst werden. Bei einer testweisen Suche im Vorfeld kann nur mit festen Abfragewerten gearbeitet werden.{{/info}} |
|
77 |
+ |
| 55 |
55 |
=== Daten für die Übermittlung an das DMS === |
| 56 |
56 |
|
|
80 |
+{{figure image="daten_config.png"}} |
|
81 |
+Konfiguration zum Übermitteln mehrerer Formular-Upload Dateien mit Angabe eines eigenen Displaynamens für die neue Ressource. |
|
82 |
+{{/figure}} |
|
83 |
+ |
|
84 |
+In der Tabelle **Metadaten **können zusätzliche Daten, welche als Eigenschaften an der hochgeladen Ressource hinterlegt werden, definiert werden. |
|
85 |
+Aktuell werden nur //Nscale //Eigenschaften vom Typ "String" unterstützt. |
|
86 |
+ |
| 57 |
57 |
Mit dem Konfigurations-Parameter **Dateien** können die zu übertragenden Dateien festgelegt werden. |
| 58 |
58 |
Die Dateien können dabei aus folgenden Bereichen stammen: |
| 59 |
59 |
|
| ... |
... |
@@ -66,13 +66,17 @@ |
| 66 |
66 |
|
| 67 |
67 |
=== Rückgabewerte === |
| 68 |
68 |
|
| 69 |
|
-Wenn Dateien und Metadaten erfolgreich an das //Nscale// DMS übermittelt werden konnten, terminiert die Plugin-Aktion normal. |
|
99 |
+Wenn Dateien und Metadaten erfolgreich an das //Nscale// DMS übermittelt werden konnten, terminiert die Plugin-Aktion normal und liefert folgende Informationen aus dem //Nscale// System zurück: |
| 70 |
70 |
|
| 71 |
|
-Es wird dabei folgende Rückgabewerte durch die Plugin-Aktion zur Verfügung gestellt: |
|
101 |
+* Id: Id der hinzugefügten Resource aus dem //Nscale// System |
|
102 |
+* AreaName: Name der //Nscale //DocArea, innerhalb derer die neue Resource auf dem System abgelegt wurde |
|
103 |
+* Type: Der Typ der neu angelegten Dateiresource aus dem //Nscale //System |
| 72 |
72 |
|
| 73 |
73 |
Fehler, während der Plugin-Verarbeitung, werden in folgende Typen unterschieden: |
| 74 |
74 |
|
| 75 |
|
-* AUTHORIZATION_FAILED: Tritt auf, wenn mit den hinterlegten Login-Daten keine erfolgreiche Authentifizierung am //Nscale//System durchgeführt werden konnte. |
| 76 |
|
-* 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. |
| 77 |
|
-* SERVICE_ERROR: Tritt auf, wenn der //Nscale// Webservice einen Fehler zurück lieferte. |
|
107 |
+* AUTHORIZATION_FAILED: Tritt auf, wenn mit den hinterlegten Login-Daten keine erfolgreiche Authentifizierung am //Nscale //System durchgeführt werden konnte. |
|
108 |
+* NO_PAYLOAD_DATA: Tritt auf, wenn zur Laufzeit keine Daten (Metadaten, Dateien) ermittelt werden konnten, die an den angebundenen //Nscale //Service übermittelt werden sollen. |
|
109 |
+* NO_TARGET_FOLDER: Wenn kein Zielverzeichnis im //Nscale //System für die Ablage von Dateien definiert wurde. |
|
110 |
+* SRV_CONNECTION_ERROR: Tritt auf, wenn keine Verbindung zum angebundenen //Nscale //System aufgebaut werden kann |
|
111 |
+* SRV_METHOD_ERROR: Tritt auf, wenn der //Nscale// Webservice-Methode einen Fehler zurück lieferte. |
| 78 |
78 |
* INTERNAL_ERROR: Tritt auf, wenn es bei der Verarbeitung zu einer Ausnahme kam, welche nicht mit den anderen Fehler-Typen bereits verarbeitet wurde. |
