Mithilfe von Experience Builder können Sie Ihren Apps URL-Parameter hinzufügen. Sie können URL-Parameter verwenden, um eine Experience zu verbessern, indem über die URL ein Gebietsschema festgelegt, auf eine bestimmte Seite verwiesen oder die Druckvorschau aktiviert wird und vieles mehr.
Parameter werden an das Ende der URL angehängt und als Schlüssel-Wert-Paar formatiert, verbunden durch ein Gleichheitszeichen. Experience Builder-Apps unterstützen Parameter, die Abfragezeichenfolgen sind, d. h. mit einem Fragezeichen beginnen. Wenn Sie mehrere Parameter angeben möchten, müssen Sie sie durch kaufmännische Und-Zeichen (&) voneinander trennen. Experience-URLs mit Parametern verwenden die folgende Struktur: https://<domain>/experience/<AppID>/[?<param1=value>&<param2=value>&...]
Beispiel:https://experience.arcgis.com/experience/<AppId>/
Eine Experience-URL kann auch einen oder mehrere der unten angegebenen Parameter enthalten.
Allgemeine Parameter
Im Folgenden finden Sie eine Liste allgemeiner URL-Parameter.
Ändern des Gebietsschemas
Um die App-Sprache zu wechseln, verwenden Sie den Parameter locale und einen zweistelligen Sprachcode nach ISO 639-1. Experience Builderunterstützt alle Sprachen, die von ArcGIS Enterprise unterstützt werden. Dazu gehören folgende Sprachcodes: ar, bg, bs, ca, cs, da, de, de-de, de-ch, el, en, en-au, en-ca, en-gb, en-us, es, es-es, es-mx, et, fi, fr, fr-fr, fr-ch, he, hr, hu, id, it, it-it, it-ch, ja, ko, lt, lv, nb, nl, pl, pt-br, pt-pt, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-cn, zh-hk und zh-tw.
Um eine Experience Builder-App auf Französisch und auf Französisch (Schweiz) zu verwenden, können Sie "locale=fr" an die URL anhängen, wie in den folgenden Beispielen gezeigt:https://experience.arcgis.com/experience/<AppId>/?locale=frhttps://experience.arcgis.com/experience/<AppId>/?locale=fr-ch
Hinweis:
Wenn Sie nur eine Sprache ohne ein detailliertes Gebietsschema zuweisen, z. B. "fr" anstelle von "fr-ch" oder "fr-fr", ist nicht garantiert, dass Sie das erwartete Datums- oder Zahlenformat erhalten. Dies liegt daran, dass verschiedene Länder manchmal unterschiedliche Schreibweisen für Datumsangaben und Zahlen haben, z. B. USA (en-us) und Großbritannien (en-gb).
Zu einer Seite gehen
Um auf eine bestimmte Seite zu verweisen, verwenden Sie page gefolgt vom Seitennamen. In den ArcGIS Online Experience Builder-Apps ist der Seitenparameter nicht Teil einer Abfragezeichenfolge und folgt nicht auf ein Fragezeichen. Er wird in den URL-Pfad eingefügt, wie in den folgenden Beispielen zu sehen:https://experience.arcgis.com/experience/<AppId>/page/Page-4https://experience.arcgis.com/experience/<AppId>/page/{xxxHome}/
Zu einer Ansicht gehen
Um zu einer bestimmten aktiven Abschnittsansicht zu gelangen, verwenden Sie views gefolgt von einer Ansichtsbeschriftung wie v1 oder View 1.
https://experience.arcgis.com/experience/<AppId>/?views=View-2https://experience.arcgis.com/experience/<AppId>/?views=v1Fenster öffnen
Um auf ein bestimmtes aktives Fenster zu verweisen, verwenden Sie dlg, gefolgt von einer Fenster-ID oder -beschriftung.https://experience.arcgis.com/experience/<AppId>/?dlg=Window-1
Steuern des Fensterfokus
Wenn Sie Einführungsfenster, Seitenfenster oder feste Fenster in eine Experience Builder-App einbetten möchten, die App jedoch nicht automatisch zu diesen Fenstern springen oder scrollen soll, können Sie mit dem Parameter disable_window_focus dieses Verhalten steuern. Fügen Sie der Host-Webseite die folgende URL hinzu, um das Springverhalten zu deaktivieren. Standardmäßig ist disable_window_focus auf "false" gesetzt.https://experience.arcgis.com/experience/<AppId>/?disable_window_focus=true
Entwurfsmodus anzeigen
Wenn Sie eine Vorschau einer App anzeigen, wird der Parameter draft automatisch hinzugefügt. Er ermöglicht es Ihnen, Elementressourcen für unveröffentlichte Apps abzurufen.https://experience.arcgis.com/experience/<AppId>/?draft=truehttps://experience.arcgis.com/experience/<AppId>/?draft=1
Druckvorschau öffnen
Um den Druckvorschau-Modus zu aktivieren, verwenden Sie print_preview.https://experience.arcgis.com/experience/<AppId>/?print_preview=truehttps://experience.arcgis.com/experience/<AppId>/?print_preview=1
Datenbezogene Parameter
Im Folgenden finden Sie eine Liste datenbezogener URL-Parameter.
Datenquellen-ID angeben
Jede Datenquelle in einer App hat ihre eigene Datenquellen-ID. Wenn Sie einen Datensatz auswählen, wird die ID der Datenquelle zur URL der App hinzugefügt, wie in den folgenden Beispielen:https://experience.arcgis.com/experience/<AppId>/?data_id=<dsID>:<selectedrecordID>https://experience.arcgis.com/experience/<AppId>/?data_id=dataSource_1-csv_966%3A0
Sie können diese Methode verwenden, um die spezifische Datenquellen-ID eines Layers zu suchen. Sie können zum Beispiel ein Widget "Liste" hinzufügen und mit einem Layer verbinden, eine Vorschau der App anzeigen und einen beliebigen Datensatz in der Liste auswählen. Die URL sieht in etwa wie folgt aus:https://experience.arcgis.com/experience/<AppId>/?data_id=dataSource_2-Shelters_966%3Axxxxxx
Der Wert nach ?data_id= und vor :<selectedrecordID> (oder %3A<selectedrecordID>) ist die Datenquellen-ID des Layers. Wenn Sie die ID kennen, können Sie sie zusammen mit anderen Parametern verwenden, um die Datenquelle zu filtern oder Versionen zu ändern.
Filtern von Datenquellen
Um eine Datenquelle direkt zu filtern, verwenden Sie data_filter. Das Filterformat ist eine standardmäßige WHERE-Klausel-Syntax, die "," oder ":" nicht enthalten darf. Um mehrere Datenquellen zu filtern, verwenden Sie das Format [<dsId:filter>,<dsId:filter>].https://experience.arcgis.com/experience/<AppId>/?data_filter=dataSource_1:st=’HI’
Die URL oben entspricht der folgenden codierten URL:https://experience.arcgis.com/experience/<AppId>/?data_filter=dataSource_1:st=%27HI%27
Folgende URL ist ein weiteres Beispiel für diesen Parameter:https://experience.arcgis.com/experience/<AppId>/?data_filter=ds1:objectid=1,ds2:fielda>2
GDB-Version einer Datenquelle ändern
Um die GDB-Version einer Datenquelle zu ändern, verwenden Sie data_version.https://experience.arcgis.com/experience/<AppId>/?data_version=<dsId:version>,<dsId:version>https://experience.arcgis.com/experience/<AppId>/?data_version=dsId1:v1, dsID2:v1
Anmeldebezogene Parameter
Im Folgenden finden Sie eine Liste anmeldebezogener URL-Parameter.
Geteilte Authentifizierung mithilfe des Widgets "Einbetten"
Bei einigen Web-Apps werden Benutzer aufgefordert, sich mit einem ArcGIS-Konto anzumelden. Dafür, dass sich Benutzer bei einer App möglicherweise anmelden müssen, gibt es verschiedene Gründe wie etwa die Freigabeeinstellungen der App oder weil die App Widgets enthält, in denen Premium-Inhalte verwendet werden.
Wenn Sie in Ihre Experience Builder-App eine ArcGIS-Web-App einbetten möchten und Benutzer sich bei beiden Apps anmelden müssen, können Sie die URL-Parameter arcgis-auth-origin und arcgis-auth-portal hinzufügen, sodass für beide Apps dieselbe Authentifizierung verwendet wird und Benutzer sich nur einmal anmelden müssen.
Wenn Sie eine private Experience Builder-App in eine andere Experience Builder-App einbetten möchten, verwenden Sie ?arcgis-auth-origin=, um die URL der Host-App-Domäne für die Authentifizierung festzulegen. Beispiel:https://<orgdomain>/experience/<AppID>/?arcgis-auth-origin=<your host app domain, such as https://localhost:3001>
Wenn Sie eine JavaScript-API-basierte App, wie etwa eine Web AppBuilder-App, einbetten möchten, verwenden Sie ?arcgis-auth-origin= für die Authentifizierung der Host-App-Domäne und ?arcgis-auth-portal= für die Domänenauthentifizierung der JavaScript-API-basierten App. Nachfolgend finden Sie einige Beispiele:https://<orgdomain>/apps/webappviewer/index.html?id=<appID>&arcgis-auth-origin=<your host app domain, such as https://localhost:3001>&arcgis-auth-portal=<orgA URL>https://www.arcgis.com/apps/opsdashboard/index.html#/<appID>?arcgis-auth-origin=https://experience.arcgis.com&arcgis-auth-portal=https://<myorg>.maps.arcgis.com