Survey123 поддерживает вопросы select_one (выбор только одного ответа), select_multiple (выбор несколько ответов) и rank (порядок в списке).
Примечание:
Вопросы типа "ранг" в настоящий момент поддерживаются только в полевом приложении и веб-приложении.
Написание вопросов со множеством ответов требует добавления рабочего листа вариантов в рабочую книгу Excel. Ниже приводится пример вопроса select_one:
Название списка в листе опроса, yes_no, должно совпадать с названием списка в списке вариантов ответа. Это обеспечит корректное отображение списка вариантов ответов для конкретного вопроса на форме.
По умолчанию, когда опрос публикуется, варианты ответов в вопросах select_one (выбор только одного ответа) добавляются в векторный слой опроса в виде доменов кодированных значений. Вы можете не создавать домены при публикации. Подробнее см. Опции публикации.
Внимание:
Ниже приводятся ограничения использования списка выбора с повторяющимися именами вариантов:
- Повторяющиеся имена вариантов не поддерживаются для вопросов select_multiple.
- Повторяющиеся имена вариантов не поддерживаются для опросов на нескольких языках.
- Функция jr:choice-name() возвращает подпись первого дубликата в списке.
- При открытии из папок Входящие, Черновики, Исходящие, Отправленные и Обзор вопросы select_one возвращаются к первому дублирующемуся варианту в списке.
Дополнительные сведения о внесении изменений в списки вариантов ответа в существующих опросах см. в разделе Обновление опроса.
Вы также можете добавлять вопросы со множеством вариантов ответов, которые позволяют выбирать несколько вариантов ответов на вопрос, например:
По умолчанию, эти варианты появляются в порядке, в котором они идут в рабочем листе choices. Вместо этого вы можете задать случайный порядок появления этих вариантов путем ввода randomize=true в столбце параметров.
Внимание:
Все значения, собранные в вопросе select_multiple или rank, сохранены как список, разделенный запятыми, поэтому избегайте использования запятых в именах столбцов вашего списка вариантов. Также обратите внимание на то, что вопросы select_multiple и rank отправляют в векторный слой только номер варианта, а не имя и подпись, как это происходит с вопросами select_one.
Значение вопроса rank останется пустым до тех пор, пока пользователь не изменит порядок выбора. Если было задано значение по умолчанию, будет применяться порядок по умолчанию, если он не будет изменен пользователем.
Отдельный ответ на вопрос select_multiple может быть возвращен с помощью функции selected-at. В следующем случае будет возвращено значение имени для первого данного ответа на вопрос select_multiple:
selected-at(${species}, 0)
Чтобы отправить надпись для ответа, вы можете использовать функцию jr:choice-name. Чтобы получить значение надписи для второго ответа, данного на тот же вопрос select_multiple используйте следующее:
jr:choice-name(selected-at(${species}, 1), '${species}')
Оформление
Выбрав в столбце оформление значение минимальное, вы отобразите в ниспадающем меню выбор одного варианта.
При выборе для оформления значения горизонтальное вопрос для выбора вариантов будет представлен столбцами равной ширины, расположенными в горизонтальной плоскости.
Оформление compact похоже на horizontal, но использует другой метод для определения ширины столбцов , что может привести к тому, что варианты выбора будут занимать меньшее пространство.
Примечание:
В Survey123 Connect вы можете указать максимальное количество столбцов для компактного оформления, задав число, разделенное дефисом. Например, compact-3 ограничивает количество столбцов в вопросах с несколькими вариантами ответов в опросах, используемых с полевым приложением или веб-приложением, максимум тремя.
Варианты оформления compact и horizontal-compact одинаковы. В веб-приложении Survey123 вместо использования столбцов эти типы оформления отображают надписи вопроса с выбором в строках рядом, без дополнительного интервала.
Для вопроса с выбором одного варианта задание в столбце оформление значения лайкерт отображает варианты в виде шкалы Лайкерта. Шкала Лайкерта - это шкала, позволяющая респондентам указать свой уровень одобрения утверждения по шкале "одобряю - не одобряю".
При выборе оформления автозавершение вопрос с выбором одного варианта будет представлен в виде текстового поля и ниспадающего меню. Ввод текста в поле ограничивает ниспадающее меню только теми ответами, которые содержат этот текст. Это подходит для очень больших списков.
Примечание:
Оформление автозавершение для вопросов с выбором нескольких вариантов ответа поддерживается только в Survey123 Mobile. Оно не поддерживается в полевом приложении и в веб-приложении.
Задав для параметра оформление значение поиск, вы можете заполнить список вариантов ответа для вопроса с выбором значениями из таблицы CSV в папке media опроса, либо из существующего векторного слоя или таблицы. Для получения дополнительной информации см. раздел Создание динамического списка вариантов выбора с использованием оформления поиска.
Установив для параметра оформление на карта-изображение, можно отобразить вопрос с выбором в полевом приложении в виде изображения с выбираемыми областями в качестве вариантов ответа, используя файл SVG. Дополнительные сведения см. в разделе Работа с файлами SVG
Создание динамического списка вариантов выбора с использованием оформления поиска
Примечание:
В этом разделе описывается функциональность, доступная только в Survey123 Connect и полевых приложениях Survey123. Эта функциональность недоступна в Survey123 Studio или Survey123 Mobile.
Вопросы типа Выбрать один и Выбор нескольких вариантов поддерживают оформление поиск, которое можно использовать для заполнения списка значениями из таблицы CSV в папке media опроса, существующего векторного слоя или таблицы. При использовании оформления search вы все равно должны добавить запись в рабочий лист choices, но вместо перечисления всех вариантов вы укажете имя поля существующего векторного слоя или таблицы.
В следующем примере в листе choices задан список us_states, который будет использовать поле STATE_NAME для выбора имени и подписи.
В следующем примере рабочий лист опроса ссылается на этот список выбора так же, как и на другие списки выбора, но он содержит выражение оформления поиска, ссылающееся на существующий векторный слой, из которого можно получить варианты выбора.
Выражение в оформлении поиска должно быть структурировано следующим образом - с разделенными запятыми переменными:
search(tableName, searchType, searchColumn, searchText, filterColumn, filterText)Параметр tableName поддерживает либо имя файла .csv в папке media опроса, например, airports, либо URL-адрес векторного слоя или слоя картографического сервиса, которому предшествует имя Survey123 для внутренней ссылки на таблицу. Это имя таблицы необязательно должно совпадать с именем размещенного слоя, но поскольку так Survey123 внутри ссылается на ваш поиск, оно должно отличаться от всех других имен таблиц и файлов .csv, используемых в опросе. При желании вы можете добавить параметры запроса в точке доступа REST вашего векторного слоя или слоев картографического сервиса, чтобы настроить поведение поиска. В следующем примере к URL-адресу векторного слоя добавлен параметр resultRecordCount для заполнения списка первыми 10 результатами запроса, при этом поиск сохраняется внутри под именем airports:
"airports?url=https://services1.arcgis.com/e7dVfn25KpfE6dDd/arcgis/rest/services/Airports2/FeatureServer/0&resultRecordCount=10"Список выбора также можно фильтровать посредством выражения WHERE. При использовании следующего примера в качестве tableName список выбора будет отфильтрован для отображения только тех штатов, название которых не будет равно Alabama или Alaska:"state?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized_Boundaries/FeatureServer/0&where=STATE_NAME
NOT IN('Alabama', 'Alaska')"
Примечание:
Параметры поиска, содержащие специальные символы, должны быть закодированы, если опрос будет использоваться в веб-приложении Survey123. Кодировка заменяет специальные символы (например, групповой символ в выражении) знаком процента (%) с последующим их шестнадцатеричным эквивалентом.
Следующие дополнительные параметры являются необязательными, но могут использоваться для сужения результатов поиска:
| Параметр | Описание |
|---|---|
searchType | Определяет, какой тип поиска выполняется, и принимает разные значения - в зависимости от того, является ли таблица, в которой выполняется поиск, пространственной таблицей векторного слоя или непространственной таблицей - в CSV или таблице объектов. Для пространственных таблиц поддерживаются типы поиска intersects, contains, crosses, envelope_intersects, index_intercepts, overlaps, touches и within. Более подробно см. Пространственные отношения. Для непространственной таблицы поддерживаются типы поиска contains, startswith, endswith и matches. |
searchColumn | Задает столбец, в котором будет выполняться поиск текста в параметре searchText. Эти столбцы берутся из самой таблицы. Кроме того, пространственная таблица в векторном слое может выполнять поиск по столбцам @geopoint, @geotrace и @geoshape. |
searchText | Содержит текст, поиск которого будет выполняться и возвращаться в параметре searchColumn. |
Кроме того, в выражение поиска можно добавить следующие параметры фильтра для дальнейшего уточнения значений списка:
| Параметр | Описание |
|---|---|
filterColumn | Устанавливает столбец для поиска совпадений с текстом, заданным в параметре filterText. Поисковый запрос вернет только результаты, содержащие этот текст. Параметры filterColumn и filterText нужно применять вместе. |
filterText | Текст, который ищется в столбце, заданном параметром filterColumn. Параметры filterColumn и filterText нужно применять вместе. |
Ниже приведен пример выражения поиска, которое включает некоторые дополнительные параметры для оформления поиска. Оно заполняет список вариантов ответов содержимым файла .csv, используя предыдущий вопрос в качестве поискового текста.
search('csvName', 'matches', 'breed', ${DogQuestion})
Примечание:
Вопросы с оформлением поиск отображаются в веб-приложении Survey123 так же, как и вопросы с выбором и оформлением автозавершение.
Другое (укажите)
Для вопросов с несколькими вариантами ответов опрос может включать опцию для выбора ответа другое, если желаемый вариант ответа не перечислен. Респонденту будет предложено указать другую опцию. Вы можете сделать это в XLSForm вручную или с помощью встроенного метода. Встроенный метод работает быстрее и проще в настройке, чем вручную, но в нем есть ряд ограничений.
Метод Вручную
Рекомендуется использовать метод Вручную, поскольку он позволяет указать имя и метку другого варианта выбора, а также имя и метку текстового вопроса, который собирает другой ответ. Вы можете указать переводы для этих имен и меток. Вы также можете применить ограничения и оформления для текстовых вопросов и сделать их обязательными.
Для начала добавьте вариант other к списку вариантов для вопроса в рабочем листе вариантов выбора. Укажите имя и метку для этого выбора, как и для других вариантов выбора в списке. В следующем примере в списке вариантов color есть вариант с именем other.
В листе опроса добавьте текстовый вопрос, чтобы собирать ответы типа other. Добавьте соответствующее выражение, чтобы этот текстовый вопрос возникал только тогда, когда выбран вариант other. В следующем примере вопрос other_color появляется только в том случае, если ответ на вопрос select_one выбран как other.
Для опросов на нескольких языках вопросы и варианты выбора могут быть переведены. В следующем примере представлены варианты перевода French и Greek в рабочем листе опросов и для вопроса select_one, и для текстового вопроса.
Перевод также представлен в таблице выбора, включая вариант другое.
Встроенный метод
С этим встроенным методом Survey123 Studio и Survey123 Connect автоматически создает вариант "другое" и вопрос для сбора другого ответа. Чтобы использовать этот метод, введите or_other после имени списка выбора в столбце type рабочего листа опроса. Вариант Другое будет показан в списке вариантов для этого вопроса. Если выбран вариант Другое, отображается вопрос Укажите другое, позволяя пользователям ввести их собственный ответ. Чтобы сохранить этот ответ, Survey123 Studio и Survey123 Connect автоматически создает дополнительное поле в векторном слое, используя имя вопроса с несколькими вариантами ответа, к которому добавляется _other, например, favorite_toppings_other. См. пример ниже:
Внимание:
Подпись к вопросу Укажите другое не отобразится на языках, отличных от английского.
При создании опроса из существующего векторного слоя поле для вопроса Укажите другое автоматически создаваться не будет, а опрос не опубликуется. Необходимо вручную создать поле для вопроса Укажите другое в векторном слое с именем вопроса с несколькими вариантами ответа, к которому добавлено _other, например, favorite_toppings_other.
Внешние списки выбора
Вы можете сохранить списки выбора для вопросов select_one и select_multiple во внешнем файле .csv. Это идеально подходит для очень больших списков выбора, опросов с несколькими списками выбора, а также для списков выбора, которые управляются вне Survey123. Внешние списки выбора не следует путать с внешними выборками, в которых варианты должны содержаться в дополнительной таблице.
Файл .csv должен содержать столбцы с именем и надписью.
Примечание:
Если в файле .csv отсутствует заголовок столбца или в конце строк файла имеется запятая, файл не может быть импортирован в опрос.
Для получения наилучших результатов кодируйте файл .csv кодировкой символов UTF-8. Если вы используете Microsoft Excel для создания своего файла .csv, сохраните его как CSV UTF-8.
Переведенные столбцы надписей могут быть включены в файл .csv, но переведенные варианты выбора будут отображаться только в Survey123 Studio, Survey123 Connect, Survey123 Mobile и в полевом приложении, но не в веб-приложении.
Чтобы создать вопрос с внешним списком выбора, введите тип вопроса - select_one_from_file или select_multiple_from_file, - а после него - путь к файлу .csv, к примеру, select_one_from_file CoverType.csv. Имена файлов чувствительны к регистру и не поддерживают пробелы.
Есть два способа включить файл .csv: сохранить его в папку media опроса или связать с файлом .csv, размещенным в ArcGIS.
Подсказка:
Запустите инструмент Конвертировать списки выбора в CSV, чтобы автоматизировать перенос списков выбора из рабочего листа Choices в файлы .csv.
Связать с файлом .csv
Примечание:
В этом разделе описывается функциональность, доступная только в Survey123 Connect и полевых приложениях Survey123. Эта функциональность недоступна в Survey123 Studio или Survey123 Mobile.
Чтобы связать файл .csv из ресурсов ArcGIS с опросом, выполните следующие действия:
- Убедитесь, что файл .csv размещен в ArcGIS Online или ArcGIS Enterprise и имеет те же права публикации, что и опрос.
- Убедитесь, что опрос опубликован в ArcGIS до того, как начата привязка ресурсов.
- Откройте в Survey123 Connect опрос и щелкните вкладку Связанные ресурсы. Нажмите на кнопку Связанные ресурсы выберите CSV и найдите и выберите файл .csv для связывания.
Чтобы в предварительном просмотре формы отображались варианты из связанного файла .csv, на вкладке Связанные ресурсы Survey123 Connect нажмите кнопку 
. Это действие помещает копию файла .csv в папку медиа-файлов опроса. Связанные файлы автоматически загружаются вместе с опросом в приложении для полевых работ.
Если вы вручную поместите файл .csv в папку медиа-файлов опроса, а позже загрузите файл .csv с тем же именем в ArcGIS и свяжете его с опросом, файл .csv в опросе будет обновлен из связанного ресурса (если он новее).
Конвертировать списки выбора в CSV
Примечание:
В этом разделе описывается функциональность, доступная только в Survey123 Connect и полевых приложениях Survey123. Эта функциональность недоступна в Survey123 Studio или Survey123 Mobile.
Запустите инструмент Survey123 Connect Конвертировать списки выбора в CSV, чтобы автоматически перенести указанные списки выбора из рабочего листа Choices в новые файлы .csv папки media. Инструмент также изменяет соответствующие вопросы в рабочем листе Survey, чтобы использовать типы вопросов select_one_from_file и select_multiple_from_file.
Чтобы запустить инструмент, выполните следующие действия:
- Настройте среду Python в Survey123 Connect, чтобы можно было запустить инструмент. Дополнительные сведения см. в разделе Настройка Python.
- Откройте XLSForm опроса. В рабочем листе Choices добавьте столбец esri_tool_convert_csv. Добавьте значение да хотя бы в одну строку для каждого списка выбора, который вы хотите преобразовать во внешние списки выбора. Сохраните и закройте файл.
- Откройте в Survey123 Connect опрос, нажмите Инструменты и выберите Конвертировать списки выбора в CSV.
Когда преобразование завершится, файл .csv будет сохранен в папке media каждого перемещенного списка выбора. Имя файла соответствует исходному значению имени списка выбора (столбец list_name). Рабочий лист Choices обновится и будет содержать только оставшиеся списки, которые не были перенесены. Он по-прежнему содержит пользовательские заголовки столбцов из источника. В рабочем листе Survey соответствующие вопросы select_one и select_multiple заменяются на select_one_from_file и select_multiple_from_file для ссылки на новые внешние списки выбора. Исходный рабочий лист Choices сохраняется в рабочем листе choice_backup, чтобы вы могли проверить результаты или отменить их. Вы можете сохранить рабочий лист backup или удалить его.
Инструмент не преобразует списки выбора, используемые в вопросах типа Ранг, группах таблиц-списков или вопросах в виде поиска. Ни один из вопросов, в которых используются эти списки выбора, не изменяется в опросе.
Если инструмент обнаружит неподдерживаемые вопросы, в папке отладки создается файл .xlsx с именами списка затронутых списков выбора. Вы можете найти этот файл в следующей папке:
C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\convertchoicelists