Syntax von Startaktionen

Verfügbar mit einem Portal, das mit der Indoors-Funktionalität lizenziert ist.​

ArcGIS Indoors unterstützt Startaktionen für die Apps von Drittanbietern direkt aus dem Informationsfenster in Indoor Viewer und der Infokachel in den mobilen Indoors-Apps. Die Startaktionen können im Bereich Indoors-Startaktionen konfigurieren in ArcGIS Pro konfiguriert werden. Sie können geändert werden, wenn Sie im ArcGIS Enterprise-Portal oder in der ArcGIS Online-Organisation eine Viewer-App konfigurieren.

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 der Indoors-App 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 können Sie Text hinzufügen.

Beispiel

https://<MySurveyURL>?Name={knownas}&office=office%3A%20{units.NAME}&loc={shape.x},{shape.y},{shape.z}

Integration mit Survey123

Survey123 ist in Ihrer 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

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 der URL 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, erhalten Sie beim Anbieter des integrierten Systems.

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 Informationsfenster in Viewer und auf der Infokachel in den mobilen Indoors-Apps kann so konfiguriert werden, dass ein Webformular oder die native App eines Drittanbieters geöffnet wird. Das Formular bzw. die App eines Drittanbieters kann zum Erfassen neuer Informationen (beispielsweise Ereignisse oder Anforderungen im Zusammenhang mit einem Raum, Asset oder sonstigen Element in Indoors) oder zum Öffnen eines vorhandenes Arbeitsauftrags in der Arbeitsauftragsverwaltungs-App eines Drittanbieters verwendet werden.

Indoors unterstützt die Übergabe von Arbeitsauftrags- und Indoors-Layer-Attributen als Abfragezeichenfolge in der URL. Die Syntax muss dem URL/URI-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