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

Wersja z 11 mar 2021, 16:32

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 1: / Linia 1: @@
 '''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|center|Format danych wejściowych]]
+Poniżej zaprezentowano przykład:
+[[Grafika:FDW_Excel1.JPG|800px|lewo|Format danych wejściowych]]
@@ Linia 20: / Linia 22: @@
 Poniżej zaprezentowano przykład:
-[[Grafika:FDW_Excel2.JPG|800px|center|Format danych wejściowych]]
+[[Grafika:FDW_Excel2.JPG|800px|lewo|Format danych wejściowych]]
 Dla powyższych danych utworzone zostaną dwa osobne dokumenty.
@@ Linia 31: / Linia 33: @@
 * 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:
@@ Linia 42: / Linia 48: @@
 * 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.
+* w ramach wiersza recordseta mogą pojawić się dowolne dane. W przypadku mechanizmu "DOC to PDF"
-* 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')}
+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:
@@ Linia 52: / Linia 64: @@
 * 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".
-* 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.
+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:
-[[Grafika:FDW_JSON.JPG|1000px|center|Format danych wejściowych]]
+[[Grafika:FDW_JSON.JPG|1000px|lewo|Format danych wejściowych]]
 '''3.1. Recodset'''
@@ Linia 63: / Linia 80: @@
 * 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.
+* w ramach wiersza recordseta mogą pojawić się dowolne dane. W przypadku mechanizmu "DOC to PDF"
-* 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')}
+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|center|Format danych wejściowych]]
+[[Grafika:JSON Recordset.jpg|1000px|lewo|Format danych wejściowych]]

Primesoft (dyskusja | edycje)

Wersja z 11 mar 2021, 16:32