Survey123 Connect будет конвертировать формы, разработанные с использованием спецификации XLSForm, в XForm для использования в Survey123 и публиковать их в ArcGIS Online или ArcGIS Enterprise. В ходе этого процесса могут возникнуть следующие проблемы.
Подсказка:
Инструмент Анализировать опрос проверяет XLSForm опроса на наличие распространенных проблем и предоставляет рекомендации для создания опроса.Ошибки конвертации форм
Когда вы создаете опрос в Survey123 Connect, вы используете спецификацию XLSForm и создаете свою форму с помощью электронной таблицы. Survey123 Connect конвертирует электронную таблицу в XForm, позволяя вам предварительно просмотреть свой опрос и увидеть, как он будет отображаться в Survey123.
Конвертация произойдет после того, как вы выполните следующие действия:
- Сохраните изменения в электронной таблице.
- Щелкните кнопку Обновить в Survey123 Connect.
Если с опросом что-либо не в порядке, то вы получите сообщение об ошибке от сервиса преобразования формы. В следующем примере в сообщении об ошибке указано, что возникла проблема с записью имени, которая называется фамилия. В данном случае запись содержит пробел. Пробел необходимо устранить или заменить нижним подчеркиванием или тире.
Некоторые наиболее часто встречающиеся ошибки форм приведены в следующей таблице:
| Описание ошибки | Диагностика |
|---|---|
Ошибка конвертации XLSForm | В приведенном выше примере эта ошибка относилась к вопросу, который называется фамилия. В том случае ошибка заключалась в наличии пробела в колонке имя. Другая общая ошибка, которая может появится в этом сообщении, это когда в колонке имя таблицы опрос или выборы используются не-ASCII символы. Символы ASCII могут использоваться в столбце label, но не в столбце name. |
[строка: 2] названия списка нет в рабочей таблице choices: [JobType] | Эта ошибка говорит о том, что один из вопросов select_one или select_multiple ссылается на список, которого нет в рабочей таблице choices. В этом примере необходимо удалить скобки. |
Для этого вопроса должны быть варианты. | Эта ошибка говорит о том, что для одного из вопросов select_one или select_multiple, в котором в качестве части типа имеется дополнительный параметр or_other, также задан фильтр вариантов. Выбор вопросов, содержащих опцию ввода значения Другой, не может использоваться в каскадной выборке. |
Ошибки сети
Если вы испытываете трудности при доступе в сервис преобразования формы, то вы получите сообщение об ошибке, аналогичное следующему:
Некоторые наиболее часто встречающиеся ошибки сети приведены в следующей таблице:
| Номер ошибки | Описание ошибки | Диагностика |
|---|---|---|
-1 | Невозможно открыть C:/Users/Username/ArcGIS/My Survey Designs/Form 1/Form 1.xlsx | Возможно, файл блокирован Excel. Убедитесь в том, что опрос не открыт в другом приложении или другим пользователем. |
3 | Хост survey123.arcgis.com не найден | Вы запустили предыдущую версию Survey123 Connect. Обновите до последней версии. |
6 | Не удалось установить SSL-взаимодействие | Существует целый ряд проблем, которые могут вызвать сбои SSL взаимодействия, включая следующие:
Вы можете протестировать сертификаты SSL, используемые веб-сервером, с помощью интерактивной программы для тестирования, такой как SSL Labs. |
99 | Время соединения истекло | Иногда наблюдается при работе с очень большими опросами. Попробуйте снова. |
202 | Ошибка при загрузке https://survey123.esri.com/api/xls2xform - ответ сервера: запрещено | Любая ошибка, сообщение о которой содержит esri.com, указывает на устаревший сервер. Обновите до последней версии. |
203 | Ошибка при загрузке https://survey123.esri.com/api/xls2xform - ответ сервера: не найдено | Любая ошибка, сообщение о которой содержит esri.com, указывает на устаревший сервер. Обновите до последней версии. |
401 | Ошибка при загрузке https://survey123.arcgis.com/api/xls2xform - ответ сервера: внутренняя ошибка сервера | Обычно, эта ошибка вызвана выражениями в столбцах релевантности или расчетов. Используйте фигурные скобки и знак $ в начале выражения. |
403 | Ошибка при загрузке https://survey123.esri.com/api/xls2xform - ответ сервера: сервис временно недоступен | Незамедлительно сообщите об этом в Esri. |
498 | Некорректный токен | Не принят токен, который Survey123 Connect пытался передать в ArcGIS. Чаще всего это вызвано тем, что URL-адрес пытается передать токен публичному векторному слою. |
499 | Ошибка при передаче https://survey123.arcgis.com/api/xls2xform - ответ сервера: ошибка прокси-сервера | Survey123 API недоступен или просрочен. Попробуйте снова через некоторое время. Если ошибка повторяется, обратитесь в группу Survey123 Esri Community для более подробной информации. |
В диалоговом окне ошибок вы можете зафиксировать эту ошибку, чтобы передать в Esri. Добавьте любую дополнительную информацию, которая могла бы содействовать устранению этой проблемы.
Ошибки публикации
Эти ошибки обычно являются следствием проблемы создания элементов из опроса в ArcGIS.
Наиболее часто встречающиеся ошибки при публикации приведены в следующей таблице:
| Ошибка | Диагностика |
|---|---|
URL-адрес не совместим (поле не найдено) | Поле с таким именем отсутствует в векторном слое заданного URL-адреса, что означает несовместимость ответов опроса с самим опросом. Либо укажите другой, новый URL-адрес, либо проверьте, корректен ли он для векторного слоя. Эту ошибку обычно вызывает дополнительное поле, которое создается при использовании опции or_other для вопросов типа select_one или select_multiple. Подробнее см. раздел Multiple choice типы вопросов. |
URL-адрес не совместим (ошибка запроса) | Проверьте, имеет ли пользователь, от имени которого вы выполнили вход в Survey123 Connect, права доступа к данному векторному слою. |
Отсутствует поле дочернего ключа в SurveyName for parent repeat_1 | Эта ошибка возникает, когда векторный слой, с которым вы работаете, использует родительские ключи Global ID, которых нет в опросе. В окне Опции публикации задайте значение true для опции Использовать родительские ключи global id в повторяющихся отношениях. |
СОЗДАНИЕ ТАБЛИЦЫ не удалось, поскольку столбец 'x' в таблице 'y' превышает максимально допустимое число столбцов 1024 | Опрос, который вы пытаетесь опубликовать, содержит больше полей, чем разрешено векторным слоем в организации ArcGIS (1024). Уменьшите число полей до менее, чем 1024, и снова опубликуйте опрос. Более подробно об этих ограничениях см. раздел Поиск и устранение проблем в справке ArcGIS Online. |
URL-адрес отправки пользовательского сервиса объектов не совместим с этим опросом (Сервис объектов не удовлетворяет требованиям для опросов с повторами - supportsApplyEditsWithGlobalIds) | Свойство supportsApplyEditsWithGlobalIds задано как false, но должно быть true. Самый простой способ сделать это – разрешить синхронизацию при публикации векторного слоя. |
URL-адрес отправки пользовательского сервиса объектов не совместим с этим опросом (Целевое отношение в таблице не найдено) | Повторная отправка отчета либо некорректно связалась с таблицей в векторном слое, или сама таблица не существует. Убедитесь, что повторная отправка выполняется с тем же именем, что и целевая связанная таблица. |
Ошибки портала
Опросы, опубликованные на ArcGIS Enterprise, имеют следующие ограничения, которые отличают их от опросов, опубликованных на ArcGIS Online.
- Вы не можете публиковать опросы на ArcGIS Enterprise, где в качестве имен полей используются определенные ключевые слова, такие как end (имена полей, в которых содержатся эти ключевые поля, приемлемы, как endSurvey, пока они не являются в прямом смысле ключевым словом). Зарезервированные ключевые слоя приведены в таблице Reserved шаблонов XLSForm Survey123.
- При публикации на ArcGIS Enterprise все имена полей должны быть в нижнем регистре.
- Максимальное количество столбцов, которое может содержать векторный слой, опубликованный на портале, зависит от вашей многопользовательской базы геоданных. Для определения ограничений по размеру обратитесь к документации по используемой вами СУБД. Если количество вопросов в вашем опросе превышает ограничение столбца для вашей многопользовательской базы геоданных, обходной путь состоит в том, чтобы включить повтор и установить repeat_count на 1, чтобы расширить опрос на несколько таблиц.
- Имя вопроса в рабочей таблице опроса не может превышать 32 символа.
- Нельзя загрузить содержание Survey123 на ArcGIS Enterprise или Portal for ArcGIS, если вы не используете ArcGIS Data Store.
- Когда ArcGIS Enterprise развернут в автономной среде, шаблоны и образцы опросов и URL-адреса Submission для отправки в векторные слои ArcGIS Online не работают.
- URL-адреса Submission не могут использоваться непосредственно с не интегрированным векторным слоем ArcGIS Server. В качестве обходного пути предлагается зарегистрировать сервис на ArcGIS Online или ArcGIS Enterprise.
- При использовании многопользовательской базы геоданных слои могут использовать сервис-ориентированную версию, но не традиционную версию. При использовании сервис-ориентированной версии базы геоданных Survey123 будет ориентироваться на версию по умолчанию. Более подробно см. в разделе Типы версий.
- esriFieldTypeDateOnly, esriFieldTypeTimeOnly, esriFieldTypeTimestampOffset и esriFieldBigInteger можно использовать только в ArcGIS Online. Эти типы полей доступны в ArcGIS Enterprise 11.2 и более поздних версий.
Включение Диагностического журналирования
Если вы обнаружите сообщения об ошибках, которые не перечислены в этом разделе, или заметите необычное поведение, целесообразно записать информацию журнала Survey123 Connect и передать ее специалистам (например, службе поддержки Esri) для поиска и устранения проблемы.
Чтобы включить журналирование, откройте меню на главной странице приложения, щелкните Настройки и нажмите на вкладку Диагностика.
Чтобы записывать сообщения в файл, щелкните переключатель Запись в журнал, чтобы включить журналирование. Окно Выходное местоположение журнала будет автоматически заполнено местоположением файла журнала по умолчанию. Путь к этому файлу можно изменить. Для записи сообщений в онлайн консоль, совместимую с протоколом syslog, введите в окно местоположении выходного журнала вместо местоположения файла журнала URL-адрес этой консоли.
Файлы журнала можно опубликовать или отправить по электронной почте. Если вы решите отправить журнал по электронной почте из приложения, в тело письма будут включены номер версии приложения, название операционной системы и языковой стандарт системы, а журнал будет включен в качестве вложения.
Примечание:
Для журналирования в режиме реального времени на вкладке Диагностика отображаются все открытые в вашей сети экземпляры консоли AppStudio. На вкладке Диагностика будет отображаться круглый символ выполнения поиска, пока не будет найдена запущенная консоль AppStudio. Если сначала вы выберете консоль AppStudio, а затем щелкнете переключатель Запись в журнал, то на соответствующей консоли начнет появляться информация журнала записей. Дополнительные сведения см. в разделе Захват с консоли в справке ArcGIS AppStudio.