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

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

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

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

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

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

Да

Да

barcode

Н/Д

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

Да

Да

begin group

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

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

Да

Да

begin repeat

Н/Д

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

Да

Да

calculate

Н/Д

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

Да

Да

десятичное¹

Число¹ ⁶

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

Да

Да

date

Дата⁶

Ввод даты.

Да

Да

dateTime

Дата и время⁶

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

Да

Да

deviceid

Н/Д

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

Да

Нет

email²

Н/Д

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

Да

Да

end

Н/Д

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

Да

Да

end group

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

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

Да

Да

end repeat

Н/Д

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

Да

Да

file

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

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

Да

Да

geopoint³

Карта³ ⁶

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

Да

Да

geoshape³

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

Да

Да

geotrace³

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

Да

Да

hidden

Н/Д

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

Да

Да

целое число¹

Число¹ ⁶

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

Да

Да

image

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

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

Да

Да

note

Примечание⁶

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

Да

Да

диапазонБегунок⁶

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

Да

Да

rank list_name

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

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

Да

Да

select_one list_name

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

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

Да

Да

select_one_from_file file_name.csv

Н/Д

Вопрос с несколькими вариантами ответов; допускается выбрать только один из вариантов. Замените file_name.csv именем файла, расположенного в папке мультимедиа опроса, который содержит список вариантов.

Да

Да

select_multiple list_name

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

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

Да

Да

select_multiple_from_file file_name.csv

Н/Д

Вопрос с несколькими вариантами ответов; допускается выбрать несколько вариантов ответов. Замените file_name.csv именем файла, расположенного в папке мультимедиа опроса, который содержит список вариантов.

Да

Да

start

Н/Д

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

Да

Да

text

Адрес⁶, Email⁶, Многострочный текст⁵ ⁶, Однострочный текст⁶, Веб-сайт⁶

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

Да

Да

time

Время⁶

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

Да

Да

username

Н/Д

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

Да

Да

¹Веб-дизайнер объединяет вопросы integer и decimal в один тип вопросов с именем Number. Опция в свойствах вопроса позволяет дизайнеру опроса задать необходимые входные данные.

²Вопросы типа email, представленные в Survey123 Connect и в веб-дизайнере Survey123, реализованы по-разному. Реализация в Survey123 Connect автоматически заполняется адресами электронной почты пользователей с учетной записью организации, с которой выполнен вход. Реализация в веб-дизайнере Survey123, наоборот, является текстовым полем, которое принимает только форматирование, соответствующее адресу электронной почты.

³Вопросы типа geopoint, geotrace и geoshape были объединены в один тип, который называется Карта. Опция в свойствах вопроса позволяет дизайнеру опроса задать необходимые входные данные. Новый тип вопроса "Адрес" позволяет отправлять геокодированные точки.

⁴Вопросы Аудио не поддерживают выгрузку в полевое приложение Survey123, как в веб-приложении. Чтобы разрешить выгрузку аудио в полевое приложение, используйте вопрос File.

⁵Несколько доступных видов оформлений в Survey123 Connect представлены взамен доступных типов вопросов в веб-дизайнере Survey123. Сюда относятся Многострочный текст, Ниспадающий список и Шкала Лайкерта.

Для каждого вопроса в веб-дизайнере предусмотрена возможность кэшировать ответ. В веб-приложении после отправки записи опроса ответ на вопрос будет кэширован в браузере и предварительно загружен в следующую отправку, сделанную для этого опроса на этом устройстве. Кэширование ответа можно настроить для всех типов вопросов, кроме Аудио, Изображения, Загрузки файла и Подписи.

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

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

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

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

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

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

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