# Benutzeraktionen
Flows im Bereich Benutzeraktionen bestehen aus einem manuellen Trigger und aus mindestens einem oder mehreren Diensten. Optional können Sie die Komplexität des Flows durch den Einsatz von Verzweigungen erweitern.
# Trigger wählen
Für Benutzeraktionen wählen Sie keine Trigger einer Komponente, sondern definieren einen Button für ELO Clients. Über diesen Button wird der Flow gestartet.
Öffnen Sie den Trigger im Knoten-Editor, indem Sie den Trigger-Knoten auswählen.
Der Tab Action-Definition öffnet sich.
Sie haben folgende Konfigurationsmöglichkeiten:
1 Label festlegen: Angezeigter Titel des Buttons in den ELO Clients
2 Hinweis hinzufügen: Tooltip-Text für den angelegten Button
3 Maske hinterlegen: Hinterlegen Sie die gültige Maske für diesen Button. Der Button wird nur aktiviert, wenn das gewählte Element die definierte Maske trägt.
Information
Im Abschnitt Komponenten > Allgemeine Informationen erhalten Sie weitere Informationen dazu, wie Sie im Flow-Designer Felder mit Bezug auf ELO Metadaten Gen. 1 und Metadaten Gen. 2 ausfüllen können.
4 Kontext aktivieren für...: Der Button wird nur aktiviert, wenn das gewählte Element ein Ordner und/oder ein Dokument ist. Nach Aktivierung wird die Objekt-ID des gewählten Objektes in Flows zur Verfügung gestellt.
5 Als Kachel anzeigen: Die Benutzeraktion wird im Funktionsbereich Mein ELO als Kachel angezeigt. Sie können hierzu ein Symbol hinterlegen.
6 In Menüband anzeigen: Definiert die Position des Buttons im Menüband der ELO Client. Wählen Sie hierzu den Tab, die Gruppe und das Symbol aus.
7 Nur in bestimmten ELO Clients anzeigen: Steuert, in welchen Clients der Button angezeigt wird. Wenn hier nichts gewählt ist, wird dieser in allen Clients angezeigt.
8 Benutzer/Gruppen: Definiert, welche Gruppen und Benutzer den Button angezeigt bekommen. Ist die Option nicht aktiviert, wird der Button allen Konten angezeigt.
Füllen Sie mindestens die Pflichtfelder aus.
Bestätigen Sie Ihre Eingaben mit Weiter.
Der Tab Zusammenfassung erscheint. Hier werden Ihnen nochmals alle Einstellungen angezeigt.
1 Knotenschlüssel: Namen des Knotens, der im Flow-Designer in eckigen Klammern angezeigt wird
2 Knotenbeschreibung: Detailliertere Beschreibung des Knotens
3 Synchrone Rückmeldung aktivieren: Führt den Flow als synchronen Flow aus.
Information
Weitere Informationen zu diesem Thema finden Sie im Abschnitt Synchrone Flows.
Wählen Sie Abschließen, um die Konfiguration des Triggers zu beenden.
Beachte Sie
Mit der Aktion Abschließen werden die Konfigurationen nur im Konfigurationsbereich zwischengespeichert und noch nicht endgültig für den Flow übernommen.
Wählen Sie im Flow-Designer Speichern, um die Eingaben im Konfigurationsbereich für den Flow endgültig zu übernehmen.
# Aktivitäten hinzufügen
Definieren Sie über Aktivität hinzufügen, was angezeigt wird, wenn der Button im Client ausgewählt wird.
Information
Aktivitäten sind optional.
Um eine Aktivität hinzuzufügen, Sie den Button mit Plussymbol direkt nach dem Trigger-Knoten.
Auf der Seiten Aktivität werden Ihnen nun alle verfügbaren Aktivitäten angezeigt.
- Information: Zeigt einen reinen Informationstext an. Diese Aktivität liefert somit keine Daten.
- Vereinbarung: Hier können Sie Kontrollkästchen definieren, um mit den Benutzern eine Vereinbarung zu treffen. Zum Beispiel eine Datenschutzvereinbarung, Lizenzvereinbarung... etc.
- Mehrfach Dokumenten-Upload: Mit dieser Aktivität können Sie den Benutzer auffordern mehrere Dokumente hochzuladen. Sie können dieses zum Beispiel mit der ELO Objekte & Metadaten in ELO speichern.
- Dokumenten-Upload: Mit dieser Aktivität können Sie den Benutzer auffordern ein Dokument hochzuladen. Sie können dieses zum Beispiel mit der ELO Objekte & Metadaten in ELO speichern.
- Date-Picker: Zeigt einen Kalender an. Benutzer können hier ein bestimmtes Datum oder ein Datumsintervall auswählen.
- Einfaches Formular: Zeigt ein Formular an. Zum Beispiel können Sie hiermit ein Kontaktformular umsetzen.
- Zusammenfassung: Die Zusammenfassung zeigt alle Daten vorausgegangener Aktivitäten an. Sie können dieses an das Ende setzen, um nochmals einen Überblick zu geben.
- Repositoryauswahl: Mit der Aktivität Repositoryauswahl, können Sie die Benutzer auffordern, ein Element aus dem ELO Repository auszuwählen. Setzen Sie in den Einstellungen das Root-Element, um zu definieren, von welcher Ebene aus die Benutzer eine Auswahl angeboten bekommen.
- Benutzerauswahl: Mit dieser Aktivität können Sie die Benutzer auffordern einen ELO Benutzer und/oder ELO Gruppe aus dem ELO System auszuwählen.
Information
Bei Aktivitäten mit Text oder Titeln, die im Client für den Benutzer sichtbar sind, können Sie Übersetzungsschlüssel wählen.
Falls Sie ELO Flows außerhalb von ELO Paketen konfigurieren, können Sie ausschließlich im System vorhandene Schlüssel nutzen.
Die Schlüssel können aus folgenden Quellen stammen:
- Bereits über ELO Pakete konfigurierte Schlüssel
- Als Properties-Dateien abgelegte Schlüssel im Repository
Für ELO Flows, die Sie innerhalb von ELO Paketen bearbeiten, können Sie darüber hinaus neue Übersetzungsschlüssel anlegen und bestehende Übersetzungsschlüssel konfigurieren. Die Übersetzung wird für die aktive Ländersprache der ELO Administration Console hinterlegt.
Tragen Sie einen Übersetzungsschlüssel ein.
Alternativ: Wählen Sie einen bestehenden Übersetzungsschlüssel aus dem Drop-down-Menü aus.
Tragen Sie eine Benennung im Feld Übersetzung ein.
Wählen Sie den Button mit Diskettensymbol, um die Benennung der Übersetzung zuzuweisen und zu speichern.
Wählen Sie eine Aktivität aus.
Optional 1: Um eine Abfolge dieser Aktivitäten abzubilden, sind diese verkettbar. Fügen Sie eine weitere Aktivität hinzu.
Optional 2: Löschen Sie die vorhandene Aktivität, indem Sie im Menüband den Button Knoten löschen wählen.
Der Button und die Aktivitäten im ELO Client können z. B. wie folgt angezeigt werden:
Beachten Sie
Der Button wird erst angezeigt, wenn der Status des Flows auf Aktiv steht. Hierzu müssen Sie mindestens einen Dienst definieren.
Nachdem Sie Aktivitäten definiert haben, können Sie die erste Verzweigung oder den ersten Dienst anlegen.
Information
Vor jedem Schritt können Sie entscheiden, ob Sie eine Verzweigung mit einer true-false-Bedingung anlegen, oder direkt einen Dienst anfügen wollen. Sie können Verzweigungen mit weiteren Verzweigungen verschachteln oder mit Diensten weiterführen.
Mehr Informationen zu Verzweigungen bei ELO Flows erhalten Sie im Abschnitt dieser Dokumentation Erweiterter ELO Flow-Ablauf.
# Dienst hinzufügen
Um einen Dienst hinzufügen, wählen Sie nach dem Trigger-Knoten den Button mit dem Plussymbol und wählen Sie Dienst aus.
Es öffnet sich der Konfigurationsbereich des neuen Knotens mit zur Verfügung stehenden Komponenten.
Wählen Sie eine Komponente aus.
Mit Auswahl der Komponente springen Sie automatisch in den nächsten Tab mit den zur Verfügung stehenden Diensten der Komponente.
Wählen Sie den gewünschten Dienst aus.
Information
Dienste können einzeln (Blitzsymbol) aufgelistet sein, oder in Gruppen (Ordnersymbol) zusammengefasst erscheinen.
Mit Auswahl des Dienstes springen Sie automatisch in den nächsten Tab mit den Benutzer-Einstellungen.
Wählen Sie eine Benutzer-Verbindung aus.
Information
Falls Sie schon unter Zugangsdaten einen Benutzer hinterlegt haben, können Sie diesen hier auswählen. Ansonsten können Sie die Default-Verbindung wählen, oder eine neue Verbindung hinzufügen.
Bestätigen Sie die Auswahl mit Weiter.
Der Tab Einstellungen erscheint.
Hinterlegen Sie die individuellen Konfigurationsdaten für den Dienst.
Information
Sie können die Felder mit statischen oder dynamische Werten befüllen. Eine dynamische Auswertung geschieht auf der Basis von JSONata. Mit dieser Transformationssprache können Sie auf Ergebnisobjekte der vorangehenden Knoten und Trigger zugreifen, sowie Transformationen oder einfache Funktionen verwenden.
Mehr zur Verwendung von JSONata in ELO Flows finden Sie im Abschnitt JSONata-Editor.
Information
Manche Dienste bieten Ihnen die Funktion des Ausgabe-Schemas an. Das bedeutet, dass dieser Dienst ein dynamisches Ausgabe-Objekt anbietet. Dies kann z. B. bei Metadaten-Objekten vorkommen.
Beispiel: Sie legen ein Dokument mit der Maske E-Mail ab und möchte in einem folgenden Knoten auf ein Feld dieses Dokumentes zugreifen. Da ELO Flows zunächst nicht weiß, welche Felder für dieses Dokument infrage kommen, bietet Ihnen der Dienst im Folgeobjekt nur das übergeordnete Objekt (z. B. objKeys und aspectData) an ohne Zugriff auf einzelne Metadaten-Felder.
Damit ELO Flows weiß, welche Metadaten-Felder das Ausgabe-Objekt besitzt, können Sie entweder einen Standard benutzen oder eine spezielle Maske laden. Geben Sie in das Feld Maske E-Mail ein und wählen Sie den Button Schema laden. Das Schema wird mit den passenden Maskeneigenschaften geladen.
Alternativ können Sie auch Standard benutzen wählen. Dann wird das Objekt mit Standard-Eigenschaften ausgegeben und der Zugriff auf die Eigenschaften des Objektes muss manuell über JSONata erfolgen.
Falls vorhanden, bestätigen Sie die Einstellungen auf der Seite Ausgabe Schema mit Weiter.
Der Tab Zusammenfassung erscheint. Hier werden Ihnen nochmals alle Einstellungen angezeigt.
1 Knotenschlüssel: Namen des Knotens, der im Flow-Designer in eckigen Klammern angezeigt wird
2 Knotenbeschreibung: Detailliertere Beschreibung des Knotens
3 Keinen Fehler auslösen, wenn der Dienst fehlschlägt.: Der komplette Flow läuft durch, auch wenn dieser Dienst fehlschlägt. Diese Funktion dient zu Testzwecken. Die Ergebnisdaten dieses Dienstes können fehlerhaft oder nicht vorhanden sein können.
Wählen Sie Abschließen, um die Einstellungen des Dienstes im Konfigurationsbereich zu übernehmen.
Beachte Sie
Mit der Aktion Abschließen werden die Konfigurationen nur im Konfigurationsbereich zwischengespeichert und noch nicht endgültig für den Flow übernommen.
Wählen Sie im Flow-Designer Speichern, um die Eingaben im Konfigurationsbereich für den Flow endgültig zu übernehmen.
Speichern Sie den gesamten Flow.
Die Statusanzeige wechselt nun auf Aktiv.