WoDo : 2. Файл для загрузки опросников (quests)

Наименование файла должно иметь следующий формат: <КОД КОНТРАГЕНТА>_quests_<остальной текст>.<xls или xlsx>.
Название контрагента должно быть указано латиницей.
Пример:

Пример заполненного файла _quests_для загрузки в систему "Test_quests_пример" 

Опросник может быть любого содержания в зависимости от потребностей производителя.
Поля обязательные для заполнения выделены синим цветом:

1. ID опросника - уникальный идентификатор опросника. Идентификатор используется для привязки опросника к Торговой точке.
   Для изменения содержания опросника нужно подать файл с указанием ID опросника.
2. Название опросника - наименование опроса будет отражено в мобильном приложении. Все опросники, кроме типа "Аудит", объединяются в Регулярную анкету.
3. Тип опросника - Аудит или Анкета (если указано другое значение или пусто - по умолчанию будет установлен тип Анкета).
4. Категория опросника - Дополнительное поле, для объединения опросников в категории.
5. Однократно - поле регулирует однократное отображение опроса в опроснике (поле устарело, не используется, не заполняется при подаче файла quests).
6. Начало - дата начала старта анкеты, регулирует с какой даты вопрос опросника становится активным. Дата подается в формате: дд-мм-гггг чч:мм:сс.
7. Окончание - дата начала завершения анкеты, регулирует по какую дату вопрос опросника активный (если текущая дата больше, чем дата указанная в поле "Окончание", вопрос опросника не отображается в визите). дата подается в формате: дд-мм-гггг чч:мм:сс.
8. * Шаг визита - указывается цифрами последовательность активностей для отображения в мобильном приложении.
   * <При формировании опросника возможно разделение его на шаги. Если для контрагента включена настройка "Отображать номер шага перед заголовком опросника в визите", то в мобильном приложении заголовки будут отображаться по возрастанию в зависимости от числового порядка шагов. Каждый шаг может содержать 1 и более вопросов или действий. Текст вопроса должен содержать не менее 5 символов. Пример: дата отсчета 01.09.22, кол-во дней 7, кол-во визитов 1, в первый визит. Т.е каждые 7 дней с 01.09.22, 1 раза опросник будет обязательным>.
   
9. Заголовок шага (экрана) опросника - первый уровень анкеты, служит для объединения вопросов анкет.
10. Подзаголовок шага (экрана) опросника - второй уровень анкеты, служит для объединения вопросов в групп.
11. Под подзаголовок шага (экрана) опросника - третий уровень анкеты, служит для объединения вопросов в группу.
12. Шаг (экрана) опросника - свайп - четвертый уровень анкеты, служит для объединения вопросов в группу (последний уровень в моб приложении отображается как экран, значения на котором меняются при помощи свайпа)
13. Текст вопроса - текст вопроса для опросника.
14. Тип ответа - тип ответа из возможных типов:
    1. %
    2. число
    3. целое число
    4. цена
    5. варианты ответов
    6. комментарий
    7. фото - указывать только фото. На текущий момент, если в шаблоне будет указан не существующий тип, вопрос создастся с типом “комментарий”.
    8. да/нет
    9. вычитание
    10. сложение
    11. деление
    12. умножение
    13. дата
    14. множественный выбор
    15. <пусто> - если тип не указан, тогда тип = комментарий
        В случае ошибки в данном поле, при загрузке файла будет указан соответствующий комментарий в разделе "Ошибки импорта".
15. Варианты ответов - варианты ответов указываются через разделитель |. Для типа фото вариант ответа не указывается (поле останется пустым).
16. Связанный вопрос - связанные вопросы указываются через разделитель | . Колонка необязательная для заполнения,  используется только для связи с другими вопросами, указанных в файле, в рамках общего Заголовка одного Опросника. Вопросы не должны иметь идентичное название, в противном случае привязка зависимых вопросов не произойдёт.
17. Обязательность вопроса - 1, “да” - обязательно, иначе - необязательно.
18. Добавить фото к ответу -  1, “да” - добавить фото, иначе - без фото.
19. Кол-во обязательных фото - указание обязательного количества фото от 0 до 10. 
20. Запрет удаления фото - . 1 - запрещать удалять фотографии. 0 или пусто - разрешать удаление фотографий. 
21. Значение от - указание порога значения, меньше которого установить число будет невозможно.
22. Значение до - указание порога значения, больше которого установить число будет невозможно.
23. Признак предзаполненного вопроса - признак, при котором предзаполненный ответ учитывается.
24. Предзаполненный ответ - ответ для вопроса опросника, учитывается независимо от ответа исполнителя.
25. Категория - значения, используются только для формирования отчета Astix.
26. Планограмма - уникальное наименование планограммы, для привязки Планограммы к Вопросу (п.10)
27. Обязательность планограммы - ставим 1, если планограмма обязательна, ставим 0, если не обязательна. 
28. * Дата отсчета - дата появления опросника у исполнителя.
29. * Количество дней - продолжительность актуальности опросника.
30. * Типы отображения - момент появления опросника, ставим 1 – если опросник должен появиться в первый визит, 0 или пусто – последний.
31. * Кол-во визитов - указывается кол-во визитов за установленный период.
    * <Этой настройкой задается период отсчета от указанной даты, в котором указывается в первый или в последний визит, попавший в этот период, опросник будет обязательным. В мобильном приложении в первый плановый визит на точку опросник будет показан обязательным. Далее, если визит не состоялся или по опроснику не были получены результаты, обязательность будет перенесена на следующий плановый визит и так пока не будет получено столько результатов опросника, сколько указано для кол-ва обязательности>.
    
32. Отображение: кол-во визитов в месяц - позволяет задать требуемое количество дней отображения опросника в рамках текущего календарного месяца. Подсчет количества визитов ведется в рамках заданного ограничения видимости, в случае если ограничение не задано то учитываются только визиты выполненные мерчандайзером.
    
33. Тип активности Astix - для корректной отправки категорий и брендов в Астикс.
    1. 0 - в Astix не отправлять
    2. 1 - Share of Shelfs
       
    3. 2 - Check-outs
       
    4. 3 - Промо дисплеи (Display)
       
    5. 4 - Промо дисплеи (Display Local)
       
34. Ограничение видимости - отображение опросов в мобильном приложении для ролей Мерчандайзер и Стажер.
    1. Стажёр/Стажер - если опрос должен отобразится в мобильном приложении только для роли Стажер (Внимание! Пользователь с ролью Стажер будет активен в том случае, если ему так же будет установлена роль Мерчандайзер);
    2. Мерчандайзер - если опрос должен отобразится в мобильном приложении только для роли Мерчандайзер;
    3. Оставить поле пустым - если необходимо чтобы опрос отображался в мобильном приложении и для роли Мерчандайзер, и для роли Стажер.

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

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

Если файл visits по какой либо причине перепадали в систему, то файл quests для пересчёта обязательности опросов подавать сверху не надо. Пересчет обязательности будет выполняться автоматически в опросниках после загрузки/перегрузки визитов на точку через файл visits и портал.