| ... |
... |
@@ -1,53
+1,53 @@ |
| 1 |
1 |
{{info}} |
| 2 |
|
-Der Abschnitt zur Konfiguration des Plugins ist nur für Administratoren notwendig, welche die Verbindung zur Postkorbschnittstelle einrichten. Wie eine Nachricht an den Postkorb gesendet werden kann, wird im Abschnitt //Postkorb-Aktion// erläutert. |
|
2 |
+The section regarding the plugin configuration is required only for administrators who need to configure the Postkorb web service. See the //Postkorb action// section on how to send a message to the Postkorb. |
| 3 |
3 |
{{/info}} |
| 4 |
4 |
|
| 5 |
5 |
{{info}} |
| 6 |
|
-Der Postkorb ist eine Funktion des Serviceportals. Im Postkorb können sogenannte Vorgänge angelegt werden, etwa wenn jemand ein Antragsformular ausgefüllt hat. Zu jedem Vorgang können dann mehrere Nachrichten gesendet werden. Dieses Plugin ermöglicht es, Nachrichten an einen Vorgang aus {{formcycle/}} heraus zu senden. Der Vorgang im Postkorb sollte nicht mit dem Vorgang in {{formcycle/}} verwechselt werden. |
|
6 |
+The Postkorb ("inbox") is a feature offered by the service portal. The Postkorb consists of so-called processes or message threads. Each message thread contains one more messages. This plugin lets you send message to an existing message thread from {{formcycle/}}. You can also create new message threads with an initial message. |
| 7 |
7 |
{{/info}} |
| 8 |
8 |
|
| 9 |
9 |
{{content/}} |
| 10 |
10 |
|
| 11 |
|
-Dieses Plugin ermöglicht die Anbindung der Postkorbschnittstelle von der regio iT. Über eine [[Workflow-Aktion>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WebHome]] können dann Nachrichten an den Postkorb des [[Serviceportals>>https://servicekonto.nrw/]] geschickt werden. |
|
11 |
+This plugin implements the Porstkorb web service provided by regio iT. It adds a new [[workflow action>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WebHome]] that lets you send messages to the Postkorb of the [[service portal>>https://servicekonto.nrw/]]. |
| 12 |
12 |
|
| 13 |
|
-Das Plugin kann sowohl als System- als auch als Mandantplugin installiert werden. Nach Installation des Plugins müssen in der Plugin-Konfiguration die Verbindungsdaten zur Postkorbschnittstelle eingetragen werden. Dann kann die Workflow-Aktion genutzt werden. |
|
13 |
+You can install this plugin both as a system plugin as well as a client plugin. Once the plugin is installed, you (or an administrator) needs to configure the connection to the Postkorb web service. Once it is configured, you can start using the Postkorb workflow action. |
| 14 |
14 |
|
| 15 |
|
-== Postkorb-Aktion == |
|
15 |
+== Postkorb action == |
| 16 |
16 |
|
| 17 |
|
-{{figure image="plugin_regioit_postkorb_workflow_select_action_de.png" width="400"}} |
| 18 |
|
-Durch Klick auf //neue Aktion// kann die Postkorbschnittstellen-Aktion zum Worfklow hinzugefügt werden. |
|
17 |
+{{figure image="plugin_regioit_postkorb_workflow_select_action_en.png" width="400"}} |
|
18 |
+ Click on //New action// to add a new Postkorb action to the workflow. |
| 19 |
19 |
{{/figure}} |
| 20 |
20 |
|
| 21 |
21 |
{{figure image="plugin_regioit_postkorb_workflow_action_base_de.png" width="400"}} |
| 22 |
|
-Grundlegende Einstellungen zum Versenden einer Nachricht an der Postkorb. Hier kann der Empfänger und der Inhalt der Nachricht eingestellt werden. |
|
22 |
+ Basic settings for sending a message to a Postkorb message thread. Here you can the recipient and the content of the message. |
| 23 |
23 |
{{/figure}} |
| 24 |
24 |
|
| 25 |
25 |
{{figure image="plugin_regioit_postkorb_workflow_action_advanced_de.png" width="400"}} |
| 26 |
|
-Fortgeschrittene Einstellungen für den Postkorb. Hier können die Metadaten des Vorgangs geändert werden, der im Postkorb erstellt wird. |
|
26 |
+ Advanced settings for sending a messag to a Postkorb message thread. Here you can change the metadata of the Postkorb message thread that is created. |
| 27 |
27 |
{{/figure}} |
| 28 |
28 |
|
| 29 |
29 |
{{figure image="plugin_regioit_postkorb_workflow_action_guest_de.png" width="400"}} |
| 30 |
|
-Eine neue Nachricht kann auch als Gast an den Postkorb gesendet werden. In dem Fall müssen einige Daten zum Gast eingetragen werden. Es kann sein, dass die Postkorbschnitstelle die Nutzung als Gast nicht erlaubt - dies sollte vorher mit dem Dienstanbieter der Postkorbschnittstelle geklärt werden. |
|
30 |
+ You can also create a new message thread as a guest. This requires you to enter a few details about the guest, such as the name and email address. Please note that creating message threads as guests may be restricted by the web service - please contact your service provider for details. |
| 31 |
31 |
{{/figure}} |
| 32 |
32 |
|
| 33 |
|
-Sobald das Plugin richtig konfiguriert ist, kann in der Statusverarbeitung die Aktion //Nachricht im Postkorb erstellen// ausgewählt werden. |
|
33 |
+Once the plugin is configured correctly, you can select the new workflow action //Create Postkorb message// in the workflow configuration. |
| 34 |
34 |
|
| 35 |
|
-=== Konfiguration === |
|
35 |
+=== Configuration === |
| 36 |
36 |
|
| 37 |
|
-Die Einstellungen für die Postkorb-Aktion sind ähnlich zur E-Mail-Aktion und in 4 Bereiche unterteilt. Für die meisten Einstellungen sind Standardwerte gesetzt, welche im Regelfall nicht geändert werden müssen - meistens sollten nur die Felder //Betreff// und //Nachricht// geändert werden. |
|
37 |
+The configuration for the Postkorb action is similar to the email action and separated into 4 sections. Most settings have a default set that you do not need to change normally - usually you just have to enter a subject and message text. |
| 38 |
38 |
|
| 39 |
|
-An den meisten Feldern ist die Verwendung von [[Platzhaltern>>doc:Formcycle.UserInterface.Variables]] möglich, um Daten aus dem Formular einzutragen. Alle Felder, wo Platzhalter möglich sind, haben rechts am Eingabefeld eine kleines Buch-Symbol. |
|
39 |
+Most settings allow the use of [[variables>>doc:Formcycle.UserInterface.Variables]] to insert data from the submitted form. All settings that allow variables have a little book icon next to them that opens the variable selection dialog. |
| 40 |
40 |
|
| 41 |
|
-Für das Senden von Nachrichten sind einige Informationen zum Empfänger notwendiger, etwa dessen Kontonummer im Serviceportal. Es wird empfohlen, die Anmeldung am Formular per regio iT (technisch: OpenID Connect) zu aktivieren. Dann können diese Daten aus dem Nutzerkonto des angemeldeten Benutzers per [[Platzhalter>>doc:Formcycle.UserInterface.Variables]] übernommen werden. |
|
41 |
+In order to send am message to the Postkorb, a few pieces of information about the recipient are required, such as their account number and name. We recommend that you allow users to sign in via the services provided by regio iT (OpenID Connect). This lets you prefill the settings with the data from the registered user via [[variables>>doc:Formcycle.UserInterface.Variables]]. |
| 42 |
42 |
|
| 43 |
|
-==== Angaben zum Empfänger ==== |
|
43 |
+==== Message type and recipient ==== |
| 44 |
44 |
|
| 45 |
45 |
; Art des Versendens |
| 46 |
46 |
: Die Postkorbschnittstelle bietet zwei Möglichkeiten: Es kann (a) eine neuer Vorgang im Postkorb mit einer initialen Nachricht erstellt werden oder (b) eine Nachricht an einen bestehenden Vorgang gesendet werden. Falls bekannt ist, ob der Vorgang im Postkorb schon existiert, kann hier die Option //Neuen Vorgang erstellen// beziehungsweise //Auf bestehenden Vorgang antworten// ausgewählt werden. Andernfalls, wenn es nicht sicher ist, ob der Vorgang bereits existiert, sollte hier die Option //Vorgang anlegen wenn noch nicht vorhanden// ausgewählt werden. Es wird dann zuerst versucht, auf einen bestehenden Vorgang zu antworten. Falls dies fehlschlägt, wird ein neuer Vorgang angelegt. |
| 47 |
47 |
; Kontonummer des Empfängers oder Antragstellers |
| 48 |
|
-: Hier muss die Kontonummer des Empfängers oder Antragstellers eingetragen werden, an den die Nachricht gesendet werden soll. Im Regelfall melden sich Benutzer über die regio iT am Formular an (technisch: OpenID Connect). In dem Fall ist der voreingestellte Wert ausreichend: //[%$last_user.preferred_username%//) Dies ist ein [[Platzhalter>>doc:Formcycle.UserInterface.Variables]], der mit der Kontonummer des angemeldeten Nutzers ersetzt wird. Diese Einstellung entspricht dem Parameter //fall.portalkonto// der Postkorbschnittstelle. |
|
48 |
+: Hier muss die Kontonummer des Empfängers oder Antragstellers eingetragen werden, an den die Nachricht gesendet werden soll. Im Regelfall melden sich Benutzer über die regio iT am Formular an (technisch: OpenID Connect). In dem Fall ist der voreingestellte Wert ausreichend: //[%$last_user.preferred_username%//] Dies ist ein [[Platzhalter>>doc:Formcycle.UserInterface.Variables]], der mit der Kontonummer des angemeldeten Nutzers ersetzt wird. Diese Einstellung entspricht dem Parameter //fall.portalkonto// der Postkorbschnittstelle. |
| 49 |
49 |
; Als Gast versenden |
| 50 |
|
-: Es ist beim Postkorb möglich, eine Nachricht als Gast zu versenden, also ohne Kontonummer im Serviceportal zu haben. Dabei ist es nur möglich, einen neuen Vorgang anzulegen, aber nicht auf einen bestehenden zu antworten. Ist diese Option aktiviert, erscheinen zusätzliche Eingabefelder für die Angaben zum Gast. Hinweis: Abhängig vom eingstellten Nutzernamen und Passwort der Postkorbschnittstelle ist es möglich, dass ein Versenden als Gast nicht erlaubt ist. Dies sollte vorher mit dem Dienstanbieter der Postkorbschnittstelle abgeklärt werden. |
|
50 |
+: Es ist beim Postkorb möglich eine Nachricht als Gast zu versenden, also ohne Kontonummer im Serviceportal zu haben. Dabei ist es nur möglich, einen neuen Vorgang anzulegen, aber nicht auf einen bestehenden zu antworten. Ist diese Option aktiviert, erscheinen zusätzliche Eingabefelder für die Angaben zum Gast. Hinweis: Bitte versichern Sie sich vor dem Nutzen der Funktion bei dem Dienstanbieter der Postkorbschnittstelle ob das Versenden als Gast erlaubt ist. |
| 51 |
51 |
|
| 52 |
52 |
Folgende Eingabefelder erscheinen, wenn die Option //Als Gast versenden// aktiviert wurde: |
| 53 |
53 |
|
| ... |
... |
@@ -87,13
+87,13 @@ |
| 87 |
87 |
: Der Name, der im Postkorb für den Vorgang angezeigt wird. Nur verfügbar, wenn ein neuer Vorgang erstellt wird. Dieser Name wird etwa auch in der Übersicht aller Vorgänge angezeigt. Als Standard ist hier der Wert //[%$PROJECT_NAME%] - [%$PROCESS_ID%]// eingetragen. Diese Platzhalter werden durch den Namen des Formulars und die Vorgangs-ID ersetzt, sodass Namen wie //Anmeldeformular - 7581f9c5-0ba9-4b9a-b7c1-cfb475eabafd// erzeugt werden. Zur Erhöhung der Lesbarkeit kann statt der Prozess-ID etwa die E-Mail des Benutzers etc. verwendet werden. Diese Einstellung entspricht dem Wert nach dem Doppelpunkt des Parameters //extern.titel// der Postkorbschnittstelle. |
| 88 |
88 |
; Link (URL) für den Vorgang im Postkorb |
| 89 |
89 |
: Eine optionale URL auf den Vorgang im Drittsystem (also {{formcycle/}}). Nur verfügbar, wenn ein neuer Vorgang erstellt wird. Hier ist standardmäßig der Platzhalter //[%$FORM_PROCESS_LINK%]// eingetragen, welcher durch den Link auf das abgesendete Formular ersetzt wird. Diese Einstellung entspricht dem Wert nach dem Doppelpunkt des Parameters //extern.url// der Postkorbschnittstelle. |
| 90 |
|
-; Beschreibungs des Vorgangs im Postkorb |
|
90 |
+; Beschreibung des Vorgangs im Postkorb |
| 91 |
91 |
: Eine optionale Beschreibung für den Vorgang im Postkorb. Nur verfügbar, wenn ein neuer Vorgang erstellt wird. Diese Einstellung entspricht dem Wert nach dem Doppelpunkt des Parameters //fall.info// der Postkorbschnittstelle. |
| 92 |
92 |
|
| 93 |
93 |
==== Überschreiben der globalen Plugin-Konfiguration ==== |
| 94 |
94 |
|
| 95 |
95 |
; Aktion bei Fehler mit Exception abbrechen |
| 96 |
|
-: Steuert, was bei einem Fehler passiert, also wenn die Nachricht nicht an den Postkorb gesendet werden konnte. Wenn diese Option aktiviert ist, wird ein Fehler geworfen, wodurch die weitere Verarbeitung abgebrochen wird und dem Nutzer eine Fehlerseite angezeigt wird. Weiterhin kann dann über die [[Fehlerbehandlung>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.ErrorHandling]] in der Status- und Aktionsverarbeitung geändert werden, was genau im Fehlerfall passieren soll. Ist andererseits diese Option deaktiviert, ist die Postkorb-Aktion immer erfolgreich und liefert bei Fehlern einen entsprechenden Statuscode (siehe unten) zurück. Über [[Abarbeitungsbedingungen>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.ActionConditions]] und Aktionsplatzhalter kann dann der Statuscode entsprechend abgefragt werden. |
|
96 |
+: Steuert, was bei einem Fehler passiert, also wenn die Nachricht nicht an den Postkorb gesendet werden konnte. Wenn diese Option aktiviert ist, wird ein Fehler geworfen, wodurch die weitere Verarbeitung abgebrochen und dem Nutzer eine Fehlerseite angezeigt wird. Weiterhin kann dann über die [[Fehlerbehandlung>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.ErrorHandling]] in der Status- und Aktionsverarbeitung geändert werden, was genau im Fehlerfall passieren soll. Ist andererseits diese Option deaktiviert, ist die Postkorb-Aktion immer erfolgreich und liefert bei Fehlern einen entsprechenden Statuscode (siehe unten) zurück. Über [[Abarbeitungsbedingungen>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.ActionConditions]] und Aktionsplatzhalter kann dann der Statuscode entsprechend abgefragt werden. |
| 97 |
97 |
; ID der Dienstleistung aus BIS |
| 98 |
98 |
: Hier kann die globale Einstellung aus der Plugin-Konfiguration überschrieben werden, falls dies notwendig ist. Siehe //ID der Dienstleistung aus BIS// im Abschnitt //Konfiguration des Plugins// oben für mehr Informationen. |
| 99 |
99 |
; Präfix für ID des Vorgangs im Postkorb |
| ... |
... |
@@ -122,9
+122,9 @@ |
| 122 |
122 |
; Passwort |
| 123 |
123 |
: Das Passwort für die Verbindung zur Postkorbschnittstelle. |
| 124 |
124 |
; Connection timeout |
| 125 |
|
-: Verbindungszeitüberschreitung (Connection-Timeout) für das Herstellen der Verbindung zur Postkorbschnittstelle. Die Zeitdauer wird mit Einheit eingetragen, also etwa //10s//, //500 ms// oder //2 min//. |
|
125 |
+: Verbindungszeitüberschreitung (Connection-Timeout) für das Herstellen der Verbindung zur Postkorbschnittstelle. Die Zeitdauer wird mit Einheit eingetragen, also etwa //10s//, //500ms// oder //2min//. |
| 126 |
126 |
; Read timeout |
| 127 |
|
-: Lesezeitüberschreitung (Read-Timeout) für das Auslesen einer Methode der Postkorbschnittstelle. Die Zeitdauer wird mit Einheit eingetragen, also etwa //10s//, //500 ms// oder //2 min//. |
|
127 |
+: Lesezeitüberschreitung (Read-Timeout) für das Auslesen einer Methode der Postkorbschnittstelle. Die Zeitdauer wird mit Einheit eingetragen, also etwa //10s//, //500ms// oder //2min//. |
| 128 |
128 |
; Vorher immer PING durchführen |
| 129 |
129 |
: Entweder //true// oder //false//. In der Spezifikation der Postkorbschnittstelle wird empfohlen, vor jeder Anfrage eine sogenannte PING-Anfrage durchzuführen, um die Verfügbarkeit der Schnittstelle zu prüfen. In der Regel kann diese Einstellung aber deaktiviert werden. |
| 130 |
130 |
|
| ... |
... |
@@ -164,6
+164,6 @@ |
| 164 |
164 |
; Port des Proxy-Servers |
| 165 |
165 |
: Der Port des Proxy-Servers. |
| 166 |
166 |
; Nutzername für Proxy-Server |
| 167 |
|
-: Nutzername, falls nötig, um eine Verbindungs zum Proxy-Server herzustellen. |
|
167 |
+: Nutzername, falls nötig, um eine Verbindung zum Proxy-Server herzustellen. |
| 168 |
168 |
; Passwort für den Proxy-Server |
| 169 |
|
-: Nutzername, falls nötig, um eine Verbindungs zum Proxy-Server herzustellen. |
|
169 |
+: Nutzername, falls nötig, um eine Verbindung zum Proxy-Server herzustellen. |