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 Daten aus Surveys anzuzeigen oder zu bearbeiten, die außerhalb Ihres Workflows erfasst werden, 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 eine Schritthilfe konfiguriert wurde, wird diese 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 überprüfen, bearbeiten oder übermitteln zu können.

Weitere Informationen zum Freigeben von Surveys in Survey123

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:
   • ArcGIS Online: Hierüber fügen Sie einen Survey auf ArcGIS Online hinzu.
   • Andere: Hierüber fügen Sie einen öffentlichen Survey von einem ArcGIS Enterprise-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.

   Verwenden Sie für ArcGIS Enterprise das Format https://webadaptorhost.domain.com/webadaptorname.

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 "GP-Service ausführen" enthalten ist, werden Schritte nach Ablauf des Benutzer-Token nicht automatisch ausgeführt. Wenn zusätzliche automatisierte Schritte ohne manuellen Eingriff ausgeführt werden sollen, müssen Sie über die Organisationserweiterung "ArcGIS Workflow Manager Advanced" verfügen.

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

      Weitere Informationen zu Planungsoptionen

14. Wählen Sie optional eine der folgenden Optionen, um die Hilfe in diesem Schritt zu konfigurieren:
    • Keine: Hierüber konfigurieren Sie den Schritt ohne Schritthilfe.
    • Text: Hierüber konfigurieren Sie den Hilfetext für den Schritt im Textfeld Text.

      Sie können ArcGIS Arcade-Ausdrücke verwenden, um für die Hilfe zum Schritt einen dynamischen Wert bereitzustellen. Wenn die Hilfe zum Schritt Text und Arcade-Ausdrücke enthält, muss der Text wie folgt formatiert werden:

      
      'For further assistance, please contact' + JobCreator($Job) + '.'

      Tipp:

      Klicken Sie auf Diese Eingabe unterstützt Arcade-Ausdrücke , und wählen Sie einen Arcade-Ausdruck für das zugehörige Textfeld aus.

    • URL: Hierüber konfigurieren Sie den Schritt mit einem Link zu einer Hilfe im Textfeld URL.

      Hinweis:

      Bei in der Web-App ausgeführten Schritten werden nur die URL-Formate HTTP und HTTPS unterstützt. Bei in ArcGIS Pro ausgeführten Schritten werden HTTP, HTTPS und Dateiformate unterstützt.

      Sie können auch Arcade-Ausdrücke verwenden, um einen dynamischen Wert bereitzustellen. Wenn die URL Text und Arcade-Ausdrücke enthält, muss der Text wie folgt formatiert werden:

      
      'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'

      Konfigurieren Sie das Kontrollkästchen Arcade-Ergebnis automatisch codieren wie folgt:

      • Wenn ein Arcade-Ausdruck ein Ergebnis zurückgibt, in dem Sonderzeichen enthalten sind, die beim Konvertieren in eine URL mit Escape-Zeichen versehen werden müssen, wie zum Beispiel ein Leerzeichen oder ein Schrägstrich, dann stellen Sie sicher, dass das Kontrollkästchen Arcade-Ergebnis automatisch codieren aktiviert ist.
      • Wenn ein Arcade-Ausdruck zum Erstellen der Basis-URL verwendet wird, dann deaktivieren Sie das Kontrollkästchen Arcade-Ergebnis automatisch codieren.

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.

    Tipp:

    Die Registerkarte Info enthält auch die ID des Schrittes, die zusammen mit dynamischen Auftragseigenschaften verwendet werden kann, um das Ergebnis eines Schrittes abzurufen. Klicken Sie auf Schritt-ID kopieren , um die Schritt-ID in die Zwischenablage zu kopieren.

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ückgabewert	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 ist der Ausgabewert des Schrittes aufgeführt:

Ausgabe	Beschreibung
<GlobalID>	Gibt die globalid des Surveys zurück, der zuletzt erstellt, angezeigt oder bearbeitet wurde.