Operator OUTPUT PARAMETERS pozwala na utworzenie i zapisanie parametrów projektowych na podstawie bitów znajdujących się na magistrali danych w trakcie przetwarzania projektu. Dzięki temu możliwe jest dynamiczne generowanie wartości parametrów w oparciu o przetwarzane dane.
Operator ten pozwala na:
- zaktualizowanie lub utworzenie parametrów projektowych na podstawie danych z bieżącego strumienia magistrali,
- zapisanie pojedynczych wartości lub zestawów danych w postaci bitów do parametrów,
- wykorzystanie wygenerowanych parametrów w dalszych etapach przetwarzania lub w innych częściach projektu,
- dynamiczną konfigurację parametrów projektu, co zwiększa elastyczność i automatyzację procesów.
OUTPUT PARAMETERS jest szczególnie przydatny, gdy chcesz przekazać wyniki obliczeń, wartości pośrednie lub ustawienia wygenerowane podczas realizacji procesu do kolejnych operatorów w projekcie w formie parametrów.
Przykład projektu GRAVITY z użyciem operatora OUTPUT PARAMETERS.
KONFIGURACJA OPERATORA
Aby skonfigurować operator, należy na zakładce Parameters wskazać bity magistrali, na podstawie których mają zostać utworzone parametry projektu.
Z obszaru Column to choose from, odpowiadającemu bitom magistrali wejściowej do operatora, wybierz (metodą drag and drop, double click lub za pomocą przycisków nawigacyjnych) bit, którego wartość będzie wartością nowego parametru (obszar Parameters).
Nazwa parametru jest generowana na podstawie nazwy bitu, ale możesz ją w każdym momencie zmodyfikować, klikając w pole na liście Parameters i wpisując nową nazwę.
Typ danych przechowywany w parametrze jest z góry określony przez typ bitu magistrali, który został użyty do utworzenia parametru.
Na zakładce Properties musisz określić, czy tworzysz parametry typu prostego, czy typy tablicowego.
System tworzy parametr tablicowy poprzez pobranie wartości odpowiedniego bitu z każdego rekordu magistrali.
Wybierając typ tablicowy, musisz określić sposób tworzenia tablicy parametrów w sytuacji, gdy bit magistrali odpowiadający za konkretny parametr ma w kolejnych rekordach wartość null (pole Null for the parametr array element), a także zachowanie w przypadku braku rekordów
na magistrali lub gdy na bicie magistrali, odpowiadającym za wartość parametru, występują tylko wartości null (pole Parameter array for no value).
Pole Null for the parameter array element umożliwia tworzenie tablicy parametrów zgodnie z dwoma ustawieniami:
- Include null values → dodawane są wartości
nulldo tablicy, gdy występują w bicie magistrali. - Skip null values →
nullwystępujący na bicie magistrali zostanie pominięty
Zbudowana tablica będzie miała postać:
[23, null, 3, null, null, 45]
Zbudowana tablica będzie miała postać:
[23, 3, 45]
Pole Parameter array for no value pozwala określić, jaką pustą wartość pustą przypisać do parametru, gdy magistrala danych w bicie odpowiadającym za parametr zawiera wyłącznie wartości null:
- Empty array → przypisanie pustej tablicy
[] - Null → przypisanie wartości
null
Powyższe dwa ustawienia są ze sobą powiązane i korelują zgodnie z poniższymi regułami:
- Na magistrali wejściowej występują rekordy i co najmniej jedna wartość bitu odpowiadającego za budowę parametru jest różna niż
null: - parametr jest budowany zgodnie z ustawieniem pola Null for the parameter array element,
- wartość konfiguracji pola Parameter array for no value nie jest brana pod uwagę
- Na magistrali nie występują żadne rekordy:
- parametr Null for the parametr array element nie jest brany pod uwagę
- pusta wartość parametru jest podstawiana zgodnie z polem Parameter array for no value.
- Na magistrali występują rekordy wchodzące, ale na którymś bicie wszystkie rekordy nie mają wszystkie wartości
null
Parameter array for no value | Null for the parametr array element | Wartość podstawiona |
null/empty array | include null values | [null, null] |
empty array | skip null values | [] |
null | skip null values | null |