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 konfigurierte Survey in der Workflow Manager-Web-App 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. Wählen Sie ein Survey123-Formular aus dem Dropdown-Menü Survey 123-Formular aus.
5. Wenn kein Survey mit dem Workflow-Diagramm verknüpft ist, fügen Sie eine Survey-Datenreferenz hinzu:
   1. Klicken Sie im Dropdown-Menü auf Datenreferenz hinzufügen.

      Das Dialogfeld Datenreferenz hinzufügen wird angezeigt.

   2. Fügen Sie eine Datenreferenz hinzu, indem Sie einen der folgenden Schritte ausführen:
      • Nach Element suchen: Durchsuchen Sie eine Elementliste im aktuellen Portal, und nehmen Sie eine Auswahl vor.

        Tipp:

        Sie können die Ergebnisse optimieren, indem Sie bei der Suche Filter und Tags anwenden.

      • Element-ID manuell eingeben: Wählen Sie die Umgebung aus, in der sich die Datenreferenz befindet, und geben Sie die Element-ID und den Referenznamen in den Textfeldern Element-ID und Referenzname an. Wenn Sie Andere ausgewählt haben, geben Sie in das Textfeld Portal-URL die URL der ArcGIS-Organisation ein, die die Datenreferenz enthält.

        Das Element wird automatisch von Workflow Manager validiert, und der Datenreferenztyp wird in der Leiste Typ festgelegt.

        Wenn die Datenreferenz nicht validiert werden kann, müssen Sie die Element-ID einer gültigen Datenreferenz angeben, die dem festgelegten Datenreferenztyp entspricht.

   3. Klicken Sie auf OK, um die Datenreferenzen zu speichern, oder auf Abbrechen, um den Vorgang zu beenden.
6. Klicken Sie auf die Umschaltfläche Beziehung, um die Survey-Beziehung als Eins-zu-Eins-(1-1-)- oder Eins-zu-Viele-(1-M-)Beziehung festzulegen.
   • 1-1: Es kann nur ein Survey mit einem Auftrag verknüpft werden.
   • 1-M: Mit einem Auftrag können mehrere Surveys verknüpft werden.
7. 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.

8. Stellen Sie optional sicher, dass das Kontrollkästchen Survey in erweiterter Ansicht öffnen aktiviert ist, um die Survey-Ansicht zu erweitern, wenn der Schritt ausgeführt wird.

   Diese Option ist standardmäßig aktiviert.

9. Klicken Sie auf die Registerkarte Options.
10. 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

11. 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.

12. Klicken Sie ggf. auf die Registerkarte Style, um Form und Farbe für den Schritt zu ändern.
13. 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.