Запустите веб-приложение

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

https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser&center=37.8199,-122.4783

Веб-приложение Survey123 также поддерживает множество параметров, которые отсутствуют в полевом приложении Survey123. Эти параметры относятся к представлению опроса в браузере. В следующей таблице содержатся параметры URL-адреса и примеры, определяющие способ открытия веб-приложения.

Примечание:

Если значение параметра содержит пробелы, знаки плюс (+) или другие специальные символы, эти символы должны быть закодированы процентами. Более подробно см. раздел Кодировка URL.

Параметры URL для запуска веб-приложения

ПараметрОписаниеТип

isOrgSignIn

Использует корпоративную страницу входа. По умолчанию, Survey123 использует страницу входа организации, но при публикации опросов для более, чем одной организации, предпочтительно использование страницы входа ArcGIS Online. Установите этот параметр как false, чтобы использовать страницу входа ArcGIS Online.

Пример:

isOrgSignIn=false

Boolean

center

Центрирует карту относительно известных значений широты, долготы и, дополнительно, высоты.

Пример:

center=37.8199,-122.4783,20

String

field:fieldname

Заполняет вопросы опроса значениями поля.

Пример:

 field:surname=Klauser

String

portalUrl

Задает URL портала, на котором размещен элемент опроса.

Пример:

portalUrl=https://myorg.arcgis.com

String

open

Указывает приложение, используемое для открытия опроса. Допустимые значения - это web, открывающее опрос в веб-приложении (по умолчанию), native, которое открывает опрос в полевом приложении, если оно установлено, и menu, открывающее веб-страницу с выбором приложения, в котором будет открыт опрос.

Пример:

open=web

String

hide

Скрывает элементы опроса в веб-приложении. Этот параметр может принимать несколько значений, разделенных запятыми. Допустимыми значениями являются navbar (строка вверху опроса, включающая параметры входа, выхода из системы и смены языка), header, description, footer, submit, theme и leaveDialog (предупреждающее сообщение, которое появляется при выходе со страницы или при закрытии страницы). Также можно использовать параметрfield:fieldName, чтобы скрыть отдельный вопрос, группу, страницу или повтор, указав имя вместо fieldName. Вопросы в повторах нельзя скрывать по-отдельности.

Пример:

hide=header,description,footer,theme

String

locale

Переключает язык опроса. Работает только, если опрос включает несколько языков.

Пример:

locale=zh-cn

String

mode

Задает режим веб-приложения. Допустимые значения: edit, которое устанавливает опрос в режим редактирования существующей записи вместо создания новой; view открывает запись в режиме только для чтения; и copy, которое создает опрос, заполняющийся содержимым указанной записи. При использовании этого параметра также требуется параметр globalId.

Пример:

mode=edit&globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

String

globalId

Определяет запись опроса, загруженную в форму. Проверяемые значения являются глобальными ID для существующих записей опросов. Имя этого параметра чувствительно к регистру.

Пример:

globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

String

recalculate

Могут использоваться только с mode=edit. Это вызывает принудительный пересчет заданного вопроса при загрузке опроса, без использования кнопки Пересчитать.

Пример:

recalculate=field:question1,field:question2

String

version

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

Пример:

version=latest

String

token

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

Пример:

token=E60M4Gsc-h4Q8plqQ...

String

autoReload

Перезагружает опрос после отправки. Задайте задержку (в секундах) перед перезагрузкой опроса. Ранее она называлась autoRefresh. Параметр autoRefresh поддерживается в целях обеспечения обратной совместимости.

Пример:

autoReload=3

Integer

encodeUrlParams

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

Пример:

encodeUrlParams=true

Boolean

width

Задает ширину опроса в пикселах. Это также затронет другие элементы управления в опросе, в частности, текстовые окна.

Пример:

width=1000

Integer

Примечание:

Параметрfield:fieldname поддерживает вопросы типа геоточка, геотрассировка и геоформа в веб-приложении. Для вопросов типа геоточка укажите широту, долготу и высоту (необязательно), разделенные пробелами. Для геотрассировка и геоформы для каждой вершины укажите широту и долготу, разделенные пробелом, а каждую пару координат разделите точкой с запятой. Этот пример будет работать для вопроса Геоформа:

field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766