Mithilfe der Orchestrator-REST-API können Sie auf eine wartende Benutzerinteraktion einer Workflowausführung antworten.

Vorbereitungen

Überprüfen Sie, ob das Paket mit Beispiel-Workflows in Orchestrator importiert wurde. Das Paket ist in der ZIP-Datei mit Orchestrator-Beispielanwendungen enthalten, die Sie von der Orchestrator-Dokumentationsseite herunterladen können.

Prozedur

  1. Rufen Sie die Liste aller Benutzerinteraktionsobjekte ab, indem Sie eine GET-Anforderung unter der URL ausführen, unter der die verfügbaren Benutzerinteraktionsobjekte gespeichert sind, oder indem Sie nur die wartenden Benutzerinteraktionen filtern:

    URL

    Beschreibung

    https://Orchestrator_Host:Port/vco/api/catalog/System/UserInteraction

    Hier sind die verfügbaren Benutzerinteraktionsobjekte in Orchestrator gespeichert.

    https://Orchestrator_Host:Port/vco/api/catalog/System/UserInteraction?status=0

    Nur die wartenden Benutzerinteraktionsobjekte werden gefiltert.

    Eine Liste der verfügbaren Benutzerinteraktionsobjekte wird ausgegeben. Wartende Benutzerinteraktionen weisen ein Attribut mit den Namen state und dem Wert waiting auf.

  2. Führen Sie eine GET-Anforderung unter der URL aus, unter der das Bestandslistenelement der wartenden Benutzerinteraktion gespeichert ist, auf die Sie antworten möchten:
    GET https://{Orchestrator_Host}:{Port}/vco/api/catalog/System/UserInteraction/{userInteractionID}/

    Das Bestandslistenelement enthält einen Link zu der Benutzerinteraktionsinstanz. Diese ist mit einer bestimmten Workflowausführung verknüpft.

  3. Führen Sie eine POST-Anforderung unter der URL der Benutzerinteraktionsinstanz für die betreffende Workflowausführung aus:
    POST https://{Orchestrator_Host}:{Port}/vco/api/workflows/{workflowID}/executions/{executionID}/interaction/
  4. Geben Sie in einem execution-context-Element im Hauptteil der Anforderung Werte für die Eingabeparameter der Benutzerinteraktion an.

Ergebnisse

Die REST-API gibt den Status 204 zurück, wenn Sie erfolgreich auf eine Benutzerinteraktion antworten.

Antworten auf die Benutzerinteraktion des interaktiven Workflows „Hello World“

Sie können den interaktiven Beispiel-Workflow „Hello World“ ausführen und auf dessen Benutzerinteraktion antworten.

  1. Suchen Sie nach der wartenden Benutzerinteraktion des Workflows, indem Sie am Endpoint für die Benutzerinteraktionsobjekte des Katalogdienstes eine GET-Anforderung ausführen:

    GET https://localhost:8281/vco/api/catalog/System/UserInteraction?status=0
  2. Suchen Sie nach dem Bestandslistenelement „Benutzerinteraktion“ für den interaktiven Workflow „Hello World“ und führen Sie unter dessen URL eine GET-Anforderung aus:

    GET https://localhost:8281/vco/api/catalog/System/UserInteraction/888080808080808080808080808080805A8080800132145338690643f66a027ec/
  3. Führen Sie eine POST-Anforderung unter der URL der Benutzerinteraktionsobjekte für die derzeit laufende Workflowausführung aus:

    POST https://localhost:8281/vco/api/workflows/CF808080808080808080808080808080E6808080013086668236014a0614d16e1/executions/88808080808080808080808080808080578080800132145338690643f66a027ec/interaction/

    Geben Sie im Hauptteil der Anforderung einen Wert für den Eingabeparameter an:

    <execution-context xmlns="http://www.vmware.com/vco">
       <parameters>
         <parameter name="name" type="string">
           <string>John Smith</string>
         </parameter>
       </parameters>
    </execution-context>