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

Доступ до сторінки імпорту
- Перейдіть до списку Форми та виберіть form schema.
- У поданні даних форми натисніть Імпортувати форми на панелі інструментів.
Крок 1 — Завантажити файл
На першому кроці відображається зона перетягування або засіб вибору файлу.
- Прийнятні формати:
.xls,.xlsx,.csv - Максимальний розмір файлу: 20 МБ
Щоб завантажити файл:
- (Необов'язково) Залиште позначку Повторно використовувати наявні метрики з тією самою назвою (усталено), щоб будь-яка метрика у файлі, назва якої збігається з наявною в системі метрикою, була пов'язана з цією наявною метрикою, а не створювала дублікат. Зніміть позначку, щоб завжди створювати нові метрики.
- Перетягніть файл у пунктирну область або натисніть Вибрати файл, щоб вибрати його.
- Після зчитування файлу майстер автоматично переходить до кроку Зіставити поля.
Форматування файлу імпорту
Дивіться опис у розділі нижче
Прості формати файлів
Dino приймає той самий файл, отриманий під час експорту. Отже, найпростіший спосіб отримати файл, належно відформатований для імпорту, — спершу експортувати деякі дані форми з того самого form schema, а потім видалити рядки з експортованими даними, залишивши лише заголовки стовпців. У будь-якому разі переконайтеся, що заголовки стовпців зрозумілі — вони використовуватимуться як підказки під час зіставлення.
Метрики, ідентифіковані за ID
Якщо стовпець метрики у вашому файлі містить ID (UUID) метрики, цей рядок пов'язується з наявною метрикою з таким ID, і нова метрика не створюється. ID має пріоритет над назвою метрики, тому це відбувається незалежно від параметра Повторно використовувати наявні метрики з тією самою назвою (який застосовується лише до зіставлення за назвою).
Крок 2 — Зіставити поля
Після завантаження ви побачите таблицю з усіма стовпцями вашого файлу. Кожен рядок має три стовпці:
- Стовпець файлу – початковий заголовок із вашого файлу.
- Поле – розкривний список, де ви вибираєте відповідне поле форми.
- Статус – показує, чи стовпець зіставлено, проігноровано чи він містить помилку.
Дії зіставлення
- Вибрати поле форми – відкрийте розкривний список для стовпця та виберіть потрібне поле. У розкривному списку можна виконувати пошук.
- Ігнорувати стовпець – виберіть у розкривному списку параметр — Ігнорувати цей стовпець — або натисніть кнопку Ігнорувати у стовпці статусу. Проігноровані стовпці відображаються сірим.
- Відновити проігнорований стовпець – натисніть кнопку Відновити у стовпці статусу.
Автоматичне зіставлення
Коли файл зчитано, Dino зіставляє кожен стовпець, заголовок якого точно збігається з назвою поля форми або з назвою повторюваного поля, після якої йде __N (див. Повторювані слайди). Решту стовпців залишається зіставити вам.
Натисніть Зіставити все заново, щоб скинути всі стовпці та дозволити Dino зіставити їх знову, цього разу також зіставляючи стовпці з полями, назви або підписи яких схожі. Перегляньте результат і за потреби скоригуйте зіставлення.
Зіставлення працює найкраще, коли заголовки є назвами полів, як в експортованому файлі.
Повторення
Якщо вибране поле форми є повторюваним полем (наприклад, кілька номерів телефонів), під розкривним списком з'являється поле введення Повторення. Введіть індекс повторення (0, 1, 2, …), щоб призначити цей стовпець файлу одному входженню повторюваної групи.
Зведення на панелі інструментів
Угорі області зіставлення відображаються три позначки:
- Усього стовпців – кількість стовпців файлу.
- Зіставлено – стовпці, призначені полю форми.
- Проігноровано – стовпці, які ви вирішили проігнорувати.
Використовуйте поле Пошук стовпців…, щоб відфільтрувати таблицю за назвою стовпця файлу.
Натисніть Назад, щоб повернутися до кроку завантаження: файл і зіставлення скасовуються, і ви вибираєте файл знову.
Коли всі потрібні стовпці зіставлено та немає помилок, кнопка Застосувати імпорт стає активною. Натисніть її, щоб розпочати імпорт. Під час обробки відображається індикатор завантаження.
Дубльоване зіставлення
Якщо ви зіставите те саме поле форми з кількома стовпцями файлу, відобразиться помилка валідації (Поле зіставлено з кількома стовпцями), і кнопка Застосувати імпорт залишатиметься неактивною, доки це не буде виправлено.
Крок 3 — Результат
Останній крок повідомляє, що сталося:
- Банер повідомляє, чи імпорт був успішним, частковим (деякі рядки відхилено) чи завершився помилкою (нічого не імпортовано).
- Лічильники показують Імпортовані рядки, Відхилені рядки, Рядків у файлі та Створені метрики.
- Списки проблем показують відповідні рядки файлу та причину. Використовуйте Пошук за рядком або помилкою, щоб відфільтрувати довгі списки.
Натисніть Закрити, щоб повернутися до списку даних форми, де з'являться нові дані. Після помилки Назад повертає вас до кроку зіставлення, щоб виправити проблеми.
Формат файлу
Ми описуємо процедуру імпорту деяких масових даних за допомогою файлу Excel, створеного з Google Sheet. Та сама процедура застосовується до файлів CSV або якщо працювати безпосередньо з Excel.
Припустімо, що ви хочете імпортувати дані у форму під назвою Projects, яка має 2 слайди, один з яких є повторюваним слайдом:

Форму 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 |
Виконайте такі кроки:
- Створіть порожній файл лише з одним аркушем (назви файлу та аркуша не мають значення).
- У першому рядку потрібно вказати назви полів форми та специфічних для DINO полів форми. У цьому прикладі полями форми можуть бути:
- country
- country_other
- title
- project_date_start
- selected_donor
- budget
- isleader
- indic (*)
- value_indic (*)
зверніть увагу, що поля в повторюваних слайдах потрібно обробляти інакше (саме тому ми поставили зірочку). Будь ласка, зверніться до відповідного розділу нижче.
Специфічними для DINO полями можуть бути:
- created_at. Дата створення форми. Указуйте це, лише якщо хочете, щоб ваші форми мали дату створення, відмінну від дати імпорту;
- user_data_ref_id. ID користувача, який буде пов'язаний з формою. Застосовується лише коли імпортує адміністратор; для інших користувачів значення ігнорується, і форми призначаються користувачеві, який їх імпортує;
- area_id. ID метрики AREA, яку потрібно пов'язати з формою;
- [area_name]
- case_id. ID метрики CASE, яку потрібно пов'язати з формою;
- [case_name]
- project_id. ID метрики PROJECT, яку потрібно пов'язати з формою;
- [project_name]
- [project_code]
- location_id. ID метрики LOCATION, яку потрібно пов'язати з формою;
- [location_name]
- organization_id. ID метрики ORGANISATION, яку потрібно пов'язати з формою;
- [organization_name]
- form_status_name. Назва одного зі статусів form schema. Рядки без нього отримують перший статус схеми. Якщо якесь значення не збігається з назвою наявного статусу, файл не імпортується (Недійсні статуси);
-
dinoinvalid. Позначає форму як недійсну. Використовуйте
true,1,yes,yабоx; будь-яке інше значення або порожня комірка залишає форму дійсною. -
кожен рядок відповідатиме іншій новій формі. Тож якщо ми створимо файл з одним заголовком + , скажімо, 5 рядків даних, у разі успішного завантаження ми створимо 5 нових форм у DINO.
- Не обов'язково мати стовпець для кожного поля форми; не обов'язково заповнювати всі рядки певного стовпця, але якщо якесь поле порожнє для всіх рядків, його можна не включати,
- Поля дат потрібно форматувати як YYYY-MM-DD у вигляді тексту (будьте уважні).
- Поля з одним вибором мають містити один із прийнятних варіантів, зазначених у «choices» (див. конструктор форм або файл XLSForm).
- Поля з множинним вибором потрібно форматувати за таким шаблоном: [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 не може створити чи знайти, відхиляється, і результат показує причину; решту рядків імпортовано.