Значение переменной пользовательского ввода проекта заполняется пользователем приложения и может быть применено к одной или нескольким кнопкам в проекте. Пользователь приложения вводит значение, однако автор проекта должен определить кнопки и поля, к которым будет применяться переменная.
Для переменной пользовательского ввода проекта применяется следующее:
- Для каждого проекта можно определить до трех переменных пользовательского ввода проекта.
- Ее значение вводится пользователем перед нажатием кнопки. Если пользовательский ввод задан как обязательный, пользователю будет предложено ввести это значение при запуске проекта, но он может изменить его в любое время.
- Ее значение может быть применено к любым текстовым полям в любых кнопках.
- Ее значение может быть применено к текстовому или целочисленному полю, с заданным доменом кодированных значений.
- Она не может быть применена к текстовому полю, с заданным интервальным доменом.
Свойства переменной пользовательского ввода проекта следующие:
- Надпись – текст, который будет отображаться в качестве заголовка страницы пользовательского ввода проекта в приложении.
- Тип ввода - может быть однострочный, многострочный текст или список выбора. Для списков выбора вы определяете значения и можете разрешить свободный ввод текста. Используйте динамический список выбора для заполнения значений из полей в слое запроса или таблице, которые вы добавляете в проект.
- Применить подсказку – отображение текста подсказки на странице пользовательского ввода проекта в приложении.
- Применить маску ввода – определите формат ввода данных, используя буквы и символы для определения маски ввода.
- Показать сканер штрих-кода — используйте сканер штрих-кода в диалоговом окне ввода для ввода текстового поля.
Примечание:
Поддерживаются следующие форматы: QR CODE, UPC A, UPC E, EAN 8, EAN 13, CODE 39 и CODE 128.
- Обязательно - определяет, должен ли пользователь мобильного приложения указывать входное значение перед тем, как он сможет нажать любую другую кнопку. Если это не требуется, пользователь может дополнительно ввести значение ввода пользователя, выбрав кнопку редактирования (рядом со значением ввода пользователя, отображаемым в верхней части экрана) и введя значение.
Примечание:
При применении значения ввода пользователя к векторному слою с обязательными полями убедитесь, что его свойство Обязательно имеет значение «истина», чтобы избежать ошибок отправки.
Переменная пользовательского ввода проекта создается и настраивается автором проекта на вкладке Данные для каждого поля или в элементе меню Пользовательский ввод проекта.
Чтобы назначить переменную пользовательского ввода проекта полю захвата кнопки, на вкладке Данные в раскрывающемся меню поля захвата выберите пункт Пользовательский ввод проекта.
В мобильном приложении пользователю будет запрещено вводить текст, превышающий длину поля данных.
Динамические списки выбора
Пользовательский ввод проекта может быть заполнен динамическим списком выбора, который связывается с существующим векторным слоем или таблицей. Автор может управлять содержимым списка, настраивая его свойства.
Чтобы использовать динамический список выбора, добавьте в проект слой запроса или таблицу, нажав Управление слоями проекта 
. На вкладке Запрос панели Слои нажмите Добавить, чтобы найти и выбрать один или несколько слоев или таблиц.
Примечание:
Для заполнения динамического списка выбора можно использовать векторные слои и таблицы, доступные только для чтения.
Используются следующие свойства динамических списков выбора:
- Отображаемое поле — значение, которое отображается в мобильном приложении.
- Поле значения — значение, которое хранится в слое.
- Поле сортировки — поле, используемое для сортировки динамического списка выбора.
- Порядок сортировки — по возрастанию или по убыванию.
- Режим обновления — ручной или автоматический. В ручном режиме, если пользовательский ввод задан как обязательный, список обновляется только при первом открытии проекта. Последующие обновления будут происходить только тогда, когда пользователь перейдет в конец списка. В автоматическом режиме, если пользовательский ввод задан как обязательный, список обновляется при первом открытии проекта и при редактировании пользовательского ввода.
- Фильтр — Запрос, используемый для ограничения количества значений, отображаемых в списке динамического выбора. При построении условий для предложения WHERE вы можете использовать параметры для выбора переменной устройства (username, fullName, firstName, lastName или email) или поля из выбранного слоя. Например, предполагая, что поле canvasser в выбранном слое содержит имена пользователей, чтобы отфильтровать список по значениям, которые соответствуют только имени пользователя canvasser, который в данный момент вошел в приложение, введите выражение Canvasser='${username}'.
Мобильное приложение вернет только первую страницу результатов списка, которая по умолчанию, для сервиса объектов ArcGIS Online, содержит 2000 записей.
Динамический список выбора доступен для оффлайн использования после его просмотра в мобильном приложении. Чтобы получать обновления списка, устройство должно быть подключено к сети во время перезагрузки списка.