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, to 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 są wskazane z bitu magistrali danych.
Pole PATH odpowiada za samą ścieżkę lub za ścieżkę i nazwę pliku, w zależności od wybranego sposobu zapisu. Pole może być parametryzowane przy użyciu zmiennych systemowych, parametrów projektu lub bitów 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 polu Action after processing failure określ sposób postępowania w przypadku niepowodzenia przetwarzania.
Domyślnie system tworzy nowy plik lub nadpisuje istniejący, jeśli w bieżącej lokalizacji znajduje się plik o tej samej nazwie.
Dostępne warianty akcji:
- NO ACTION → przetwarzanie nie generuje nowego pliku,
- CREATE OR OVERWRITE EMPTY FILE → zostanie utworzony pusty plik,
- REMOVE OLD FILE → plik o tej samej nazwie w lokalizacji zostanie usunięty,
- REVERT → jeśli istniejący plik został nadpisany, zostanie przywrócony do poprzedniej wersji.
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.
