Table of Contents

SMART Generic Excel Report

Rozszerzenie – SMART Generic Excel Report jest przeznaczone do używania razem z rozszerzeniem „SMART Data Template”.

Dodatek SMART Generic Excel Report to rozszerzenie dla Microsoft Dynamics 365 Business Central, które umożliwia generowanie raportów Excel na podstawie utworzonych szablonów danych. Wykorzystuje mapowania między zmiennymi szablonu danych a komórkami raportu Excel – bez pisania kodu i bez udziału programisty.

Aby generować uniwersalne raporty Excel, wykonaj poniższe kroki konfiguracji.

1. Tworzenie uniwersalnego raportu Excel

Strona: Uniwersalne raporty Excel

Utwórz nowy uniwersalny raport Excel, wypełniając następujące pola:

Pole Opis
Kod Unikatowy identyfikator raportu.
Opis Opis raportu.
Kod szablonu Excel Wybierz szablon Excel, który będzie używany do generowania raportu. Szablon musi być utworzony wcześniej, ze wszystkimi komórkami i nazwanymi zakresami potrzebnymi do mapowania danych z szablonów danych.
Id tabeli głównego elementu danych Identyfikator tabeli głównej.
Nazwa tabeli głównego elementu danych Nazwa tabeli głównej (wypełniana automatycznie).
Kod szablonu danych Wybierz szablon danych, na którym będzie oparty raport. Szablon danych musi zawierać wszystkie zmienne, które zostaną wyeksportowane do raportu Excel. Szczegółowy opis tworzenia i konfigurowania szablonu danych zawiera scenariusz SMART Data Template.
Wiele firm Ustaw Tak, aby tworzyć raport z danych kilku firm środowiska, jedna po drugiej. Zobacz sekcję 6.
Wybór firm Sposób wyboru firm: Zapytaj otwiera stronę filtru przy każdym uruchomieniu raportu, Wszystkie firmy używa każdej firmy, Filtr używa poniższego filtru firm.
Filtr firm Filtr nazwy firmy, na przykład COMPANY A\|COMPANY B. Przy opcji Zapytaj strona filtru otwiera się z tym filtrem, więc użytkownik potwierdza go lub zmienia, zamiast wpisywać go ponownie.
Błąd firmy Co dzieje się z firmą, której danych nie można odczytać: Pomiń firmę pomija ją i wyświetla ją po eksporcie, Pokaż błąd zatrzymuje raport. Wybierz Pokaż błąd, gdy skoroszyt ma być kompletny albo nie powstać wcale.

2. Tworzenie sekcji raportu

Dla wybranego szablonu Excel dodaj sekcje na podstronie Sekcje.

Pole Opis
Nazwa arkusza Nazwa arkusza w pliku Excel wybranym w polu Kod szablonu Excel – należy ją wybrać z listy rozwijanej.
Nazwa sekcji Nazwa odpowiedniego zakresu w szablonie Excel – należy ją wybrać z listy rozwijanej. Wszystkie zakresy muszą być wcześniej utworzone w szablonie Excel określonym w polu Kod szablonu Excel. Przykłady: HEADER, LINE, FOOTER.
Powtarzalna Ustaw Tak dla sekcji raportu Excel, które mają się powtarzać.
Drukuj raz Ustaw Tak dla sekcji, która należy do skoroszytu, a nie do firmy – tytułu raportu lub nagłówka kolumn. W raporcie wielofirmowym jest ona zapisywana tylko dla pierwszej firmy; każda inna sekcja jest zapisywana ponownie dla każdej firmy.

3. Konfigurowanie mapowania komórek Excel

Dla każdej komórki raportu Excel, która ma otrzymać dane z systemu, należy zdefiniować mapowanie na zmienne szablonu danych określonego w polu Kod szablonu danych. Aby skonfigurować to mapowanie, na karcie Uniwersalny raport Excel dla każdej sekcji przejdź do strony Mapowanie uniwersalnego raportu Excel, wybierając przycisk Mapowanie w wierszu sekcji.

Na stronie Mapowanie uniwersalnego raportu Excel możesz użyć funkcji Zaproponuj elementy danych, aby wybrać komórki szablonu Excel, które wymagają mapowania (komórki szablonu Excel są tworzone automatycznie, gdy użytkownik importuje szablon Excel do systemu).

Pole Opis
Nazwa elementu danych Nazwa komórki w szablonie Excel.
Typ danych Określ format, w jakim dane zostaną wyeksportowane do Excel, np.: Tekst (format tekstowy); Data (format daty); Dziesiętne (format liczbowy); Wartość logiczna (Tak/Nie).
Format liczby Określ format liczbowy stosowany do eksportowanych wartości.
Kod mapowania danych Określa zmienną szablonu danych używanego w tym uniwersalnym raporcie, która ma zostać wyeksportowana do wskazanej komórki Excel.

4. Uruchamianie raportu

Aby uruchomić raport, przejdź do strony Uniwersalny raport Excel i wybierz akcję Uruchom raport.

5. Wybór raportu na stronie Wybór Raportu - HRP

Utworzony Uniwersalny raport Excel można wybrać na stronie Wybór Raportu - HRP dla określonego typu dokumentu. Dzięki temu raport może być generowany z odpowiedniego źródła. Na przykład Uniwersalny raport Excel można utworzyć dla dokumentu Formularz Urlop wraz z szablonem Excel, szablonem danych i skonfigurowanym raportem uniwersalnym. Następnie na stronie Wybór Raportu - HRP dla dokumentu Formularz Urlop można wskazać raport 72835670 i wybrać wymagany układ. Podczas drukowania z formularza urlopu będzie wtedy możliwe wygenerowanie tego raportu w Excel zgodnie ze skonfigurowanym szablonem Uniwersalny raport Excel.

6. Tworzenie raportu z kilku firm

Raport może zebrać dane z kilku firm tego samego środowiska w jednym skoroszycie. Szablon danych nie wymaga żadnych zmian: raport oblicza go raz dla każdej firmy, a każda tabela szablonu jest odczytywana w tej firmie.

Aby to skonfigurować:

  1. Na karcie Uniwersalny raport Excel ustaw w polu Wiele firm wartość Tak.
  2. Wybierz wartość w polu Wybór firm – pytanie przy każdym uruchomieniu, wszystkie firmy lub zapisany filtr firm.
  3. Aby uzyskać kolumnę z firmą, dodaj do szablonu danych zmienną opartą na tabeli Informacje o firmie oraz kod mapowania odczytujący jej pole Nazwa, a następnie zmapuj ten kod mapowania na komórkę jak zwykle. Tabela Company Information zawiera jeden rekord na firmę, więc mechanizm odczytuje właściwy rekord w każdej firmie – kolumna nie wymaga w raporcie żadnego specjalnego ustawienia.
  4. Ustaw Drukuj raz dla sekcji, które należą do skoroszytu, a nie do firmy, takich jak tytuł lub nagłówek kolumn.

Raport zapisuje wtedy swoje sekcje raz dla każdej firmy, w kolejności wyboru firm. Ta sama konfiguracja daje oba kształty raportu wielofirmowego:

  • Jeden wiersz na firmę – użyj sekcji niepowtarzalnych, których wartości są agregacjami (Suma, Liczba, Średnia) szablonu danych. Każda firma daje jeden wiersz, ponieważ każde obliczenie widzi jedną firmę.
  • Wiersze szczegółowe wszystkich firm – użyj sekcji powtarzalnych. Wiersze wszystkich firm następują po sobie w jednej tabeli, a kolumna z firmą pozwala je rozróżnić. Sekcja umieszczona przed nimi działa jak nagłówek firmy.

O czym warto pamiętać

  • Filtry są dosłowne w każdej firmie. Filtr wskazujący numer konta, wartość wymiaru lub numer nabywcy nie znajdzie niczego w firmie, która nie używa tej wartości. To samo dotyczy filtrów wprowadzonych na stronie filtru przy uruchamianiu raportu.
  • Uprawnienia są Twoje, osobno dla każdej firmy. Firma, której nie możesz odczytać, jest pomijana (albo zatrzymuje raport, zależnie od pola Błąd firmy). Pominięte firmy wraz z przyczyną dla każdej z nich są wyświetlane w komunikacie po eksporcie – krótszy raport nigdy nie powstaje bez ostrzeżenia.
  • Firma bez rekordu głównego elementu danych jest pomijana w ten sam sposób.
  • Raport kosztuje jedno pełne obliczenie na firmę. Przy więcej niż kilku firmach uruchamiaj go z kolejki zadań, a nie ze strony.

7. Przenoszenie raportu do innej bazy danych

Gotowy raport to trzy elementy: szablon Excel, szablon danych, który wyznacza wartości, oraz konfiguracja, która mapuje jedno na drugie. Akcje Eksportuj pakiet raportu i Importuj pakiet raportu na stronie Uniwersalny raport Excel przenoszą wszystkie trzy w jednym pliku .json, dzięki czemu raport zbudowany raz można dostarczyć do innego środowiska bez ponownego wpisywania czegokolwiek.

Eksportuj pakiet raportu zapisuje plik. Zawiera on raport z sekcjami i mapowaniami, sam skoroszyt Excel, odczytane z niego arkusze, sekcje i nazwane komórki oraz cały szablon danych.

Importuj pakiet raportu odczytuje go z powrotem. Nic nie jest zapisywane, dopóki plik nie zostanie sprawdzony, a wszystko, co jest z nim nie tak, jest najpierw wyświetlane na liście:

Uwaga Znaczenie
PKG-KIND Plik nie jest pakietem raportu. Wybierz plik utworzony przez akcję Eksportuj pakiet raportu.
PKG-ROOT-TABLE Tabela głównego elementu danych tu nie istnieje. Rozszerzenie, do którego należy, prawdopodobnie nie jest zainstalowane.
PKG-REPORT-EXISTS Raport o tym kodzie już tu istnieje, a zastąpienie nie zostało potwierdzone.
PKG-CELL-MISSING Mapowanie wskazuje komórkę Excel, która nie będzie istnieć po imporcie.
PKG-TEMPL-KEPT / PKG-TEMPL-REPLACED Co stało się z szablonem Excel, który już tu istniał.
PKG-COMPANY-FILTER Filtr firm w pliku nie pasuje tu do żadnej firmy – popraw go po imporcie.
IMP-… Uwaga dotycząca szablonu danych zawartego w pakiecie, zgłoszona przez SMART Data Template.

O czym warto pamiętać

  • Import nie wymaga połączenia internetowego z usługą Excel. Import pliku .xlsx zwykle wysyła go do analizy; pakiet zawiera już wynik tej analizy, więc można go zaimportować w środowisku, w którym usługa Excel Report Builder nigdy nie została skonfigurowana.
  • Szablon Excel, który już tu istnieje, jest zachowywany, a nie nadpisywany. Szablony Excel są współużytkowane przez wszystkie raporty, które się do nich odwołują, więc zastąpienie jednego zmienia również inne raporty. Zanim to nastąpi, system zapyta o potwierdzenie.
  • Nazwy firm w innej bazie danych nie są takie same. Filtr firm jest przenoszony w postaci, w jakiej go zapisano, i jest zgłaszany, gdy do niczego nie pasuje – sprawdź go po imporcie.
  • Wybory raportów nie są przenoszone. Raport używany do drukowania dokumentów trzeba ponownie przypisać do dokumentu w docelowej bazie danych.