Formaty danych wejściowych
1. Excel Podstawowy arkusz excel zawierający dane wejściowe musi zawierać pierwszy wiersz określający nazwy kolumn oraz przynajmniej jeden wiersz z danymi. Poniżej zaprezentowano przykład:
W takim przypadku każdy wiersz z danymi będzie generowany jako osobny plik lub też osobny mail.
Aby dodać do szablonu docx wartość z excela należy wstawić tag ${kolumna} → np. ${nr_umowy}
1.1. Recodset W przypadku wykorzystania recordsetów (dodatkowych danych do każdego dokumentu, np. tabela z ratami) konieczne jest zastosowanie poniższych zasad:
pierwszy wiersz zawiera nazwy kolumn dane dla recordsetów zamieszczone są na końcu arkusza standardowe dane oddzielone są od danych recordsetu kolumną recordset. Kolumna ta zawiera ilości wierszy recordsetu. wszystkie wartości dla kolumn znajdujących się po prawej stronie kolumny recordset zawierają dane wstawiane jako tabela w szablonie. wszystkie wartości dla kolumn znajdujących się po lewej stronie kolumny recordset muszą być powielone tyle razy ile mamy wierszy recordsetu. Poniżej zaprezentowano przykład:
Dla powyższych danych utworzone zostaną dwa osobne dokumenty.
Aby dodać do szablonu docx wartość recordsetu z excela należy wstawić to tabeli tag ${recordset(kolumna)} → np. ${recordset(kapital)}
2. XML Podstawowy plik XML zawierający dane wejściowe powinien zawierać następujące elementy:
element główny (root) o nazwie "GDK" przynajmniej jeden rekord danych, który otoczony jest elementem "GDK_ROW". Element ten może posiadać opcjonalny atrybut "RowNumber", który określa numer wiersza danych. w ramach rekordu mogą pojawić się dowolne dane. W przypadku mechanizmów "DOC to PDF" i "XFDF to PDF" dozwolony jest tylko jeden poziom zagnieżdżenia danych. Poniżej zaprezentowano przykład tożsamy z zestawem danych z punktu 1:
3. JSON Podstawowy plik JSON zawierający dane wejściowe powinien zawierać następujące elementy:
element główny (root) o nazwie "GDK" przynajmniej jeden rekord danych, który otoczony jest elementem "GDK_ROW". Element ten może posiadać opcjonalny element "@RowNumber", który określa numer wiersza danych. w ramach rekordu mogą pojawić się dowolne dane. W przypadku mechanizmów "DOC to PDF" i "XFDF to PDF" dozwolony jest tylko jeden poziom zagnieżdżenia danych. Poniżej zaprezentowano przykład tożsamy z zestawem danych z punktu 1:
