Веб-приложение Survey123 может принимать параметры в том же формате, что и полевое приложение. Следует отметить одно отличие: идентификатор элемента опроса является частью URL-пути, а не параметром URL-адреса, как другие ссылки, используемые для открытия опросов. Когда вы добавляете параметры к этому URL-адресу, используйте вопросительный знак, чтобы отделить идентификатор элемента опроса в пути от первого параметра, и амперсанды - для разделения следующих параметров. В следующем примере, URL передает параметры фамилии и координат в веб-приложение Survey123:
https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser¢er=37.8199,-122.4783Веб-приложение Survey123 также поддерживает множество параметров, которые отсутствуют в полевом приложении Survey123. Эти параметры относятся к представлению опроса в браузере. В следующей таблице содержатся параметры URL-адреса и примеры, определяющие способ открытия веб-приложения.
Примечание:
Если значение параметра содержит пробелы, знаки плюс (+) или другие специальные символы, эти символы должны быть закодированы процентами. Более подробно см. раздел Кодировка URL.
Параметры URL для запуска веб-приложения
| Параметр | Описание | Тип |
|---|---|---|
signIn | Для публичных опросов показывает кнопку входа или требует от пользователей входа в систему. По умолчанию веб-приложение не предоставляет пользователям возможности входа в систему для участия в публичных опросах, но публичные опросы могут включать функции, которые будут работать только после входа пользователей в систему. Примером может служить использование вычисления для извлечения адреса электронной почты вошедшего в систему пользователя. Допустимые значения: show, при котором кнопка входа отображается на панели навигации в верхней части веб-приложения; require, при котором пользователям необходимо войти в систему путем перенаправления на страницу входа. Пример: | String |
isOrgSignIn | Использует корпоративную страницу входа. По умолчанию, Survey123 использует страницу входа организации, но при публикации опросов для более, чем одной организации, предпочтительно использование страницы входа ArcGIS Online. Установите этот параметр как false, чтобы использовать страницу входа ArcGIS Online. Пример: | Boolean |
center | Центрирует карту относительно известных значений широты, долготы и, дополнительно, высоты. Пример: | String |
field:fieldname | Заполняет вопросы опроса значениями поля. Пример: | String |
portalUrl | Задает URL портала, на котором размещен элемент опроса. Пример: | String |
| open | Указывает приложение, используемое для открытия опроса. Допустимые значения - это web, открывающее опрос в веб-приложении (по умолчанию), native, которое открывает опрос в полевом приложении, если оно установлено, и menu, открывающее веб-страницу с выбором приложения, в котором будет открыт опрос. Пример: | String |
| hide |
Скрывает элементы опроса в веб-приложении. Этот параметр может принимать несколько значений, разделенных запятыми. Допустимыми значениями являются navbar (строка вверху опроса, включающая параметры входа, выхода из системы и смены языка), header, description, footer, submit, theme и leaveDialog (предупреждающее сообщение, которое появляется при выходе со страницы или при закрытии страницы). Также можно использовать параметрfield:fieldName, чтобы скрыть отдельный вопрос, группу, страницу или повтор, указав имя вместо fieldName. Вопросы в повторах нельзя скрывать по-отдельности. Пример: | String |
| locale | Переключает язык опроса. Работает только, если опрос включает несколько языков. Пример: | String |
| mode | Задает режим веб-приложения. Допустимые значения: edit, которое устанавливает опрос в режим редактирования существующей записи вместо создания новой; view открывает запись в режиме только для чтения; и copy, которое создает опрос, заполняющийся содержимым указанной записи. При использовании этого параметра также требуется параметр globalId. Пример: | String |
| globalId | Определяет запись опроса, загруженную в форму. Проверяемые значения являются глобальными ID для существующих записей опросов. Имя этого параметра чувствительно к регистру. Пример: | String |
recalculate | Могут использоваться только с mode=edit. Это вызывает принудительный пересчет заданного вопроса при загрузке опроса, без использования кнопки Пересчитать. Пример: | String |
| version | Задает версию используемого веб-приложения. Единственным доступным значением является latest, настраивающее веб-приложение на использование его последней версии, даже если версия опроса заблокирована. Пример: | String |
| token | Передает опросу действующий токен. Может использоваться для разрешения респондентам отвечать на опросы, для доступа к которым требуется учетная запись ArcGIS, не выполняя вход. Пример: | String |
autoReload | Перезагружает опрос после отправки. Задайте задержку (в секундах) перед перезагрузкой опроса. Ранее она называлась autoRefresh. Параметр autoRefresh поддерживается в целях обеспечения обратной совместимости. Пример: | Integer |
| encodeUrlParams | Перекрывает параметры URL. Полученный URL будет содержать параметр code, представляющий все закодированные параметры; параметры вне code будут игнорироваться. Пример: | Boolean |
width | Задает ширину опроса в пикселях или в виде части ширины экрана. Значение, большее 1, задаст ширину в пикселах. Если значение пиксела меньше ширины экрана, будет использоваться ширина экрана. Значение между 0 и 1 задаст ширину формы как долю (часть) ширины экрана. Это также влияет на другие элементы управления в опросе, к примеру, текстовые поля, и может помочь улучшить отображение веб-приложением фиксированной или динамической сетки. Примеры: | String |
Примечание:
Параметрfield:fieldname поддерживает вопросы типа геоточка, геотрассировка и геоформа в веб-приложении. Для вопросов типа геоточка укажите широту, долготу и высоту (необязательно), разделенные пробелами. Для геотрассировка и геоформы для каждой вершины укажите широту и долготу, разделенные пробелом, а каждую пару координат разделите точкой с запятой. Этот пример будет работать для вопроса Геоформа:
field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766