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=frhttps://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-4https://experience.arcgis.com/experience/<AppId>/page/{xxxHome}/
Перейти к виду
Чтобы напрямую перейти к указанному конкретному виду раздела, используйте views после подписи вида, например v1 или View 1.
https://experience.arcgis.com/experience/<AppId>/?views=View-2https://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=truehttps://experience.arcgis.com/experience/<AppId>/?draft=1
Открыть предварительный просмотр печати
Для активации режима предварительного просмотра печати используйте print_preview.https://experience.arcgis.com/experience/<AppId>/?print_preview=truehttps://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