Выгрузка результатов

Запрос массива

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

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

1. Счётчик, по которому будет производиться отбор интервью для выгрузки. Если счётчик не указан - будет выгружен пустой массив (макет).
2. Формат выгрузки массива. Доступны следующие варианты:
   • SPSS Data (.sav) - формат IBM SPSS Statistics.
   • Excel (.xlsx) - формат Microsoft Excel версии 2007 и новее.
   • Excel (.xls) - формат Microsoft Excel старых версий (до 2003 включительно).
   • Text (.csv) - универсальный текстовый формат CSV.
3. Кодировка файла SPSS. По умолчанию Windows-1251, можно выбрать UTF8.
4. Период выгрузки. Доступны следующие варианты:
   • Все данные - выгружаются все данные с самого начала проекта.
   • За сегодня - выгружаются интервью, дата начала которых - сегодня.
   • За вчера - выгружаются интервью, дата начала которых - вчера.
   • За дату - выгружаются интервью в указанную дату начала.
   • За период - выгружаются интервью, начатые в течение указанного периода.
5. Дата начала периода.
6. Время начала периода.
7. Дата окончания периода.
8. Время окончания периода.

После отправки запроса на выгрузку массива он будет добавлен в очередь на обработку, и его состояние (обновляется автоматически) можно посмотреть в таблице:

У каждого запроса отображается его состояние:

• В очереди - запрос ожидает обработки.
• Обработка - запрос находится в процессе обработки.
• Успешно - запрос успешно обработан, без ошибок.
• Ошибка - при обработке запроса были обнаружены ошибки, и выгрузка не была произведена. Подробнее об ошибках выгрузки можно почитать ниже.
• Предупреждение - запрос обработан, но при этом были обнаружены ошибки (такое возможно, если включен флаг Игнорировать ошибки при выгрузке).

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

Журнал обработки запроса

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

Колонки массива

Помимо ответов на вопросы анкеты, любой массив содержит стандартные данные:

• ID - идентификатор респондента.
• UserID - идентификатор пользователя, который провёл интервью.
• UserName - имя пользователя.
• UserLgIn - логин пользователя.
• IVDate1 - дата и время начала интервью.
• IVDate2 - дата и время окончания интервью.
• IVDur - длительность интервью в секундах. В телефонных опросах здесь будет указана длительность последнего интервью (из-за перезвонов их может быть несколько).
• Phone - номер телефона респондента (если проект телефонный).

При выгрузке массива с некоторыми флагами или установленными параметрами в свойствах проекта также будут добавлены:

• URL - ссылка на просмотр интервью.
• ExtID или RespExtId - идентификатор респондента, полученный из внешней системы (из параметра extid рабочей ссылки).
• ContractorName - название подрядчика, который провёл интервью.
• ContractorCode - код подрядчика (если присвоен ему).
• Result - результат интервью.
• IVDurAll - общая длительность всех интервью респондента.
• IVCnt - общее количество интервью респондента.
• IPAddress - IP-адрес респондента или оператора.
• UserAgent - User Agent браузера или Android-приложения.
• IVREC - ссылка на аудиозапись с планшета. Если включена запись отдельных вопросов, а не всего интервью, аналогичные столбцы с названиями вида ВОПРОС_REC (Q21_REC) будут находиться после столбцов с ответами на эти вопросы.
• IVLAT и IVLONG, а также ВОПРОС_LAT и ВОПРОС_LONG - широта и долгота - GPS-координаты места опроса.
• IVADDR, а также ВОПРОС_ADDR - автоматически определённый по GPS адрес места опроса.
• VComment - комментарии, оставленные проверяющим во время контроля интервью.
• VUserName - имя пользователя, проводившего контроль интервью.
• VUserLogin - логин пользователя, проводившего контроль интервью.
• VStarted - дата и время начала проведения контроля.
• VEnded - дата и время окончания проведения контроля.
• VDuration - длительность контроля в секундах.
• ВОПРОС_ATT1, ВОПРОС_ATT2… - прикреплённые к вопросу файлы. Например, Q9_ATT1, Q9_ATT2, Q9_ATT3.
• ВОПРОС_SIGN - прикреплённая к вопросу подпись респондента. Например, Q86_SIGN.
• ВОПРОС_DUR - длительность ответа на вопрос в секундах. Например, Q2_DUR.
• IVLocSpoof - результат проверки на возможную подделку GPS-координат в приложении. Может быть один из следующих вариантов:
  • Не обнаружено - никаких подозрений на подмену координат не обнаружено.
  • Разрешено на устройстве - в системных настройках устройства разрешена подделка координат, но, скорее всего, она не использовалась.
  • Установлено ПО - на устройстве установлено приложение для подделки координат, но, скорее всего, оно не использовалось.
  • Запущено ПО - во время интервью на устройстве было запущено приложение для подделки координат, но признаков их изменения не обнаружено.
  • Подделано - координаты точно были подменены.
• IVTimeOffset - количество минут, на которое время на планшете отличалось от точного.
• IVRealDate1 - реальные дата и время начала интервью (IVDate1 + IVTimeOffset).
• IVDeviceId - идентификатор устройства (Андроид), на котором проведено интервью (в приложении).
• IVSendDelay - время в минутах между завершением интервью в приложении и сохранением в базу данных сервера.

Возможные ошибки выгрузки и способы их исправления

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

Ошибка при подготовке списка полей массива для вопроса QXXX: Колонка с именем "X" уже существует в массиве

Ошибка при подготовке списка полей массива для вопроса QXXX: Недопустимое имя переменной "X" для вопроса QXXX

Ошибка при подготовке списка полей массива для вопроса QXXX: Индекс (отсчитываемый от нуля) должен быть больше или равен нулю, но меньше размера списка аргументов

Ошибка при подготовке списка полей массива для вопроса QXXX: Input string was not in a correct format

Ошибка при создании переменной X

SPSS function spssSetVarName for X returned error code SPSS_INVALID_VARNAME

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

Для выгрузки в Excel (*.xls) максимально допустимое количество колонок - 256

При запросе массива был выбран формат *.xls, который не поддерживает больше 256 столбцов, а в выгружаемом массиве их больше, поэтому нужно выбрать другой формат.

Ошибка при подготовке списка полей массива для вопроса QXXX: Элемент с тем же ключом уже был добавлен

Ошибка при подготовке списка полей массива для вопроса QXXX: An item with the same key has already been added. Key: 0

Это очень редкая ошибка, и связана она с выгрузкой ответов вопроса с множественным выбором в альтернативном режиме, если у одного из ответов есть код 0. В этом режиме код выбранного ответа записывается в своё поле, а если ответ не выбран, ставится ноль. И если у варианта ответа код 0, то получается наложение: ноль означает, что ответ не выбран, и одновременно ноль – это выбранный ответ. Поэтому такие вопросы нужно выгружать в другом режиме.

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