Eksport danych do pliku za pomocą Flexy
Parametry:
Nazwa | Opis |
---|---|
tplnam | nazwa szablonu z lokalizacji var/tpl/ jaki zostanie użyty do eksportu danych |
action | akcja dla wygenerowanego pliku. Przyjmuje wartość liczbową: 1 (zapisz - plik zostanie zapisany w lokalizacji wskazanej w parametrze Skład), 2 (załącz do dokumentu - plik zostanie dodany jako załącznik do dokumentu) lub 3 (pobierz - plik zostanie przesłany do przeglądarki użytkownika co umożliwi jego bezpośrednie pobranie). Domyślnie ustawiona zostanie wartość 1.' |
repath | lokalizacja gdzie zostanie umieszony wygenerowany plik. Ścieżka nie musi być zakończona znakiem |
flname | nazwa pliku po jaką zostanie zapisany wygenerowany plik. Domyślnie jako nazwa zostanie użyta nazwa szablonu oraz znacznik czasu. W momencie jeśli w podanej lokalizacji istnieje już plik z podaną nazwą komenda zwróci błąd (chyba, że zostanie użyty parametr "Nadpisz") |
ovwrit | jeśli w podanej lokalizacji istnieje plik o podanej nazwie wpisz w parametrze 1 aby nadpisać istniejący. Domyślnie parametr przyjmuje wartość 0 - nie nadpisuje komenda zwraca błąd jeśli istnieje. |
outenc | kodowanie pliku wyjściowego. Domyślnie jest to UTF-8 |
Informacja dodatkowa
Wszystkie parametry maja możliwość pobierania wartości w następujący sposób:
- z cechy
- emp_id = "featid|81"
- emp_id = "featid::81"
- dscrpt = "Pracownik featid::81::string prosi o udzielenie urlopu okolicznościowego"
- bezpośrednio z otwartego formularza
- emp_id = "{rspuid}" gdzie wartość {rspuid} zostanie zamieniona na wartość w kolumnie (polu) odpowiedniej tabeli - dla formularza dokumentu documents (plus dodatkowe tabele) dla sprawy processes.
W podanym przypadku pole rspuid (osoba odpowiedzialna w sprawie) jest wartością z kolumny rspuid z tabeli processes.
- jako wynik zaptania SQL
- emp_id = "SQL::SELECT usr_id FROM users WHERE usr_id = featid|81"
- emp_id = "SQL::SELECT usr_id FROM users WHERE usr_id = featid::81"
- emp_id = "SQL::SELECT usr_id FROM users WHERE usr_id = {rspuid}"
- emp_id = "SELECT usr_id FROM users WHERE usr_id = {rspuid}" (dla wersji > 3.5)
- crtdat = "SELECT {$data_z_danej_wej}" ($data_z_danej_wej jest daną wejściową lub własnością)
- predefiniowane parametry
- {LOGGED_USR_ID} - id zalogowanego użytkownika
- {ENT_ID} - id jednostki na której pracuje użytkownik
- {PKEYVALUE} - wartość klucza głównego (id dokumentu/sprawy) patrz klucz główny
- {CURRENT_DATE} - aktualna data (dla wersji > 3.5)
- {CURRENT_TIME} - aktualny czas (dla wersji > 3.5)
- {LOGGED_ORUNID} - identyfikator stanowiska zalogowanej osoby (dla wersji > 3.5)
Predefiniowane parametry można używać w następujący sposób
- emp_id = "SQL::SELECT rspuid FROM processes WHERE prc_id = {PKEYVALUE}"
- emp_id = "{LOGGED_USR_ID}"
Sposób definicji parametrów można łączyć np.:
emp_id = "SQL::SELECT usr_id FROM users WHERE usrnam = featid:81 AND adddat > '{adddat}'::timestamp AND usr_id != {LOGGED_USR_ID} AND ent_id = {ENT_ID}" lub można wykonywać działania (przykład teoretyczny nigdzie nie występuje taki parametr 😉)
netto_ = "SQL::SELECT {brutto}::int * featid::89"
Do parametru określonego za pomocą cechy np featid::89 można dodać specjalny modyfikator - string czyli featid::89::string - pozwala to na pobranie wartości tekstowej cechy zdefiniowanej jako lista pracowników lub lista adresów. W wyniku działania tego modyfikatora otrzymamy na nazwę urządzenia wybranego w cesze.
Dodatkowo dla dokumentów różnych typów można podawać nazwy kolumn z dodatkowych tabel np dla faktur tabela vatnote itd.