Formaty danych wejściowych: Różnice pomiędzy wersjami
Nie podano opisu zmian |
Nie podano opisu zmian |
||
| (Nie pokazano 14 pośrednich wersji utworzonych przez tego samego użytkownika) | |||
| Linia 1: | Linia 1: | ||
'''1. Excel''' | '''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: | Podstawowy arkusz excel zawierający dane wejściowe musi zawierać pierwszy wiersz określający nazwy kolumn oraz przynajmniej jeden wiersz z danymi. | ||
[[Grafika:FDW_Excel1.JPG|800px| | |||
Poniżej zaprezentowano przykład: | |||
[[Grafika:FDW_Excel1.JPG|800px|lewo|Format danych wejściowych]] | |||
| Linia 15: | Linia 25: | ||
pierwszy wiersz zawiera nazwy kolumn | pierwszy wiersz zawiera nazwy kolumn | ||
dane dla recordsetów zamieszczone są na końcu arkusza | 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. | 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 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. | 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: | Poniżej zaprezentowano przykład: | ||
[[Grafika:FDW_Excel2.JPG|800px| | [[Grafika:FDW_Excel2.JPG|800px|lewo|Format danych wejściowych]] | ||
Dla powyższych danych utworzone zostaną dwa osobne dokumenty. | Dla powyższych danych utworzone zostaną dwa osobne dokumenty. | ||
| Linia 31: | Linia 61: | ||
* element główny (root) o nazwie "GDK" | * 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. | * przynajmniej jeden rekord danych, który otoczony jest elementem "GDK_ROW". Element ten może posiadać opcjonalny atrybut "RowNumber", | ||
* 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. | |||
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: | Poniżej zaprezentowano przykład tożsamy z zestawem danych z punktu 1: | ||
[[Grafika:FDW_XML.JPG|1000px| | [[Grafika:FDW_XML.JPG|1000px|lewo|Format danych wejściowych]] | ||
'''2.1. Recodset''' | '''2.1. Recodset''' | ||
| Linia 43: | Linia 98: | ||
* każdy wiersz recordsetu może zawierać opcjonalny element RecordsetNumber określający numer wiersza danych. | * 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. | * 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. | * 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')} | * Aby dodać do szablonu docx wartość recordsetu z nazwą należy wstawić do tabeli tag ${recordset(kolumna, 'nazwa recodsetu')} → np. ${recordset(kapital, 'harmonogram')} | ||
| Linia 49: | Linia 106: | ||
'''3. JSON''' | '''3. JSON''' | ||
Podstawowy plik JSON zawierający dane wejściowe powinien zawierać następujące elementy: | Podstawowy plik JSON zawierający dane wejściowe powinien zawierać następujące elementy: | ||
* element główny (root) o nazwie "GDK" | * 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. | * 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. | * 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: | Poniżej zaprezentowano przykład tożsamy z zestawem danych z punktu 1: | ||
[[Grafika:FDW_JSON.JPG|1000px| | [[Grafika:FDW_JSON.JPG|1000px|lewo|Format danych wejściowych]] | ||
'''3.1. Recodset''' | '''3.1. Recodset''' | ||
| Linia 66: | Linia 153: | ||
* 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. | * 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')} | * 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: | Poniżej zaprezentowano przykład tożsamy z zestawem danych z punktu 1: | ||
[[Grafika:JSON Recordset.jpg|1000px|lewo|Format danych wejściowych]] | |||
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 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:
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:
ArthurDoc Podręcznik użytkownika
ArthurDoc Podręcznik administratora
