Jak używać wyjść z funkcji Connector w aplikacjach

Przeznaczenie

Funkcje SQL i HTTP Connector wysyłają do aplikacji "Dane wyjściowe" w postaci obiektów lub tablic. Dowiedz się jak manipulować obiektami w aplikacjach.

W tym artykule dowiesz się.
* Jak używać "Wyjścia" z funkcji Connector w aplikacji

Jak używać wyjść z funkcji Connector w aplikacji?

Tablice i Obiekty to dwie popularne struktury danych, które są używane w wielu językach programowania. Tulip wykorzystuje obie te struktury danych w funkcjach łączących:

1. Kiedy funkcja konektora SQL zwraca wiele wierszy, dane wyjściowe są wysyłane do aplikacji jako tablica pełna obiektów
2. Kiedy funkcja złącza HTTP zwraca wyjście z tablicą, tablica ta pojawi się w aplikacji jako tablica pełna obiektów.
3. Gdy funkcja złączenia SQL zwraca pojedynczy wiersz lub gdy funkcja złączenia HTTP zwraca dowolne wyjście, wartości są przechowywane jako pary klucz/wartość w obiekcie

Obiekty mogą być tworzone automatycznie tylko po pomyślnym zakończeniu działania funkcji Connector.

Ten przewodnik pokaże Ci jak automatycznie organizowane są dane wyjściowe funkcji Connector. Następnie zobaczysz, jak używać tych danych wyjściowych w aplikacjach.

Zbieranie danych wyjściowych z Connectorów

Wyobraź sobie, że chcesz pobrać wszystkie dane o konkretnym operatorze z bazy danych SQL na podstawie jego identyfikatora Tulip.

Aby to zrobić, napisałbyś funkcję SQL Connector, która pobiera badge_id jako dane wejściowe i zapisuje wszystkie informacje o operatorze na wyjściu. W tym przypadku wyjście nazywa się group_name. Oto jak wyglądałaby ta funkcja:

Ta funkcja ma jedno wyjście, group_name, które jest przechowywane jako ciąg znaków. Jest to oparte na etykiecie "Text" w sekcji Outputs.

W rzeczywistości, gdy tworzysz funkcję Connector, nie ma opcji przechowywania danych wyjściowych jako tablicy lub obiektu. Oto dozwolone typy danych z sekcji "Outputs".

Musisz więc zapisać go jako "Text", a następnie manipulować nim w edytorze wyzwalaczy.

Uruchom tę funkcję w edytorze wyzwalaczy, aby zapisać dane wyjściowe w obiekcie.

• "Run Connector Function" connector: "SBD - Test" "Nawigacja operatora"
• identyfikator: "Static Value" "text" "2222" i zapisz wynik jako: "Variable" "test_var"

W tym przypadku używasz wartości 2222 jako wejścia i przechowujesz wyjście w zmiennej o nazwie "test_var".

Używanie obiektów w aplikacji

W powyższym przykładzie wzięliśmy wyjście o nazwie group_name, a następnie zapisaliśmy je w zmiennej o nazwie test_var. Widok App Variables pokazuje, że ta zmienna jest w rzeczywistości obiektem z jedną właściwością o nazwie "group_name".

W rzeczywistości, gdyby funkcja Connector miała wiele wyjść, każde z nich byłoby zapisane jako nowa właściwość obiektu o nazwie "test_var", który został utworzony w wyzwalaczu. Pozwala to na uporządkowanie wszystkich wyjść jednego wywołania funkcji w jednym miejscu.

Możesz przetestować wyjścia funkcji, dodając jakiś tekst zmiennej do swojej aplikacji, a następnie wybierając zmienną z zakładki Widget w Context Pane.

W tym przypadku mamy zmienną o nazwie "Order Details", która przechowuje obiekt z 5 polami:

• orderPlaced
• quantity
• adres1
• adres2
• adres3

Gdy tylko wybierzesz obiekt z pola wyszukiwania Zmienne, zobaczysz, że wszystkie 5 pól wypełni się w Twojej aplikacji etykietami opartymi na nazwach właściwości. Być może będziesz musiał rozwinąć pole tekstowe zmiennej, aby zobaczyć je wszystkie naraz.

Wyświetlanie obiektów

Jeśli Twój obiekt posiada wiele właściwości, możesz chcieć wyświetlić je wszystkie na raz w jednym kroku aplikacji. Jest to łatwiejsze niż tworzenie nowego tekstu zmiennej dla każdej właściwości.

Aby zmienić kolejność/usunąć poszczególne właściwości z obiektu, kliknij x lub symbol siatki na właściwości w oknie kontekstowym.

Aby zmienić liczbę kolumn, użyj opcji Kolumny w oknie kontekstowym.

Aby zmienić sposób wyświetlania etykiet i wartości, dostosuj kolor i rozmiar czcionki w oknie kontekstowym.

Aby zobaczyć, jak te dane zostaną pokazane operatorowi, uruchom aplikację w Odtwarzaczu, a będziesz mógł zobaczyć cały obiekt. Wartości będą uwzględnione, jeśli najpierw uruchomisz funkcję Connector, która zbiera wartości.

Manipulowanie obiektami

Używanie tablicy obiektów w twojej aplikacji może ograniczyć twoje opcje wyodrębniania punktów danych, które próbujesz namierzyć. Możesz manipulować tablicą obiektów, która jest wyprowadzana z funkcji łączącej, aby ułatwić dostęp do danych, które chcesz wykorzystać w swojej logice itp. Można to zrobić, określając klucz(y) w obiekcie, który chcesz wyodrębnić. Pomoże to usprawnić dane wyjściowe, pozwalając lepiej wykorzystać dane, którymi jesteś zainteresowany.

Przykład funkcji Connector można zobaczyć poniżej:

Powyższe wyjście jest tablicą obiektów. Gdy funkcje łączące zwracają tablicę obiektów, w edytorze wyrażeń znajdują się akcje, które pomagają w ich manipulowaniu. Te funkcje mapowania pozwalają na mapowanie odpowiednich wartości w oparciu o dany klucz. Wypisane wartości mogą zostać zmapowane do tablicy wybranego typu. Możesz użyć MAP_TO_TEXT_LIST(), aby uzyskać tablicę tekstową wszystkich Tytułów.

• "Run Connector Function" connector: "Test" "Testuj funkcję" i zapisz wynik jako: "test_output"
• "Data Manipulation" "Store" dane: "Wyrażenie" "MAP_TO_TEXT_LIST(zmienna.test_out.Test Parent, 'Test Child')

Pierwszym parametrem przekazanym do funkcji map jest tablica obiektów. Drugi parametr, "Test Child", to nazwa ekstraktora nakreślona na wyjściu funkcji złączenia. Nazwa ekstraktora jest używana jako klucz do wyodrębnienia wartości. Spowoduje to wyprowadzenie wszystkich tytułów w tablicy łańcuchów.

Przeglądanie wszystkich zmiennych obiektowych w aplikacji

Aby móc manipulować strukturą danych w aplikacji, musi ona być już zapisana jako zmienna. Możesz zobaczyć istniejące zmienne wchodząc do Context Pane w App Editor i wybierając symbol Sigma obok "Variables" w zakładce App.

Obiekty zostaną wyświetlone z uniwersalnym symbolem obiektu "{}".

Wyświetlanie wielu wierszy SQL lub tablic z połączeń HTTP

Jeśli chcesz przekształcić wiele rzędów danych wyjściowych SQL lub tablic z łączników HTTP w interaktywne listy w aplikacji, sprawdź ten osobny przewodnik

Więcej informacji

• Jak używać tablic w aplikacjach
• Jak wywołać funkcję łącznika za pomocą wyzwalaczy
• Przewodnik po Edytorze wyrażeń w Edytorze aplikacji

Czy znalazłeś to, czego szukałeś?

Możesz również udać się na stronę community.tulip.co, aby zadać swoje pytanie lub sprawdzić, czy inni spotkali się z podobnym pytaniem!