Перейти до змісту

Імпорт даних

Сторінка Імпорт даних дає змогу масово завантажувати дані в form schema з файлу .xls, .xlsx або .csv. Майстер із трьох кроків — Завантажити файл, Зіставити поля, Результат — проводить вас через завантаження файлу, зіставлення його стовпців із полями форми та перегляд результату.

Головний вигляд сторінки «Імпорт даних»

Доступ до сторінки імпорту

  1. Перейдіть до списку Форми та виберіть form schema.
  2. У поданні даних форми натисніть Імпортувати форми на панелі інструментів.

Крок 1 — Завантажити файл

На першому кроці відображається зона перетягування або засіб вибору файлу.

  • Прийнятні формати: .xls, .xlsx, .csv
  • Максимальний розмір файлу: 20 МБ

Щоб завантажити файл:

  1. (Необов'язково) Залиште позначку Повторно використовувати наявні метрики з тією самою назвою (усталено), щоб будь-яка метрика у файлі, назва якої збігається з наявною в системі метрикою, була пов'язана з цією наявною метрикою, а не створювала дублікат. Зніміть позначку, щоб завжди створювати нові метрики.
  2. Перетягніть файл у пунктирну область або натисніть Вибрати файл, щоб вибрати його.
  3. Після зчитування файлу майстер автоматично переходить до кроку Зіставити поля.

Форматування файлу імпорту

Дивіться опис у розділі нижче

Прості формати файлів

Dino приймає той самий файл, отриманий під час експорту. Отже, найпростіший спосіб отримати файл, належно відформатований для імпорту, — спершу експортувати деякі дані форми з того самого form schema, а потім видалити рядки з експортованими даними, залишивши лише заголовки стовпців. У будь-якому разі переконайтеся, що заголовки стовпців зрозумілі — вони використовуватимуться як підказки під час зіставлення.

Метрики, ідентифіковані за ID

Якщо стовпець метрики у вашому файлі містить ID (UUID) метрики, цей рядок пов'язується з наявною метрикою з таким ID, і нова метрика не створюється. ID має пріоритет над назвою метрики, тому це відбувається незалежно від параметра Повторно використовувати наявні метрики з тією самою назвою (який застосовується лише до зіставлення за назвою).

Крок 2 — Зіставити поля

Після завантаження ви побачите таблицю з усіма стовпцями вашого файлу. Кожен рядок має три стовпці:

  • Стовпець файлу – початковий заголовок із вашого файлу.
  • Поле – розкривний список, де ви вибираєте відповідне поле форми.
  • Статус – показує, чи стовпець зіставлено, проігноровано чи він містить помилку.

Дії зіставлення

  • Вибрати поле форми – відкрийте розкривний список для стовпця та виберіть потрібне поле. У розкривному списку можна виконувати пошук.
  • Ігнорувати стовпець – виберіть у розкривному списку параметр — Ігнорувати цей стовпець — або натисніть кнопку Ігнорувати у стовпці статусу. Проігноровані стовпці відображаються сірим.
  • Відновити проігнорований стовпець – натисніть кнопку Відновити у стовпці статусу.

Автоматичне зіставлення

Коли файл зчитано, Dino зіставляє кожен стовпець, заголовок якого точно збігається з назвою поля форми або з назвою повторюваного поля, після якої йде __N (див. Повторювані слайди). Решту стовпців залишається зіставити вам.

Натисніть Зіставити все заново, щоб скинути всі стовпці та дозволити Dino зіставити їх знову, цього разу також зіставляючи стовпці з полями, назви або підписи яких схожі. Перегляньте результат і за потреби скоригуйте зіставлення.

Зіставлення працює найкраще, коли заголовки є назвами полів, як в експортованому файлі.

Повторення

Якщо вибране поле форми є повторюваним полем (наприклад, кілька номерів телефонів), під розкривним списком з'являється поле введення Повторення. Введіть індекс повторення (0, 1, 2, …), щоб призначити цей стовпець файлу одному входженню повторюваної групи.

Зведення на панелі інструментів

Угорі області зіставлення відображаються три позначки:

  • Усього стовпців – кількість стовпців файлу.
  • Зіставлено – стовпці, призначені полю форми.
  • Проігноровано – стовпці, які ви вирішили проігнорувати.

Використовуйте поле Пошук стовпців…, щоб відфільтрувати таблицю за назвою стовпця файлу.

Натисніть Назад, щоб повернутися до кроку завантаження: файл і зіставлення скасовуються, і ви вибираєте файл знову.

Коли всі потрібні стовпці зіставлено та немає помилок, кнопка Застосувати імпорт стає активною. Натисніть її, щоб розпочати імпорт. Під час обробки відображається індикатор завантаження.

Дубльоване зіставлення

Якщо ви зіставите те саме поле форми з кількома стовпцями файлу, відобразиться помилка валідації (Поле зіставлено з кількома стовпцями), і кнопка Застосувати імпорт залишатиметься неактивною, доки це не буде виправлено.

Крок 3 — Результат

Останній крок повідомляє, що сталося:

  • Банер повідомляє, чи імпорт був успішним, частковим (деякі рядки відхилено) чи завершився помилкою (нічого не імпортовано).
  • Лічильники показують Імпортовані рядки, Відхилені рядки, Рядків у файлі та Створені метрики.
  • Списки проблем показують відповідні рядки файлу та причину. Використовуйте Пошук за рядком або помилкою, щоб відфільтрувати довгі списки.

Натисніть Закрити, щоб повернутися до списку даних форми, де з'являться нові дані. Після помилки Назад повертає вас до кроку зіставлення, щоб виправити проблеми.

Формат файлу

Ми описуємо процедуру імпорту деяких масових даних за допомогою файлу Excel, створеного з Google Sheet. Та сама процедура застосовується до файлів CSV або якщо працювати безпосередньо з Excel.

Припустімо, що ви хочете імпортувати дані у форму під назвою Projects, яка має 2 слайди, один з яких є повторюваним слайдом:

Форма Projects із двома слайдами, один з яких є повторюваним слайдом

Форму Projects було створено за допомогою такого XLSForm. Аркуш «survey» — це

type name label
begin group start Start
select_one countries country Country
select_multiple countries country_other Other Countries
text title Project Title
date project_date_start Start date
select_one donors selected_donor Donor
integer budget Budget
boolean isleader Leading applicant
end group
begin repeat indicators Indicators
text indic Indicator description
integer value_indic Value reached
end repeat

а «choices» — це

list_name name label
donors ue UE
donors govita ITALIAN GOVERNMENT
donors un UN
donors pub ALTRI DONATORI PUBBLICI
donors la ENTI LOCALI
donors priv DONATORI PRIVATI
donors other Others
countries AFG Afghanistan
countries ALB Albania
countries DZA Algeria
countries ASM American Samoa

Виконайте такі кроки:

  1. Створіть порожній файл лише з одним аркушем (назви файлу та аркуша не мають значення).
  2. У першому рядку потрібно вказати назви полів форми та специфічних для DINO полів форми. У цьому прикладі полями форми можуть бути:
  3. country
  4. country_other
  5. title
  6. project_date_start
  7. selected_donor
  8. budget
  9. isleader
  10. indic (*)
  11. value_indic (*)

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

Специфічними для DINO полями можуть бути:

  1. created_at. Дата створення форми. Указуйте це, лише якщо хочете, щоб ваші форми мали дату створення, відмінну від дати імпорту;
  2. user_data_ref_id. ID користувача, який буде пов'язаний з формою. Застосовується лише коли імпортує адміністратор; для інших користувачів значення ігнорується, і форми призначаються користувачеві, який їх імпортує;
  3. area_id. ID метрики AREA, яку потрібно пов'язати з формою;
  4. [area_name]
  5. case_id. ID метрики CASE, яку потрібно пов'язати з формою;
  6. [case_name]
  7. project_id. ID метрики PROJECT, яку потрібно пов'язати з формою;
  8. [project_name]
  9. [project_code]
  10. location_id. ID метрики LOCATION, яку потрібно пов'язати з формою;
  11. [location_name]
  12. organization_id. ID метрики ORGANISATION, яку потрібно пов'язати з формою;
  13. [organization_name]
  14. form_status_name. Назва одного зі статусів form schema. Рядки без нього отримують перший статус схеми. Якщо якесь значення не збігається з назвою наявного статусу, файл не імпортується (Недійсні статуси);
  15. dinoinvalid. Позначає форму як недійсну. Використовуйте true, 1, yes, y або x; будь-яке інше значення або порожня комірка залишає форму дійсною.

  16. кожен рядок відповідатиме іншій новій формі. Тож якщо ми створимо файл з одним заголовком + , скажімо, 5 рядків даних, у разі успішного завантаження ми створимо 5 нових форм у DINO.

  17. Не обов'язково мати стовпець для кожного поля форми; не обов'язково заповнювати всі рядки певного стовпця, але якщо якесь поле порожнє для всіх рядків, його можна не включати,
  18. Поля дат потрібно форматувати як YYYY-MM-DD у вигляді тексту (будьте уважні).
  19. Поля з одним вибором мають містити один із прийнятних варіантів, зазначених у «choices» (див. конструктор форм або файл XLSForm).
  20. Поля з множинним вибором потрібно форматувати за таким шаблоном: [opt1, opt2] (тобто список варіантів у квадратних дужках).

Наприклад, дійсним файлом може бути такий:

country country_other title project_date_start budget isleader area_id
ALB [AFG,DZA] Human rights in education 2022-01-28 120000 true 81387ff7-5c7d-44e7-9dc6-76b8d09265ac
ASM A new approach to social justice 2022-02-14 20000 81387ff7-5c7d-44e7-9dc6-76b8d09265ac

У цьому випадку ми імпортуємо 2 форми, і для обох вибираємо лише метрику AREA. Крім того, зауважте, що ми надаємо не всі поля форми для всіх форм, але для полів, де ми надаємо значення, ми суворо дотримуємося вказівок, описаних вище.

Робота з метриками під час імпорту

Під час імпорту даних форми, що стосується метрик, ви можете захотіти:

  • створити нові метрики під час імпорту
  • повторно використати вже створені метрики

Правила, яких потрібно дотримуватися для правильного керування метриками, такі:

МЕТРИКА СТВОРЕННЯ З ІНТЕРФЕЙСУ СТВОРЕННЯ З ІМПОРТУ СТВОРЕННЯ + ПРИЗНАЧЕННЯ З ІМПОРТУ ВИКОРИСТАННЯ З ІМПОРТУ СТВОРЕННЯ + ПРИЗНАЧЕННЯ З ІМПОРТУ (батьківська) ВИКОРИСТАННЯ ЯК БАТЬКІВСЬКОЇ
Справа назва назва назва id, або назва (з опцією повторного використання), або обидва назва, в іншому рядку того самого файлу id або назва
Організація назва назва назва id, або назва (з опцією повторного використання), або обидва назва, в іншому рядку того самого файлу id або назва
Місцезнаходження назва назва назва id, або назва (з опцією повторного використання), або обидва назва, в іншому рядку того самого файлу id або назва
Область назва назва назва id, або назва (з опцією повторного використання), або обидва назва, в іншому рядку того самого файлу id або назва
Проект назва, код назва, код назва, код id, або назва (з опцією повторного використання), або обидва назва й код, в іншому рядку того самого файлу id або назва

Коли рядок містить і id, і назву метрики, перемагає id, а назва ігнорується. Нова метрика створюється лише тоді, коли надано назву, а id порожній.

Батьківські метрики задаються стовпцями <metric>_parent_id та <metric>_parent_name (наприклад location_parent_name) і застосовуються лише до метрик, створених імпортом. Батьківська метрика має бути того самого типу, що й метрика, і або вже існувати, або бути створеною іншим рядком того самого файлу, у будь-якому порядку. Батьківська метрика, яка нічому не відповідає, не створюється: таку метрику позначено як метрика з недійсним батьком.

Повторювані слайди

Якщо у вас є поле в повторюваних слайдах, його потрібно назвати інакше. Кожне поле в повторюваному слайді потрібно назвати \<field_name>__X, де X — номер повторення, від 0 (відповідає одному повторенню) до N-1, де N — загальна кількість повторень слайда в цій формі.
Наприклад, припустімо, що у вас лише 1 повторення повторюваного слайда, і ви хочете додати обидва поля «Indicator description» та «Value reached». Вам потрібно буде додати ці два стовпці до файлу імпорту:

indic__0 value_indic__0
Number of children 100

Отже, наприклад, ми могли б мати:

country budget indic__0 value_indic__0 indic__1 value_indic__1 isleader
ALB 120000 Children 100 true
ASM 20000
AFG 15000 Parents 45 Schools 34 true

Помилки

  • Невідомі ID – якщо стовпець посилається на користувача або метрику за ID, якого не існує в Dino, весь файл не імпортується (Файл не імпортовано!), а результат показує Недійсні ідентифікатори користувачів або Недійсні ідентифікатори метрик. Перевірте ID у своєму файлі перед імпортом.
  • Невідомий статус форми – form_status_name, який не збігається з жодним статусом схеми, також зупиняє імпорт (Недійсні статуси).
  • Метрики, які неможливо пов'язати – рядок, який називає метрику, яку Dino не може створити чи знайти, відхиляється, і результат показує причину; решту рядків імпортовано.