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

ArthurDoc Strona główna

@@ Linia 5: / Linia 5: @@
 Poniżej zaprezentowano przykład:
 [[Grafika:FDW_Excel1.JPG|800px|lewo|Format danych wejściowych]]
@@ Linia 24: / Linia 25: @@
 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:
 [[Grafika:FDW_Excel2.JPG|800px|lewo|Format danych wejściowych]]
@@ Linia 55: / Linia 69: @@
 Poniżej zaprezentowano przykład tożsamy z zestawem danych z punktu 1:
-[[Grafika:FDW_XML.JPG|1000px|center|Format danych wejściowych]]
+[[Grafika:FDW_XML.JPG|1000px|lewo|Format danych wejściowych]]
 '''2.1. Recodset'''
@@ Linia 62: / Linia 97: @@
 * 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"
+* w ramach wiersza recordseta mogą pojawić się dowolne dane. W przypadku mechanizmu "DOC to PDF" dozwolony jest tylko jeden poziom zagnieżdżenia danych.
-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
+* Aby dodać do szablonu docx wartość recordsetu z nazwą należy wstawić do tabeli tag ${recordset(kolumna, 'nazwa recodsetu')} → np. ${recordset(kapital, 'harmonogram')}
-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:
@@ Linia 81: / Linia 113: @@
 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"
+* 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.
-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:
 [[Grafika:FDW_JSON.JPG|1000px|lewo|Format danych wejściowych]]
 '''3.1. Recodset'''
@@ Linia 94: / Linia 150: @@
 * 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"
+* 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:
+[[Grafika:JSON Recordset.jpg|1000px|lewo|Format danych wejściowych]]
-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:
-[[Grafika:JSON Recordset.jpg|1000px|lewo|Format danych wejściowych]]

Primesoft (dyskusja | edycje)

Aktualna wersja z 11 mar 2021, 16:39