Hinzufügen und Konfigurieren des Schrittes "Field Maps-Task erstellen"

Mit der Workflow Manager-Lizenz verfügbar.

Mit dem Schritt "Field Maps-Task erstellen" in ArcGIS Workflow Manager können Sie einen Task erstellen, um die mit einem Auftrag verbundenen Außendienstarbeiten mit ArcGIS Field Maps zu verwalten und zu verfolgen. Die Task-Funktionen in Field Maps helfen Ihnen bei der effizienten Verwaltung und Verfolgung der Arbeiten im Außendienst. In einem Task-fähigen Feature-Service wird jedes Feature als Task-Element in einer interaktiven Liste in der mobilen Field Maps-App angezeigt.

Wenn der Schritt "Field Maps-Task erstellen" ausgeführt wird, erstellt Workflow Manager automatisch einen neuen Task im Task-fähigen Feature-Service. Dieser Schritt aktualisiert außerdem automatisch die Task-Eigenschaften mit den im Bereich Schrittdetails angegebenen Werten.

Für die Ausführung des Schrittes "Field Maps-Task erstellen" muss der Auftrag eine definierte Position aufweisen. Jeder Task verfügt über eine Punkt-, Polylinien- oder Polygon-Geometrie, die er von der Auftragsposition übernimmt. Ist die Task-Position ein Punkt und die Auftragsposition eine Polylinie oder ein Polygon, so wird der Schwerpunkt der Auftragsposition als Task-Position verwendet. Wenn es sich bei der Task-Position um eine Polylinie oder ein Polygon handelt, muss die Auftragsposition denselben Geometrietyp aufweisen.

Workflow Manager kann dem Auftrag optional eine Webhook-Abhängigkeit zuweisen, die automatisch aufgehoben wird, sobald der Status der Task die im Bereich Schrittdetails festgelegten Bedingungen erfüllt. Dazu muss im Schritt "Field Maps-Task erstellen" eine Webhook-Verbindung zum Task-fähigen Feature-Service erstellt werden. Dadurch kann Workflow Manager Aktualisierungen zum Task-Status empfangen. Dem Schritt, der auf den Schritt "Field Maps-Task erstellen" folgt, wird automatisch eine Webhook-Abhängigkeit hinzugefügt.

Für die Verwendung von Webhook-Abhängigkeiten im Schritt "Field Maps-Task erstellen" müssen Sie die Organisationserweiterung "ArcGIS Workflow Management" aktivieren.

Tipp:

Die Webhook-Abhängigkeit kann auf der Registerkarte Rückstellungen im Abschnitt Abhängigkeiten angezeigt werden.

Konfigurieren des Schrittes

Führen Sie die folgenden Schritte aus, um den Schritt "Field Maps-Task erstellen" zu konfigurieren:

1. Erstellen oder bearbeiten Sie ein Workflow-Diagramm, um das Fenster Schrittbibliothek aufzurufen.
2. Ziehen Sie Field Maps-Task erstellen 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 einen Feature-Service aus dem Dropdown-Menü Feature-Service aus.
5. Wenn kein Feature-Service mit dem Workflow-Diagramm verknüpft ist, fügen Sie eine Feature-Service-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 Filter und Tags anwenden.

   • Element-ID manuell eingeben: Geben Sie die Element-ID und den Referenznamen in den Textfeldern Element-ID und Referenzname ein. Das Element wird automatisch von Workflow Manager überprüft, und der Datenreferenztyp wird festgelegt.

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

   Weitere Informationen zum Verwalten von Datenreferenzen

6. Klicken Sie auf den Dropdown-Pfeil neben Layer-Name, und wählen Sie den Task-fähigen Layer aus, in dem Sie den Task erstellen möchten.

   Vorsicht:

   • Für die Ausführung des Schrittes "Field Maps-Task erstellen" muss der Auftrag eine definierte Position aufweisen. Wenn es sich bei der Task-Position um eine Polylinie oder ein Polygon handelt, muss die Auftragsposition denselben Geometrietyp aufweisen.
   • Der Feature-Service muss mindestens einen Task-fähigen Layer enthalten, um mit dem Schritt "Field Maps-Task erstellen" konfiguriert werden zu können.
7. Klicken Sie auf den Dropdown-Pfeil Eingabetyp ändern, und wählen Sie einen Eingabetyp für das Kombinationsfeld Task-Typ aus.
   • Auswahl: Wählen Sie aus dem Dropdown-Menü Task-Typ einen Task-Typ aus, der dem Task-Typ entspricht, den Sie erstellen möchten.
   • Arcade: Geben Sie einen ArcGIS Arcade-Ausdruck an, der einen Domänencode eines Task-Typs referenziert, der in Ihrem Task-fähigen Layer konfiguriert ist.
8. Konfigurieren Sie optional eine Task-Eigenschaft für den Schritt, die bei der Erstellung des Tasks aktualisiert wird.
   1. Klicken Sie auf Task-Eigenschaft hinzufügen.
   2. Klicken Sie auf Standardwert anzeigen , um den Standardwert für die Eigenschaft festzulegen.
   3. Wählen Sie eine der folgenden Optionen:
      • Wert: Geben Sie einen statischen Wert ein.
      • Arcade-Ausdruck: Geben Sie einen dynamischen Wert mithilfe eines Arcade-Ausdrucks ein.
   4. Geben Sie einen Standardwert für die Eigenschaft in das Textfeld Wert oder das Textfeld Arcade-Ausdruck ein.
   5. Klicken Sie optional auf Task-Eigenschaft hinzufügen, und wiederholen die Schritte, um weitere Eigenschaften hinzuzufügen.

      Tipp:

      Um eine Task-Eigenschaft zu löschen, bewegen Sie den Mauszeiger darüber und klicken auf Eigenschaft löschen.

   6. Zeigen Sie optional mit der Maus auf eine Eigenschaft, klicken Sie auf Eigenschaft umordnen, und ziehen Sie sie an die gewünschte Position, um die Reihenfolge der Eigenschaften zu ändern.
9. Fügen Sie dem Schritt optional eine Webhook-Abhängigkeit hinzu.

   Lizenz:

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

   1. Aktivieren Sie das Kontrollkästchen Webhook-Abhängigkeit hinzufügen.
   2. Wählen Sie im Dropdown-Menü Webhook-Verbindung eine Webhook-Verbindung aus.

      Hinweis:

      Um eine Webhook-Abhängigkeit hinzufügen zu können, muss mindestens eine Webhook-Verbindung mit dem in Schritt 4 ausgewählten Feature-Service konfiguriert sein.

   3. Legen Sie unter Aufhebungsbedingung die Kriterien fest, die der Task-Status erfüllen muss, damit die Abhängigkeitsrückstellung aufgehoben wird.

      Die Aufhebungsbedingung sollte einem Status entsprechen, der anzeigt, dass die Außendienstarbeiten abgeschlossen sind. Beispiel: Task Status = Completed.

      Tipp:

      Mithilfe der Logikoperatoren AND und OR können mehrere Kombinationen aus Aufhebungsbedingungen verwaltet werden. Wenn beispielsweise zwei Aufhebungsbedingungen konfiguriert sind und der Logikoperator OR verwendet wird, wird die Abhängigkeitsrückstellung aufgehoben, sobald der Task-Status einem der beiden Werte entspricht. Wenn der Logikoperator AND verwendet wird, wird die Abhängigkeitsrückstellung erst aufgehoben, wenn der Task-Status beiden Werten entspricht.

   4. Klicken Sie auf Aufhebungsbedingung hinzufügen, um weitere Aufhebungsbedingungen hinzuzufügen.

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 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 ist fehlgeschlagen.

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 sind die Ausgabewerte des Schrittes aufgeführt:

Ausgabe	Beschreibung
taskObjectId	Gibt die Objekt-ID des Tasks zurück, der im Schritt "Field Maps-Task erstellen" erstellt wurde
taskType	Gibt den codierten Wert für den Task-Typ für den Task zurück, er im Schritt "Field Maps-Task erstellen" erstellt wurde
taskGlobalId	Gibt die Global-ID des Tasks zurück, der im Schritt "Field Maps-Task erstellen" erstellt wurde