Wtyczka zawiera implementację źródeł danych operujących na plikach PRN. Za pomocą opisanego źródła można zapisywać dane do plików PRN.

W przypadku przekazywania wartości parametrów tabelarycznych zawierających więcej niż jedną wartość — pojedyncze wartości z innych parametrów są powielane w każdym wierszu pliku wynikowego.

W przypadku "nierównych kolumn" pośród wartości parametrów (np. w jednym parametrze przekazywanych jest 5 wartości, a w innym 2), do krótszego parametru dopisywane są puste wartości.

Nazwa parametruOpis parametruWartość domyślnaWymagalnośćUwagi i ograniczenia
Ścieżka do pliku

Parametryzowana absolutna ścieżka do pliku na dysku. Można skorzystać z dodatkowych znaczników opisanych poniżej

  • {PWFL_HOME} - wstawia automatycznie ścieżkę do katalogu domowego
  • {WORKING_DIRECTORY} - wstawia automatycznie ścieżkę do katalogu tymczasowego ustawionego w parametrach systemowych ("WorkingDirectory")
 Wymagany 
KodowanieFormat kodowania znaków w plikuUTF-8Wymagany 
Obsługa istniejącego pliku

Określa czynność, która zostanie wykonana w przypadku, gdy w lokalizacji wskazanej w parametrze 'Ścieżka do pliku' istnieje już plik PRN.

Możliwe wartości:

  • Dopisz - dopisze wartości do istniejącego pliku lub stworzy nowy, gdy plik nie istnieje
  • Nadpisz - nadpisze wszystkie wartości w istniejącym pliku lub stworzy nowy, gdy plik nie istnieje
Dopisz  
Id parametru ścieżkiUnikalne id parametru ścieżki Opcjonalny 
Nazwa parametru ścieżkiNazwa parametru ścieżki wyświetlana w systemie Opcjonalny 
Id parametru

Unikalne id parametru wyjściowego. Można skorzystać ze zmiennych kontekstowych za pomocą specjalnych oznaczeń, wstawiając w identyfikatorze jedną ze zmiennych (wielkość liter nie ma znaczenia):

Zmienna kontekstowaWstawiana wartość
@ctx_FileNameNazwa pliku (bez rozszerzenia)
@ctx_FileNameWithExtensionNazwa pliku z rozszerzeniem
@ctx_FilePathPełna ścieżka do pliku
 WymaganyW przypadku wybrania tego samego identyfikatora dla parametru ścieżki oraz dla parametru wyjściowego wyświetlane będzie jedno pole do wpisania wartości, z nazwą zdefiniowaną w polu "Nazwa parametru ścieżki".
Nazwa Nazwa parametru wyjściowego wyświetlana w systemie Wymagany 
DługośćDługość parametru. Jest to wartość liczbowa określająca maksymalną długość, która zostanie zapisana do pliku. Wymagany 
Typ

Typ parametru określający formatowanie wartości zapisywanych do pliku. Wszystkie typy wyrównują wartości do prawej strony. Możliwe wartości:

  • Tekstowy
  • Całkowity
  • Zmiennoprzecinkowy
  • Datowy
  • Data i czas

Różnice pomiędzy poszczególnymi typami zostały przedstawione w tabelce:

NazwaOpis
Tekstowy

Wyrównuje wartości poprzez wstawianie spacji w niewykorzystanej przestrzeni.

Przykład:

WartośćDługośćWynik
"FAKTURA 1/1/2023"20"    FAKTURA 1/1/2023"
"FAKTURA 1/1/2023"16"FAKTURA 1/1/2023"
"FAKTURA 1/1/2023"10"FAKTURA 1/"
Całkowity

Wyrównuje wartości poprzez wstawianie zer w niewykorzystanej przestrzeni.

Przykład:

WartośćDługośćWynik
"1234567890"15"000001234567890"
"1234567890"10"1234567890"
"1234567890"8"12345678"
Zmiennoprzecinkowy

Wyrównuje wartości poprzez wstawianie spacji w niewykorzystanej przestrzeni oraz zamienia kropki na przecinki.

Przykład:

WartośćDługośćWynik
"12345678.90"15"    12345678,90"
"12345678.90"11"12345678,90"
"12345678.90"8"12345678"
Datowy

Wyrównuje wartości poprzez wstawianie spacji w niewykorzystanej przestrzeni oraz formatuje datę do postaci "yyyyMMdd".

Przykład:

WartośćDługośćWynik
"2023-01-01"15"       20230101"
"2023-01-01"8"20230101"
"2023-01-01"6"202301"
Data i czas

Wyrównuje wartości poprzez wstawianie spacji w niewykorzystanej przestrzeni oraz formatuje datę i czas do postaci "yyyyMMddHHmmss".

Przykład:

WartośćDługośćWynik
"2023-01-01 09:10:20"20"      20230101091020"
"2023-01-01 09:10:20"16"20230101091020"
"2023-01-01"20"      20230101000000"
 Wymagany