Использование параметров URL

Experience Builder позволяет добавлять параметры URL в ваше приложение. Вы можете использовать параметры URL для улучшения интерфейса, задав URL-адресу языковой стандарт, перенаправив на определенную страницу, активировать предварительный просмотр печати и многое другое.

Параметры добавляются в конец строки URL и форматируются в виде пар ключ-значение, через знак равенства. Приложения Experience Builder поддерживают параметры, являющиеся строками запроса, то есть начинающиеся с вопросительного знака. Чтобы включить множественные параметры, их необходимо разделять амперсандами. URL интерфейса с параметрами использует следующую структуру:

 https://<domain>/experience/<AppID>/[?<param1=value>&<param2=value>&...]

Ниже приведен пример:

https://experience.arcgis.com/experience/<AppId>/

URL интерфейса также может содержать один или несколько параметров, приведенных ниже.

Основные параметры

Ниже приведен список основных параметров URL.

Переключение языка

Чтобы переключить язык приложения, используйте параметр locale и двухбуквенный код языка ISO 639-1. Experience Builder поддерживает те же языки что поддерживает ArcGIS Enterprise, они представлены следующими языковыми кодами: ar, bg, bs, ca, cs, da, de-at, de-de, de-ch, el, en-au, en-ca, en-gb, en-us, es-es, es-mx, et, fi, fr-fr, fr-ch, he, hr, hu, id, 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, и zh-tw.

Для использования приложения Experience Builder на французском или швейцарском французском, вы можете добавить код=fr к URL, как в следующих примерах:

https://experience.arcgis.com/experience/<AppId>/?locale=fr
https://experience.arcgis.com/experience/<AppId>/?locale=fr-ch
Примечание:

Если вы назначаете язык без уточненного идентификатора, например, fr а не fr-ch или fr-fr, возможно форматы даты или чисел может не соответствовать ожиданиям. Это связано с тем, что в разных регионах, где говорят на одном и том же языке, иногда используются разные обозначения дат и чисел, например, Соединенные Штаты (en-us) против Соединенного Королевства (en-gb).

Перейти на страницу

Для перехода на конкретную страницу используйте page после имени страницы. В приложениях ArcGIS Online Experience Builder параметры страницы не являются частью строки запроса, и не начинаются с вопросительного знака. Он добавляется к пути URL, как в следующих примерах:

https://experience.arcgis.com/experience/<AppId>/page/Page-4
https://experience.arcgis.com/experience/<AppId>/page/{xxxHome}/

Перейти к виду

Чтобы напрямую перейти к указанному конкретному виду раздела, используйте views после подписи вида, например v1 или View 1.

https://experience.arcgis.com/experience/<AppId>/?views=View-2
https://experience.arcgis.com/experience/<AppId>/?views=v1

Открыть окно

Чтобы напрямую перейти к указанному активному окну, используйте dlg после ID или подписи окна.

https://experience.arcgis.com/experience/<AppId>/?dlg=Window-1

Фокус окна элементов управления

Если вы хотите встроить приложение Experience Builder с окнами приветствия, окнами страниц или фиксированными окнами и не хотите, чтобы приложение автоматически переходило к этим окнам или прокручивало к ним, вы можете использовать параметр disable_window_focus для управления этим поведением. Добавьте следующий URL-адрес на веб-страницу хоста, чтобы отключить поведение перехода. По умолчанию disable_window_focus имеет значение false.

https://experience.arcgis.com/experience/<AppId>/?disable_window_focus=true

Режим просмотра черновика

Каждый раз при предварительном просмотре приложения, параметр draft добавляется автоматически. Это позволяет вам получать доступ к ресурсам элементов для неопубликованных приложений.

https://experience.arcgis.com/experience/<AppId>/?draft=true
https://experience.arcgis.com/experience/<AppId>/?draft=1

Открыть предварительный просмотр печати

Для активации режима предварительного просмотра печати используйте print_preview.

https://experience.arcgis.com/experience/<AppId>/?print_preview=true
https://experience.arcgis.com/experience/<AppId>/?print_preview=1

Параметры, связанные с данными

Ниже приведен список параметров URL, связанных с данными.

Указать ID источника данных

Каждый источник данных в приложении содержит собственный идентификатор (ID) источника данных. Если вы выбираете запись данных, идентификатор источника данных добавляется к URL приложения, как показано в следующих примерах:

https://experience.arcgis.com/experience/<AppId>/?data_id=<dsID>:<selectedrecordID>
https://experience.arcgis.com/experience/<AppId>/?data_id=dataSource_1-csv_966%3A0

Вы можете использовать этот метод для поиска ID источников данных слоя. Например, вы можете добавить виджет Список и подключить его к слою, просмотреть приложение и выбрать любую запись в списке. URL-адрес заполняется как указано в следующем примере:

https://experience.arcgis.com/experience/<AppId>/?data_id=dataSource_2-Shelters_966%3Axxxxxx

Значение после ?data_id= и перед :<selectedrecordID> (или %3A<selectedrecordID>) - идентификатор источника данных (ID). Зная ID вы можете использовать его с другими параметрами, чтобы применять фильтры к источникам данных или изменять версии.

Фильтр источников данных

Чтобы напрямую использовать фильтр источника данных data_filter. Формат фильтра - стандартный синтаксис условия WHERE, который не может содержать "," или ":". Для применения фильтра к нескольким источникам данных используйте формат [<dsId:filter>,<dsId:filter>].

https://experience.arcgis.com/experience/<AppId>/?data_filter=dataSource_1:st=’HI’

Приведенный выше URL-адрес соответствует следующему закодированному URL-адресу:

https://experience.arcgis.com/experience/<AppId>/?data_filter=dataSource_1:st=%27HI%27

Далее предсавлен другой пример URL с этим параметром:

https://experience.arcgis.com/experience/<AppId>/?data_filter=ds1:objectid=1,ds2:fielda>2

Изменение версии БГД источника данных

Чтобы изменить версию БГД источника данных, используйте 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

Параметры, связанные с именем пользователя

Ниже приведен список параметров URL, связанных с именем пользователя.

Доступ к аутентификации через виджет Встроить

Некоторые веб-приложения предлагают пользователям войти в систему с учетной записью ArcGIS. Приложению может потребоваться, чтобы пользователи выполнили вход в систему из-за его настроек общего доступа, поскольку приложение включает виджеты, использующие премиум ресурсы, или по другим причинам.

Если вы хотите встроить веб-приложение ArcGIS в свое приложение Experience Builder, и обязать пользователей выполнять вход в систему, вы можете добавить параметры URL arcgis-auth-origin и arcgis-auth-portal, чтобы совместно использовать аутентификацию между обоими приложениями, а пользователям нужно было войти только один раз.

Чтобы встроить частное приложение Experience Builder в другое приложение Experience Builder, используйте ?arcgis-auth-origin= для определения URL-адреса домена хост-приложения для аутентификации. Ниже приведен пример:

https://<orgdomain>/experience/<AppID>/?arcgis-auth-origin=<your host app domain, such as https://localhost:3001>

Чтобы внедрить приложение на основе JavaScript API, например приложение Web AppBuilder, используйте ?arcgis-auth-origin= для аутентификации домена хост-приложения и ?arcgis-auth-portal= для проверки подлинности домена приложения на основе JavaScript API. Ниже приведены примеры:

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