Integrieren in andere Apps—ArcGIS QuickCapture

ArcGIS QuickCapture kann über einen QuickCapture oder ein benutzerdefiniertes URL-Schema in andere Apps integriert werden. Von beiden Methoden werden dieselben Parameter unterstützt, jedoch sind plattformabhängige Unterschiede zu beachten.

QuickCapture-Links beginnen mit https://quickcapture.arcgis.app und funktionieren nur unter iOS und Android. QuickCapture-Links entsprechen den Anforderungen, die vom App Store und von Google Play festgelegt werden. Sie ermöglichen die Verknüpfung mit weiteren Apps und unterstützen verkürzte Links, die einfacher freigegeben werden können. Mit einem QuickCapture-Link können Sie u. a. die ArcGIS-Apps ArcGIS Survey123, ArcGIS Field Maps, ArcGIS Workforce und ArcGIS Navigator öffnen.

Links mit einem benutzerdefinierten URL-Schema beginnen mit arcgis-quickcapture:// und funktionieren unter Windows, Android und mit einer ausgewählte Gruppe von Apps unter iOS. Zu den ArcGIS-Apps, die mit einem URL-Schema aus QuickCapture geöffnet werden können, zählen ArcGIS Survey123 und ArcGIS Collector unter Windows. Diese Links können nicht verkürzt werden und sind unter Android nur schwierig zu öffnen. Sie sollten in Erwägung ziehen, Links mit einem benutzerdefinierten URL-Schema in Form von Hyperlinks darzustellen. Hier ein Beispiel:

<a href="arcgis-quickcapture://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open project</a>

QuickCapture-Links sind die bevorzugte Methode für die Verbindung von Apps und benutzerdefinierte URL-Schemas die bevorzugte Methode für die Freigabe von Projekten.

Damit Sie einen Link verwenden können, der Parameter zum Starten eines Projekts in der mobilen App enthält, sollte die App bereits auf dem Gerät installiert sein.

Parameter für die mobile App

Mit den folgenden Parametern können Sie das Öffnen der mobilen App anpassen:


Parameter	Beschreibung	Beispiel	Typ
action	Gibt an, wie ein Projekt geöffnet wird. Unterstützte Werte sind press (zum Drücken einer bestimmten Taste) und field (zum Ausfüllen eines Feldes für einen Tastendruck). Tasten werden mittels einer GUID bestimmt, die unten auf der Registerkarte Aussehen für die Schaltflächen in QuickCapture Designer angezeigt wird.	Erfassen eines Punkt-Features oder Starten bzw. Stoppen der Erfassung eines Linien- oder Polygon-Features: action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4 Erfassen eines Features und Ausfüllen des Feldes für den Durchmesser dieses Features mit dem Wert 20: action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4&field:diameter=20	Zeichenfolge
callback	Gibt die URL an, die beim Drücken einer Taste zurückgegeben werden soll.	callback=https://survey123.arcgis.app	URL
center	Zentriert die Karte auf einen bekannten Breitengrad, Längengrad und optional eine Höhe.	center=37.8199,-122.4783,20	Zeichenfolge
externalBrowserSignIn	Gibt an, dass ein externer Browser zum Anmelden verwendet werden soll.	externalBrowserSignIn=true	Boolesch
itemID	Gibt das zu öffnende Projekt an.	itemID=aabda4a5e36d42c2bcf1c479fe01e5e3	UUID
portalUrl	Gibt die URL zu dem Portal an, in dem das QuickCapture-Projektelement gehostet wird.	portalUrl=https://myorg.arcgis.com	Zeichenfolge
userInput	Gibt ID und Wert an, mit denen die Benutzereingabevariable für das Projekt belegt werden soll.	userInput:001=Alice	Zeichenfolge

Erstellen eines Links zu QuickCapture aus einem Desktop-Webbrowser

Sie können einen Link zum Öffnen der mobilen QuickCapture-App erstellen, den Sie in eine andere App einbetten können. Denselben Link können Sie auch zu Testzwecken in einem Webbrowser eingeben. In den folgenden Schritten wird beschrieben, wie ein benutzerdefiniertes URL-Schema erstellt und in einem Desktop-Webbrowser verwendet wird:

Hinweis:

Nach der Erstellung des Links können Sie arcgis-quickcapture:// durch https://quickcapture.arcgis.app ersetzen, sodass der Link als QuickCapture-Link unter iOS oder Android verwendet werden kann.

Geben Sie arcgis-quickcapture:// in Ihrem Browser ein.
Die mobile QuickCapture-App wird geöffnet (oder Sie werden dazu aufgefordert, sie zu öffnen).
Hinweis:
Um ein Projekt aus einem angegebenen Portal zu starten und herunterzuladen, müssen Sie den Parameter für die Portal-URL angeben, z. B. arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor (wobei host, domain und webadaptor durch die Informationen Ihres Portals ersetzt werden). Um einen externen Browser für die Anmeldung zu verwenden, müssen Sie den Parameter externalBrowserSignIn einbinden und auf "true" festlegen, z. B. arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor&externalBrowserSignIn=true.

Sie können auch eine eindeutige Referenz zu einem Projekt einfügen und der URL hinzufügen. Zunächst müssen Sie die Element-ID des Projekts identifizieren, das Sie öffnen möchten. Dies ist die Zeichenfolge, die ArcGIS Online zur eindeutigen Identifizierung des Projekts verwendet. Sie befindet sich in der URL Ihres Projektelements in ArcGIS Online. Wenn Ihre Projekt-URL beispielsweise https://exampleurl.maps.arcgis.com/home/item.html?id=aabda4a5e36d42c2bcf1c479fe01e5e3 lautet, ist die Projektelement-ID aabda4a5e36d42c2bcf1c479fe01e5e3.

Um das Projekt in die URL einzufügen, die Sie erstellen, fügen Sie ?itemID= und die Projektelement-ID zur URL hinzu.
Die URL sollte in etwa wie folgt aussehen:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3
Wenn Sie die URL testen, wird nun die mobile QuickCapture-App und direkt im Anschluss das Projekt darin geöffnet.
Hinweis:
Sollte sich das Projekt noch nicht auf Ihrem Gerät befinden, wird es heruntergeladen.

Optional können Sie eine vorab festgelegte Projekt-Benutzereingabevariable hinzufügen.

Um etwa eine Projekt-Benutzereingabevariable auszufüllen, geben Sie &userInput: gefolgt von der ID und dem Wert der Benutzereingabe ein, wobei hier das Gleichheitszeichen (=) als Trennzeichen dient.

Hinweis:
Das kaufmännische Und (&) dient als Trennzeichen zwischen den Parametern.
Jede Projekt-Benutzereingabe hat eine eindeutige ID. Wechseln Sie zur Anzeige der ID in die JSON-Ansicht des Projekts, und suchen Sie nach userInputs. Die einzelnen Projekt-Benutzereingaben werden als Eigenschaften-Array aufgeführt, wobei die erste Eigenschaft die ID ist.
Die URL sollte in etwa wie folgt aussehen:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice
Mit dieser URL werden die mobile QuickCapture-App und das Projekt geöffnet. Der Benutzereingabewert Alice für das Projekt wird in jedem Feld verwendet, das entsprechend konfiguriert wurde. Sie können einem Projekt bis zu drei Benutzereingabewerte für Projekte hinzufügen. Eine URL mit mehr als einem Benutzereingabewert für Projekte sollte in etwa wie folgt aussehen:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice&userInput:002=Zone5

Sie können auch den Inhalt von Feldern über ein Pop-up in einer ArcGIS-Webkarte an QuickCapture übergeben und damit die Integration in alle Esri Apps, die Pop-ups in einer Webkarte nutzen, ermöglichen.

Wählen Sie für einen vorhandenen Layer in Ihrer Webkarte Pop-up konfigurieren aus. Wählen Sie im Dropdown-Menü "Anzeigen" eine benutzerdefinierte Attributanzeige aus, klicken Sie auf Konfigurieren, und fügen Sie einen Link in das Projekt ein.
Wenn Sie die Projekt-Benutzereingabevariable für das Feature, über das der Link gestartet wurde, mit dem Wert des Feldes "observer" füllen möchten, geben Sie &userInput:001={observer} ein. Das kaufmännische Und (&) dient als Trennzeichen zwischen den Parametern, und die geschwungenen Klammern ({}) stehen für einen Feldnamen.
Die URL sollte in etwa wie folgt aussehen:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}.

Erstellen eines Links zu QuickCapture aus einer anderen App

Sie können einen Link erstellen, mit dem in anderen Apps QuickCapture gestartet werden kann, um einen Datensatz zu erfassen. In den folgenden Schritten wird beschrieben, wie ein QuickCapture-Link erstellt und in einem Webkarten-Pop-up verwendet wird. Dieser Link wird in das Pop-up einer Webkarte in Ihrer ArcGIS-Organisation eingegeben. Sie können den Link mit einem Webbrowser auf einem iOS- oder Android-Gerät testen (die Schritte dafür ähneln den oben beschriebenen Schritten).

Wählen Sie für einen vorhandenen Webkarten-Layer, der auf dem Gerät angezeigt werden soll, Pop-up konfigurieren aus.
Wählen Sie im Dropdown-Menü "Anzeigen" eine benutzerdefinierte Attributanzeige aus, klicken Sie auf Konfigurieren, und fügen Sie einen Link in das Projekt ein.
Geben Sie https://quickcapture.arcgis.app als Parameter für die URL und Launch QuickCapture als Link-Text an, und klicken Sie auf OK.
1. Öffnen Sie die Webkarte über einen Browser oder eine ArcGIS-App auf einem mobilen Gerät.
2. Wählen Sie ein Feature aus, und klicken Sie im Pop-up zum Starten von QuickCapture auf den Link QuickCapture starten.
Um das Projekt in die URL einzufügen, die Sie erstellen, fügen Sie ?itemID= und die Projektelement-ID zur URL hinzu.
Die URL sollte in etwa wie folgt aussehen:
```
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3
```
Wenn Sie die URL testen, sollte nun die mobile QuickCapture-App und direkt im Anschluss das Projekt darin geöffnet werden.
Hinweis:
Sollte sich das Projekt noch nicht auf Ihrem Gerät befinden, wird es heruntergeladen.

Optional können Sie eine vorab festgelegte Projekt-Benutzereingabevariable hinzufügen.

Um etwa eine Projekt-Benutzereingabevariable auszufüllen, geben Sie &userInput:id= und den gewünschten Wert ein. Das kaufmännische Und (&) dient als Trennzeichen zwischen den Parametern.
Die URL sollte in etwa wie folgt aussehen:
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice
Mit dieser URL werden die mobile QuickCapture-App und das Projekt geöffnet. Der Benutzereingabewert Area7 für das Projekt wird in jedem Feld verwendet, das entsprechend konfiguriert wurde.

Über eine ArcGIS-App können Sie auch Feldinhalte an eine Projekt-Benutzereingabevariable übergeben.

Wenn Sie die Projekt-Benutzereingabevariable für das Feature, über das der Link gestartet wurde, mit dem Wert des Feldes "observer" füllen möchten, geben Sie &userInput:001={observer} ein. Das kaufmännische Und (&) dient als Trennzeichen zwischen den Parametern, und die geschwungenen Klammern ({}) stehen für einen Feldnamen.
Die URL sollte in etwa wie folgt aussehen:
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}

Herstellen einer Verknüpfung zu anderen Apps aus QuickCapture

Ein QuickCapture-Projekt kann so konfiguriert werden, dass durch Tippen auf eine Schaltfläche eine URL und über die URL eine andere App geöffnet wird. Dadurch erhalten Außendienstmitarbeiter eine nahtlose Bedienoberfläche für die Verwendung von QuickCapture und anderen Anwendungen.

Um von QuickCapture eine Verknüpfung zu einer anderen App herzustellen, müssen Sie ein Projekt konfigurieren, indem Sie eine Link-Schaltfläche hinzufügen und die URL für diese Schaltfläche konfigurieren. Im Designer können Sie die Schaltfläche so konfigurieren, dass sie als dedizierte URL geöffnet wird, z. B. als benutzerdefinierte URL oder als App-Link zum Öffnen einer anderen Esri App. In der mobilen ArcGIS Survey123-App können Sie mit "Durchsuchen" zusätzlich ein Survey-Formular auswählen und die Werte für die Survey-Fragen vordefinieren.

Konfigurieren einer Link-Schaltfläche

Gehen Sie folgendermaßen vor, um eine Schaltfläche zu konfigurieren, über die eine URL zu einem Dashboard geöffnet wird:

Klicken Sie auf die Schaltfläche, und rufen Sie die Registerkarte Link auf.
Klicken Sie auf URL.
Geben Sie https://www.arcgis.com/apps/dashboards/747e7365d1894db4bbadf100f65cf991 als URL ein.

Dadurch wird eine Link-Schaltfläche erstellt. Wenn Sie in der mobilen App darauf klicken, wird das QuickCapture BioBlitz Dashboard geöffnet. Sie können im Text-Editor eine beliebige HTTPS-basierte URL oder ein benutzerdefiniertes URL-Schema einer anderen App eingeben, in der QuickCapture zugelassen wurde.

Hinweis:

Sie können Links zum Starten von Kommunikationsanwendungen wie E-Mail, SMS und Telefon erstellen. Damit erhalten Benutzer im Projekt einen schnellen Zugriff auf Hilfemöglichkeiten. Im folgenden finden Sie Beispiele für Links zu Kommunikations-Apps:

E-Mail: mailto:sample@esri.com?subject=Fix%20the%20pipe&body=We%20really%20need%20to%20fix%20the%20pipe
SMS: sms:0291920995 (unter Android kann auch ein Nachrichtentext einbezogen werden: sms:0291920995?body=We%20really%20need%20to%20fix%20the%20pipe)
Telefon: tel:0291920995

Konfigurieren einer ArcGIS Survey123-Schaltfläche

Gehen Sie folgendermaßen vor, um eine Schaltfläche zu konfigurieren, über die die mobile ArcGIS Survey123-App aufgerufen wird:

Klicken Sie auf die Schaltfläche, und rufen Sie die Registerkarte Link auf.
Klicken Sie auf Mobile Survey123-App.
Wählen Sie einen Survey aus, den Sie mit der Schaltfläche verknüpfen möchten.
Dadurch wird der Parameter itemID im Link Survey123 definiert.
Klicken Sie auf Hinzufügen, um eine Survey-Frage hinzuzufügen und passend dazu einen festen Wert, eine Gerätevariable oder eine Projekt-Benutzereingabe festzulegen.
Dadurch wird der Wert des angegeben Parameters field:fieldname im Link Survey123 definiert. Wiederholen Sie diesen Schritt für alle anderen Survey-Fragen. Wenn Sie eine konfigurierte Survey-Frage entfernen möchten, klicken Sie auf "Löschen". Dadurch wird der Parameter field:fieldname aus dem Link Survey123 entfernt.
Aktivieren Sie optional Position an Survey123 übergeben, um den Parameter center mit Breiten- und Längengradwerten in den Survey123-Link einzubinden.
Enthält der Survey eine Geopunkt-Frage, wird die Karte auf die Position zentriert, die aus QuickCapture übergeben wurde.
Aktivieren Sie gegebenenfalls die Option Zu QuickCapture zurückkehren, wenn Sie den Benutzer nach dem Übermitteln des Survey an QuickCapture weiterleiten möchten.
Dadurch wird der Parameter callback:submit zum Link Survey123 hinzugefügt.

Der Link Survey123 wird im Designer automatisch erstellt.

Die URL sollte in etwa wie folgt aussehen: Das Beispiel enthält einen festen Wert für condition, eine die Gerätevariable für capturetime und einen Projekt-Benutzereingabe für username.

arcgis-survey123://?itemID=2a41c332e24644ee895bbbd9b929773f&field:condition=damaged&field:capturetime=${captureTime}&field:username=${userInput:001}

Alternativ können Sie den Link Survey123 auch manuell mit der Option URL erstellen. Erstellen Sie die URL im Text-Editor manuell, oder fügen Sie über die Werkzeugleiste einen vordefinierten Wert für die URL-Parameter hinzu. Sie können der URL einen festen Wert, eine Gerätevariable oder eine Projekt-Benutzereingabevariable hinzufügen. Die Variablen in der erstellten URL stehen in geschwungenen Klammern ({}), wobei der eigentliche Wert beim Klicken auf die Schaltfläche automatisch von der mobilen App in die Klammern eingetragen wird.

Wenn Sie zwischen den Optionen URL und Mobile Survey123-App wechseln, wird die vorhandene URL verworfen.

Weitere Informationen über die von Survey123 unterstützten Parameter finden Sie unter Integrieren von Survey123 in andere Apps.

Hinweis:

Bei der Zuweisung von Variablen zu Survey-Fragen muss der Feldtyp übereinstimmen.

Auch wenn nicht codierte URL-Parameter in einigen Umgebungen verwendet werden können, wird bei manueller URL-Erstellung eine Codierung der URL-Parameter empfohlen. Die Codierung ersetzt ungültige Zeichen durch das Prozentzeichen (%) gefolgt vom jeweils zugehörigen hexadezimalen Äquivalent. Um beispielsweise den Rückrufparameter einzubinden, sollte die URL folgendermaßen aussehen:

arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback:submit=https%3A%2F%2Fquickcapture.arcgis.app%253FitemID%99c18758066b42e1a0f4027603070b34

Feedback zu diesem Thema?