Automatisieren von Field Maps—ArcGIS Field Maps

Sie können ArcGIS Field Maps automatisieren, um die Vorbereitung von Karten und ihre Bereitstellung vor Ort zu optimieren. Mithilfe von Webhooks und Skripterstellung können Sie eine Vielzahl von Aufgaben automatisieren, z. B. das Kopieren eines Formulars von einer Karte in eine andere oder die automatische Generierung einer E-Mail-Benachrichtigung, wenn ein Objekt inspiziert wird. Nachfolgend finden Sie zwei Möglichkeiten zur Automatisierung von Aufgaben für Field Maps:

Einrichten eines Webhooks in Make (ehemals Integromat): Erhalten Sie automatisch und nahezu in Echtzeit Benachrichtigungen, wenn Außendienstmitarbeiter Features im Außendienst erstellen, bearbeiten oder löschen.
Verwenden von ArcGIS API for Python: Verwenden Sie Python-Skripte und Notebooks, um Karten zu konfigurieren und bereitzustellen sowie die in Field Maps erfassten Daten zu verwalten und zu analysieren.

Einrichten eines Webhooks in Make

Mit einem Webhook kann eine Anwendung für andere Anwendungen ereignisgesteuerte Informationen bereitstellen. Die häufigsten Verwendungsmöglichkeiten von Webhooks sind: Senden von Benachrichtigungen per E-Mail oder SMS, Veröffentlichen von Nachrichten in sozialen Medien, automatisches Schreiben von Datensätzen in eine Tabelle und Aktualisieren von Enterprise-Datenbanken. Field Maps unterstützt Webhooks über Make (ehemals Integromat), einem Workflow-Automatisierungsservice eines Drittanbieters. Make verfügt über eine integrierte Field Maps-App, mit der Sie Field Maps in einen Webhook-Workflow integrieren können. Sie können die Field Maps-App auf folgende Arten integrieren:

Auslösen eines Webhooks: Der Trigger Watch Features sucht nach Features, die in der mobilen Field Maps-App hinzugefügt, bearbeitet oder gelöscht werden.
Durchführen eines API-Anrufs: Die Aktion Make an API Call ermöglicht es Ihnen, API-Anforderungen an ArcGIS-Web-Services zu senden.

Hinweis:

Die Field Maps-App in Make unterstützt nur gehostete Feature-Services und wird derzeit nicht in ArcGIS Enterprise unterstützt.

Hinzufügen der Field Maps-App

Führen Sie die folgenden Schritte aus, um die Field Maps-App einem Webhook in Make hinzuzufügen:

Melden Sie sich unter https://www.make.com/ an.
Falls Sie kein Konto besitzen, können Sie sich kostenlos registrieren.
Klicken Sie auf Create a new scenario.
Suchen Sie nach ArcGIS Field Maps, wählen Sie den Eintrag aus, und klicken Sie auf Continue.
Die ArcGIS Field Maps-App wird als Favorit in Ihrem Szenario angezeigt.
Klicken Sie in der Bildschirmmitte auf die Schaltfläche für das Modul, und wählen Sie ArcGIS Field Maps aus dem Menü aus.
Die ArcGIS Field Maps-App wird hinzugefügt. Sie können die App verwenden, um einen Webhook auszulösen oder einen API-Anruf an ArcGIS-Web-Services auszuführen.

Herstellen einer Verbindung mit Ihrer ArcGIS-Organisation

Richten Sie eine Verbindung zu Ihrer ArcGIS-Organisation ein, wenn Sie die Field Maps-App in Make zum ersten Mal verwenden. Wie Sie eine Verbindung mit Ihrer Organisation herstellen, hängt davon ab, welches Modul Sie verwenden und auf welche Services Sie zugreifen.

Herstellen einer Verbindung zwischen dem Trigger "Watch Features" und Ihrer ArcGIS-Organisation

Führen Sie die folgenden Schritte aus, um den Trigger Watch Features mit Ihrer ArcGIS-Organisation zu verbinden:

Fügen Sie die Field Maps-App zu einem Webhook in Make hinzu.
Wählen Sie den Trigger Watch Features aus.
Klicken Sie unter Webhook auf Add.
Klicken Sie unter Connection auf Add, und nennen Sie die Verbindung ArcGIS.
Klicken Sie zum Herstellen der Verbindung mit ArcGIS Online auf Continue, und melden Sie sich bei Ihrer ArcGIS-Organisation an.

Sie können die von Ihnen erstellten Verbindungen auf der Registerkarte Connections in Make anzeigen und bearbeiten. Wenn Sie eine Verbindung zu mehreren Webservices in ArcGIS herstellen möchten, müssen Sie möglicherweise mehrere Verbindungen erstellen. Wenn Sie zum Beispiel ein "Make an API Call"-Modul für die Abfrage eines Feature-Layers verwenden, und ein anderes "Make an API Call"-Modul verwenden, um auf die Freigabe-API zuzugreifen, benötigen Sie jeweils eine eigene Verbindung zu jedem Service.

Hinweis:

Wenn Sie eine Verbindung 90 Tage lang nicht nutzen, läuft das Aktualisierungstoken ab, und Sie müssen erneut eine Verbindung mit Ihrer ArcGIS-Organisation herstellen. Wenn der Wert maxTokenExpirationMinutes für Ihre Organisation konfiguriert ist und weniger als 90 Tage entspricht, läuft das Aktualisierungstoken basierend auf diesem Wert ab.

Herstellen einer Verbindung zwischen der Aktion "Make an API Call" und Ihrer ArcGIS-Organisation

Führen Sie die folgenden Schritte aus, um eine Verbindung zwischen der Aktion Make an API Call und Ihrer ArcGIS-Organisation herzustellen:

Fügen Sie die Field Maps-App zu einem Webhook in Make hinzu.
Wählen Sie die Aktion Make an API Call aus.
Klicken Sie unter Connection auf Add, und geben Sie folgende Informationen an:
1. Connection name: Geben Sie einen Namen für die Verbindung an, z. B. "ArcGIS".
  Hinweis:
  Wenn Sie auf die Freigabe-API zugreifen, klicken Sie auf Continue, um sich bei Ihrer ArcGIS-Organisation anzumelden, anstatt die folgenden Teilschritte auszuführen.
2. Subdomain: Geben Sie die Services an, mit denen eine Verbindung hergestellt werden soll. Wenn Sie zum Beispiel eine Verbindung zu Feature-Services herstellen möchten, geben Sie Services ein.
  Hinweis:
  Wenn Sie eine Verbindung mit Feature-Services herstellen, ermitteln Sie auf der Elementseite Ihres Feature-Layers die zu verwendende Subdomain. Unter URL beginnt der angezeigte Link mit https://<services>.arcgis.com. Verwenden Sie den Text in <services> als Subdomain, um das Modul mit Feature-Services zu verbinden.
3. ArcGIS Online-URL: Klicken Sie auf Show advanced settings, und geben Sie die URL zu Ihrer ArcGIS Organisation an.
  Klicken Sie zum Herstellen der Verbindung mit ArcGIS Online auf Continue, und melden Sie sich bei Ihrer ArcGIS-Organisation an.

Hinweis:

Auslösen eines Webhooks mit der Field Maps-App

Webhooks können eingerichtet und aktiviert werden, wenn ein Feature in Field Maps oder anderen Anwendungen, wie z. B. Map Viewer, erstellt, aktualisiert oder gelöscht wird. Wenn zum Beispiel ein neues Feature in Field Maps erfasst wird, kann ein Webhook eine andere Aktion auslösen, wie z. B. das Senden einer E-Mail-Benachrichtigung. Führen Sie die folgenden Schritte in Make aus, um einen Webhook zu erstellen, der jedes Mal eine E-Mail-Benachrichtigung sendet, wenn ein Feature in der mobilen Field Maps-App erstellt, aktualisiert oder gelöscht wird:

Hinweis:

Ein Lernprogramm mit Schritt-für-Schritt-Anweisungen finden Sie im Blogbeitrag Automate email notifications for field updates und im Video Automate Email Notifications using Make.

Fügen Sie die Field Maps-App zu einem Webhook in Make hinzu.
Wählen Sie das Trigger-Modul Watch Features aus.
Dieses Modul führt das Szenario jedes Mal aus, wenn ein Feature erstellt, aktualisiert oder gelöscht wird.
Die Farbe des Symbols für das Szenario wird geändert, und es wird ein Fenster angezeigt, das Sie bei der Konfiguration des Field Maps-Moduls unterstützt.
Klicken Sie auf Add, und geben Sie einen Namen für den Webhook an.
Der Name muss in dem Projekt oder in der Karte, in dem bzw. der der Webhook verwendet werden soll, eindeutig sein.
Richten Sie eine Verbindung zu Ihrer ArcGIS-Organisation ein, wenn Sie dieses Modul in Make zum ersten Mal verwenden.
Hinweis:
Wenn Sie eine Verbindung für das "Make an API Call"-Modul erstellt haben, können Sie diese Verbindung für das "Watch Features"-Modul wiederverwenden.
Wählen Sie unter Feature-Layer einen bearbeitbaren Feature-Layer aus Ihrer ArcGIS-Organisation aus, mit dem Sie eine Verbindung herstellen möchten.
Wählen Sie eines oder mehrere der folgenden Trigger-Ereignisse aus, die der Webhook berücksichtigen soll:
- Features Created: Das Szenario wird ausgelöst, wenn ein Feature erstellt wird.
- Features Updated: Das Szenario wird ausgelöst, wenn ein Feature aktualisiert wird.
- Features Deleted: Das Szenario wird ausgelöst, wenn ein Feature gelöscht wird.
Klicken Sie auf Speichern.
Klicken Sie auf OK.
Das Field Maps-Modul wird konfiguriert.
Klicken Sie im Abschnitt Tools auf Flow Control.
Wählen Sie in der Liste die Option Iterator aus.
Das Iterator-Modul wird automatisch mit dem Field Maps-Modul verbunden. Dadurch kann der Webhook ein Array von Features durchlaufen, wenn mehrere Features gleichzeitig zurückgegeben werden.
Wählen Sie das Iterator-Modul aus, und klicken Sie auf das Textfeld Array.
Suchen Sie im Dropdown-Menü unter ArcGIS Field Maps - Watch Feature Service eines der folgenden Arrays, und wählen Sie es aus:
- Adds []: Für Features, die erstellt werden
- Updates []: Für Features, die aktualisiert werden
- Delete IDs []: Für Features, die gelöscht werden
Klicken Sie auf OK.
Klicken Sie neben dem Iterator-Modul auf die Schaltfläche Add another module.
Suchen Sie nach einem zu verwendenden E-Mail-Dienst, z. B. dem von Microsoft 365, und wählen Sie die App aus.
Wählen Sie die Aktion Create and Send a Message aus.
Wenn Sie das Modul in Make zum ersten Mal verwenden, klicken Sie auf Add, um eine Verbindung zu Ihrem E-Mail-Konto einzurichten. Wählen Sie einen Verbindungstyp aus, und melden Sie sich bei Ihrem Konto an.
Dies müssen Sie nur einmal tun. Make speichert die Verbindung für die künftige Verwendung.
Fügen Sie der E-Mail einen Betreff (Subject) und einen Text (Body Content) hinzu.
Über Mapping können Sie Attribute aus Ihrem Layer zur Formatierung der Textfelder einbeziehen. Fügen Sie bei Verwendung von Mapping die Layer-Attribute aus dem Iterator-Modul hinzu.
Fügen Sie die E-Mail-Adresse eines Empfängers hinzu.
An diese Adresse werden E-Mails gesendet, die durch bestimmte Aktionen ausgelöst werden.
Klicken Sie auf OK.
Klicken Sie auf Save, um das Szenario zu speichern.
Klicken Sie optional auf Run once, um den Webhook zu testen. Nachdem Sie auf Run once geklickt haben, öffnen Sie Field Maps, und erfassen, aktualisieren oder löschen Sie ein Feature. Vergewissern Sie sich, dass der Empfänger die E-Mail erhält.
Verwenden Sie die Umschaltfläche Scheduling, um das Szenario zu aktivieren. Legen Sie den Zeitplan auf Immediately fest, um sicherzustellen, dass das Szenario bei jeder Aktualisierung eines Features ausgeführt wird.

Hinweis:

Informationen zur Unterstützung unter Make finden Sie in der Dokumentation zu Make.

Durchführen eines API-Anrufs mit der Field Maps-App

Die Field Maps-App kann verwendet werden, um API-Anforderungen an ArcGIS-Web-Services zu senden. Wenn ein Benutzer beispielsweise ein neues Feature in Field Maps erfasst, können Sie das Make an API Call-Modul verwenden, um die E-Mail-Adresse dieses Benutzers abzufragen und ihm eine E-Mail zu senden. Sie können das Modul auch verwenden, um einen Feature-Layer abzufragen und Features wie eine Workforce-Zuweisung zu erstellen. Im Folgenden finden Sie Beispiele dafür, wie Sie die Field Maps-App für API-Anforderungen verwenden können:

Senden einer Anforderung an die Freigabe-API

Mit der Freigabe-API können Sie Informationen über Benutzer, Gruppen und Inhalte in einer Organisation anfordern. Sie können damit Benutzerinformationen abrufen, Karten durchsuchen, Inhalte anzeigen und vieles mehr. Sie können die Field Maps-App in einem Webhook verwenden, um Informationen von der Freigabe-API abzurufen. Um beispielsweise eine E-Mail an einen Benutzer zu senden, der gerade eine Inspektion abgeschlossen hat, können Sie über die Field Maps-App dessen E-Mail-Adresse abrufen. Führen Sie die folgenden Schritte aus, um die Field Maps-App so zu konfigurieren, dass sie die Informationen eines Benutzers von der Freigabe-API abruft:

Fügen Sie die Field Maps-App zu einem Webhook in Make hinzu.
Wählen Sie das Aktionsmodul Make an API Call aus.
Die Farbe des Symbols für das Szenario wird geändert, und es wird ein Fenster angezeigt, das Sie bei der Konfiguration des Field Maps-Moduls unterstützt.
Richten Sie eine Verbindung zu Ihrer ArcGIS-Organisation ein, wenn Sie dieses Modul in Make zum ersten Mal verwenden.
Hinweis:
Wenn Sie eine Verbindung für das "Watch Features"-Modul erstellt haben, können Sie diese Verbindung wiederverwenden, um eine Verbindung mit der Freigabe-API im "Make an API Call"-Modul herzustellen.
Geben Sie unter URL den Pfad zur Freigabe-API an.
Verwenden Sie in diesem Beispiel den folgenden Pfad, um auf die Informationen eines Benutzers zuzugreifen:
```
/sharing/rest/community/<username>
```
Weitere Informationen finden Sie unter Introduction to the Sharing API.
Wählen Sie unter Method die Option Get aus.
Klicken Sie unter Query String auf Add item.
Geben Sie die folgenden Informationen an:
1. Key: f
2. Value: json
Klicken Sie auf OK.
Klicken Sie auf Save, um das Szenario zu speichern.

Wenn es ausgelöst wird, ruft das Field Maps-Modul die Informationen des Benutzers von der Freigabe-API ab.

Hinweis:

Informationen zur Unterstützung unter Make finden Sie in der Dokumentation zu Make.

Senden einer Anforderung zur Abfrage eines Feature-Layers

Sie können eine API-Anforderung stellen, um einen Feature-Layer abzufragen. Sie möchten zum Beispiel eine Zusammenfassung am Ende des Tages per E-Mail erhalten. Dazu können Sie die Field Maps-App so festlegen, dass die Statistiken für die Inspektionen eines Tages abgefragt und in eine E-Mail eingefügt werden. Führen Sie die folgenden Schritte durch, um die Field Maps-App für die Abfrage eines Feature-Layers zu konfigurieren:

Fügen Sie die Field Maps-App zu einem Webhook in Make hinzu.
Wählen Sie das Aktionsmodul Make an API Call aus.
Die Farbe des Symbols für das Szenario wird geändert, und es wird ein Fenster angezeigt, das Sie bei der Konfiguration des Field Maps-Moduls unterstützt.
Richten Sie eine Verbindung zu Ihrer ArcGIS-Organisation ein, wenn Sie dieses Modul in Make zum ersten Mal verwenden.
Geben Sie unter URL den Pfad zu dem Feature-Service an, den Sie abfragen möchten:
```
/<org-id>/arcgis/rest/services/<layer-name>/FeatureServer/<layer-id>/query
```
Weitere Informationen finden Sie unter Abfragen (Feature-Service/-Layer).
Wählen Sie unter Method die Option Get aus.
Fügen Sie die Elemente für die Abfragezeichenfolge hinzu.
1. Klicken Sie unter Query String auf Add item, und geben Sie die folgenden Informationen an:
  1. Key: f
  2. Value: json
2. Klicken Sie auf Hinzufügen.
3. Klicken Sie auf Add item, und geben Sie die folgenden Informationen an:
  1. Key: where
  2. Value: 1=1
4. Klicken Sie auf Hinzufügen.
5. Klicken Sie auf Add item, und geben Sie die folgenden Informationen an:
  1. Key: outFields
  2. Value: *
6. Klicken Sie auf Hinzufügen.
Klicken Sie auf OK.
Klicken Sie auf Save, um das Szenario zu speichern.

Wenn es ausgelöst wird, fragt das Field Maps-Modul den Feature-Layer anhand der von Ihnen angegebenen Parameter ab.

Hinweis:

Informationen zur Unterstützung unter Make finden Sie in der Dokumentation zu Make.

Senden einer Anforderung zum Erstellen eines Features

Sie können eine API-Anforderung stellen, um ein Feature zu erstellen. Wenn beispielsweise eine Hydranteninspektion in Field Maps abgeschlossen wird, kann dies die Erstellung eines Zuweisungsfeatures in ArcGIS Workforce auslösen. Führen Sie die folgenden Schritte durch, um die Field Maps-App so zu konfigurieren, dass ein Feature zu einem Layer hinzugefügt wird:

Fügen Sie die Field Maps-App zu einem Webhook in Make hinzu.
Wählen Sie das Aktionsmodul Make an API Call aus.
Die Farbe des Symbols für das Szenario wird geändert, und es wird ein Fenster angezeigt, das Sie bei der Konfiguration des Field Maps-Moduls unterstützt.
Richten Sie eine Verbindung zu Ihrer ArcGIS-Organisation ein, wenn Sie dieses Modul in Make zum ersten Mal verwenden.
Geben Sie unter URL den Pfad zu dem Feature-Service an, dem Sie Features hinzufügen möchten:
```
/<org-id>/arcgis/rest/services/<layer-name>/FeatureServer/<layer-id>/applyEdits
```
Weitere Informationen finden Sie unter Änderungen übernehmen (Feature-Service/-Layer).
Wählen Sie unter Method die Option Post aus.
Klicken Sie unter Headers auf Edit.
Ändern Sie den Eintrag für Value in application/x-www-form-urlencoded.
Klicken Sie auf Speichern.
Geben Sie unter Body f=json&adds=[<json-object>] ein.
Der Wert für <json-object> muss eine JSON-Zeichenfolge sein, die ein Feature darstellt. Die genaue Spezifikation, die zu verwenden ist, hängt von Ihrem Layer ab. Weitere Informationen finden Sie unter Feature-Objekt.
Klicken Sie auf OK.
Klicken Sie auf Save, um das Szenario zu speichern.

Wenn es ausgelöst wird, fügt das Field Maps-Modul dem Layer ein Feature hinzu.

Hinweis:

Informationen zur Unterstützung unter Make finden Sie in der Dokumentation zu Make.

Verwenden von ArcGIS API for Python

Verwenden Sie ArcGIS API for Python, um Aufgaben für Field Maps zu automatisieren und Skripte für sie zu erstellen. Mit dem Modul "Forms" können Sie Formulare für die Datenerfassung erstellen und bearbeiten, und Sie können auf das Field Maps-Skript-Repository unter GitHub zugreifen, um zum Beispiel Skripte und Notebooks zu verwenden. Mit den Skripten und Notebooks können Sie Aufgaben automatisieren, z. B. das Kopieren von Formularen von einer Karte in eine andere und das Herunterladen von Anlagen aus dem Feature-Layer.

Hinweis:

Für die Verwendung des "Forms"-Moduls ist ArcGIS API for Python 1.9.0 oder höher erforderlich.

Feedback zu diesem Thema?