Konfigurieren von Startaktionen für Indoor Viewer

Verfügbar mit der Erweiterung "ArcGIS Indoors Maps".

ArcGIS Indoors unterstützt Startaktionen für die Apps von Drittanbietern direkt aus dem Informationsfenster in Indoor Viewer. Aktionen für den App-Start bieten die Möglichkeit zur Einbindung Ihrer Business-Systeme in ArcGIS Indoors.

Eine Startaktion kann zum Öffnen einer Webseite oder nativen mobilen App und automatischen Übergeben von Indoor-Daten an das Zielsystem oder die Ziel-App konfiguriert werden. Auf diese Weise können Benutzer Ereignisse oder Anforderungen für ein ausgewähltes Feature in Viewer senden. Benutzer können über eine Webseite bzw. eine mobile App Informationen zu einem in der Viewer-App ausgewählten Feature überprüfen und automatisch Formularfelder mit aktualisierten Informationen ausfüllen.

Sie können mit den folgenden Methoden Startaktionen für Viewer konfigurieren:

  • Mit dem Bereich Indoors-Startaktionen konfigurieren in ArcGIS Pro. Startaktionen, die in ArcGIS Pro konfiguriert wurden, können später während der App-Konfiguration modifiziert werden.
    Hinweis:

    Änderungen, die im Fenster App konfigurieren vorgenommen werden, wirken sich nur auf die Startaktionen in der Viewer-App aus.

  • Mit dem Fenster App konfigurieren, wenn Sie eine App erstellen oder ändern. Sie können im Konfigurationsfenster in ArcGIS Pro erstellte Startaktionen ändern oder neue Startaktionen erstellen.

Hinweis:

Indoors ermöglicht die Platzierung von Pins für Positionen außerhalb eines Gebäudes, z. B. in Campus-Parkanlagen oder Außenanlagen. Wenn eine Startaktion im Konfigurationsfenster auf Alle Layer angewendet wird, ist die Aktion auch für die hinzugefügten Pins verfügbar.

Konfigurieren von Startaktionen mithilfe des Konfigurationsfensters

Führen Sie während der Konfiguration der Viewer-App die folgenden Schritte aus , um in ArcGIS Pro erstellte Aktionen für den App-Start zu ändern oder neue Aktionen zu erstellen:

  1. Navigieren Sie im Bereich App konfigurieren zum Abschnitt App-Start.
    Hinweis:

    Wenn Sie Startaktionen in ArcGIS Pro konfiguriert haben, werden sie im Abschnitt App-Start angezeigt. Bei Bedarf können Sie sie aktualisieren.

  2. Fügen Sie optional eine neue Aktion hinzu.
    1. Klicken Sie auf Hinzufügen, um eine neue Aktion hinzuzufügen.
    2. Geben Sie in das Textfeld Beschriftung einen Namen für die Aktion ein.
    3. Fügen Sie die URL für die Aktion im Textfeld URL hinzu.
    4. Klicken Sie auf Kategorien und Layer auswählen, und aktivieren Sie das Kontrollkästchen für die Layer und Kategorien, mit denen diese Aktion verknüpft werden soll.

      Standardmäßig sind alle Layer und Unterkategorien ausgewählt.

    5. Klicken Sie auf OK.
    6. Wiederholen Sie für etwaige weitere Aktionen die vorstehenden Schritte.
  3. Klicken Sie neben Startaktionen, die Sie entfernen möchten, auf die Schaltfläche Entfernen Entfernen.
  4. Ordnen Sie die Aktionen bei Bedarf mit den Auf- und Abwärtspfeilen neu an.
  5. Klicken Sie auf Speichern, um Aktualisierungen der App-Vorlage zu speichern.

Wenn Sie im Informationsfenster für Features in den Kategorien und Layern mit konfigurierten Startaktionen auf die Schaltfläche Mehr Mehr klicken, werden Startaktionen in einer Liste angezeigt.

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:

Setzen Sie beim Konfigurieren von Startaktionen für Viewer URLs für native mobile Apps mit Bedacht ein, 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 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 einer separaten App geöffnet wird.

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