Подготовка к редактированию существующих данных опроса

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

Включить редактирование

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

Вы можете отредактировать ранее отправленные опросы, которые существуют в полевом приложении Survey123 в папке Отправленные. Для получения информации о том, как настраивать опции отправления опросов см. Папка Отправлено.

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

Внимание:

Включение папки Входящие разрешает доступ на чтение к данным опроса, что позволяет увидеть ответы. Дополнительные сведения и рекомендации для защиты данных см. в разделе Защита опроса.

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

Редактирование опроса включено в

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

Примечание:

Входящие теперь может содержать максимум 5,000 ответов на вопросы. Это ограничение применяется только к родительским записям опроса (к повторам не применяется).

Чем больше записей должно быть возвращено, тем дольше занимает обновление Входящих. Для опроса, который содержит повторы, убедитесь, что общее число записей во Входящих получаемых при обновлении, может быть больше, чем число родительских записей. Например, если векторный слой содержит 2000 родительских записей, а у каждой родительской записи 10 повторяющихся, то во Входящих появится 22 000 записей. Вы можете ограничить число родительских записей, применив выражение запроса или пространственный фильтр. Вы можете ограничить число повторяющихся записей, настроив запрос в столбце bind::esri:parameters.

Внимание:

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

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

Выражения WHERE

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

Выражения запросов должны использовать общепринятый синтаксис SQL и функции, поддерживаемые ArcGIS. Все запросы запускаются для векторного слоя опроса, так что вы можете построить и протестировать выражение с помощью операции запроса для конечной точки REST векторного слоя. Дополнительные сведения об этом процессе с примерами синтаксиса запросов см. в Запрос – сервис объектов. Более подробно см. Стандартизированные функции SQL в ArcGIS Online для получения дополнительной информации о поддерживаемых функциях.

Ниже приведены примеры использования и синтаксиса:

  • В этом примере возвращаются опросы, в которых число в поле rating больше или равно двум:

    rating>=2

  • Этот пример возвращает опросы, в которых дата в поле EditDate - 13 апреля 2017 или более поздняя.

    EditDate>='2017-4-13'

  • Этот пример возвращает опросы, в которых поле Editor равно 'BKlauser':

    Editor='BKlauser'

  • Этот пример возвращает опросы, где поле status равно 'for_review':

    status='for_review'

  • Этот пример возвращает опросы, в которых в поле inspection_date - дата за последние семь дней:

    inspection_date>CURRENT_DATE-7 AND inspection_date<=CURRENT_DATE

  • Этот пример возвращает опросы, в которых поле project_status не равно 'complete':

    project_status<>'complete'

  • Этот пример возвращает опросы, в которых поле final_approval пустое (null):

    final_approval IS NULL

  • Этот пример возвращает опросы, в которых поле final_approval не пустое (null):

    final_approval IS NOT NULL

Запросы входящих данных также поддерживают переменную username. Эти переменные должны быть указаны в том же формате, что и выражения XLSForm. Например, запрос Creator=${username} возвратит все записи, созданные текущим вошедшим пользователем.

Примечание:

Переменная username — единственный случай, когда синтаксис XLSForm можно использовать во входящем выражении запроса. Несмотря на то что переменная username должна быть записана как ${username}, ее значение берется из учетной записи пользователя ArcGIS, вошедшего в систему, а не из вопроса в опросе.

Чтобы вернуть записи для вошедшего в систему пользователя из поля, содержащего список нескольких пользователей, в запросе необходимо использовать функцию POSITION(). Например, запрос POSITION(${username} IN assigned_to) > 0 возвратит все записи опроса, включающие вошедшего в систему пользователя, где значения в поле assigned_to могут представлять собой разделенный запятыми список всех возможных назначенных пользователей, например 'George_Smith, Nick_Jones'.

Пространственный фильтр

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

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

Вкладка Карта для пространственных фильтров

Повторы

Survey123 позволяет редактировать объекты, у которых есть связанные записи из полей Входящие или Отправленные. Можно добавлять новые записи и редактировать имеющиеся, но удаление существующих записей не поддерживается. Редактирование существующих записей по умолчанию отключено, если не разрешено allowUpdates=true с помощью параметра запросов.

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

По умолчанию, из папки Входящие или Отправленные не доступны ни какие связанные записи с ответами на опрос. Чтобы получить доступ к связанным записям ответа, введите запрос в столбце bind::esri:parameters для типа вопроса begin repeat. Свойство запроса поддерживает такие же параметры, как указанные выше выражения WHERE, например, query="Editor='BKlauser'", для загрузки связанных записей только со значением 'BKlauser' в поле Редактор.

Чтобы загрузить все записи в связанной таблице, введите запрос без параметров (query).

К другим параметрам, которые могут применяться к повторам через столбец bind::esri:parameters в типе вопроса begin repeat, относятся:

  • query – позволяет выполнять запросы и загружать записи в связанную таблицу , например, query="severity='high'".
  • allowAdds — позволяет добавлять к повтору новые записи при редактировании. Значением по умолчанию является true. Значение false вводится с помощью allowAdds=false.
  • allowUpdates — позволяет обновлять имеющиеся записи повтора при редактировании. Значением по умолчанию является false. Значение true вводится с помощью allowUpdates=true.

Несколько пар ключевых значений можно использовать вместе, разделяя их пробелами, например, allowUpdates=true query="Editor='BKlauser'". Если сами значения содержат пробелы, их необходимо взять в кавычки.

Изображения

Survey123 позволяет пользователю добавлять к существующим записям опроса изображения. Хотя редактирование существующих изображений не поддерживается, каждый вопрос типа Изображение содержит кнопку Дублировать при редактировании опроса, позволяющую скопировать имеющееся изображение, которое можно редактировать путем поворота, переименования или редактирования с использованием оформления draw и annotate.

Выбор новых изображений по умолчанию включен. Чтобы отключить эту возможность, введите allowAdds=false в столбце bind::esri:parameters.

Есть ряд ограничений редактирования изображений:

  • Автономные рабочие процессы не поддерживаются.
  • Оформление signature не поддерживает функцию Дублировать.
  • Вложения изображений используют свойства ключевых слов, чтобы связать изображение с вопросом, на который оно было отправлено. Свойства ключевых слов не поддерживается версиями ArcGIS Enterprise ранее 10.8.1, поэтому изображение, отправленное для опроса, который публикуется на портале ArcGIS Enterprise версии до 10.8.1, не будет связано с вопросом. Аналогично, изображения, прикрепленные к объекту не при помощи опроса (например, в ArcGIS Pro или на веб-карте ArcGIS Online), могут не содержать ключевых слов.
  • Когда существующий опрос загружается на устройство для использования из папки Входящие, существующие изображения не загружаются. Функция count-selected будет подсчитывать только изображения, находящиеся на устройстве, и возвратит 0 при первом открытии опроса. Учитываться будут все вновь полученные изображения.