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

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

Элементы опроса

Опции на вкладке Добавить в веб-дизайнере Survey123 позволяют управлять видимостью следующих элементов:

• Заголовок опроса—заголовок появляется в верхней части формы, он может быть текстом или изображением. Для заголовка изображения укажите URL изображения, которое хранится онлайн, либо загрузите файл изображения.
• Описание опроса—описание появится ниже заголовка и может содержать отформатированный текст, ссылки или изображения.
• Нижний колонтитул опроса—нижний колонтитул появляется под кнопкой Отправить в виде гиперссылки. Введите текст и URL для гиперссылки.
• CAPTCHA - CAPTCHA – это тест, отображаемый в конце формы, который пользователи должны пройти перед отправкой ответа. Пользователи решают CAPTCHA, вводя символы, показанные на изображении. Вы можете изменить текст, который появляется над CAPTCHA, щелкнув его в предварительном просмотре формы. CAPTCHA можно включить при использовании https://survey123.arcgis.com/ и он поддерживается в веб-приложении Survey123. CAPTCHA невозможно настроить, если веб-сайт Survey123 установлен в вашей инфраструктуре, и он не поддерживается в полевом приложении 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. Сюда относятся Многострочный текст, Ниспадающий список и Шкала Лайкерта.

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

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

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

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

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

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

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

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

Дата, число, текст и время

Следующие типы вопросов позволяют пользователям вводить ответы или выбирать дату и время.

Дата

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

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

Дата и время

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

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

Email

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

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

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

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

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

Число

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

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

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

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

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

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

Время

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

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

Веб-сайт

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

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

Выбор

Следующие типы вопросов позволяют пользователям выбирать ответ из списка вариантов. Способ представления вариантов зависит от типа вопроса.

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

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

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

Примечание:

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

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

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

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

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

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

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

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

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

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

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

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

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

Рейтинг

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

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

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

Один вариант ответа

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

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

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

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

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

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

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

Местоположение

Следующие типы вопросов позволяют пользователям указать местоположение либо на карте, либо путем ввода адреса.

Адрес

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

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

Карта

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

Примечание:

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

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

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

Медиа и файлы

Следующие типы вопросов позволяют пользователям захватывать или загружать мультимедиа и файлы.

Аудио

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

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

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

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

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

Изображение

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

Внимание:

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

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

Подпись

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

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

Отображение и структура

Следующие типы вопросов позволяют пользователям управлять компоновкой формы опроса.

Группа

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

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

Примечание

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

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

Страница

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

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