Краткий справочник

ArcGIS Survey123 поддерживает множество XLSForm спецификаций В этом справочнике приведено описание объектов XLSForm, которые могут использоваться в Survey123. Опросы можно создавать вSurvey123 Connect или Survey123 веб-сайте; некоторые возможности доступны только на одном из этих них, а некоторые – на обоих.

Типы вопросов

Survey123 Connect типы вопросовSurvey123 тип вопроса веб-дизайнераОписаниеПоддерживается в полевом приложении Survey123Поддерживается в веб-приложении Survey123

integer

Число

Ввод целых чисел.

Да

Да

decimal

Ввод десятичных знаков.

Да

Да

range

Н/Д

Используется для заданного диапазона чисел.

Да

Нет

text

Однострочный текст, многострочный текст, Email, веб-сайт, адрес

Ответ в произвольной форме. Для Email и веб-сайт применяется регулярное выражение. Вид геокодирования применяется к адресу.

Да

Да

select_one list_name

Один вариант ответа, Сетка одного варианта ответа, Ниспадающий список, Шкала Лайкерта, Рейтинг

Вопрос с несколькими вариантами ответов; допускается выбрать только один из вариантов. Замените list_name именем списка выбора.

Да

Да

select_multiple list_name

Несколько вариантов ответа

Вопрос с несколькими вариантами ответов; допускается выбрать несколько вариантов ответов. Замените list_name именем списка выбора.

Да

Да

rank list_name

Ранжирование

Вопрос типа Ранг. Предлагает список вариантов. Замените list_name именем списка выбора.

Да

Да

note

Примечание

Показывает текст на экране. Примечание также может управлять скрытыми вычислениями.

Да

Да

geopoint

Карта

Получает координаты GPS. По умолчанию используется текущее местоположение.

Да

Да

geotrace

Собирает линию на карте.

Да

Да

geoshape

Собирает полигон на карте.

Да

Да

date

Date

Ввод даты.

Да

Да

time

Время

Ввод данных о времени.

Да

Да

dateTime

Дата и время

Ввод даты и времени.

Да

Да

image

Изображение, подпись

Принимается изображение из файлов на устройстве или непосредственно снятое фото.

Да

Да

begin group

Группа, страница

Начинает группу вопросов.

Да

Да

end group

Группа, страница

Завершает группу вопросов.

Да

Да

begin repeat

Н/Д

Начинает группу повторяющихся вопросов.

Да

Да

end repeat

Н/Д

Завершает группу повторяющихся вопросов.

Да

Да

calculate

Н/Д

Выполняет калькуляцию значений по форме. Вычислить поле содержит результат калькуляции.

Да

Да

username

Н/Д

При входе под учетной записью организации в это поле автоматически заносится имя пользователя этой учетной записи.

Да

Да

email

Н/Д

При входе под учетной записью организации в это поле автоматически заносится электронный адрес почты этой учетной записи.

Да

Да

hidden

Н/Д

Создает поле в векторном слое, которое не отображается в форме. Используйте столбцы bind::esri:fieldType и bind::esri:fieldLength, чтобы указать схему данных для этого поля.

Да

Да

barcode

Н/Д

Сканирует штрих-код или QR-код.

Да

Нет

start

Н/Д

Дата и время начала опроса.

Да

Да

end

Н/Д

Дата и время окончания опроса.

Да

Да

deviceid

Н/Д

UUID определенного устройства, на котором производился опрос.

Да

Нет

audio

Аудио

Записывает аудиоклип в полевом приложении. Записывает аудиоклип или берет выгруженный аудиофайл в веб-приложении.

Да

Да

file

Загрузка файла

Принимает файл на устройстве.

Да

Да

Различия вопросов в приложении и веб

Хотя в таблице выше описаны типы вопросов, доступные вSurvey123 Connect, Survey123 полевом приложении, Survey123 веб-дизайнере, и Survey123 веб-приложении, существуют различия в их поведении и применении в пределах платформы.

  • Веб-дизайнер комбинирует вопросы integer и decimal в один тип вопроса с названием Number. Опция в свойствах вопроса позволяет дизайнеру опроса задать необходимые входные данные.
  • Вопросы типа email в Survey123 Connect и в Survey123 веб-дизайнере реализованы по-разному. Реализация в Survey123 Connect автоматически заполняется адресами электронной почты пользователей с учетной записью организации, с которой выполнен вход. Реализация в веб-дизайнере Survey123, наоборот, является текстовым полем, которое принимает только форматирование, соответствующее адресу электронной почты.
  • Вопросы типа Геоточка, геотрассировка и геоформа были объединены в один тип, который называется «Карта». Опция в свойствах вопроса позволяет дизайнеру опроса задать необходимые входные данные. Новый тип вопроса "Адрес" позволяет отправлять геокодированные точки.
  • Вопросы Аудио не поддерживают выгрузку в полевое приложение Survey123, как в веб-приложении. Чтобы разрешить выгрузку аудио в полевое приложение, используйте вопрос Файл.
  • Несколько доступных видов оформлений в Survey123 Connect представлены как типы вопросов в веб-дизайнере Survey123. Сюда относятся Многострочный текст, Ниспадающий список и Шкала Лайкерта.
  • Для каждого вопроса веб-дизайнер предоставляет возможность кэшировать ответ. В веб-приложении после отправки записи опроса ответ на вопрос будет кэширован в браузере и предварительно загружен в следующую отправку, сделанную для этого опроса на этом устройстве. Кэширование ответа можно настроить для всех типов вопросов, кроме Изображения, Загрузки файла и Подписи.

Проверка данных

Проверка Это – обязательный вопрос на вкладке Редактировать, требующий ввода значения для завершения данной формы.

Для большинства вопросов может быть задана минимальная и максимальная длина. Благодаря этой функции опрос не может быть пройден, если длина ответов превышает установленные границы. Эта функция выполняет ту же роль, что и ограничение или столбец bind::esri:fieldLength в Survey123 пецификации XLSForm.

Значения по умолчанию

Для большинства вопросов можно задать ответ по умолчанию, который будет автоматически заполняться при загрузке опросника. Это имеет ту же цель, что и столбец по умолчанию в XLSForm.

Специальные символы

Имена вопросов и ответов не должны содержать специальные символы, как-то пробелы, запятые, дефисы, круглые скобки, квадратные скобки и такие символы, как $, % и #. Важно, чтобы имена вариантов ответов для вопросов с несколькими вариантами ответов не содержали пробелов или запятых.

Однострочный текст

Однострочный текст предоставляет пользователю отдельное текстовое поле. Если текст превышает размер текстового поля, он прокручивается по горизонтали без разрывов строк, не изменяясь в размере. Это идеально подходит для коротких ответов. Вы также можете применить маску ввода, чтобы ввод осуществлялся в определенном формате.

Этот тип вопросов работает аналогично text вопросу в Survey123 Connect.

Многострочный текст

Многострочный текст предоставляет пользователю простое отдельное текстовое поле. В нем нет предела для текста; если текст длинный, то он переходит на новую строку, а затем появляется полоса прокрутки. Такой текст идеально подходит для развернутых ответов.

Этот тип вопросов работает аналогично вопросу text с оформлением multiline в Survey123 Connect.

Один вариант выбора

Один вариант выбора подразумевает наличие списка ответов, из которых пользователь должен выбрать только один; на вкладке Редактировать один из этих ответов может быть назначен в качестве варианта, который будет использоваться по умолчанию. Также есть отметка Разрешить "Другие", позволяющая пользователю задавать дополнительный вариант, отсутствующий в списке. Также есть возможность установки случайного порядка появления вариантов. В разделе Оформление можно выбрать вертикальное или горизонтальное расположение ответов.

Для вопросов, предполагающих только один вариант ответа, предусмотрена кнопка Задать правило, которая находится слева в секции дизайна. Щелкните эту кнопку, чтобы открыть окно, в котором можно задать правило видимости для вопроса, идущего следом за данным вопросом. Назначение этой функции то же, что и столбца по умолчанию в XLSForm.

Этот тип вопросов работает аналогично вопросу select_one вSurvey123 Connect.

Сетка одного варианта выбора

Сетка одного варианта выбора подразумевает наличие списка потенциальных ответов для набора вопросов, из которых пользователь должен выбрать только один; на вкладке Редактировать один из этих ответов может быть назначен в качестве варианта, который будет использоваться по умолчанию. Эти функции идентичны сериям вопросов с одним вариантом выбора и у них нет кнопки Установить правило.

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

Этот тип вопросов работает аналогично группе вопросов select_one с оформлением table-list в Survey123 Connect.

Несколько вариантов ответа

Вопросы, подразумевающие несколько вариантов ответов, содержат список возможных ответов, из которых пользователь может выбрать любое число ответов; на вкладке Редактировать некоторые из этих ответов можно назначить в качестве вариантов, которые будут использоваться по умолчанию. Также есть отметка Разрешить "Другие", позволяющая пользователю задавать дополнительный вариант, отсутствующий в списке. Также есть возможность установки случайного порядка появления вариантов. В разделе Оформление можно выбрать вертикальное или горизонтальное расположение ответов.

Этот тип вопросов работает аналогично вопросу select_multiple в Survey123 Connect.

Ниспадающий список

В ниспадающем списке пользователь может выбрать только один вариант ответа; на вкладке Редактировать один из этих ответов может быть назначен в качестве варианта, который будет использоваться по умолчанию. Отметка Разрешить "Другие" позволяет пользователю задавать дополнительный вариант, отсутствующий в списке. Также есть возможность установки случайного порядка появления вариантов. Отметка Автозавершение позволит пользователю вводить текст в поле, ограничивая список только ответами, содержащими этот текст. Вопросы этого типа идентичны вопросам, предполагающим один вариант ответа, но ответы на них представлены в виде ниспадающего списка. Она идеально подходит для более длинных списков с вариантами ответов, поскольку список не будет доступен, пока вы его не выберете.

Как и для вопросов, предполагающих только один вариант ответа, для ниспадающих вопросов также предусмотрена кнопка Задать правило, которая находится слева в секции дизайна. Щелкните эту кнопку, чтобы открыть окно, в котором можно задать правило видимости для вопроса, идущего следом за данным вопросом. Назначение этой функции то же, что и столбца по умолчанию в XLSForm.

Этот тип вопросов работает аналогично вопросу select_one с минимальным оформлением в Survey123 Connect.

Рейтинг

В ниспадающем списке пользователь может выбрать только один вариант ответа; на вкладке Редактировать один из этих ответов может быть назначен в качестве варианта, который будет использоваться по умолчанию. Эта функция идентична вопросу, предполагающему один вариант ответа, но ответы в ней представлены в виде нескольких иконок. По умолчанию этот тип вопросов представлен в виде диапазона от одной до 5 звездочек, но это максимальное значение и иконку можно изменить на вкладке Редактировать.

Как и для вопросов, предполагающих только один вариант ответа, для вопросов рейтинга также предусмотрена кнопка Задать правило, которая находится слева в секции дизайна. Щелкните эту кнопку, чтобы открыть окно, в котором можно задать правило определения видимости вопросов. Назначение этой функции то же, что и столбца по умолчанию в XLSForm.

Этот тип вопросов работает аналогично вопросу select_one вSurvey123 Connect.

Шкала Лайкерта

Шкала Лайкерта представляет собой список потенциальных ответов, из которого пользователь может выбрать только один вариант; на вкладке Редактировать один из этих ответов может быть назначен в качестве варианта, который будет использоваться по умолчанию. Эта функция идентична вопросу, предполагающему один вариант ответа, но ответы в ней представлены в виде шкалы Лайкерт. По умолчанию этот типы вопросов представляет диапазон от одного до 5, но диапазон можно изменить на вкладке Редактировать.

Как и для вопросов, предполагающих только один вариант ответа, для ниспадающих вопросов также предусмотрена кнопка Задать правило, которая находится слева в секции дизайна. Щелкните эту кнопку, чтобы открыть окно, в котором можно задать правило видимости для вопроса, идущего следом за данным вопросом. Назначение этой функции то же, что и столбца по умолчанию в XLSForm.

Этот тип вопросов работает аналогично вопросу select_one с оформлением Likert в Survey123 Connect.

Число

Число подразумевает вопрос, позволяющий пользователю использовать только числовые значения. По умолчанию допускается один десятичный знак. В секции Проверка имеется окошко опции, с помощью которого можно указать, чтобы это значение было целочисленным. Если эта опция отмечена, ввод десятичных знаков невозможен.

Вместо минимального и максимального числа знаков в числовых вопросах предусмотрены минимальные и максимальные значения, которые не позволяют пользователю пройти опрос, если его ответы выходят за пределы заданного диапазона. Работает так же, как и столбец ограничения в XLSForm.

Этот тип вопросов работает аналогично вопросам целочисленный или десятичный в Survey123 Connect, в зависимости от того, включена ли опция целых чисел.

Date

Дата содержит календарь, где можно выбрать дату. Можно задать ответ по умолчанию на этот вопрос, который будет запускаться либо в определенную дату, либо в день прохождения опроса. В секции Проверка можно указать диапазон дат, доступных для выбора пользователем.

Этот тип вопросов работает аналогично date вопросу в Survey123 Connect.

Время

Time (время) позволяет выбрать время в формате час:минута AM/PM. Ниспадающее меню позволяет выбирать время с пятнадцатиминутными интервалами; выбранное время показывается в текстовых полях, что позволяет пользователям указать более конкретное время. Можно задать ответ по умолчанию на этот вопрос, который будет запускаться либо в определенное время, либо в момент загрузки опроса.

Этот тип вопросов работает аналогично вопросу time в Survey123 Connect.

Дата и время

Тип Дата/Время представлен в виде календаря для выбора даты и поля для выбора времени. Эти поля ведут себя так же, как вопросы типа дата и время соответственно, и предоставляют те же элементы управления для значений по умолчанию и проверки.

Этот тип вопросов работает аналогично dateTime вопросу в Survey123 Connect.

Изображение

Вопрос типа Изображение предоставляет кнопку для выбора файла изображения на устройстве, либо дает возможность сделать фото с помощью камеры устройства, если она есть. Вы можете запретить пользователю отправлять файлы изображения с устройства, выбрав Только камера в качестве источника изображений. Вы можете разрешить пользователю отправлять до 99 изображений в одном ответе на вопрос.

Внимание:

Если вопрос типа Изображение содержит несколько изображений, данные EXIF не могут быть извлечены из изображений. Если вам необходимо извлечь данные EXIF из нескольких изображений одного вопроса, воспользуйтесь повтором.

Этот тип вопросов работает аналогично image вопросу в Survey123 Connect.

Аудио

Аудио предоставляет кнопки записи и выгрузки аудиофайла. Раздел Проверка позволяет создателю опроса задать максимальную продолжительность записываемых аудиофайлов или указать ее в качестве обязательного вопроса.

Этот тип вопросов работает аналогично вопросу Аудио в Survey123 Connect.

Загрузка файла

Загрузка файла предоставляет кнопку для выбора файла на устройстве. Раздел Проверка позволяет дизайнеру опроса задать допустимые типы файлов, сначала по категории (Документ, Архив или по выбору пользователя), а затем или по списку с отметками, или по списку расширений файла с разделителями-запятыми. Вы можете разрешить пользователю отправлять несколько файлов в одном ответе на вопрос, максимум до 99.

Этот тип вопросов работает аналогично вопросу file в Survey123 Connect.

Подпись

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

Этот тип вопросов работает аналогично вопросу image с оформлением signature Survey123 Connect.

Адрес

Тип Адрес предоставляет текстовое окно для ввода адреса. Начните вводить адрес, и появится несколько вариантов автозаполнения, предлагающих местоположения на основе сервиса локатора, установленного для вопроса. Если он не задан, вопрос будет использовать выбранный вашей организацией локатор, которым по умолчанию является ArcGIS World Geocoding Service. Вы можете задать этот вопрос, чтобы либо отправить выбранный адрес, выбранный в виде текста, либо отправить выбранный адрес в виде текста и его местоположение в виде точечной геометрии. Вопрос типа Карта уже есть в опросе, и вы можете отправить адрес только как текст.

Этот тип вопросов работает аналогично текстовому вопросу с оформлением геокодирования в Survey123 Connect.

Карта

На карте будет специальный интерфейс для пользователя, который позволит указать точку, линию или полигон. Выберите тип геометрии и стиль рисования, которые будут использоваться в опросе. Указанный тип геометрии будет применяться к используемому в опросе векторному слою. После публикации изменить его будет нельзя, а стиль рисования можно поменять в любое время. Настройки Карты и экстента позволяют выбрать онлайн базовую карту, экстент по умолчанию, и используемый вопросом сервис локатора. Существует также возможность гарантировать, что местоположение пользователя будет получено только при первом взаимодействии с вопросом.

Примечание:

Если для вопроса типа Карта установлена отметка Не отправлять ответ, тип геометрии не будет использоваться для базового векторного слоя, и вы можете изменить его после публикации.

Этот тип вопроса эквивалентен в Survey123 Connect вопросам типа Геоточка, Геотрассировка и Геоформа. Следующие функции поддерживаются полевым приложением Survey123, но не поддерживаются веб-приложением:

  • Автономные базовые карты.
  • Усреднение местоположения для вопросов типа геоточка.
  • Символы геоточек.
  • Пороговые значения и выражения точности определения местоположения.
  • Все свойства pulldata("@geopoint"). Веб-приложение поддерживает только свойства x, y, z, horizontalAccuracy, verticalAccuracy, speed и direction.
  • Вычисления для вопросов типа Геотрассировка и Геоформа, в том числе функция sum().
  • Опции стиля для вопросов типа Геотрассировка и Геоформа.

Ранжирование

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

Этот тип вопросов работает аналогично rank вопросу в Survey123 Connect.

Email

Тип Email представлен в виде ограниченного текстового поля автоматически отклоняющего любой ответ, который представлен не в формате адреса email. Для этого типа вопросов есть только дополнительные опции, позволяющие объявить его обязательным вопросом или кэшировать ответ для будущих респондентов.

Этот тип вопросов не работает аналогично вопросу email в Survey123 Connect. Вместо этого он действует как вопрос типа text с примененным регулярным выражением.

Веб-сайт

Веб-сайт предоставляет ограниченное текстовое поле, автоматически отклоняющее любой ответ. Который не является URL веб-сайта. Для этого типа вопросов есть только дополнительные опции, позволяющие объявить его обязательным вопросом или кэшировать ответ для будущих респондентов.

Этот вопрос действует как вопрос типа text с примененным регулярным выражением.

Примечание

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

Этот тип вопросов работает аналогично вопросу примечания в Survey123 Connect.

Группа

Группа – элемент, в который можно перетащить вопросы. Эта группа является сворачиваемой, при этом вкладка Редактировать предоставляет этой группе возможность быть свернутой по умолчанию.

Этот тип вопроса работает аналогично паре групповых вопросов начала и окончания в Survey123 Connect.

Страница

Создает отдельную страницу для вопросов, как созданных внутри, так и перенесенных внутрь. Панель дизайна предоставляет опции для дублирования страницы или слияния с другой.

Этот тип вопросов работает аналогично паре групповых вопросов начала и окончания с использованием стиля страниц в Survey123 Connect.