CONVERT FORMAT TO BITS

Operator CONVERT FORMAT TO BITS umożliwia konwersję danych tekstowych zawartych w wybranym bicie magistrali wejściowej na pełnoprawną strukturę magistrali danych. Przetwarzany bit może zawierać dane w jednym ze wspieranych formatów tekstowych, takich jak:

JSON – JavaScript Object Notation
XML – Extensible Markup Language
CSV – Comma-Separated Values
XLSX – Microsoft Excel (format OpenXML)

Dla powyższych formatów operator oferuje wbudowaną funkcjonalność automatycznego dekodowania struktury danych oraz ich odwzorowania na rekordy i bity magistrali wyjściowej.

Operator oferuje tryb User format w przypadku danych zapisanych w innych formatach, takich jak:

HTML
EPP
EDI (np. EDIFACT, X12),
niestandardowe tekstowe struktury.

W trybie User format możesz samodzielnie zdefiniować strukturę dekodowania przy użyciu narzędzia Edytor konwersji tekstu do bitów magistrali , w którym konfigurujesz reguły interpretacji tekstu, zagłębienia danych oraz przypisania do konkretnych bitów i typów danych.

Każdy rekord wynikowej magistrali wyjściowej powstaje zgodnie z logiką zagłębień danych - oznacza to, że jedna struktura tekstowa może zostać rozbita na wiele rekordów z zachowaniem relacji danych hierarchicznych.

Przykład projektu z wykorzystaniem operatora CONVERT FORMAT TO BITS:

KONFIGURACJA OPERATORA

Operator przetwarza wskazany bit tekstowy magistrali wejściowej. Rezultatem działania jest nowa magistrala wyjściowa zbudowana na podstawie danych z przetworzonego formatu tekstowego.

Konwersja danych zostanie wykonana niezależnie dla każdego rekordu magistrali wejściowej. Natomiast magistrala wyjściowa będzie sumą przetworzonych danych.

Sposób konfigurowania operatora różni się w zależności od formatu danych, które będziesz przetwarzał przez operator.

Masz do wyboru trzy formaty danych:

XLSX file → pozwala na przetwarzania pliku Excel. Wymaga jednak, aby plik składał się jedynie z danych w formie tabeli,
CSV file → pozwala na przetwarzanie danych z plików CSV,
XML file → pozwala na przetwarzanie danych zawartych w formacie XML,

Taka sytuacja występuje często, gdy po wywołaniu REST API chcesz zdekodować odebrane dane. W większości przypadków wywołany serwis zwraca dane w formacie JSON.

JSON file → pozwala na przetwarzanie danych zawartych w formacie JSON,
User format → pozwala na przetwarzanie danych zawartych w dowolnym formacie tekstowym poprzez konfigurację znaczników w tekście odpowiadającym pozycją danych oraz grup danych.

Niezależnie od formatu, który zamierzasz konwertować, musisz wskazać bit magistrali, przechowujący tekst w wybranym formacie (Column with text format) oraz podjąć decyzję w jaki sposób budować magistralę wyjściową (Result target for decoded data).

Create a busbar from the result → zostanie utworzona zupełnie nowa magistrala danych składająca się tylko z danych zdekodowanych z tekstu.
Add to existing busbar without source bit → dane zdekodowane zostaną dołączone do istniejącej magistrali. Magistrala składać się będzie z bitów wchodzących do operatora oraz bitów utworzonych podczas dekodowania tekstu.
Add to existing busbar → działanie identyczne jak powyżej, z tą różnicą, że dekodowanie pole tekstowe nie przechodzi do magistrali wyjściowej.

Zarówno dla opcji Add to existing busbar without source bit, jak i opcji Add to existing busbar, jeśli po zdekodowaniu pola tekstowego rezultatem będzie więcej niż jeden rekord, to wartości bitów rekordu wejściowego zostaną powielone dla wszystkich rekordów uzyskanych z dekodowania pola tekstowego.

Konfiguracja schematu XLSX, CSV, XML oraz JSON jest identyczna jak w przypadku konfiguracji na operatorze INPUT FILE i została szczegółowo opisana.

Konfiguracja schematu User format wymaga wprowadzenia w polu Text template próbki tekstu, który będzie konwertowany w celu umożliwienia wykonania testu konwersji na komponencie.

Na zakładce File format musisz wprowadzić separatory używane do znaczników pozycji danych w konwertowanym tekście, a następnie uruchomić i dokonać konwersji tekstu za pomocą Edytor konwersji tekstu do bitów magistrali

Po wykonaniu schematu konwersji w edytorze zobaczysz wypełnione pole schematu. Możesz je również edytować ręcznie bez użycia edytora.

Teraz możesz sprawdzić działanie konwersji dla tekstu podanego w polu Text template, używając przycisku Test.

Rezultat dla tekstu opisanego w Edytor konwersji tekstu do bitów magistrali:

Następnie przejdź na zakładkę Columns, gdzie wygenerujesz bity magistrali wyjściowej dla zdefiniowanego schematu konwersji tekstu.

System automatycznie dostosowuje typ danych bitów na podstawie przykładowego tekstu. Jeśli jest to konieczne możesz dokonać modyfikacji typu lub nazwy bitu klikając w odpowiednie pole.