Mit dem Schritt "Auftragsversion festlegen" können Sie eine vorhandene Verzweigungsversion als aktuelle Version des Auftrags festlegen. Wenn der Schritt ausgeführt wird, wird die Auftragsversion durch die angegebene Version überschrieben. Wenn die angegebene Version nicht vorhanden ist oder der Benutzer, der den Schritt ausführt, keinen Zugriff auf diese Version hat, schlägt der Schritt fehl. Stattdessen wird auf der Auftragskachel eine Fehlermeldung angezeigt.
Wenn Sie Workflow verwaltet für den Schritt aktivieren, dann verwaltet ArcGIS Workflow Manager die Verzweigungsversion, und die Schritte Anspruch auf Version und Bereinigen können verwendet werden, um die Version zu ändern oder zu löschen.
Konfigurieren des Schrittes
Um den Schritt zu konfigurieren, gehen Sie wie folgt vor:
- Erstellen oder bearbeiten Sie ein Workflow-Diagramm, um das Fenster Schrittbibliothek aufzurufen.
- Ziehen Sie Auftragsversion festlegen aus dem Fenster Schrittbibliothek auf den Verbindungspfeil eines Schrittes auf der Workflow-Zeichenfläche.
Das Fenster Schrittdetails wird angezeigt.
- Geben Sie in das Textfeld Schrittname einen Namen für den Schritt ein.
- Wählen Sie im Abschnitt Datenquelle eine Option aus:
Quelle auswählen: Wählen Sie im Dropdown-Menü die Feature-Service-Datenreferenz aus, die die festzulegende Version enthält.
Wenn mit dem Workflow-Diagramm keine Feature-Service-Datenreferenz verknüpft ist, klicken Sie im Dropdown-Menü auf Datenreferenz hinzufügen, und 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: Geben Sie die Element-ID und den Referenznamen in den Textfeldern Element-ID und Referenzname ein.
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.
- Nach Element suchen: Durchsuchen Sie eine Elementliste im aktuellen Portal, und nehmen Sie eine Auswahl vor.
Arcade-Ausdruck: Geben Sie einen ArcGIS Arcade-Ausdruck an, der die Element-ID der Datenreferenz zurückgibt, um die Datenreferenz mit der festzulegenden Version dynamisch zu bestimmen.
Der Arcade-Ausdruck muss die Datenreferenz-ID zurückgeben, nicht den Datenreferenznamen.
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.
Hinweis:
Für diesen Schritt kann nur eine Datenreferenz verwendet werden. Um die Auftragsversion für mehr als eine Datenreferenz festzulegen, konfigurieren Sie entsprechend mehrmals den Schritt "Auftragsversion festlegen" im Workflow-Diagramm.
- Wählen Sie im Abschnitt Version eine Option aus:
- Versions-GUID: Geben Sie die GUID der Verzweigungsversion an. Diese Methode wird für eine bessere Performance empfohlen.
- Versionsname: Geben Sie den vollständig qualifizierten Versionsnamen der Verzweigungsversion an – zum Beispiel WORKFLOWUSER.JOB_44.
- Zusätzlich können Sie das Kontrollkästchen Workflow verwaltet aktivieren, damit Workflow Manager die Verzweigungsversion verwalten kann.
Dadurch werden die Schritte Anspruch auf Version und Bereinigen zum Ändern oder Löschen der Version aktiviert.
- Klicken Sie auf die Registerkarte Options.
- 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 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 Rolle "ArcGIS Workflow Manager Server Advanced" verfügen.
- Nach einem Zeitplan ausführen: Der Schritt wird nach einem festgelegten Zeitplan ausgeführt.
- Manuell: Der Schritt wird manuell ausgeführt.
- 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 Schritthilfe Text und Arcade-Ausdrücke enthält, muss der Text wie folgt formatiert werden:
'For further assistance, please contact' + JobCreator($Job) + '.' - 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.
- Klicken Sie ggf. auf die Registerkarte Style, um Form und Farbe für den Schritt zu ändern.
- 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 sind die Ausgabewerte des Schrittes aufgeführt:
| Ausgabe | Beschreibung |
|---|---|
| Version | Gibt ein Array der festgelegten Version zurück. |
dataSource | Gibt ein Array der Datenreferenz-URLs zurück, für die erfolgreich Versionen festgelegt wurden. |