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.
Nazwa parametru
Opis parametru
Wartość domyślna
Wymagalność
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
Kodowanie
Format kodowania znaków w pliku
UTF-8
Wymagany
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żki
Unikalne id parametru ścieżki
Opcjonalny
Nazwa parametru ścieżki
Nazwa 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 kontekstowa
Wstawiana wartość
@ctx_FileName
Nazwa pliku (bez rozszerzenia)
@ctx_FileNameWithExtension
Nazwa pliku z rozszerzeniem
@ctx_FilePath
Pełna ścieżka do pliku
Wymagany
W 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:
Nazwa
Opis
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".