Änderungen von Dokument Ceyoniq: Nscale-Plugin


Von Version 9.4
bearbeitet von rth
am 13.04.2022, 15:13
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 9.1
bearbeitet von rth
am 13.04.2022, 14:40
Änderungskommentar: Neues Bild nscale_system_config_2.png hochladen

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -44,8 +44,8 @@
44 44  
45 45  == Aktions-Plugin //Nscale Upload// ==
46 46  
47 -Für die Übermittlung von Dateien in das //Nscale //DMS steht das Aktions-Plugin **Nscale Upload** im Workflow zur Verfügung.
48 -Im Vorfeld ist dafür innerhalb der Aktion ein Ablageordner aus dem //Nscale//-System zu definieren.
47 +Für die Übermittlung von Dateien in das Nscale DMS steht das Aktions-Plugin **Nscale Upload** im Workflow zur Verfügung.
48 +Im Vorfeld ist dafür innerhalb der Aktion ein Ablageordner aus dem Nscale-System zu definieren.
49 49  Die dafür notwendige Konfigurationsoberfläche des Plugins ist in einzelne Funktionsbereiche unterteilt, die nachfolgend beschrieben werden.
50 50  
51 51  === Nscale System Konfiguration ===
... ... @@ -55,28 +55,22 @@
55 55  {{/figure}}
56 56  
57 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.
58 +Beispielkonfiguration zum Ermitteln eines Ablageordners aus dem Nscale-System zur Laufzeit. Als Query-Werte können Platzhalter verwendet werden.
59 59  {{/figure}}
60 60  
61 61  In diesem Bereich wird die Festlegung für den Datei-Ablageordner im //Nscale //System getroffen. 
62 -Dies geschieht in folgenden Schritten:
62 +Dies erfolgt in drei Schritten
63 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 -
68 -* 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.
69 -
70 -* Ist "**Ablageordner per Nscale-Abfrage festlegen?**" nicht ausgewählt, so ist der //Nscale //Ablageordner aus dem Feld **Ablageordner **auszuwählen.
71 -Das Auswahlfeld wird automatisch bei der Festlegung der DocArea befüllt.
72 -
73 -* Ist "**Ablageordner per Nscale-Abfrage festlegen?"** ausgewählt, so erscheint automatisch eine Tabelle für die Auswahl der **Suchparameter für Nscale Ablageordner**.
74 -Diese Tabelle dient der Definition von Suchparametern zum Ausfinden eines konkreten //Nscale //Ablageordners zum Ausführungszeit der Plugin-Aktion.
64 +1. Festlegung eines **DocArea Name**, welche den Zielablageordner beinhaltet muss.
65 +Die Werte innerhalb der DocArea-Auswahlliste werden
66 +automatisch beim der Anzeige der Workflow-Aktions-Eigenschaften ermittelt. Sollte keine Verbindung zum konfigurierten //Nscale //System möglich sein,
67 +erscheint eine entsprechende Fehlermeldung.
68 +1. Nach Auswahl einer DocArea erscheint automatisch eine Tabelle für die Auswahl der **Suchparameter für Nscale Ablageordner**.
69 +Diese Tabelle dient der Definition von Suchparametern zum Ausfinden eines konkretem Nscale Ablageordners.
75 75  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.
76 76  Ü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. 
77 -Ein Klick auf den **Ablageordner suchen** Button führt eine Suche im //Nscale //System mit den definierten Parameter durch.
78 -Damit lässt sich im Vorfeld ermitteln, ob zur Laufzeit auch ein Ordner aus dem //Nscale //System ermittelt werden kann.
79 -\\{{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}}
72 +Ein Klick auf den **Ablageordner suchen** Button führt eine Suche im Nscale System mit den definierten Parameter durch. Mit den Ergebnissen wird die Auswahlliste **Ablageordner **befüllt.
73 +1. Auswahl eines **Ablageordners**. Der ausgewählte Ordner wird zum Ausführungszeitpunkt der Workflow-Aktion als Ablageordner für die übermittelten Dateien herangezogen.
80 80  
81 81  === Daten für die Übermittlung an das DMS ===
82 82  
... ... @@ -101,16 +101,15 @@
101 101  
102 102  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:
103 103  
104 -* **Resource-Id**: Id der hinzugefügten Ressource aus dem //Nscale// System
105 -* **Resource-DisplayName**: Name der hinzugefügten Ressource
106 -* **Folder-Id**: Id des //Nscale //Ordners, in den die übermittelte Ressource abgelegt wurde
107 -* **Folder-DisplayName**: Name des //Nscale //Ordners, in den die übermittelte Ressource abgelegt wurde
98 +* Id: Id der hinzugefügten Resource aus dem //Nscale// System
99 +* AreaName: Name der //Nscale //DocArea, innerhalb derer die neue Resource auf dem System abgelegt wurde
100 +* Type: Der Typ der neu angelegten Dateiresource aus dem //Nscale //System
108 108  
109 109  Fehler, während der Plugin-Verarbeitung, werden in folgende Typen unterschieden:
110 110  
111 -* **AUTHORIZATION_FAILED**: Tritt auf, wenn mit den hinterlegten Login-Daten keine erfolgreiche Authentifizierung am //Nscale //System durchgeführt werden konnte.
112 -* **NO_PAYLOAD_DATA**: Tritt auf, wenn zur Laufzeit keine Daten (Metadaten, Dateien) ermittelt werden konnten, die an den angebundenen //Nscale //Service übermittelt werden sollen.
113 -* **NO_TARGET_FOLDER**: Wenn kein Zielverzeichnis im //Nscale //System für die Ablage von Dateien definiert wurde.
114 -* **SRV_CONNECTION_ERROR**: Tritt auf, wenn keine Verbindung zum angebundenen //Nscale //System aufgebaut werden kann
115 -* **SRV_METHOD_ERROR**: Tritt auf, wenn der //Nscale// Webservice-Methode einen Fehler zurück lieferte.
116 -* **INTERNAL_ERROR**: Tritt auf, wenn es bei der Verarbeitung zu einer Ausnahme kam, welche nicht mit den anderen Fehler-Typen bereits verarbeitet wurde.
104 +* AUTHORIZATION_FAILED: Tritt auf, wenn mit den hinterlegten Login-Daten keine erfolgreiche Authentifizierung am //Nscale //System durchgeführt werden konnte.
105 +* NO_PAYLOAD_DATA: Tritt auf, wenn zur Laufzeit keine Daten (Metadaten, Dateien) ermittelt werden konnten, die an den angebundenen //Nscale //Service übermittelt werden sollen.
106 +* NO_TARGET_FOLDER: Wenn kein Zielverzeichnis im //Nscale //System für die Ablage von Dateien definiert wurde.
107 +* SRV_CONNECTION_ERROR: Tritt auf, wenn keine Verbindung zum angebundenen //Nscale //System aufgebaut werden kann
108 +* SRV_METHOD_ERROR: Tritt auf, wenn der //Nscale// Webservice-Methode einen Fehler zurück lieferte.
109 +* INTERNAL_ERROR: Tritt auf, wenn es bei der Verarbeitung zu einer Ausnahme kam, welche nicht mit den anderen Fehler-Typen bereits verarbeitet wurde.