Przykład projektu z wykorzystaniem operatora CONVERT BITS TO FORMAT.
Operator pozwala na przekształcenie danych magistrali wejściowej w dowolny format danych, w formie tekstowej, który może posiadać strukturę drzewiastą. Tekst zbudowany na podstawie wybranego i skonfigurowanego formatu zostanie dodany do magistrali wyjściowej jako dodatkowy bit danych o nazwie file_data.
Magistrala wyjściowa operatora różni się od magistrali wejściowej, a ilość bitów oraz ilość rekordów zależy od wykorzystania bitów magistrali wejściowej do budowy formatu danych tekstowego.
Na magistrali wyjściowej znajdą się tylko te bity, które posłużyły do budowy danych pierwszego poziomu w formacie tekstowym + bit file_data, który będzie przechowywał zbudowany tekst. Natomiast ilość rekordów magistrali będzie wynikiem grupowania magistrali wejściowej z użyciem bitów pierwszego poziomu.
Oznacza to, że operator potrafi zbudować dane w formie tekstowej na postawie magistrali, która niesie w sobie informacje typu rodzic → dziecko (wartości bitów rodzica są powielone tyle razy ile ma dzieci np. zamówienie → pozycje), a na magistrali wyjściowej pozostaną tylko bity danych rodzica plus bit z danymi tekstowymi oraz ilość rekordów równa ilości rodziców.
np. jeśli na magistrali transportujesz dane 3 zamówień i każde zamówienie ma 2 pozycje to łącznie na magistrali wejściowej będzie 6 rekordów. Tworząc format tekstowy JSON na pierwszym poziomie użyjesz tylko bity zamówienia, a na drugim tylko bity pozycji to magistrala wyjściowa będzie miała tylko 3 rekordy i bity z pierwszego poziomu + bit tekstowy file_data.
KONFIGURACJA OPERATORA
Konfiguracja operatora sprowadza się do wybrania formatu do jakiego chcesz konwertować bity magistrali wchodzącej oraz użycia edytora wybranego formatu w celu zameldowania konwersji.
Masz do wyboru trzy formaty danych:
- XLSX file → Pozwala konwertować dane do formatu excel
- CSV file → Pozwala konwertować dane do formatu CSV
- XML file → Pozwala konwertować dane do formatu XML. Po wyborze zobaczysz zakładkę XML File format i musisz wcisnąć przycisk Define XML scheme. Otworzy się okno Edytor formatu XML gdzie możesz budować strukturę XML.
- JSON file → Pozwala skonwertować dane do formatu JSON. Po wyborze zobaczysz zakładkę JSON File format i musisz wcisnąć przycisk Define JSON scheme. Otworzy się okno Edytor formatu JSON gdzie możesz budować strukturę JSON.
- User format → Pozwala skonwertować dane do dowolnego formatu tekstowego. Po wyborze zobaczysz zakładkę User file format. Musisz określić separator początkowy i końcowy bitów magistrali wstawianych w edytorze, a następnie przejść do Edytor konwersji bitów do dowolnego formatu tekstowego - User format gdzie możesz budować dowolny format tekstowy.
ZAKŁADKA PROPERTIES
Definiując pole Result target możesz zdecydować w jaki sposób operator ma generować magistralę danych wyjściową. Masz do wyboru dwie opcje:
- Create a busbar with the columns from the first grouping bit text → powoduje wygenerowanie magistrali z wartościami kolumn, które znalazły się na pierwszym poziomie grupowania plus bit z wygenerowanym formatem danych
file_data
. Oznacza to, że magistrala wyjściowa będzie posiadała tyle wierszy ile rekordów powstanie z pierwszego grupowania, a dane w biciefile_data
odpowiadają danym zbudowanym z pierwszego poziomu grupowania - Create a busbar without grouped columns → magistrala wyjściowa zostanie zbudowana tylko i wyłącznie z bitu
file_data
a dane w tym bicie będą odpowiadały całej magistrali wyjściowej.
Używaj tego typu gdy chcesz zbudować w bicie file_data
dane dla konkretnej grupy bitów np: dane konkretnej faktury w osobnych bitach file_data
.
Używaj tego typu gdy chcesz zbudować pojedynczy bit z całymi danymi z magistrali