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 udostępnia tryb User format, który daje pełną kontrolę nad strukturą wyjściową. Umożliwia on 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 dowolnego formatu, na przykład:

HTML
EPP
EDI (np. EDIFACT, X12),
lub innych struktur tekstowych 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 liczba bitów oraz liczba 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 oraz bit file_data, który będzie przechowywał zbudowany tekst. Liczba 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 formacie tekstowym na postawie magistrali, która niesie w sobie informacje typu rodzic → dziecko. W takiej strukturze wartości bitów rodzica są powielane tyle razy, ile ma on elementów podrzędnych (np. zamówienie → pozycje). Na magistrali wyjściowej pozostaną jedynie bity danych rodzica, bit z danymi tekstowymi oraz liczba rekordów odpowiadająca liczbie rodziców.

Na przykład, jeśli na magistrali transportujesz dane trzech(3) zamówień, a każde zamówienie ma dwie(2) pozycje to łącznie na magistrali wejściowej będzie sześć(6) rekordów. Tworząc format tekstowy JSON, na pierwszym poziomie użyjesz tylko bitów zamówienia, a na drugim tylko bitów pozycji. W rezultacie magistrala wyjściowa będzie miała tylko trzy(3) rekordy oraz bity z pierwszego poziomu i 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 zdefiniowania konwersji.

Masz do wyboru poniższe 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 wybraniu formatu otwórz zakładkę XML File format i kliknij przycisk Define XML scheme. Zostanie otwarte okno Edytor formatu XML, w którym możesz zbudować strukturę dokumentu XML.

JSON file → Pozwala konwertować dane do formatu JSON. Po wybraniu tego formatu otwórz zakładkę JSON File format i kliknij przycisk Define JSON scheme. Zostanie otwarte okno Edytor formatu JSON, w którym możesz zbudować strukturę dokumentu JSON.

User format → Pozwala konwertować dane do dowolnego formatu tekstowego. Po wybraniu tej opcji otwórz zakładkę User file format. Określ separator początkowy i końcowy bitów magistrali, które będą wstawiane w edytorze, a następnie przejdź do Edytor konwersji bitów do dowolnego formatu tekstowego - User format, aby zbudować własny 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, oraz bitem 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 będą odpowiadały danym zbudowanym z pierwszego poziomu grupowania.

Używaj tego typu, aby utworzyć pojedynczy bit file_data z danymi w wybranym formacie, zbudowanymi według schematu powielanego zgodnie z grupowaniem bitów magistrali wejściowej.

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, aby utworzyć pojedynczy bit file_data z danymi w wybranym formacie, zbudowanymi według schematu powielanego zgodnie z grupowaniem bitów magistrali wejściowej.