Benutzerschnittstellen für Prozessinstanzen erstellen

Zur Erstellung einer Benutzerschnittstelle für Prozessinstanzen müssen Sie zuerst einen clientseitigen Benutzerservice erstellen. Anschließend können Sie Ihre angepasste Schnittstelle erstellen, indem Sie den generierten Service und die Seite ändern.

1. Öffnen Sie den Prozess, für den Sie die Benutzerschnittstelle erstellen möchten.
2. Wechseln Sie zur Seite Ansichten .
3. Wählen Sie die zu erstellende Schnittstelle aus, z. B. Standard unter Benutzerschnittstelle für Details oder Benutzerschnittstelle starten.
4. Klicken Sie auf Neu neben Clientseitiger Benutzerservice und geben Sie einen Namen für Ihre Benutzerschnittstelle ein.
5. Klicken Sie auf Weiter.
   Auf der Seite Neuer clientseitiger Benutzerservice sehen Sie eine Liste der Variablen, die Sie an den clientseitigen Benutzerservice übergeben und aus diesem zurückgeben können.

   Eine Zuordnung der Variablen zwischen dem Prozess und dem Benutzerservice ist nicht erforderlich. Die Prozessvariablen sind den Benutzerservicevariablen mit demselben Namen bereits zugeordnet.

6. Klicken Sie auf Fertigstellen.
7. Der Editor für den clientseitigen Benutzerservice wird geöffnet. Wechseln Sie zur Seite Variablen .
   Beachten Sie, dass die über den Prozess zugeordneten Eingabe- und Ausgabevariablen gesperrt sind. Diese Variablen können nur im Prozesseditor bearbeitet werden. Sie können allerdings private Variablen hinzufügen, die nur für den Benutzerservice zur Verfügung stehen.

   Wenn Sie eine Startbenutzerschnittstelle erstellen, wird eine Variable cancelLaunch des Typs 'Boolean' generiert. Der Standardwert ist 'false'. Sie können diese Variable nur anzeigen, Sie können sie aber weder ändern noch löschen. Der Wert der Variablen wird durch den Benutzerservice für die Startbenutzerschnittstelle festgelegt. Wenn der Wert von cancelLaunch auf 'true' gesetzt ist, wenn ein Benutzer den Benutzerservice während des Starts ausführt, wird der Startvorgang abgebrochen. Lautet der Wert 'false', wird der Prozess gestartet.

8. Wechseln Sie zur Seite Diagramm .
   Es wird ein Basisdiagramm generiert. Wenn Sie eine Benutzerschnittstelle für Details erstellen, enthält das Diagramm einen Handler für Datenänderungsereignisse zur Verwaltung von Datenänderungen in der Benutzerschnittstelle während der Ausführung. Der Ereignishandler ist zur Verwendung bereit. Sie können die Implementierung jedoch anpassen, indem Sie auf den Knoten Datenänderung doppelklicken. Weitere Informationen finden Sie unter Handhabung von Datenänderungen.
9. Schließen Sie das Benutzerservicediagramm ab und passen Sie die Seiten an.
   • Bei einer Benutzerschnittstelle für Details verfügt der generierte Benutzerservice über zwei Seiten:
     • Instanzdetails anzeigen: Enthält die folgenden Ansichten:

       Standardschablone für Instanzdetails

       Zeigt die Instanzdetails in Workplacean

       Datenabschnitt

       Zeigt die Werte der Variablen an, die an den Benutzerservice übergeben werden.

     • Fehler anzeigen - ein Coach, der einen Fehler zurückgibt, wenn die Instanz nicht gefunden wird.
   • Bei einer Startbenutzerschnittstelle verfügt der generierte Benutzerservice über über eine Seite Daten eingeben mit einem Steuerelement für jede zugeordnete Prozessvariable. Wenn Sie eine Startprozessbenutzerschnittstelle angeben, wird eine Variable cancelLaunch des Typs 'Boolean' generiert. Der Wert der Variablen wird durch den Benutzerservice für die Startbenutzerschnittstelle festgelegt. Wenn der Wert von cancelLaunch auf 'true' gesetzt ist, wenn ein Benutzer den Benutzerservice zum Starten abschließt, wird der Startvorgang abgebrochen. Wenn der Wert von cancelLaunch auf 'false' gesetzt ist, wird der Prozess gestartet. Der Standardwert ist 'false'. Die generierte Startbenutzerschnittstelle verfügt über eine Seite mit zwei Schaltflächen: OK und Abbrechen. Wenn ein Benutzer auf Abbrechen klickt, wird die Variable cancelLaunch auf 'true' gesetzt.
     Sie können Ihre Startbenutzerschnittstelle so ändern, dass ein Benutzer Dokumente im Prozessordner anzeigen oder hinzufügen kann, den Sie auf der Seite Ordner angegeben haben. Hierzu können Sie mithilfe der im Content-Management-Toolkit bereitgestellten Ansichten Dokumente im Content-Store anzeigen und abrufen. Ein Beispiel hierfür ist das Steuerelement Dokumentexplorer. Diese Steuerelemente stehen im Content Management-Toolkit zur Verfügung. Weitere Informationen finden Sie unter:

     • Verwendung von Ansichten zum Speichern oder Anzeigen von Dokumenten

     Anmerkung: Wenn der Prozessstart abgebrochen wird, werden die Dokumente und Ordner in einem externen Enterprise Content Management-System, auf die vom Prozessordner verwiesen wird, nicht gelöscht.
10. Klicken Sie auf Speichern oder auf Bearbeitung beenden.
    Details zur Deklaration von Variablen für die clientseitigen menschlichen Dienste finden Sie unter Deklaration von Variablen
11. Testen Sie den clientseitigen Benutzerservice.
    • Klicken Sie unter Launch UI auf Run , um den clientseitigen menschlichen Dienst und die Seite zu testen.
    • Führen Sie für eine Benutzerschnittstelle für Details eine der folgenden Aktionen aus:
      • Wenn der Benutzerservice-Flow nicht angepasst ist, führen Sie die Instanzbenutzerschnittstelle in Workplaceaus.
      • Gehen Sie wie folgt vor, um die angepasste Benutzerschnittstelle inkrementell zu testen und zu erstellen:
        1. Führen Sie eine Instanz des Prozesses aus, der zu der angepassten Benutzerschnittstelle gehört, und notieren Sie sich die Instanz-ID.
        2. Der Benutzerservice beinhaltet Logik, die einen Fehler anzeigt, wenn die Prozessinstanz-ID null ist. Entfernen Sie diese Logik, indem Sie den Knoten Start direkt mit dem Knoten Clientseitige Initialisierungsdaten verbinden.
        3. In dem Script Client Side Init Data ändern Sie die erste Zeile wie folgt:

           tw.local.selectedInstanceId ='6'; 

           Dabei ist 6 die Instanz-ID, die Sie in Schritt a notiert haben.
        4. Führen Sie den Benutzerservice aus.
        5. Nachdem Sie sich davon überzeugt haben, dass der Service erwartungsgemäß funktioniert, setzen Sie die Änderungen, die Sie in den Schritten b und c vorgenommen haben, zurück. Wiederholen Sie den Test, indem Sie die Instanzbenutzerschnittstelle in Process Portalausführen.