Table of Contents

Опис додатку SMART Generic Excel Report

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

SMART Generic Excel Report має використовуватись разом з додатком SMART Data Template.

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

1. Створення універсального Excel звіту

Сторінка: Універсальні звіти Excel

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

Поле Опис
Код Унікальний ідентифікатор звіту.
Опис Опис звіту.
Код шаблону Excel Необхідно обрати Шаблон Excel для генерації звіту. Попередньо, шаблон необхідно створити, проіменувати всі комірки і області Excel, які мають заповнюватись по відповідним кодам співставлення даних з шаблонів даних.
Id таблиці головного об'єкта даних ID кореневої таблиці.
Назва таблиці головного об'єкта даних Назва кореневої таблиці (заповнюється автоматично).
Код шаблону даних Необхідно обрати шаблон даних, на основі якого буде формуватись звіт. В шаблоні даних мають бути визначені всі змінні, які будуть вивантажуватись в Excel звіт. Детальний опис процесу створення і налаштування шаблону даних можна знайти в сценарії SMART Data Template.
Кілька компаній Встановіть Так, щоб звіт формувався з даних кількох компаній середовища, одна за одною. Див. розділ 6.
Вибір компаній Як обираються компанії: Запитати — сторінка фільтра відкривається під час кожного запуску, Усі компанії — використовується кожна компанія, Фільтр — використовується фільтр компаній, збережений нижче.
Фільтр компаній Фільтр за назвою компанії, наприклад COMPANY A\|COMPANY B. За варіанта Запитати сторінка фільтра відкривається на полі Назва саме з цим фільтром, тож користувач підтверджує або змінює його, а не вводить заново.
Якщо компанію не прочитано Що відбувається з компанією, дані якої не вдалося прочитати: Пропустити компанію — вилучити її та перелічити після експорту, Показати помилку — зупинити звіт. Обирайте Показати помилку, коли книга має бути або повною, або жодною.

2. Створення Секцій звіту

Для обраного шаблону Excel необхідно додати розділи в табличній частині Секції

Поле Опис
Ім'я листа Ім'я листа файлу Excel, обраного в полі Код шаблону Excel, необхідно обрати значення з випадаючого списку.
Назва секції Назва відповідної області в шаблоні Excel, , необхідно обрати значення з випадаючого списку. Всі області мають бути попередньо створені в Excel шаблоні, що визначений в полі Код шаблону Excel. Це, наприклад, області HEADER, LINE, FOOTER.
Повторення Необхідно встановити Так для області Excel звіту, що має бути повторювальною.
Друкувати один раз Встановіть Так для секції, яка належить книзі, а не компанії, — заголовка звіту, шапки колонок або завершальної секції. У звіті з кількох компаній така секція записується лише один раз: секція, розташована перед останньою секцією, що записується для кожної компанії, записується з першою компанією, а секція після неї — один раз, після останньої компанії. Решта секцій записуються для кожної компанії заново.

3. Налаштування співставлення для комірок Excel

Для кожної комірки Excel звіту, в яку має вивантажуватись інформація з системи, має буде вказане співставлення (маппінг) з змінними шаблону даних, що вказаний в полі Код шаблону даних. Для визначення такого співставлення на картці Універсального звіту Excel для кожної секції необхідно зайти на сторінку Відображення універсального Excel звіту, натиснувши кнопку Співставлення на рядку з секцією універсального Excel звіту.

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

Поле Опис
Назва змінної Назва комірки в Excel шаблоні.
Тип даних Можна вказати тип, з яким дані будуть вивантажуватись в звіт Excel, наприклад: Текст (текстовий формат); Дата (формат дати); Десяткове (числовий формат); Так/Ні.
Формат числа Можна вказати формат, у якому треба вивантажувати числові показники.
Код даних співставлення Визначає змінну шаблону даних, що вказаний для даного універсального звіту, яка має вивантажуватись в визначену комірку Excel.

4. Запуск звіту

Для запуску звіту необхідно на сторінці Універсальний звіт Excel викликати дію Запустити звіт.

5. Вибір звіту для "Вибір звіту - персонал"

Створений універсальний Excel звіт можна обрати на сторінці Вибір звіту - персонал для певного типу документа. Це дозволить генерувати цей звіт з відповідного джерела. Наприклад, можна створити універсальний Excel звіт для наказу на відпустку (наприклад, по формі П-3), створити Excel шаблон для нього, шаблон даних і налаштувати універсальний звіт. Після цього, зазначити звіт 72835670 на сторінці Вибір звіту-персонал для Наказу на відпустку, обрати необхідний макет. При запуску друку з наказу на відпустку з'яявиться можливість сформувати цей звіт в Excel відповідно до налаштованого шаблону універсального звіту.

6. Формування звіту з кількох компаній

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

Налаштування:

  1. На картці Універсального звіту Excel встановіть Кілька компаній = Так.
  2. Оберіть Вибір компаній — запитувати щоразу, усі компанії або збережений фільтр компаній.
  3. Для колонки компанії додайте в шаблон даних змінну над таблицею Інформація про компанію і код зіставлення, що читає її поле Назва, а далі зіставте цей код із коміркою як звичайно. У таблиці "Інформація про компанію" один запис на компанію, тож рушій прочитає потрібний у кожній компанії — жодного окремого налаштування у звіті не треба.
  4. Встановіть Друкувати один раз для секцій, які належать книзі, а не компанії, — заголовка, шапки колонок або завершальної секції. Секція Друкувати один раз, розташована після останньої секції, що записується для кожної компанії, є завершальною секцією: вона записується один раз, після останньої компанії, зі значеннями останньої компанії, яку вдалося прочитати. Звіт не підсумовує компанії між собою; для підсумку за всіма компаніями використовуйте формулу Excel у шаблоні.

Звіт записує свої секції один раз для кожної компанії, у порядку, в якому компанії обрано. Так одне й те саме налаштування дає обидві форми звіту:

  • Рядок на компанію — використовуйте неповторювані секції, значення яких є агрегаціями шаблону даних (Сума, Кількість, Середнє). Кожна компанія дає один рядок, бо кожен розрахунок бачить одну компанію.
  • Деталізація всіх компаній — використовуйте повторювані секції. Рядки всіх компаній ідуть одна за одною в одній таблиці, а колонка компанії їх розрізняє. Секція перед ними працює як заголовок компанії.

Про що варто пам'ятати

  • Фільтри тлумачаться буквально в кожній компанії. Фільтр, який називає номер рахунку, значення виміру чи номер клієнта, не знайде нічого в компанії, де такого значення немає. Це саме стосується фільтрів, які вводяться на сторінці фільтра під час запуску звіту.
  • Права діють ваші, окремо в кожній компанії. Компанію, яку вам не дозволено читати, буде пропущено (або звіт зупиниться — залежно від поля Якщо компанію не прочитано). Пропущені компанії та причину для кожної показано в повідомленні після експорту: коротший звіт ніколи не буває мовчазним.
  • Компанію без запису головного об'єкта даних буде пропущено так само.
  • Звіт коштує одного повного розрахунку на компанію. Якщо компаній більше кількох, запускайте його через чергу завдань, а не зі сторінки.

7. Перенесення звіту в іншу базу

Готовий звіт складається з трьох частин: шаблон Excel, шаблон даних, який обчислює значення, і налаштування, що зв'язує одне з одним. Дії Експортувати пакет звіту та Імпортувати пакет звіту на сторінці Універсальний Excel звіт переносять усі три частини одним файлом .json, тож звіт, зроблений один раз, можна передати в інше середовище, нічого не набираючи повторно.

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

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

Знахідка Що означає
PKG-KIND Файл не є пакетом звіту. Виберіть файл, створений дією Експортувати пакет звіту.
PKG-ROOT-TABLE Головної таблиці даних тут немає. Найімовірніше, не встановлено додаток, якому вона належить.
PKG-REPORT-EXISTS Звіт із таким кодом уже є, а заміну не підтверджено.
PKG-CELL-MISSING Відображення вказує на комірку Excel, якої після імпорту не буде.
PKG-TEMPL-KEPT / PKG-TEMPL-REPLACED Що сталося з шаблоном Excel, який уже був у базі.
PKG-COMPANY-FILTER Фільтр компаній із файлу не відповідає жодній компанії — виправте його після імпорту.
IMP-… Знахідка про шаблон даних усередині пакета; її повідомляє SMART Data Template.

Про що варто пам'ятати

  • Для імпорту не потрібен зовнішній сервіс Excel. Зазвичай імпорт файлу .xlsx відправляє його на аналіз; пакет уже несе результат цього аналізу в собі, тож його можна імпортувати в середовищі, де сервіс Excel Report Builder ніколи не налаштовували.
  • Шаблон Excel, який уже є в базі, зберігається, а не перезаписується. Шаблони Excel спільні для всіх звітів, які на них посилаються, тож заміна одного змінює й інші звіти. Перед цим вас запитають.
  • Назви компаній в іншій базі інші. Фільтр компаній переноситься як є, і про те, що він нічому не відповідає, буде повідомлено — перевірте його після імпорту.
  • Вибір звітів не переноситься. Звіт, який використовується для друку документів, потрібно підчепити до документа в цільовій базі заново.