Definicje raportów domyślnych znajdują się w katalogu z zainstalowaną aplikacją, a dokładnie Comarch WMS\Management\ReportDefinitions\Common.
Definicja XML raportu składa się z następujących głównych sekcji:
- Nazwa raportu
- Opis
- Definicje argumentów
- Definicje elementów raportu
- Definicja klas CSS
- Definicja układu elementów raportu (layout)
Ogólna struktura raportu jest następująca:
1. Nazwa raportu
Nazwa raportu podana w elemencie <Name> jest wyświetlana na górnej belce widoku raportu oraz na kafelkach listy raportów.
Przykład użycia:
<Name>Raport wydajności pracowników</Name>
2. Opis raportu
Opis raportu podany w elemencie jest wyświetlany na kaflach listy z raportami.
Przykład użycia:
<Description>Raport wydajności pracowników według dni</Description>
3. Elementy raportu
Raport może składać się z wielu elementów następującego typu:
- Tabela płaska
- Tabela wielopoziomowa
- Wykres słupkowy
- Wykres liniowy
- Wykres kołowy
- Tekst
Definicje elementów raportu należy umieścić w sekcjach
Elementami XML wspólnymi dla każdego typu jest:
- Identyfikator elementu (unikalna liczba całkowita) w elemencie
, np. 1 ,- Typ elementu określony w węźle
, np. PivotTable , dostępne wartości:- Table – tabela płaska
- PivotTable – tabel wielopoziomowa
- Bar – wykres słupkowy
- Pie – wykre kołowy
- Line – wykres liniowy
- Text – element typu tekst
- Zapytanie SQL pobierające dane do elementu raportu określone w elemencie
, np. - Typ elementu określony w węźle
Dodatkowo dla tabel oraz wykresów można zdefiniować tytuł wyświetlany nad elementem w sekcji <Header>, np.
<Header>Wykres dziennej wydajności pracowników</Header>.
Struktura XML wspólna dla wszystkich elementów jest następująca:
4. Definicja układu elementów raportu
W ostatniej sekcji należy określić układ poszczególnych elementów raportu, wykorzystując sekcje:
Przykładowo chcąc umieścić dwa elementy raportu jeden nad drugim należy ustawić layout w następujący sposób: