Formaty danych wejściowych: Różnice pomiędzy wersjami

Aktualna wersja z 11 mar 2021, 16:39

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:

2.1. Recodset W przypadku wykorzystania recordsetów konieczne jest zastosowanie poniższych zasad:

każdy wiersz recodsetu dodawany jest do XMLa jako kolejny element potomny elementu "GDK_ROW"
każdy wiersz recordsetu może zawierać opcjonalny element RecordsetNumber określający numer wiersza danych.
w ramach wiersza recordseta mogą pojawić się dowolne dane. W przypadku mechanizmu "DOC to PDF" dozwolony jest tylko jeden poziom zagnieżdżenia danych.
do danych wejściowych można dodać kilka recordsetów. W takim wypadku recordsety należy nazwać.

Wykonuje się to poprzez dodanie do recordsetu nazwy: recordset_NAZWA_RECORDSETU.

Aby dodać do szablonu docx wartość recordsetu z nazwą należy wstawić do tabeli tag ${recordset(kolumna, 'nazwa recodsetu')} → np. ${recordset(kapital, 'harmonogram')}

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 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:

3.1. Recodset W przypadku wykorzystania recordsetów konieczne jest zastosowanie poniższych zasad:

każdy wiersz recodsetu dodawany jest do JSONa jako kolejny element potomny elementu "GDK_ROW"
każdy wiersz recordsetu może zawierać opcjonalny element RecordsetNumber określający numer wiersza danych.
w ramach wiersza recordseta mogą pojawić się dowolne dane. W przypadku mechanizmu "DOC to PDF" dozwolony jest tylko jeden poziom zagnieżdżenia danych.
do danych wejściowych można dodać kilka recordsetów. W takim wypadku recordsety należy nazwać. Wykonuje się to poprzez dodanie do recordsetu nazwy: recordset_NAZWA_RECORDSETU.
Aby dodać do szablonu docx wartość recordsetu z nazwą należy wstawić do tabeli tag ${recordset(kolumna, 'nazwa recodsetu')} → np. ${recordset(kapital, 'harmonogram')}

Poniżej zaprezentowano przykład tożsamy z zestawem danych z punktu 1: