Operator OUTPUT FILE umożliwia zapis danych znajdujących się na magistrali do pliku w wybranym formacie i we wskazanej lokalizacji. Działa na strumieniu danych wejściowych – każdy rekord i jego kolumny (bity) są przekształcane w zawartość pliku zgodnie z konfiguracją operatora.
Dzięki temu możliwe jest:
- eksportowanie danych do standardowych formatów plikowych, takich jak CSV, XLSX, JSON, XML itp.,
- zapis wyników przetwarzania do systemu plików, katalogu lokalnego lub współdzielonego, z możliwością dynamicznego tworzenia nazw plików (np. na podstawie daty, wartości z bitów, parametrów projektu),
- budowanie integracji plikowych, w których efektem działania aplikacji GRAVITY jest fizyczny plik możliwy do pobrania, przesłania lub dalszego przetwarzania,
Operator pozwala także na konfigurację struktury pliku (np. nagłówków, separatorów, typów danych) oraz formatowania danych zgodnie z wymaganiami odbiorcy.
Tryb działania operatora zależy od wybranego formatu:
- Dla standardowych formatów plików (CSV, JSON, XLSX, XML itd.) operator działa na całym zestawie danych magistrali, tworząc jeden spójny plik.
- Dla formatów typu plik binarny (Binary file) lub plik tekstowy (Text file) operator działa na poziomie pojedynczych rekordów, co oznacza, że każdy rekord może wygenerować osobny plik lub zawartość pliku, np. gdy chcemy zapisać binarne dane dokumentu lub zapisać wcześniej przygotowane dane tekstowe np z użyciem operatora
CONVERT BITS TO FORMAT.
Operator OUTPUT FILE jest powszechnie stosowany w procesach raportowania, eksportu danych, generowania faktur, tworzenia backupów oraz budowania interfejsów wymiany danych opartych o pliki.
Przykład projektu GRAVITY z użyciem operatora OUTPUT FILE.
TYPY PLIKÓW WYJŚCIOWYCH
Oprogramowanie GRAVITY pozwala na zapis strumienia danych z magistrali do wybranych formatów plików.
Dostępne typy plików to:
- XLSX
- CSV
- XML
- JSON
- Binary
- Text
W zależności od typu pliku na zakładce File format musisz wypełnić informacje specyficzne i niezbędne do konwersji magistrali danych do wybranego typu pliku.
USTAWIENIE PARAMETRÓW PLIKU WYJŚCIOWEGO
W zakładce OUTPUT FILE PROPERTIES ustawisz niezbędne parametry pliku generowanego przez operator.
W parametrze Target file recognization wskaż sposób tworzenia nowego pliku:
- Choosen file → Plik zawsze będzie zapisany do lokalizacji wskazanej w parametrze Path. Jeśli we wskazanej lokalizacji istnieje już plik w podanej nazwie zostanie on nadpisany nowym danymi.
- New file → System będzie tworzył nowy plik o wskazanej nazwie. Ścieżka zapisu pliku będzie pobierana z pola Path. Zarówno pole nowej nazwy jak i pole Path może być parametryzowane.
- File path from busbar → Ścieżka i nazwa pliku wskazana z bitu magistrali danych
Pole PATH zależnie od wybranego sposobu zapisu pliku odpowiada za samą ścieżkę lub ścieżkę i nazwę pliku. Pole może być parametryzowane wykorzystując zmienne systemowe, parametry projektu oraz bity magistrali danych.
Aby wybrać parametr ustaw się kursorem na miejscu gdzie chcesz wstawić parametr kliknij i przycisk parametrów.
W oknie parametrów wybierz parametr i kliknij przycisk Insert
W opcji Action after processing failure wybierz wariant akcji w przypadku niepowodzenia przetwarzania procesu.
Standardowo przetwarzanie tworzy nowy plik lub go nadpisuje, jeżeli znajdzie identyczny plik w dotychczasowej lokalizacji.
Możesz zadeklarować akcje:
- NO ACTION → przetwarzanie nie generuje nowego pliku
- CREATE OR OVERWRITE EMPTY FILE → wygenerowany plik będzie pusty
- REMOVE OLD FILE → jeżeli istnieje plik we wskazanej lokalizacji o tej samej nazwie, zostanie wykasowany
- REVERT → jeśli istniał plik w lokalizacji i został nadpisany to zostanie przywrócony.
KONFIGURACJA FORMATU PLIKU WYJŚCIOWEGO W zależności od formatu pliku wyjściowego użytkownik zobowiązany jest do ustawienia różnych parametrów tworzonego pliku (zakładka File format).
- XLSX → wymaga podania nazwy arkusza
- CSV → należy określić informacje o formacie pliku CSV czyli znak rozdzielający dane, czy w pierwszym wierszu będą nazwy kolumn i w jakim kodowaniu powstanie plik z CSV.
- XML → wymaga zamodelowania struktury pliku XML na podstawie bitów magistrali danych przy użyciu edytora formatu XML
- JSON → wymaga zamodelowania struktury pliku JSON na podstawie bitów magistrali danych przy użyciu edytora formatu JSON
- Binary → pozwala zapisać plik z danymi binarnymi. Dane binarne te muszą być transportowane na magistrali danych jako bit typu Blob, a konfiguracja sprowadza się do wyboru bitu magistrali, który reprezentuje dane binarne. Ten typ zapisze tyle plików ile będzie rekordów na magistrali.
- Text → pozwala zapisać plik z danymi tekstowymi. Konfiguracja sprowadza się do wyboru bitu magistrali, który reprezentuje dane tekstowe oraz kodowania w którym plik ma być zapisany. Ten typ zapisze tyle plików ile będzie rekordów na magistrali.
