Syntax von Startaktionen

Verfügbar für ArcGIS-Organisationen mit Lizenz für die Erweiterung "Indoors".

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 in der ArcGIS-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 aktive 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.

Wenn Sie einen Survey in Ihrer ArcGIS Online-Organisation erstellen, wird die URL zur Freigabe des Survey standardmäßig gekürzt. Um Startaktionen zu ermöglichen, muss beim Anhängen von Argumenten und Paaren die vollständige URL verwendet werden. Gehen Sie wie folgt vor, um die vollständige URL für einen vorhandenen Survey abzurufen:

  1. Klicken Sie in Survey123 auf die Registerkarte Eigene Surveys, und klicken Sie auf den Survey, für den Sie eine Startaktion erstellen möchten.
  2. Klicken Sie auf die Registerkarte Zusammenarbeit und auf Survey freigeben.
  3. Kopieren Sie die gekürzte URL, fügen Sie sie in einen Browser ein, und laden Sie den Survey.

    In der Adressleiste wird die vollständige URL angezeigt.

  4. Kopieren Sie die vollständige URL aus der Adressleiste.

An diese URL können Sie nun beim Konfigurieren von Startaktionen nach Bedarf Argumente und Paare anhängen.

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. Verwenden Sie die URL einer nativen App nur beim Definieren von Startaktionen für Workflows, die die nativen Indoors-Apps oder den Zugriff auf Viewer über einen mobilen Browser unterstützen.

Integration mit Drittanbietersystemen

Sie können die Aktionsschaltfläche ebenfalls so konfigurieren, 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 sich unterscheiden.
  • 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 vorhandenen 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 Startaktionen unterstützt werden.

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