CONVERT FORMAT TO BITS

Operator CONVERT FORMAT TO BITS służy do konwersji bitu tekstowego magistrali wejściowej zawierającego dane w formacie tekstowym (np. JSON, XML, itp) na magistralę danych wyjściowych zbudowaną z danych zawartych w dekodowanym bicie tekstowym. Operator posiada wbudowaną konwersję danych formatów XML oraz JSON. Pozostałe formaty danych (HTML, EPP, CSV, EDI , itd.) możesz dekodować przy użyciu typu User format pozwalającego na skonfigurowanie szablonu interpretacji formatu tekstowego.

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 jakie będziesz przetwarzał przez operator.

Masz do wyboru trzy formaty danych:

• JSON file → pozwala na przetwarzanie danych zawartych w formacie JSON

Taka sytuacja ma często miejsce kiedy otrzymujesz zwrot z REST API i chcesz zdekodować odebrane dane. Najczęściej serwis jaki wywołujesz zwraca dane w formacie JSON
• XML file → pozwala na przetwarzanie danych zawartych w formacie XML
• 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 jaki zamierzasz konwertować musisz wskazać bit magistrali, który przechowuje 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 zdecydowanych z tekstu.
• Add to existing busbar without source bit → dane zdekodowane zostaną dołączone do istniejącej magistrali. Magistrala będzie się z bitów wchodzących do operatora + bity jakie zostały utworzone 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 XML oraz JSON są identyczne jak w wypadku konfiguracji na operatorze INPUT FILE i zostały szczegółowo opisane.

Konfiguracja schematu User format Wymaga wprowadzenia w polu Text template próbki tekstu jaki będzie konwertowany w celu możliwości wykonania testu konwersji na komponencie.

Na zakładce File format musisz wprowadzić separatory używane do znaczników pozycji danych w konwertowanym tekście. Oraz uruchomić i dokonać konwersji tekstu przy użyciu 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 z tego poziomu 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 tekst 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 według przykładowego tekstu. Jeśli jest to potrzebne możesz dokonać modyfikacji typu lub nazwy bitu klikając w odpowiednie pole.