CONVERT BITS TO FORMAT

Operator CONVERT BITS TO FORMAT umożliwia przekształcenie danych pochodzących z magistrali wejściowej na jednolity format tekstowy, zgodny z wymaganiami dalszego przetwarzania lub integracji z systemami zewnętrznymi.

Dane ze strumienia (rekordy i bity) mogą zostać automatycznie przekonwertowane do popularnych formatów strukturalnych takich jak:

JSON – JavaScript Object Notation,
XML – Extensible Markup Language,
CSV – Comma-Separated Values.

Dodatkowo, operator oferuje tryb User format, który umożliwia pełną kontrolę nad strukturą wyjściową – pozwalając na zdefiniowanie własnego układu tekstu przy użyciu znaczników i konstrukcji szablonowych. Dzięki temu możliwe jest przekształcenie danych magistrali do dowolnej postaci, np.:

HTML
EPP
EDI (np. EDIFACT, X12),
lub innych tekstowych struktur specyficznych dla konkretnego zastosowania.

Operator wykonuje przekształcenie dla całego strumienia danych dzięki czemu możliwe jest grupowanie danych czyli budowanie struktur zagłębionych.

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 bicie file_data odpowiadają danym zbudowanym z pierwszego poziomu grupowania

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.

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ć pojedynczy bit z całymi danymi z magistrali