ArcGIS Survey123 поддерживает множество XLSForm спецификаций В этом справочнике приведено описание объектов XLSForm, которые могут использоваться в Survey123. Опросы можно создавать вSurvey123 Connect или Survey123 веб-сайте; некоторые возможности доступны только на одном из этих них, а некоторые – на обоих.
Типы вопросов
В следующей таблице представлены типы вопросов, доступные в Survey123 Connect, в полевом приложении Survey123, веб-дизайнере Survey123 и веб-приложении Survey123. На разных платформах по некоторым вопросам существуют различия с точки зрения поведения и реализации; о различиях читайте в примечаниях после таблицы.
| Survey123 Connect типы вопросов | Survey123 тип вопроса веб-дизайнера | Описание | Поддерживается в полевом приложении Survey123 | Поддерживается в веб-приложении Survey123 |
|---|---|---|---|---|
| аудио⁴ | Аудио⁴ | Записывает аудиоклип в полевом приложении. Записывает аудиоклип или берет выгруженный аудиофайл в веб-приложении. | Да | Да |
| barcode | Сканирует штрих-код или QR-код | Да | Да | |
| begin group | Начинает группу вопросов. | Да | Да | |
| begin repeat | Начинает группу повторяющихся вопросов. | Да | Да | |
| вычислить | Н/Д | Выполняет калькуляцию значений по форме. Вычислить поле содержит результат калькуляции. | Да | Да |
| десятичное¹ | Ввод десятичных знаков. | Да | Да | |
| date | Ввод даты. | Да | Да | |
| dateTime | Ввод даты и времени. | Да | Да | |
| deviceid | Н/Д | UUID определенного устройства, на котором производился опрос. | Да | Нет |
| email² | Н/Д | При входе под учетной записью организации в это поле автоматически заносится электронный адрес почты этой учетной записи. | Да | Да |
| окончание | Н/Д | Дата и время окончания опроса. | Да | Да |
| end group | Завершает группу вопросов. | Да | Да | |
| end repeat | Завершает группу повторяющихся вопросов. | Да | Да | |
| файл | Принимает файл на устройстве. | Да | Да | |
| 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 именем файла, расположенного в папке мультимедиа опроса, который содержит список вариантов. | Да | Да |
| начало | Н/Д | Дата и время начала опроса. | Да | Да |
| text | Адрес⁶, Email⁶, Многострочный текст⁵ ⁶, Однострочный текст⁶, Веб-сайт⁶ | Ответ в произвольной форме. Для Email и веб-сайт применяется регулярное выражение. Вид геокодирования применяется к адресу. | Да | Да |
| время | Ввод данных о времени. | Да | Да | |
| 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.
Специальные символы
Имена вопросов и ответов не должны содержать специальные символы, как-то пробелы, запятые, дефисы, круглые скобки, квадратные скобки и такие символы, как $, % и #. Важно, чтобы имена вариантов ответов для вопросов с несколькими вариантами ответов не содержали пробелов или запятых.