Hinzufügen und Konfigurieren von Survey123

Mit dem Schritt Survey123 können Sie ArcGIS Survey123-Surveys in ArcGIS Workflow Manager erfassen, anzeigen und bearbeiten.

Für den Schritt Survey123 muss aus dem Survey-Formular eine Tabelle mit erweiterten Eigenschaften erstellt werden, um Survey-Daten mit Aufträgen zu verknüpfen. Wenn ein Survey übermittelt wird, wird die Tabelle mit den erweiterten Eigenschaften für die Verknüpfung mit den Daten befüllt, die im Rahmen des Surveys gesammelt wurden. Wenn keine Tabelle mit erweiterten Eigenschaften aus dem Survey-Formular erstellt wurde, können Survey-Daten gesammelt werden, aber auf die gesammelten Daten kann nicht für die Aufträge zugegriffen werden.

Tipp:

Um Survey-Daten anzuzeigen oder zu bearbeiten, die außerhalb Ihres Workflows gesammelt wurden, erstellen Sie aus dem Survey-Formular eine Tabelle mit erweiterten Eigenschaften. Fügen Sie Ihrem Workflow-Diagramm den Schritt Auftragseigenschaften aktualisieren vor dem Schritt Survey123 hinzu, und aktualisieren Sie den Wert für die Link-ID in der Tabelle mit den erweiterten Eigenschaften mit einer globalid eines vorhandenen Survey.

Wenn der Schritt in der Workflow Manager-Web-App ausgeführt wird, wird der in dem Schritt konfigurierte Survey auf der Auftragskachel angezeigt. Wenn der Schritt in ArcGIS Pro ausgeführt wird, wird auf der Auftragskachel die Schaltfläche Im Web öffnen angezeigt, mit der der in dem Schritt in der Workflow Manager-Web-App konfigurierte Survey geöffnet werden kann. Wenn zu dem Schritt Hilfetext konfiguriert wurde, wird er unten auf der Auftragskachel angezeigt.

Hinweis:

Der Benutzer, der den Schritt ausführt, muss über ausreichende Berechtigungen in Survey123 verfügen, um das in dem Schritt konfigurierte Survey-Formular anzeigen, bearbeiten oder übermitteln zu können.

Weitere Informationen zum Freigeben von Surveys in Survey123

Vorsicht:

Wenn der in dem Schritt konfigurierte Survey nicht auf demselben ArcGIS Enterprise-Portal gehostet wird wie ArcGIS Workflow Manager Server, wird empfohlen, sich mit verschiedenen Webbrowsern bei der Workflow Manager-Web-App und Survey123 anzumelden. Wenn Sie bei mehreren Portalen im selben Webbrowser angemeldet sind, wenn der Schritt ausgeführt wird, werden für den Zugriff auf den Survey Ihre Survey123-Anmeldeinformationen und nicht Ihre Workflow Manager-Anmeldeinformationen verwendet.

BEim Ausführen des Schrittes können die folgenden Aktionen durchgeführt werden:

• Der konfigurierte Survey kann übermittelt, angezeigt und bearbeitet werden.
• Sie können den Schritt abbrechen, indem Sie auf Abbrechen klicken.
• Sie können den Schritt fertig stellen, indem Sie auf Fortfahren klicken.

Konfigurieren des Schrittes

Um den Schritt zu konfigurieren, gehen Sie wie folgt vor:

1. Erstellen oder bearbeiten Sie ein Workflow-Diagramm, um das Fenster Schrittbibliothek aufzurufen.
2. Ziehen Sie Survey123 aus dem Fenster Schrittbibliothek auf den Verbindungspfeil eines Schrittes auf der Workflow-Zeichenfläche.

   Weitere Informationen zum Hinzufügen von Schritten zu einem Workflow-Diagramm

   Das Fenster Schrittdetails wird angezeigt.

3. Geben Sie in das Textfeld Schrittname einen Namen für den Schritt ein.
4. Klicken Sie im Abschnitt Survey123-Formular auf Survey123-Formular hinzufügen.

   Das Dialogfeld Survey123-Formular hinzufügen wird angezeigt.

5. Wählen Sie eine der folgenden Optionen aus, um anzugeben, wo sich das Survey123-Formular befindet:
   • Dieses Enterprise-Portal: Hierüber fügen Sie einen Survey hinzu, der auf demselben Portal verfügbar ist wie Workflow Manager.
   • ArcGIS Online: Hierüber fügen Sie einen öffentlichen Survey auf ArcGIS Online hinzu.
   • Andere: Hierüber fügen Sie einen öffentlichen Survey von einem anderen Portal hinzu.
6. Wenn Sie Andere ausgewählt haben, geben Sie in das Textfeld Portal-URL die URL des Portals ein, das den Survey enthält und drücken die Eingabetaste.

   Die URL kann beispielsweise das Format https://webadaptorhost.domain.com/webadaptorname haben.

7. Geben Sie die Formular-ID des Surveys in das Textfeld Formular-ID ein.
8. Geben Sie in das Textfeld Referenzname einen Namen für den Survey ein.
9. Klicken Sie auf OK.

   Der Survey wird im Fenster Schrittdetails angezeigt.

   Hinweis:

   Ein Survey kann über die Schaltfläche Survey löschen gelöscht werden.

10. Klicken Sie auf die Umschaltfläche Beziehung, um zwischen einer Eins-zu-Eins-(1-1-) und einer Eins-zu-Viele-(1-M-)Survey-Beziehung mit Workflow Manager-Aufträgen zu wechseln.
    • 1-1: Legen Sie eine Eins-zu-Eins-Beziehung fest, wenn Sie möchten, dass nur ein Survey mit einem Auftrag verknüpft wird.
    • 1-M: Legen Sie eine Eins-zu-Viele-Beziehung fest, wenn Sie möchten, dass mehrere Surveys mit einem Auftrag verknüpft werden.
11. Wählen Sie eine der folgenden Optionen als Einstellung für Modus aus:
    • Neue erstellen: Hierüber erstellen und erfassen Sie einen Survey.

      Hinweis:

      Diese Option steht nur bei Surveys mit einer Eins-zu-Viele-(1-M-)Beziehung zur Verfügung.

    • Bearbeiten: Hierüber bearbeiten Sie einen Survey.

      Hinweis:

      Wenn kein Survey zu dem Auftrag vorhanden ist, wird ein Survey erstellt und erfasst. Wenn der Survey mit einer Eins-zu-Viele-(1-M-)Beziehung konfiguriert wurde, wird der zuletzt erfasste Survey bearbeitet.

    • Anzeigen: Hierüber zeigen Sie einen Survey an.

      Hinweis:

      Wenn der Survey mit einer Eins-zu-Viele-(1-M-)Beziehung konfiguriert wurde, wird der zuletzt erfasste Survey angezeigt.

12. Klicken Sie auf die Registerkarte Options.
13. Konfigurieren Sie Schrittoptionen nach Bedarf.
    • Manuell: Der Schritt wird manuell ausgeführt.
      • Optional: Der Schritt kann fertiggestellt werden, ohne dass er ausgeführt wird.
    • Automatisch: Der Schritt wird ausgeführt, sobald er aktiviert wird.

      Hinweis:

      Wenn das Workflow-Diagramm so konfiguriert ist, dass automatisch eine Folge von Schritten ausgeführt wird, in der der Schritt "Datenqualität bewerten" oder der Schritt "GP-Service ausführen" enthalten ist, werden Schritte, die nach Ablauf des Benutzer-Tokens, mit dem diese Schrittfolge gestartet wurde, nicht automatisch ausgeführt. Wenn die zusätzlichen automatisierten Schritte ohne manuellen Eingriff ausgeführt werden sollen, müssen Sie über eine Lizenz für die Rolle ArcGIS Workflow Manager Server Advanced verfügen.

    • Nach einem Zeitplan ausführen: Der Schritt wird nach einem von Ihnen festgelegten Zeitplan ausgeführt.

      Weitere Informationen zu Planungsoptionen

14. Im Textfeld Hilfe zum Schritt können Sie einen Hilfetext zum Schritt bereitstellen.

    Sie können auch wie im folgenden Beispiel ArcGIS Arcade-Ausdrücke verwenden, um einen dynamischen Wert anzuzeigen:

    
    'For further assistance, please contact ' + jobCreator($job) + '.'

15. Klicken Sie ggf. auf die Registerkarte Style, um Form und Farbe für den Schritt zu ändern.
16. Klicken Sie ggf. auf die Registerkarte Info, und geben Sie im Textfeld Schrittbeschreibung eine Beschreibung für den Schritt ein.

    Hinweis:

    Die Registerkarte Info enthält auch die ID des Schrittes, die zusammen mit dynamischen Auftragseigenschaften verwendet werden kann, um das Ergebnis eines Schrittes abzurufen.

Rückgabewert

Nach Abschluss des Schrittes wird der Rückgabewert gespeichert, um das Ergebnis des Schrittes anzuzeigen. Der Rückgabewert kann mithilfe von Pfaden sofort ausgewertet werden, um die nächsten Schritte im Workflow zu bestimmen. Mithilfe von ArcGIS Arcade-Ausdrücken können Sie während des gesamten Workflows auch den Rückgabewert eines abgeschlossenen Schrittes abrufen. In der folgenden Tabelle sind die Rückgabewerte des Schrittes aufgeführt:

Rückgabewerte	Beschreibung
S000001	Der Schritt wurde erfolgreich abgeschlossen.
F000001	Der Schritt wurde nicht erfolgreich abgeschlossen.

Ausgabewert

Nach Abschluss des Schrittes wird der Ausgabewert gespeichert. Er kann dann zum Festlegen des Pfades, dem der Workflow folgt, oder als Eingaben für weitere Schritte während des gesamten Workflows verwendet werden. In der folgenden Tabelle wird der Ausgabewert des Schrittes angezeigt:

Ausgabe	Beschreibung	Syntax für ArcGIS Arcade-Ausdruck
<GlobalID>	Gibt die globalid des Surveys zurück, der zuletzt erstellt, angezeigt oder bearbeitet wurde.	jobOutputValue($job, '<step_id>')