Erstellen von Aufträgen mit einem Survey123-Webhook

Lizenz:

Für diese Funktionalität ist eine Lizenz für die Rolle ArcGIS Workflow Manager Server Advanced erforderlich.

Sie können für ArcGIS Survey123-Surveys Webhooks konfigurieren, um beim Übermitteln von Surveys automatisch Aufträge in ArcGIS Workflow Manager zu erstellen. Allen Benutzern, die Surveys übermitteln, von denen automatisch Aufträge in Workflow Manager erstellt werden, muss eine Lizenz für die Benutzertyp-Erweiterung ArcGIS Workflow Manager zugewiesen sein. Zudem müssen sie über die entsprechenden Berechtigungen zum Erstellen von Aufträgen verfügen.

Hinweis:

Der Survey muss auf demselben ArcGIS Enterprise-Portal wie Workflow Manager Server gehostet werden.

Wenn ArcGIS Workflow Manager Server mit einem ArcGIS Enterprise-Portal integriert ist, das als Authentifizierungsmethode Integrated Windows Authentication (IWA) oder Public Key Infrastructure (PKI) verwendet, können Survey123-Webhooks nicht für die Erstellung von Aufträgen in Workflow Manager genutzt werden.

Vorsicht:

Wenn Sie einen Webhook für einen Survey erstellen oder ändern, muss der Survey in der mobilen Survey123-App aktualisiert werden, damit die Änderungen wirksam werden.

  1. Erstellen Sie für die Auftragsvorlage, die Sie bei der Übermittlung von Surveys zur Erstellung von Aufträgen verwenden möchten, eine erweiterte Eigenschaftentabelle.

    Darüber können Survey-Daten mit Aufträgen verknüpft werden.

  2. Suchen Sie nach der ID des Workflow-Elements und der Auftragsvorlage, die Sie verwenden möchten.
    1. Rufen Sie die Workflow Manager-Web-App auf.
    2. Klicken Sie auf die Registerkarte Entwerfen.

      Die Seite Entwerfen wird angezeigt.

      Hinweis:

      Wenn Sie nicht über ausreichende Berechtigungen verfügen, wird Ihnen die Registerkarte Entwerfen nicht angezeigt.

    3. Klicken Sie auf die Schaltfläche Auftragsvorlagen Job Templates.

      Das Fenster Auftragsvorlagen wird angezeigt.

    4. Klicken Sie im Fenster Auftragsvorlagen auf die Auftragsvorlage, die Sie verwenden möchten.
      Hinweis:

      Sie können ein Schlüsselwort in das Textfeld Auftragsvorlagen durchsuchen eingeben, um die Liste nach Auftragsvorlagen zu filtern, die das Schlüsselwort enthalten.

    5. Suchen Sie in der URL, die in der Adressleiste Ihres Webbrowsers angezeigt wird, nach der ID des Workflow-Elements und der Auftragsvorlage.

      Beispiel: https://gisserver.domain.com/webadaptorname/apps/workflowmanager/<workflow item id>/design/jobTemplate/<job template id>

  3. Konfigurieren Sie mit den folgenden Parametern einen Webhook für den Survey:
    1. Geben Sie im Feld Payload-URL die URL für Workflow Manager Server an. Orientieren Sie sich dabei an dem folgenden Beispiel:
      https://gisserver.domain.com/webadaptorname/workflow/<workflow item id>/webhooks/createJobFromSurveyResponse/<job template id>
    2. Aktivieren Sie im Abschnitt Trigger-Ereignisse das Kontrollkästchen Neuer Datensatz wurde gesendet.
    3. Aktivieren Sie im Abschnitt Ereignisdaten die folgenden Kontrollkästchen:
      • Surveyinformationen
      • Gesendeter Datensatz
      • Portalinformationen

Der Webhook ist verwendungsbereit und erstellt bei jedem Senden einer Survey-Antwort einen Auftrag in Workflow Manager.

Verwandte Themen