アプリでコネクタ関数の出力を使用する方法

01 Nov 2022
1 読む分
寄稿者

印刷する
共有

アプリでコネクタ関数の出力を使用する方法

更新日 01 Nov 2022
1 読む分
寄稿者

印刷する
共有

Article Summary

目的

SQLおよびHTTPコネクタ関数は、オブジェクトまたは配列としてアプリに「出力」を送信します。アプリの中でオブジェクトを操作する方法を学びます。

この記事では、次のことを学びます。
*** アプリでコネクタ関数から「**出力」を使用する方法

アプリでコネクタ関数からの出力を使用する方法

配列とオブジェクトは、多くのプログラミング言語で使用される、2 つの一般的なデータ構造です。チューリップでは、Connector Functionsでこれら両方のデータ構造を利用します。

SQLコネクタ関数が複数行を出力する場合、その出力はオブジェクトでいっぱいの配列としてアプリに送信されます。
HTTPコネクタ関数が配列を含む出力を返すと、その配列はオブジェクトでいっぱいの配列としてアプリに表示されます。
SQLコネクタ関数が1行を出力する場合、またはHTTPコネクタ関数が何らかの出力をする場合、その値はキーと値のペアとしてオブジェクトに格納されます。

オブジェクトは、Connector 関数が正常に完了した場合にのみ自動的に作成されます。

このガイドでは、Connector Function の出力が自動的に整理される方法を説明します。そして、アプリでこれらの出力を使用する方法を説明します。

コネクタから出力を収集する

Tulip バッジ ID に基づいて、SQL データベースから特定のオペレータに関するすべてのデータを引き出すことを想像してください。

これを行うには、入力としてbadge_idを取り、出力にすべてのオペレータの情報を保存するSQLコネクタ関数を書くことになります。この場合、出力はgroup_nameと呼ばれます。これはそのように見えるでしょう。

この関数は、group_nameという1つの出力を持ち、これは文字列として保存されます。これは、Outputs セクションの「Text」ラベルに基づくものです。

実際、Connector 関数を作成するとき、出力を配列またはオブジェクトとして格納するオプションはありません。以下は、「Outputs」セクションから許可されたデータ型です。

{height="" width="350"} です。

したがって、「Text」として格納し、Trigger Editor で操作する必要があります。

トリガーエディタでこの関数を実行し、出力をオブジェクトに格納します。

"Run Connector Function" コネクタを実行します。"SBD - Test" "オペレータ・ナビゲーション"
バッジID: "Static Value" "text" "2222 "として結果を保存します。"変数" "test_var" として保存します。

この場合、入力として2222の値を使用し、出力を "test_var "という変数に保存していることになります。

アプリでのオブジェクトの使用

上記の例では、group_nameという出力を受け取り、それをtest_varという変数に保存しています。App Variables ビューでは、この変数が実際には「group_name」という 1 つのプロパティを持つオブジェクトであることが示されています。

実際、Connector Function に複数の出力がある場合、各出力は Trigger で作成された「test_var」というオブジェクトの新しいプロパティとして保存されます。これにより、1 つの関数呼び出しのすべての出力を 1 つの場所に整理することができます。

アプリに変数テキストを追加し、コンテキストペインのウィジェットタブから変数を選択すると、関数の出力をテストすることができます。

この例では、「Order Details」という変数があり、5つのフィールドを持つオブジェクトを格納しています。

orderPlaced
数量
住所1
住所2
address3

変数検索ボックスからオブジェクトを選択するとすぐに、5つのフィールドすべてが、プロパティの名前に基づいたラベルで、アプリに入力されるのがわかります。一度にすべてを見るには、変数テキストフィールドを展開する必要があるかもしれません。

オブジェクトの表示

Objectに複数のプロパティがある場合、アプリの1つのステップでそれらのすべてを一度に表示したい場合があります。これは、個々のプロパティのために新しい変数テキストを作成するよりも簡単です。

Object から個々のプロパティを並べ替えたり削除したりするには、Context Pane でプロパティの x またはグリッド記号をクリックします。

列の数を変更するには、「Context Pane」の「Columns」オプションを使用します。

ラベルや値の表示を変更するには、「コンテキストペイン」で色やフォントサイズを調整します。

このデータがどのようにオペレータに表示されるかを確認するには、アプリをプレーヤーで実行すると、オブジェクトの全体像を見ることができます。値を収集するコネクタ関数を最初に実行すると、値が含まれます。

オブジェクトの操作

アプリでオブジェクトの Array を使用すると、ターゲットとするデータポイントを抽出するためのオプションが制限される場合があります。コネクタ関数から出力されたオブジェクトの配列を操作して、ロジックなどで使用したいデータへのアクセスを容易にすることができます。オブジェクトのキーを指定することで、抽出することができます。これにより、データ出力が合理化され、関心のあるデータをよりよく活用できるようになります。

Connector Function の例を以下に示します。

{高さ="" 幅=""}。

{height="" width=""}.

上記の出力はオブジェクトの配列です。コネクタ関数がオブジェクトの配列を返す場合、エクスプレッション・エディタにはそれらを操作するのに役立つアクションがあります。これらのマップ関数は、与えられたキーに基づき、対応する値をマッピングすることができます。出力された値は、選択された型の配列にマップすることができます。例えば、MAP_TO_TEXT_LIST()を使って、すべてのTitleのテキスト配列を取得するとします。

{height="" width=""}.

"Run Connector Function" コネクタ。"Test" "Test Function" として結果を保存します。"test_output"
"データ操作" "保存 "データ"式" "MAP_TO_TEXT_LIST(Variable.test_out.Test Parent, 'Test Child')

map関数に渡される最初のパラメータは、オブジェクトの配列です。2番目のパラメータである'Test Child'は、コネクタ関数の出力に概説されているエクストラクタ名である。この抽出器名は、値を抽出するためのキーとして使用されます。これで、すべてのタイトルが文字列の配列で出力されます。