Available for an ArcGIS organization licensed with the Indoors extension.
ArcGIS Indoors unterstützt Startaktionen für die Apps von Drittanbietern direkt aus dem Informationsfenster in Indoor Viewer. Diese Startaktionen ermöglichen Indoors-Organisationen die einfache Einbindung von Informationen aus anderen Business-Systemen. Zum Öffnen einer Webseite oder einer nativen mobilen App kann eine Startaktion konfiguriert werden. Dies erleichtert es, Ereignisse oder Anforderungen zu einem ausgewählten Element in Indoors zu senden. Benutzer können über eine Webseite bzw. eine mobile App Informationen zu einem in Indoors ausgewählten Element anzeigen und automatisch Formularfelder mit aktualisierten Informationen ausfüllen.
URL-Syntax
Startaktionen werden durch URLs aktiviert. Die Syntax muss den allgemeinen URL-Konventionen entsprechen. So müssen beispielsweise Sonderzeichen in den Argumenten URL-codiert sein, und die Argument- oder Wertepaare müssen gemäß Standard-URL-Konventionen getrennt sein.
Für Indoors müssen die Werte in geschweiften Klammern eingeschlossen sein und die folgende Syntax aufweisen:
?arg={Layer.Attribute}&arg={Attribute}
Hinweis:
Der Layer ist optional. Wird dieser nicht angegeben, wird standardmäßig das aktuell in Indoors ausgewählte Element verwendet. In vielen Anwendungsfällen müssen Attribute von einem anderen Layer in der Karte oder Szene übergeben werden. Dies wird mit dem Layer-Operator unterstützt. Bei Argumenten und Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Beispiele:
Einzelner Wert
?Name={KNOWNAS}&building={facility_name}&space={Units.Name}
Mehrere Werte
?center={shape.y},{shape.x}
Wert aus einer anderen Feature-Class
&site={FACILITIES.SITE_ID}
Übergeben des Wertes an ein spezifisches Feld
&field:room={units.name}
Unterstützte Argument- und Werteformate
Die URL der Startaktion kann das Übergeben eines Wertes mit einem generischen Argument (field={Units.UNIT_ID}) unterstützen oder aber mit dem Wert auf ein spezifisches Feld im Survey123-Formular verweisen (field:room={Units.Name}).
Zudem können mehrere Argumente zusammen aufgeführt werden, und dazwischen kann Text eingegeben werden.
Beispiel
https://<MySurveyURL>?Name={knownas}&office=office%3A%20{units.NAME}&loc={shape.x},{shape.y},{shape.z}
Integration mit Survey123
Survey123 ist in der Indoors-Lizenz enthalten. Falls keine anderen unterstützten Arbeitsauftrags- oder Ticketing-Systeme vorhanden sind, können Startaktionen für Survey123 konfiguriert werden.
Hängen Sie zur benutzerdefinierten Verwendung der Aktionsschaltfläche für Survey123 ein gültiges Argument- oder Wertepaar an die URL an.
Beispiel: Basis-URL für Standardverhalten
https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal
Beispiel: Benutzerdefiniert
In diesem Beispiel wird die Standardeingabe für "room" durch das Namensfeld aus dem Layer "Units" außer Kraft gesetzt.
https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal?field:room={Units.NAME}
Beispiel: Starten der nativen Survey123-App auf mobilen Geräten
"url": "arcgis-survey123://?itemID=surveyformGUID&portalUrl=https://myportal.myorg.com/portal&field:comments={Units.NAME}"
Hinweis:
Verwenden Sie spezifische URLs für native mobile Apps beim Konfigurieren von Startaktionen für Viewer mit Bedacht, da diese für Desktop-Benutzer nicht unterstützt werden. Das Verwenden von URLs für eine native App beim Definieren von Startaktionen sollte auf Workflows beschränkt werden, die die nativen Indoors-Apps oder den Zugriff auf Viewer über einen mobilen Browser unterstützen.
Integration mit Drittanbietersystemen
Die Aktionsschaltfläche kann auch so konfiguriert werden, dass eine Drittanbieter-URL geöffnet und Attributwerte an diese übergeben werden. Voraussetzung hierfür ist, dass das Drittanbietersystem per URL konfigurierbare Formulare oder Parameter für Startaktionen unterstützt. Verwenden Sie in diesem Fall eine URL, die das System in der Konfiguration der Indoors-App mit einer entsprechenden URL für das integrierte System aufruft. Häufig verwendet wird eine Verknüpfung mit Arbeitsauftragsverwaltungs- oder Asset-Management-Systemen von Drittanbietern.
Beachten Sie bei der Arbeit mit Drittanbietersystemen Folgendes:
- Der Operator field: kann unterschiedlich sein.
- Webformulare, die URL-Argumente unterstützen, erfordern ggf. weitere Konfigurationen.
- Nähere Informationen dazu, ob und wie dies umgesetzt werden kann, sind der Dokumentation des integrierten Systems zu entnehmen.
Hinweis:
Je nach verwendetem Business-System werden möglicherweise einige Zeichen nicht unterstützt, beispielsweise das #- oder das +-Zeichen.
Integration mit Arbeitsauftragsverwaltungssystemen
Indoors unterstützt das Starten externer Asset- und Arbeitsauftragsverwaltungssysteme. Die Aktionsschaltfläche im Viewer-Informationsfenster kann so konfiguriert werden, dass wahlweise ein Webformular bzw. die native App eines Drittanbieters zum Erfassen neuer Informationen (beispielsweise Ereignisse oder Anforderungen im Zusammenhang mit einem Raum, Asset oder sonstigen Element in Indoors) oder ein vorhandener Arbeitsauftrag in der Arbeitsauftragsverwaltungs-App eines Drittanbieters geöffnet wird.
Indoors unterstützt die Übergabe von Arbeitsauftrags- und Indoors-Layer-Attributen als Abfragezeichenfolge in der URL. Die Syntax muss dem URL-Schema für Indoors und die App des Arbeitsauftragssystems entsprechen, damit das Starten unterstützt wird.
Der Attributwert muss in geschweiften Klammern eingeschlossen sein und die folgende Syntax aufweisen:
?arg={Work order Attribute}&arg={Layer.Attribute}
Weitere Syntax-Beispiele:
Einzelwert aus dem Arbeitsauftrags-Layer
?arg={workorderid}
Mehrere Werte aus dem Arbeitsauftrags-Layer
?arg={workorderid}&arg={priority}
Wert aus dem Arbeitsauftrags- und Indoors-Layer
?arg={workorderid}&arg={Layer.Attribute}
ServiceNow-URL
Im folgenden Beispiel wird die Nummer des Arbeitsauftrags als Parameter übergeben und ein vorhandener Arbeitsauftrag geöffnet:
https://<MyServerURL>/nav_to.do?uri=task.do?sysparm_query=number={workorderid}
Weitere Beispiele zum Konfigurieren von Startaktionen für ServiceNow
Festlegen der Konfigurationszeichenfolge für die Startaktion
Startaktionen für Viewer können auf verschiedene Weise konfiguriert werden. Eine gültige JSON-Konfigurationszeichenfolge kann in der Tabelle "Indoors Configuration" in ArcGIS Pro angegeben werden.
Startaktionen können auch im Konfigurator des Portals festgelegt werden, wenn eine App aus der Indoor Viewer-Vorlage erstellt wird. In diesem Szenario sind die Standardwerte für Startaktionen der Tabelle "Indoors Configuration" zu entnehmen, sofern die Zeichenfolge für die Startaktion in der Tabelle vorhanden ist. Durch Änderungen im Konfigurationsfenster werden die Einstellungen in der Tabelle "Indoors Configuration" außer Kraft gesetzt.
Nachdem App-Startaktionen im Viewer-Konfigurator konfiguriert wurden, können sie zur Verwendung in ArcGIS Indoors for iOS und ArcGIS Indoors for Android exportiert werden.