Сценарій "SMART Data Template" .

Extension - SMART Data Template

Додаток SMART Data Template — це розширення для Microsoft Dynamics 365 Business Central, яке дозволяє гнучко налаштовувати мепінг і трансформацію даних. В додатку є можливість створювати шаблони з кількома таблицями, мапінгами та виразами для автоматизації інтеграції, звітності та експорту даних — без змін у коді.

Основні можливості:

• Визначення шаблонів даних з будь-якою кількістю таблиць (як змінних).
• Налаштування мапінг-кодів і виразів для обчислення значень.
• Підтримка як одиничних, так і повторюваних (рядкових) структур.
• Гнучке налаштування фільтрів і зв’язків між таблицями.
• Автоматизація експорту, інтеграції та звітності.

SMART Data Template дозволяє налаштовувати складну логіку вибірки та трансформації даних через інтерфейс. Ви визначаєте, які таблиці використовувати, як вони пов’язані, які дані витягувати та як їх обчислювати чи трансформувати — без написання коду.

• Шаблони групують усі налаштування для сценарію.
• Таблиці виступають змінними та контекстом для вибірки даних.
• Мапінги визначають, які дані виводити.
• Вирази описують, як обчислювати кожен мапінг.
• Фільтри контролюють, які записи включати та як таблиці пов’язані.

Цей підхід дозволяє бізнес-користувачам та консультантам автоматизувати потоки даних, звітність та інтеграції гнучко й ефективно.

Для використання шаблону даних необхідно виконати наступні налаштування.

1. Створення шаблону даних

Сторінка: Шаблони даних

Необхідно створити новий шаблон даних, заповнивши наступні поля:

Поле	Опис
Код	Унікальний ідентифікатор шаблону.
Опис	Опис шаблону.
Тип	Оберіть тип шаблону: Співставлення даних або Фільтр записів. Для вивантаження інформації згідно певного меппінгу даних необхідно обрати тип Співставлення даних.
ID таблиці-джерела	ID основної таблиці.
Назва таблиці-джерела	Назва основної таблиці (заповнюється автоматично).

2. Додавання таблиць до шаблону

Для відповідного шаблону необхідно додати таблиці, які будуть використовуватись як змінні (контексти) у шаблоні даних.

Сторінка: Таблиці шаблонів даних (необхідно натиснути на кнопку Таблиці даних на сторінці Шаблони даних)

Поле	Опис
Код	Унікальний код змінної таблиці.
Опис	Опис таблиці.
Ідентифікатор таблиці	ID таблиці у Business Central.
Назва таблиці	Назва таблиці (заповнюється автоматично).
Є корневою таблицею	Позначає основну таблицю (заповнюється автоматично).
Повторення	Якщо встановлено, таблиця є повторюваною (рядковою).
Код батьківських даних	Код батьківської таблиці, по полю якої буде відбуватися пошук необхідної інформації для конкретного запису.
Запитувати додаткові фільтри	Якщо при формуванні звіту необхідно виводити сторінку запиту для можливості встановлювати фільтри по полям необхідної таблиці, для такої таблиці необхідно встановити налаштування Так
Останній	Якщо по певним фільтрам записів було знайдено більше ніж один, то це налаштування при значенні Так визначає, що потрібно вивантажувати в звіт останній знайдений запис.

3. Налаштування фільтрів таблиць

Визначте фільтри для кожної таблиці, щоб обмежити або зв’язати дані. Для встановлення фільтрів на сторінці Таблиці шаблонів даних для конкретної таблиці необхідно провалитись в поле Відфільтрований, і заповнити необхідні фільтри:

Поле	Опис
ID поля	ID поля для фільтрації.
Мітка поля	Назва поля (заповнюється автоматично).
Тип	Тип фільтра: Фільтр або Пов'язане поле. Для того, щоб відфільтрувати записи в поточній таблиці - необхідно обрати тип Фільтр. Для того, щоб зв'язати дані з батьківською таблицею - необхідно обрати тип Пов'язане поле
Значення фільтра	Для записів з типом = Фільтр в цьому полі необхідно зазначити значення або вираз для фільтра.
Ідентифікатор пов’язаного поля	Для записів з типом = Пов'язане поле в цьому полі необхідно вказати поле, по якому буде відбуватись зв'язок записів в двох таблицях (поточної і батьківської)
Назва пов’язаного поля	Назва пов’язаного поля (заповнюється автоматично).

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

4. Додавання мапінг-кодів

Необхідно додати мапінг-коди, які будуть використовуватись при формуванні звітів або виконанні інтеграції.

Сторінка: Зіставлення шаблонів даних (необхідно натиснути на кнопку Відображення кодів даних на сторінці Шаблони даних)

Поле	Опис
Код	Унікальний код співставленної змінної.
Опис	Опис співставлення.
Повторення	Якщо встановлено, то це співставлення для повторюваної таблиці.
Повторювана таблиця даних	Код повторюваної таблиці.

5. Додавання виразів

Для кожного коду співставлення даних необхідно додати один або кілька виразів. Вирази будуть визначати дані, які мають вивантажитись в сформований звіт. Для вказання виразів на сторінці Зіставлення шаблонів даних для конкретного коду співставлення необхідно провалитись в поле Вираз, і прописати необхідні вирази:

Поле	Опис
Операція	Вид операції (Concat, +, -, *, /, If empty тощо). Для визначення значення з певного поля необхідно обрати тип операції Concat. Для виконання арифметичних дій з значеннями необхідно обрати відповідний логічний оператор (наприклад: +). Для визначення логічного виразу, якщо знайдене значення в певній змінній пусто, то необхідно вивантажувати певне значення - треба встановити тип операції Якщо порожній. Для визначення логічного виразу, якщо знайдене значення в певній змінній НЕ пусто, то необхідно вивантажувати певне значення - треба встановити тип операції Якщо не порожній.
Тип	Тип виразу (Константа, Поле, Дані). Для визначення значення з певного поля треба обрати тип Поле; певної текстової константи - тип Константа.
Значення константи	Необхідно вказати значення текстової константи, якщо в полі Тип визначено Константа
Дані пов’язаної таблиці	Код пов’язаної таблиці, з якої необхідно витягнути дані
Назва таблиці	Назва пов’язаної таблиці, з якої необхідно витягнути дані
ID поля	ID поля пов’язаної таблиці, з якого необхідно витягнути дані
Мітка поля	Назва поля пов’язаної таблиці, з якого необхідно витягнути дані
Правило перетворення	Використовуйте правило перетворення, якщо отримане в певному виразі значення має бути конвертовано в інший формат вивантаження в звіті.

6. Сценарії використання

Сценарій 1: Експорт даних документа

1. Створіть шаблон для документа (наприклад, Рахунок на продаж).
2. Додайте основну таблицю документа та таблицю рядків як повторювану.
3. Налаштуйте фільтри для зв’язку рядків із заголовком.
4. Визначте мапінг-коди для полів заголовка та рядків.
5. Додайте вирази для обчислення значень (наприклад, конкатенація полів, умови).

Сценарій 2: Інтеграція даних

1. Створіть шаблон для інтеграції.
2. Додайте всі необхідні таблиці (наприклад, Клієнт, Заголовок продажу, Рядок продажу).
3. Використовуйте фільтри для вибору потрібних записів.
4. Визначте мапінг-коди для полів інтеграції.
5. Використовуйте вирази для трансформації даних.

Сценарій 3: Кастомна звітність

1. Створіть шаблон для звіту.
2. Додайте таблиці та налаштуйте зв’язки.
3. Визначте мапінг-коди для колонок звіту.
4. Використовуйте вирази для обчислюваних колонок (наприклад, підсумки, умовні значення).