Skip To Content

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.

When the step is run, the following actions can be performed:

  • Der konfigurierte Survey kann übermittelt, angezeigt und bearbeitet werden.
  • The step can be cancelled by clicking Cancel.
  • The step can be finished by clicking Proceed.

Konfigurieren des Schrittes

To configure the step, do the following:

  1. Create or edit a workflow diagram to access the Step Library panel.
  2. Ziehen Sie Survey123 aus dem Fenster Schrittbibliothek auf den Verbindungspfeil eines Schrittes auf der Workflow-Zeichenfläche.

    The Step Details panel appears.

  3. Provide a name for the step in the Step Name text box.
  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 Delete Survey 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. Click the Options tab.
  13. Configure Step Options as necessary.
    • Manual—Run the step manually.
      • Optional—Allow the step to be finished without being run.
    • Automatic—Run the step as soon as it becomes active.
      Hinweis:

      If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.

    • Run on a Schedule—Run the step according to a schedule you set.

      Learn more about scheduling options

  14. Optionally, provide help text for the step in the Step Help text box.

    You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:

    'For further assistance, please contact ' + jobCreator($job) + '.'
  15. Optionally, click the Style tab to change the shape and color of the step.
  16. Optionally, click the About tab and provide a description for the step in the Step Description text box.
    Hinweis:

    The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.

Return value

When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:

Return valuesDescription

S000001

The step completed successfully.

F000001

The step failed to complete successfully.

Ausgabewert

When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table shows the step's output value:

AusgabeBeschreibungSyntax für ArcGIS Arcade-Ausdruck

<GlobalID>

Gibt die globalid des Surveys zurück, der zuletzt erstellt, angezeigt oder bearbeitet wurde.

jobOutputValue($job, '<step_id>')

Verwandte Themen