Webitel: Документація

Імпорт даних з CSV файлів

1. Опис

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

Складається з таких елементів:

  1. Інструмент створення (Рис. 1(1));

  2. Поле пошуку (Рис. 1(2));

  3. Інструмент оновлення реєстру записів (Рис. 1(3));

  4. Реєстр записів (Рис. 1(4));

  5. Пагінація (Рис. 1(5)).

Сторінка Імпорт даних з CSV файлів.png
Рис. 1. Сторінка "Імпорти CSV файлів"

1.1. Інструмент створення

Для створення нового об'єкта слугує кнопка "Додати" (Рис. 1(1)), після натискання на яку відкривається доступ до деталей. Відкрити доступ до деталей уже наявного імпорту можна через інструмент редагування запису (див. пункт 1.4.5).

Деталі:

1.2. Поле пошуку

Пошук здійснюється за колонкою "Ім'я".

Складається з поля введення та кнопки закриття ( image-20241231-141138.png ), яка відображається, коли в полі введення встановлено курсор. Для пошуку в частині слова або номера використовується символ *. Можна використовувати символ *  і для заміни будь-якої кількості символів.

1.3. Інструмент оновлення реєстру записів

Оновлення таблиці реєстру записів виконується натисканням кнопки оновлення - image-20241231-123329.png .

1.4. Реєстр записів

Реєстр це список записів наявних об'єктів цього розділу, кожен з яких складається з набору полів.

Складається з таких частин:

  1. Чекбокс;

  2. Колонка "Ім'я";

  3. Колонка "Призначення імпорту";

  4. Інструмент завантаження;

  5. Інструмент редагування;

  6. Інструмент видалення.

Якщо на сторінці немає жодного запису, відображається додаткова кнопка «Додати», функціонал якої дублює кнопку «Додати» у п. 1.1.

1.4.1. Чекбокс

Використовується для вибору одного або кількох записів. Після вибору одного або кількох записів з’являється додатковий інструмент видалення біля поля пошуку. Інформація про кількість записів, вибраних для видалення, з’являється при наведенні на цей інструмент. Коли ви натискаєте на нього, з’являється модальне вікно підтвердження. Він містить кнопки "Так", "Ні" та кнопку закриття - image-2023-7-12_22-34-16.png . Натискання кнопки "Так" видаляє записи. Натискання кнопки «Ні» закриває модальне вікно, а записи не видаляються.
Якщо відмітити чекбокс у заголовку, то усі записи на сторінці будуть вибрані.

Модальне вікно Підтвердіть видалення (декілька об'єктів).png

Рис. 2. Видалення кількох записів

1.4.2. Колонка "Ім'я"

Тут відображаються назви шаблонів імпорту даних.

1.4.3. Колонка "Призначення імпорту"

Відображається черга, для якої призначений цей шаблон.

1.4.4. Інструмент завантаження

Для завантаження даних з файлу CSV скористайтеся кнопкою імпорт файлу CSV - 91f3ef3e-039c-4454-abf3-5c3444d0eab5 . При наведенні курсора на цю кнопку відображається напис "Завантажити". При натисканні на кнопку 91f3ef3e-039c-4454-abf3-5c3444d0eab5 відкривається вікно вибору файлу.

Під час збереження переконайтеся, що встановлено "CSV-файл", як тип файлу.

Виберіть потрібний файл на вашому пристрої та натисніть кнопку "Відкрити" (залежно від ОС вікно вибору файлу може відрізнятися) (Рис. 3).

Вікно вибору файлу - Імпорт даних з CSV файлів.png
Рис. 3. Вікно вибору файлу

Відкривається модальне вікно "Імпортувати CSV" (Рис. 5).

У документі для імпорту повинні бути заголовки, які вказані в деталі "Налаштування". Приклад файлу для імпорту можна подивитися на Рис. 4.

Приклад файлу для імпорту.png
Рис. 4. Приклад файлу для імпорту
1.4.4.1. Модальне вікно “Імпортувати CSV”

Відображає перші рядки імпортованого файлу (Рис. 5).

Модальне вікно Імпортувати CSV - Імпорт даних з CSV файлів.png
Рис. 5. Модальне вікно "Імпортувати CSV"

Натискання кнопки "Зберегти" імпортує дані з файлу. Натискання на кнопку "Закрити" закриває модальне вікно, дані не імпортуються.

Якщо імпортований файл не містить заголовків колонок, які вказані в шаблоні, то імпортування не відбудеться.

1.4.5. Інструмент редагування

Відкривається натисканням кнопки редагування ( image-20241231-123436.png ), при наведенні курсором на яку відображається інформація з назвою інструмента. Після натискання цієї кнопки відкривається доступ до деталей, в яких можна змінити дані об'єкта.

1.4.6. Інструмент видалення

Використовується для видалення об'єкта із підтвердженням через модальне вікно. Під час наведення на кнопку видалення ( image-20241231-123050.png ) відображається інформація з назвою інструменту. Після натискання кнопки видалення з'являється модальне вікно з підтвердженням. Натискання кнопки "Так" видаляє об'єкт. Натискання кнопки "Ні" закриває модальне вікно, об'єкт не видаляється.

Модальне вікно Підтвердіть видалення.png

Рис. 6. Модальне вікно підтвердження видалення

1.5. Пагінація

Складається з поля "Записів на сторінці", в якому вказується кількість записів (можливо задати від 1 до 1000) на одну сторінку та кнопок вперед image-20250102-163221.png і назад image-20250102-163241.png для перемикання сторінок.

2. Можливості

2.1. Створення нового шаблону для імпорту

Ціль

Створити новий шаблон для імпорту

Передумови

  1. Доступ до застосунку "Admin";

  2. Доступ до розділу "Імпорт даних із CSV файлу" в Admin;

  3. Дозвіл на створення у розділі "Імпорт даних із CSV файлу".

Сценарій:

 

  1. Натиснути кнопку "Додати". Відкривається сторінка деталі "Загальне".

  2. Внести дані.

  3. Перейти на сторінку деталі "Налаштування".

  4. Внести необхідні дані. Кнопка "Зберегти" стає активною.

  5. Натиснути на кнопку "Зберегти"

Результат

Дані збережено. Шаблон створено.

2.2. Видалення шаблону для імпорту

Ціль

Видалити шаблон для імпорту

Передумови

  1. Доступ до застосунку "Admin";

  2. Доступ до розділу "Імпорт даних із CSV файлу" в Admin;

  3. Дозвіл на перегляд і видалення у розділі "Імпорт даних із CSV файлу";

  4. Наявність щонайменше одного шаблону для імпорту.

Сценарій:

 

  1. Знайти шаблон для імпорту, який потрібно видалити.

  2. Натиснути кнопку видалення - 8081457e-7e43-4e3c-b4af-8ab74da1ed24 . Відкривається модальне вікно для підтвердження видалення.

  3. Натиснути кнопку "Так".

Результат

Модальне вікно закривається. Шаблон для імпорту видалено.

2.3. Видалення декількох шаблонів

Ціль

Видалити кілька шаблонів

Передумови

  1. Доступ до застосунку "Admin";

  2. Доступ до розділу "Імпорт даних із CSV файлу" в Admin;

  3. Дозвіл на перегляд і видалення у розділі "Імпорт даних із CSV файлу";

  4. Наявність записів у реєстрі.

Сценарій:

 

  1. Знайти шаблони, які необхідно видалити. Вибрати їх за допомогою чекбокса.

  2. Натиснути на кнопку видалення вгорі реєстру записів. Відкривається модальне вікно для підтвердження видалення

  3. Натиснути кнопку "Так".

Результат

Модальне вікно закривається. Обрані шаблони видалено.

2.4. Редагування шаблону

Ціль

Редагувати шаблон

Передумови

  1. Доступ до застосунку "Admin";

  2. Доступ до розділу "Імпорт даних із CSV файлу" в Admin;

  3. Дозвіл на перегляд і видалення у розділі "Імпорт даних із CSV файлу";

  4. Наявність щонайменше одного шаблону для імпорту.

Сценарій:

 

  1. Знайти в реєстрі записів шаблон для імпорту, який необхідно редагувати.

  2. Натиснути на кнопку редагування в записі про цей шаблон. Відкривається сторінка деталі "Загальне".

  3. Внести зміни. Кнопка "Зберегти" стає активною.

  4. Натиснути кнопку "Зберегти".

Результат

Обраний шаблон відредаговано.

2.5. Імпортування даних за шаблоном

Ціль

Імпортувати дані за шаблоном

Передумови

  1. Доступ до застосунку "Admin";

  2. Доступ до розділу "Імпорт даних із CSV файлу" в Admin;

  3. Дозвіл на додавання в розділі в який будуть імпортуватися дані.

  4. Наявність щонайменше одного шаблону для імпорту.

Сценарій:

 

  1. Знайти шаблон, який необхідно імпортувати.

  2. Натиснути на кнопку завантаження 8230bf2d-697a-4cf0-9a22-7a5ed53b6811 в запису шаблону. Відкривається вікно вибору файлу.

  3. Вибрати файл (Рис. 2).

  4. Натиснути кнопку "Відкрити". Відкривається модальне вікно "Імпортувати CSV".

  5. Натиснути кнопку "Зберегти".

Результат

Дані імпортовано.