Опис додатку 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. Формування звіту з кількох компаній
Звіт може зібрати дані кількох компаній одного середовища в одну книгу. Шаблон даних при цьому не змінюється: звіт розраховує його один раз для кожної компанії, і кожна таблиця шаблону читається в цій компанії.
Налаштування:
- На картці Універсального звіту Excel встановіть Кілька компаній = Так.
- Оберіть Вибір компаній — запитувати щоразу, усі компанії або збережений фільтр компаній.
- Для колонки компанії додайте в шаблон даних змінну над таблицею Інформація про компанію і код зіставлення, що читає її поле Назва, а далі зіставте цей код із коміркою як звичайно. У таблиці "Інформація про компанію" один запис на компанію, тож рушій прочитає потрібний у кожній компанії — жодного окремого налаштування у звіті не треба.
- Встановіть Друкувати один раз для секцій, які належать книзі, а не компанії, — заголовка, шапки колонок або завершальної секції. Секція Друкувати один раз, розташована після останньої секції, що записується для кожної компанії, є завершальною секцією: вона записується один раз, після останньої компанії, зі значеннями останньої компанії, яку вдалося прочитати. Звіт не підсумовує компанії між собою; для підсумку за всіма компаніями використовуйте формулу 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 спільні для всіх звітів, які на них посилаються, тож заміна одного змінює й інші звіти. Перед цим вас запитають.
- Назви компаній в іншій базі інші. Фільтр компаній переноситься як є, і про те, що він нічому не відповідає, буде повідомлено — перевірте його після імпорту.
- Вибір звітів не переноситься. Звіт, який використовується для друку документів, потрібно підчепити до документа в цільовій базі заново.