...
| 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ść. 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: brakRezultat funkcji:
Nazwa Typ Opis String Identyfikator pakietu, w którym znajduje się aktualnie wykonywane zadaniePrzedrostek dodawany na początku wartości
- 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
- 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
Przykłady
Załóżmy, że dysponujemy następującą fakturą EDI typu UN/EDIFACT D96A:
...