Formularzentrierte Workflows in OSGi - Schritt-Referenz forms-centric-workflow-on-osgi-step-reference

Titel: Titel der Aufgabe. Der Titel wird im AEM-Posteingang angezeigt.

Beschreibung: Erläuterung der in der Aufgabe ausgeführten Vorgänge. Diese Informationen sind für andere Prozessentwickler nützlich, wenn Sie in einer gemeinsamen Entwicklungsumgebung arbeiten.

Pfad für Miniaturansichten: Pfad der Aufgabenminiatur. Wenn kein Pfad angegeben ist, wird für ein adaptives Formular eine Standardminiatur angezeigt und für das Datensatzdokument ein Standardsymbol.

Workflow-Phase: Ein Workflow kann mehrere Phasen enthalten. Diese werden im AEM-Posteingang angezeigt. Sie können diese Schritte in den Eigenschaften des Modells definieren (Sidekick > Seite > Seiteneigenschaften > Schritte).

Priorität: Die ausgewählte Priorität wird in der AEM Inbox angezeigt. Die verfügbaren Optionen sind "Hoch", "Mittel"und "Niedrig". Der Standardwert ist "Mittel".

Fälligkeitsdatum: Geben Sie die Anzahl der Tage oder Stunden an, nach denen die Aufgabe als überfällig markiert wird. Wenn Sie Aus, wird die Aufgabe nie als überfällig markiert. Sie können auch einen Zeitüberschreitungshandler festlegen, um bestimmte Aufgaben auszuführen, nachdem die Aufgabe überfällig ist.

Tage: Die Anzahl der Tage, nach denen die Aufgabe abgeschlossen werden soll. Die Anzahl der Tage wird gezählt, nachdem die Aufgabe einem Benutzer zugewiesen wurde. Wenn eine Aufgabe nicht abgeschlossen ist und die im Feld Tage angegebene Anzahl von Tagen überschreitet, wird bei Auswahl dieser Option nach dem Fälligkeitsdatum ein Timeout-Handler ausgelöst.

Stunden: Die Anzahl der Stunden, in denen die Aufgabe abgeschlossen werden soll. Die Anzahl der Stunden wird gezählt, nachdem die Aufgabe einem Benutzer zugewiesen wurde. Wenn eine Aufgabe nicht abgeschlossen und die Anzahl der Stunden im Feld „Stunden“ überschritten wurde, wird bei Auswahl dieser Option nach der entsprechenden Stundenanzahl ein Zeitüberschreitungshandler ausgelöst.

Zeitüberschreitung nach Fälligkeitsdatum: Wählen Sie diese Option, um das Auswahlfeld „Zeitüberschreitungshandler“ zu aktivieren.

Zeitüberschreitungshandler: Wählen Sie das Skript aus, das ausgeführt werden soll, wenn der Schritt „Aufgabe zuweisen“ das Fälligkeitsdatum überschreitet. Skripte, die im CRX-Repository unter [apps]/fd/dashboard/scripts/timeoutHandler abgelegt werden, stehen zur Auswahl. Der angegebene Pfad existiert nicht im CRX-Repository. Ein Administrator erstellt den Pfad, bevor er ihn verwendet.

Markieren Sie Aktion und Kommentar aus der letzten Aufgabe in „Aufgabendetails“: Wählen Sie diese Option, um die letzte ausgeführte Aktion und den Kommentar, der im Abschnitt „Aufgabendetail“ einer Aufgabe erhalten wurde, anzuzeigen.

Typ: Wählen Sie den Typ des Dokuments, das ausgefüllt werden soll, wenn der Workflow gestartet wird. Sie können ein adaptives Formular, ein schreibgeschütztes adaptives Formular oder ein nicht interaktives PDF-Dokument auswählen.

Adaptives Formular verwenden: Geben Sie die Methode zum Suchen des adaptiven Eingabeformulars an. Sie können das adaptive Formular verwenden, das in einem absoluten Pfad verfügbar ist, als Nutzlast an den Workflow übermittelt wird oder in einem Pfad verfügbar ist, der mithilfe einer Variablen berechnet wurde. Sie können eine Variable des Typs „Zeichenfolge“ verwenden, um den Pfad anzugeben.

Adaptiver Formularpfad: Geben Sie den Pfad des adaptiven Formulars an. Das Feld ist verfügbar, wenn Sie im Feld Typ ein adaptives Formular oder eine schreibgeschützte Option für ein adaptives Formular verwenden und im Feld Adaptives Formular verwenden die Option absoluter Pfad verwenden.

PDF Path: Geben Sie den Pfad eines nicht interaktiven PDF-Dokuments an. Das Feld ist verfügbar, wenn Sie im Feld „Typ“ ein nicht interaktives PDF-Dokument auswählen. Der Pfad ist immer relativ zur Payload. Beispiel: [Payload_Directory]/Workflow/PDF/credit-card.pdf. Der Pfad ist im CRX-Repository nicht vorhanden. Ein Administrator erstellt den Pfad, bevor er ihn verwendet. Sie benötigen eine Option "Datensatzdokument"aktiviert oder auf Formularvorlagen basierende adaptive Formulare, um die Option PDF-Pfad verwenden zu können.

Geben Sie für abgeschlossene Aufgaben das adaptive Formular als: Wenn eine Aufgabe als abgeschlossen markiert ist, können Sie das adaptive Formular als schreibgeschütztes adaptives Formular oder als PDF-Dokument wiedergeben. Sie benötigen eine Option "Datensatzdokument"aktiviert oder auf Formularvorlagen basierende adaptive Formulare, um das adaptive Formular als Datensatzdokument wiederzugeben.

Vorausgefüllte Informationen: Die folgenden Felder dienen als Eingaben für die Aufgabe:

• Datendateipfad: Pfad der Eingabedatendatei (.json oder .xml). Der Pfad ist immer relativ zur Payload. Beispielsweise enthält die Datei die Daten, die über eine AEM-Posteingangsanwendung für das Formular übermittelt werden. Ein Beispielpfad ist [Payload_Directory]/workflow/data.
• Anlagenpfad: Die am Speicherort verfügbaren Anlagen werden an das Formular angehängt, das mit der Aufgabe verknüpft ist. Der Pfad ist immer relativ zur Payload. Ein Beispielpfad ist [Payload_Directory]/attachments/

Gesendete Informationen: Die folgenden Felder dienen als Ausgabespeicherorte für die Aufgabe:

• Datendateipfad: Pfad der Datendatei (.json oder .xml). Die Datendatei enthält Informationen, die über das zugeordnete Formular übermittelt werden. Der Pfad ist immer relativ zur Payload. Zum Beispiel [Payload_Directory]/Workflow/data, wobei „data“ für eine Datei steht.
• Anlagenpfad: Pfad zum Speichern der in einer Aufgabe bereitgestellten Formularanhänge.
• Pfad des Datensatzdokuments: Pfad zum Speichern einer Datensatzdokumentdatei. Beispielsweise [Payload_Directory]/DocumentofRecord/credit-card.pdf. Das Datensatzdokument wird nicht generiert, wenn das Pfadfeld leer gelassen wird. Der Pfad ist immer relativ zur Payload.

Optionen zuweisen: Geben Sie die Methode an, um die Aufgabe einem Benutzer zuzuweisen. Sie können die Aufgabe dynamisch einem Benutzer oder einer Gruppe zuweisen, indem Sie das Skript „Teilnehmerauswahl“ verwenden oder die Aufgabe einem bestimmten AEM-Benutzer oder einer bestimmten Gruppe zuweisen.

Teilnehmerauswahl: Die Option ist verfügbar, wenn die Dynamisch für einen Benutzer oder eine Gruppe im Feld Optionen zuweisen ausgewählt ist. Sie können ein ECMAScript oder einen Service verwenden, um einen Benutzer oder eine Gruppe dynamisch auszuwählen. Weitere Informationen finden Sie unter Dynamische Zuweisung eines Workflows an Benutzer und Erstellen eines benutzerdefinierten Adobe Experience Manager Dynamic Participant-Schritts.

Teilnehmer: Das Feld ist verfügbar, wenn die Option com.adobe.granite.workflow.core.process.RandomParticipantChooser im Feld Teilnehmerauswahl ausgewählt ist. In diesem Feld können Sie Benutzer oder Gruppen für die Option „RandomParticipantChooser“ auswählen.

Argumente: Das Feld ist verfügbar, wenn ein anderes als das Skript „RandomParticipantChoose“ im Feld „Teilnehmerauswahl“ ausgewählt wurde. In diesem Feld können Sie eine Liste mit durch Kommas getrennten Argumenten für das im Feld „Teilnehmerauswahl“ ausgewählte Skript angeben.

Benutzer oder Gruppe: Die Aufgabe wurde dem ausgewählten Benutzer oder der Gruppe zugewiesen. Die Option ist verfügbar, wenn die Option Zu einem bestimmten Benutzer bzw. einer bestimmten Gruppe im Feld Optionen zuweisen ausgewählt ist. Das Feld listet alle Benutzer und Gruppen der Workflow-Benutzergruppe auf.

Bevollmächtigten per E-Mail benachrichtigen: Wählen Sie diese Option, um E-Mail-Benachrichtigungen an den Bevollmächtigten zu senden. Diese Benachrichtigungen werden gesendet, wenn einem Benutzer eine Aufgabe zugewiesen wird. Bevor Sie die Option verwenden, aktivieren Sie die Benachrichtigungen über AEM Web-Konsole. Eine schrittweise Anleitung finden Sie unter E-Mail-Benachrichtigungen für den Schritt "Aufgabe zuweisen"konfigurieren

HTML-E-Mail-Vorlage: Wählen Sie die E-Mail-Vorlage für die Benachrichtigungs-E-Mail. Um eine Vorlage zu bearbeiten, ändern Sie die Datei unter /libs/fd/dashboard/templates/email/htmlEmailTemplate.txt im crx-Repository.

Delegation zulassen an: AEM Posteingang bietet eine Option für den angemeldeten Benutzer, den zugewiesenen Workflow an einen anderen Benutzer zu delegieren. Sie können innerhalb derselben Gruppe oder an den Workflow-Benutzer einer anderen Gruppe delegieren. Wenn die Aufgabe einem einzelnen Benutzer zugewiesen ist und die Option Delegierung an Mitglieder der Gruppe an Verantwortlichen zulassen aktiviert ist, kann die Aufgabe nicht an einen anderen Benutzer oder eine andere Gruppe übertragen werden.

Standardaktionen: Standardmäßig sind die Aktionen "Senden", "Speichern"und "Zurücksetzen"verfügbar. Alle Standardaktionen sind standardmäßig aktiviert.

Route-Variable: Name der Route-Variablen. Die Route-Variable erfasst benutzerdefinierte Aktionen, die ein Benutzer im AEM-Posteingang auswählt.

Routen: Eine Aufgabe kann zu verschiedenen Routen verzweigen. Bei Auswahl im AEM-Posteingang gibt die Route einen Wert zurück, und der Workflow verzweigt basierend auf der ausgewählten Route.

Routentitel: Geben Sie den Titel für die an. Er wird im AEM-Posteingang angezeigt.

Korallensymbol: Geben Sie das HTML-Attribut eines Korallensymbols an. Die Adobe CoralUI-Bibliothek bietet eine Vielzahl von Touch-First-Symbolen. Sie können ein Symbol für die Route auswählen und verwenden. Es wird zusammen mit dem Titel im AEM-Posteingang angezeigt.

Zulassen, dass Verantwortlicher Kommentare hinzufügt: Wählen Sie diese Option, um Kommentare für die Aufgabe zu aktivieren. Ein Verantwortlicher kann die Kommentare innerhalb des AEM-Posteingangs zum Zeitpunkt der Aufgabenübermittlung hinzufügen.

Bevollmächtigten erlauben, Anlagen zur Aufgabe hinzuzufügen: Wählen Sie diese Option aus, um Anlagen für die Aufgabe zu aktivieren. Ein Verantwortlicher kann die Anhänge im AEM-Posteingang zum Zeitpunkt der Aufgabenübermittlung hinzufügen.

Ausgabepfad der Aufgabenanlagen: Geben Sie den Speicherort des Anlagenordners an. Der Speicherort ist relativ zur Payload.

Verwenden benutzerdefinierter Metadaten: Wählen Sie diese Option aus, um das benutzerdefinierte Metadatenfeld zu aktivieren. Benutzerdefinierte Metadaten werden in E-Mail-Vorlagen verwendet.

Benutzerdefinierte Metadaten: Wählen Sie benutzerdefinierte Metadaten für die E-Mail-Vorlagen. Die benutzerdefinierten Metadaten sind im CRX-Repository unter apps/fd/dashboard/scripts/metadataScripts verfügbar. Der angegebene Pfad existiert nicht im CRX-Repository. Ein Administrator erstellt den Pfad, bevor er ihn verwendet. Sie können auch einen Service für die benutzerdefinierten Metadaten verwenden. Sie können auch die Schnittstelle WorkitemUserMetadataService erweitern, um benutzerdefinierte Metadaten bereitzustellen.

Daten aus vorherigen Schritten anzeigen: Wählen Sie - falls verfügbar - diese Option aus, um den Bevollmächtigten das Anzeigen früherer Bevollmächtigter, bereits vorgenommener Aktionen, Kommentare zu dieser Aufgabe und des Nachweisdokuments über abgeschlossene Aufgaben zu ermöglichen.

Daten aus allen nachfolgenden Schritten einblenden: Wählen Sie diese Option, um dem aktuellen Bearbeiter zu ermöglichen, die durchgeführte Aktion und Kommentare, die von nachfolgenden Beauftragten zur Aufgabe hinzugefügt wurden, anzuzeigen. Außerdem kann der aktuelle Bevollmächtigte ein Datensatzdokument der abgeschlossenen Aufgabe anzeigen, sofern verfügbar.

Sichtbarkeit des Datentyps: Standardmäßig kann ein Bevollmächtigter ein Datensatzdokument, Bevollmächtigte, durchgeführte Aktionen und Kommentare anzeigen, die von früheren und nachfolgenden Bevollmächtigten hinzugefügt wurden. Verwenden Sie die Option „Sichtbarkeit des Datentyps“, um den Typ der für die Verantwortlichen sichtbaren Daten zu begrenzen.

Literal: Verwenden Sie die Option, wenn Sie den genauen Wert kennen, der angegeben werden soll. Beispiel: beispiel@beispiel.com.

Workflow-Metadaten: Verwenden Sie die Option , wenn der zu verwendende Wert in einer Workflow-Metadateneigenschaft gespeichert wird. Geben Sie nach Auswahl der Option den Namen der Metadateneigenschaft in das leere Textfeld unter der Option Workflow-Metadaten ein. Beispiel: e-mailAdresse.

Asset-URL: Verwenden Sie diese Option zum Einbetten eines Weblinks einer interaktiven Kommunikation in die E-Mail. Nachdem Sie die Option ausgewählt haben, suchen Sie nach der interaktiven Kommunikation, die eingebettet werden soll. Das Asset kann sich auf dem Autoren- oder Veröffentlichungsserver befinden.

Bild: Verwenden Sie die Option , um ein Bild in die E-Mail einzubetten. Nachdem Sie die Option ausgewählt haben, suchen Sie nach dem entsprechenden Bild und wählen Sie es aus. Die Bildoption ist nur für die Bild-Tags (<img src="*" />) verfügbar, die in der E-Mail-Vorlage verfügbar sind.

Titel: Bezeichnung des Schrittes. Dies erleichtert die Identifizierung dieses Schritts im Workflow-Editor.

Beschreibung: Erklärungen können für andere Entwickler nützlich sein, wenn Sie in einer gemeinsamen Entwicklungsumgebung arbeiten.

Pfad für Formulardatenmodell: Wählen Sie ein Formulardatenmodell auf dem Server aus.

Dienst: Liste der Dienste, die das ausgewählte Formulardatenmodell bereitstellt.

Eingabe für Dienste > Bereitstellen von Eingabedaten mithilfe von Literal, Workflow-Metadaten und einer JSON-Datei: Ein Dienst kann mehrere Argumente haben. Wählen Sie die Option aus, um den Wert der Dienstargumente aus einer Workflow-Metadateneigenschaft oder einem JSON-Objekt abzurufen, oder geben Sie den Wert direkt in das bereitgestellte Textfeld ein:

• Literal: Verwenden Sie die Option, wenn Sie den genauen Wert kennen, der angegeben werden soll. Beispiel: srose@we.info.
• Aus Workflow-Metadaten abrufen: Verwenden Sie die Option , wenn der zu verwendende Wert in einer Workflow-Metadateneigenschaft gespeichert wird. Beispiel: e-mailAddress.
• JSON Dot Notation: Verwenden Sie die Option, wenn der zu verwendende Wert in einer JSON-Datei enthalten ist. Beispielsweise ist die Option "insurance.customerDetails.emailAddress.The JSON Dot Notation"nur verfügbar, wenn die Option Eingabefelder aus Eingabe-JSON zuordnen ausgewählt ist.
• Zuordnen von Eingabefelder aus der Eingabe JSON: Geben Sie den Pfad einer JSON-Datei an, um den Eingabewert einiger Service-Parameter aus der JSON-Datei abzurufen. Der Pfad der JSON-Datei kann relativ zur Payload oder ein absoluter Pfad sein.

Eingabe für Dienste > Bereitstellen von Eingabedaten mithilfe einer JSON-Datei: Wählen Sie die Option aus, um Werte für alle Argumente aus einer JSON-Datei abzurufen.

Eingabe-JSON-Dateipfad: Pfad der JSON-Datei mit Werten für alle Service-Argumente. Der Pfad der JSON-Datei kann relativ zur Payload oder ein absoluter Pfad sein.

JSON Dot Notation: Lassen Sie das Feld leer, um alle Objekte der angegebenen JSON-Datei als Eingabe für Dienstargumente zu verwenden. Um ein bestimmtes JSON-Objekt aus der angegebenen JSON-Datei als Eingabe für Service-Argumente zu lesen, geben Sie die Dot Notation für das JSON-Objekt an, z. B. wenn Sie eine JSON ähnlich wie am Anfang des Abschnitts aufgeführt haben, geben Sie „insurance.customerDetails“ an, um alle Details eines Kunden als Eingabe für den Service anzugeben.

Ausgabe des Dienstes > Zuordnen und Schreiben von Ausgabewerten zu Metadaten: Wählen Sie die Option zum Speichern der Ausgabewerte als Eigenschaften des Metadatenknotens der Workflow-Instanz im crx-Repository aus. Geben Sie den Namen der Metadateneigenschaft an und wählen Sie das entsprechende Service-Ausgabeattribut, das der Metadateneigenschaft zugeordnet werden soll, ordnen Sie z. B. die vom Ausgabe-Service zurückgegebene Telefonnummer der Eigenschaft „phone_number“ der Workflow-Metadaten zu.

Ausgabe des Dienstes > Ausgabe als JSON speichern: Wählen Sie die Option zum Speichern der Ausgabewerte in einer JSON-Datei aus.

Pfad der JSON-Ausgabedatei: Pfad zum Speichern der JSON-Ausgabedatei. Der Pfad der JSON-Ausgabedatei kann relativ zur Payload oder einem absoluten Pfad sein.

Name der Vereinbarung: Geben Sie den Titel der Vereinbarung an. Der Name der Vereinbarung wird Teil des Betreffs und des Textkörpers der E-Mail, die an die Unterzeichner gesendet wird.

Gebietsschema: Geben Sie die Sprache für die E-Mail- und Bestätigungsoptionen an.

Acrobat Sign Cloud-Konfiguration: Wählen Sie eine Acrobat Sign Cloud-Konfiguration aus. Wenn Sie Acrobat Sign nicht für AEM Forms konfiguriert haben, finden Sie weitere Informationen unter Integrieren von Acrobat Sign mit AEM Forms.

Zu signierendes Dokument: Sie können ein Dokument an einem Speicherort auswählen, der relativ zur Payload ist, die Payload als Dokument verwenden oder einen absoluten Pfad des Dokuments angeben.

Pfad für Eingabeanlage: Wählen Sie eine Anlage aus. Diese Anlagen sind im Signaturdokument enthalten. Sie können die Anlagen an einem Speicherort relativ zur Payload belassen oder einen absoluten Pfad der Anlagen angeben.

Wenn Sie den Pfad eines Ordners angeben, z. B. Anhänge, werden alle Dateien, die direkt im Ordner verfügbar sind, an das Datensatzdokument angehängt. Wenn Dateien in den Ordnern verfügbar sind, die im angegebenen Anlagenpfad direkt verfügbar sind, werden die Dateien im Signaturdokument als Anlagen aufgenommen. Wenn sich Ordner in direkt verfügbaren Ordnern befinden, werden diese übersprungen.

Tage bis Abgabetermin: Ein Dokument wird als „fällig“ (Abgabetermin überschritten) gekennzeichnet, nachdem für die im Feld Tage bis Abgabetermin angegebene Anzahl von Tagen keine Aktivität für die Aufgabe ermittelt wurde. Die Anzahl der Tage wird gezählt, nachdem das Dokument einem Benutzer zur Unterzeichnung zugewiesen wurde.

Häufigkeit der E-Mail-Erinnerung: Sie können eine Erinnerungs-E-Mail im täglichen oder wöchentlichen Intervall senden. Die Woche wird ab dem Tag gezählt, an dem das Dokument einem Benutzer zum Signieren zugewiesen wurde.

Signaturprozess: Sie können ein Dokument in einer sequenziellen oder parallelen Reihenfolge signieren. Bei sequenzieller Reihenfolge erhält jeweils nur ein Unterzeichner das Formular zur Unterzeichnung. Nachdem der erste Unterzeichner das Signieren des Dokuments abgeschlossen hat, wird das Dokument an den zweiten Unterzeichner gesendet usw. Bei paralleler Reihenfolge können mehrere Unterzeichner ein Formular gleichzeitig signieren.

Umleitungs-URL: Geben Sie eine Umleitungs-URL an. Nachdem das Dokument signiert wurde, können Sie den Verantwortlichen an eine URL umleiten. Normalerweise enthält diese URL eine Dankesnachricht oder weitere Anweisungen.

Workflow-Phase: Ein Workflow kann mehrere Phasen enthalten. Diese werden im AEM-Posteingang angezeigt. Sie können diese Schritte in den Eigenschaften des Modells definieren (Sidekick > Seite > Seiteneigenschaften > Schritte).

Unterzeichner wählen: Geben Sie die Methode zum Auswählen von Unterzeichnern für das Dokument an. Sie können den Workflow einem Benutzer oder einer Gruppe dynamisch zuweisen oder manuell Details zu einem Unterzeichner hinzufügen.

Skript oder Dienst zur Auswahl von Unterzeichnern: Die Option ist nur verfügbar, wenn im Feld Unterzeichner auswählen die Option Dynamisch ausgewählt ist. Sie können ein ECMAScript oder einen Service angeben, um Unterzeichner und Verifizierungsoptionen für ein Dokument auszuwählen.

Unterzeichnerdetails: Die Option ist nur verfügbar, wenn die Option „Manuell“ im Feld „Unterzeichner auswählen“ ausgewählt ist. Geben Sie die E-Mail-Adresse an und wählen Sie einen optionalen Verifizierungsmechanismus aus. Bevor Sie einen zweistufigen Überprüfungsmechanismus auswählen, stellen Sie sicher, dass die entsprechende Überprüfungsoption für das konfigurierte Acrobat Sign-Konto aktiviert ist.

Statusvariable: Ein für Acrobat Sign aktiviertes Dokument speichert den Signaturstatus des Dokuments in einer Variablen. Geben Sie den Namen der Statusvariable (adobeSignStatus) an. Eine Statusvariable einer Instanz ist in CRXDE unter /etc/workflow/instances/<Server>/<Datum/Uhrzeit>/<Instanz des Workflow-Modells>/workItems/<Knoten>/metaData verfügbar und enthält den Status einer Variablen.

Signed Document Path: Geben Sie den Speicherort für signierte Dokumente an. Sie können die Payload-Datei überschreiben oder das signierte Dokument an einem Speicherort im Payload-Verzeichnis ablegen.