Page History

...

Element	Opis	Wymagany
obiekt	Oznacza typ obiektu w szablonie. Możliwe są następujące wartości: value i table. Obiekt value wskazuje na pojedynczą wartość z pliku EDI, która ma zostać wstawiona w dane miejsce. Placeholder ten może występować wszędzie - w ciele głównym szablonu, nagłówkach, tabelach itd. Obiekt table oznacza wartość, która może zostać wielokrotnie powielona, w zależności od ilości dopasowań placeholder'a w pliku EDI. Placeholder ten może występować jedynie w komórkach tabeli w dowolnym miejscu - pierwszy wiersz, drugi wiersz n-ty wiersz, nie musi to także być ostatni wiersz, dopuszczalne jest także dodanie wierszy podsumowujących w wierszu pod placeholder'em. Zostanie on zamieniony pierwszą dopasowaną wartością, a pozostałe utworzą nowe komórki dodane od obecnej komórki. W jednej komórce możliwe jest wykorzystanie kilku placeholder'ów, wartości zostaną połączone za pomocą spacji. Dodawanych jest tyle komórek, ile wymaga najdłuższy szereg wartości. Dla pozostałych kolumn, które mają mniej wartości dodawane są puste komórki. Podczas kopiowania komórek są przenoszone właściwości wierszy i komórek (np. obramowanie, kolor tła komórek).
sekcja w pliku EDI	Oznacza nazwę sekcji w pliku EDI wynikającą ze standardu EDI. Możliwe są następujące wartości: header, details, summary. W celu uzyskania informacji o sekcjach i wykrywaniu ich granic w pliku EDI należy zapoznać się ze standardem np. dla UN/EDIFACT (http://www.unece.org/cefact/edifact/welcome.html w tym np. dla typu D96A http://www.unece.org/trade/untdid/d96a/Welcome.html). Wartości są grupowane dla poszczególnych sekcji.
segment w pliku EDI	Oznacza tag segmentu, najczęściej trzyliterowy znacznik, pierwszy element w każdej nowej linii pliku EDI.
(filtr)...(filtr)	Oznacza szereg dodatkowych filtrów postaci (wartość)(wartość) itd. Możliwe jest dodanie dowolnej ilości filtrów lub ich pominięcie. Pozwala on selektywnie wybierać wartości dla danego segmentu. Kolejne filtry są dopasowywane do kolejnych wartości w segmencie, jeżeli wartości z segmentu i filtru są takie same, to wartość jest brana pod uwagę. Możliwe jest także filtrowanie za pomocą pustych wartości - filtr postaci () oraz akceptowanie każdej wartości - filtr postaci (*). Filtrowanie jest szczególnie przydatne w przypadku danych tabelarycznych (patrz przykłady).
numer komponentu w segmencie	Oznacza pozycję wartości w segmencie, która ma zostać pobrana. Wartości są liczone od 1, włącznie z pustymi wartościami. Np. w segmencie postaci CUX+2:EUR:4' wartość "EUR" jest komponentem o numerze 2 w segmencie CUX.
numer wartości w pobranym szeregu	Oznacza numer wartości w pobranym szeregu. Wartości są liczone od 1. W przypadku braku wartości i dopasowaniu do placeholder'a większej ilości wartości są one łączone w jedną wartość i rozdzielane znakiem spacji. Np. dla segmentów: MOA+79:9086.83' MOA+125:9086.83' MOA+124:0' MOA+128:9086.83' pobranie wartości z pozycji numer 2 skutkuje zwróceniem wartości "9086.83 9086.83 0 9086.83", w przypadku wskazania numeru wartości w szeregu o wartości 3 zwrócona jest wartość "0". Wartość nie ma znaczenia dla placeholder'ów z obiektem typu table. Po wprowadzeniu numeru wartości nie będą rozpoznawane.
nazwa funkcji(parametry):...:nazwa funkcji(parametry)	Oznacza szereg dodatkowych funkcji postaci functionName1(parameter2,...,parameterN):functionName1(parameter2,...,parameterN). Funkcje te formatują pobrane wartości. Może być ich nieskończenie wiele, wartość jest krok po kroku formatowana. Dla każdego kolejnego wywołania funkcji, wartość wejściowa jest rezultatem poprzedniego wywołania funkcji. Jeżeli w danej funkcji wystąpi błąd, to zwracana jest aktualna wartość wejściowa. Jeżeli funkcja o podanej nazwie nie istnieje, to zwracana jest aktualna wartość. Jeżeli liczba parametrów funkcji nie zgadza się z oczekiwaną liczbą parametrów, to zwracana jest aktualna wartość. Jeżeli w wartościach parametrów stosujemy znaki ":" lub ",", to należy je poprzedzić znakiem "\". Zestaw dostępnych funkcji jest zdefiniowany poniżej.

...

Podczas formatowania wartości można skorzystać z następujących zdefiniowanych funkcji:

• getPackageId - zwraca identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanieaddPrefix - dodaje przedrostek na początku formatowanej wartości.
  

  • Parametry funkcji: brak
    Rezultat

    Nazwa	Opis
    prefix	Przedrostek dodawany na początku wartości.

• addPostfix - dodaje przyrostek na końcu formatowanej wartości.
  

  • Parametry funkcji:
    

    Typ

    Nazwa	Opis
    String	Identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie

  getPackageId - zwraca identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie

  • postfix

    Przyrostek dodawany na końcu wartości.

• customFunction - uruchamia dowolną funkcję, która formatuje wartość.
  

  • Parametry funkcji: brak
    Rezultat funkcji:

    Nazwa

    Typ	Opis
    String	Identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie

  getPackageId - zwraca identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie.
  

• Parametry funkcji: brak
  

Rezultat funkcji:


Typ	Opis
String	Identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie

getPackageId - zwraca identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie.


• Parametry funkcji: brak
  

Rezultat funkcji:


Typ	Opis
String	Identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie

getPackageId - zwraca identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie.


• Parametry funkcji: brak
  

Rezultat funkcji:


Typ	Opis
String	Identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie

getPackageId - zwraca identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie.


• Parametry funkcji: brak
  

Rezultat funkcji:


Typ	Opis
String	Identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie

getPackageId - zwraca identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie.


• Parametry funkcji: brak
  

Rezultat funkcji:


Typ	Opis
String	Identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadanie

g

• • Opis
    className	Pełna nazwa klasy Java wraz z pakietem.
    methodName	Nazwa metody w klasie Java podanej w parametrze className. Metoda musi być publiczna, statyczna, musi jako parametry przyjmować String (wartość wejściowa), List<String> (pozostałe parametry customFunction) oraz zwracać obiekt typu String.
    ...	Pozostałe parametry, które są przekazywane w formie interface List do wywołania metody. Parametrów może być nieskończenie wiele.

• formatAmount - formatuje wartość kwotową postaci 123456.56789.
  

  • Parametry funkcji:
    

    Nazwa	Opis
    format	Format wyjściowy zgodny z językiem Java (patrz DecimalFormat). Wartością wejściową musi być liczba nie zawierająca separatorów tysięcznych i posiadająca kropkę jako separator dziesiętny lub też brak separatora dziesiętnego.

• formatDateTime - formatuje datę lub czas.
  

  • Parametry funkcji:
    

    Nazwa	Opis
    fromFormat	Wejściowy format daty zgodny z językiem Java (patrz DateFormat).
    toFormat	Wyjściowy format daty zgodny z językiem Java (patrz DateFormat).

• removeCharacters - usuwa dowolne ciągi znaków z wartości.
  

  • Parametry funkcji:
    

    Nazwa	Opis
    characters	Usuwany ciąg znaków. Funkcja może posiadać nieskończenie wiele parametrów, znaki te są kolejno usuwane z wartości.
    ...	...

• replaceCharacters - zamienia dowolny ciąg znaków innym ciągiem znaków.
  

  • Parametry funkcji:
    

    Nazwa	Opis
    search	Poszukiwany ciąg znaków.
    replacement	Ciąg znaków, którym jest zastępowany znaleziony ciąg znaków z parametru search.

• skipEmptyTableValue - pomija wiersz z pustą wartością w danych tabelarycznych.

  • Parametry funkcji: brak

   
  
• transformUnit - zamienia jednostki miar i wag znane dla pliku EDI, nazwy jednostek występują w języku angielskim.
  

  • Parametry funkcji: brak

Przykłady

Załóżmy, że dysponujemy następującą fakturą EDI typu UN/EDIFACT D96A:

...

• ${value:header:CUX:2} - EUR
• ${value:header:DTM:2:1:formatDateTime(yyyyMMdd,yyyy-MM-dd)} - 2015-01-21
• ${value:header:FTX:4} - FRANCH TVA, ART 275 CGI PAULSTRA                      SNC
• ${value:header:FTX:4:1} - FRANCH TVA, ART 275 CGI
• ${value:header:RFF:2} - FR47542035753 542035753 FR47542035753 542035753 R.C.S. PARIS B 314.397.670 FR39314397670 314397670
• ${value:header:RFF(VA):2} - FR47542035753 FR47542035753 FR39314397670
• ${value:header:RFF(VA):2:3} - FR39314397670
• ${value:details:MEA:4} - 49 874 144 0 84 0 317 0
• ${value:details:MEA(AAI)(AAA):4} - 49 144 84 317
• ${value:summary:TAX:4} - 9086.83

...

na

Podczas konwersji szablonu docx na pdf za pomocą Docx4J wykorzystywana jest transformacja XSLT, która posiada pewne ograniczenia. Jeżeli pewne komponenty są zmieniane lub znikają, to moduł nie ma na to wpływu. Podczas uzupełniania szablonu w celu poprawnego uzupełnienia danych usuwane/zmieniane są następujące elementy:

• content control - usuwane
• bookmark'i - usuwane
  
• floating images - usuwane
  
• załamane nagłówki tabel - zmieniane, wyraz jest w jednej linii, co może powodować wychodzenie liter poza komórkę
• brak obramowania tabeli numeracja stron - zmieniane, pojawia się obramowanienie zmienia numeracji