リストからプル

概要と主要な概念

[リストからプル]アクティビティは、リストから1つ以上の値をプルします。

このアクティビティが最初に作成されると、アクティビティが機能するためにリストへのリンクが必要であることを通知する赤い感嘆符 がアクティビティの右側に表示されます。リンクは、感嘆符をクリックしてListオブジェクトをクリックすると作成できる直接ポインターにすることもできます。または、[リスト]プロパティの値を設定して動的な参照にすることもできます。

デフォルトでは、このアクティビティはリストから必要なものをすべて正常にプルするまで終了しません。つまり、トークンは[必要数]値がリストからプルされるまで[リストからプル]アクティビティに残ります。

最大待機タイマー]を使用すると、トークンはリストから値をプルしようと試みてから追加のアクティビティに移動できるようになります。

リストから値をプルする処理で、トークンやオブジェクトが物理的に移動することはありません。その代わり、プルされた値への参照をプルするトークンに格納できます。この参照は、後に他のアクティビティで使用できます。

リソースからプルする

[リストからプル]アクティビティは、リソース共有アセットでも使用できます。[リストからプル]アクティビティがリソースに接続できるようにするには、リソースがリストを使用している必要があります。これは、次のいずれかによって実行できます。

  • リソース共有アセットでキュー方法を定義する。
  • リソース共有アセットでデフォルトのクエリを定義する。
  • リソース共有アセットをグローバルリストまたはリスト共有アセットにリンクする。

リソースを取得]アクティビティの代わりに[リストからプル]アクティビティを使用すると、取得できるリソースやリソースの取得方法に関するオプションが増えます。[リソースをリリース]アクティビティを使用して、プルされたリソースをリリースします。

コネクター

[リストからプル]アクティビティでは、複数のコネクターを使用できます。ただし、このアクティビティから自動的にリリースされたトークンは、最初のコネクターからリリースされます。手動でリリースされたトークンのみが別のコネクターから出ることができます。詳細については、「アクティビティを追加および接続する」を参照してください。

プロパティ

次の画像は、[リストからプル]アクティビティのプロパティを示しています。

これらの各プロパティについては、次のセクションで説明します。

名前

アクティビティの名前を変更するために使用します。このプロパティの詳細については、「名前」を参照してください。

フォント

フォント]ボタン で、アクティビティの背景色プロパティとフォントプロパティを編集するウィンドウが開きます。このプロパティの詳細については、「フォント」を参照してください。

統計

統計]ボタン でアクティビティの統計ウィンドウが開きます。このプロパティの詳細については、「統計」を参照してください。

リスト参照

このアクティビティがプルしている[リスト]への参照。

リクエスト数

プルしようとする値の数を定義します。リクエスト数は[必要数]以上にする必要があります。トークンが最初にプルするときに必要数よりも多くの値が利用可能な場合、トークンはそのような値をさらにリクエスト数までプルしてからすぐにトークンをリリースします。

リクエスト数がゼロの場合、プルオペレーションは単なるクエリオペレーションとなります。クエリフィルターに一致するリストの全オブジェクトをプルが取得しますが、リストから値を削除しません。

番号を要求

プルする必要がある最小数値を定義します。リストにある値が必要な数に満たない場合はバックオーダーが作成され、必要な数値が利用可能になるまでトークンはアクティビティで待機します。

必要数がゼロの場合、必ずアクティビティはすぐに終了して正常にプルした量を返します。この場合、バックオーダーは作成されません。

割り当て先

指定されたラベルやノードの参照を、リストからプルされた値に割り当てます。詳細については、「共通プロパティ」の「割り当て先」セクションを参照してください。

Query / Object / Array

プルする値を指定する条件で、次のいずれかの形式です。

  • SQLクエリ - このクエリを構築するには、 ボタンを使用できます。
  • オブジェクト - 指定した3Dオブジェクトからプルを試みます。他の種類のツリーノードを参照し、そのノードをプルすることもできます。
  • 配列 - プルが可能な値の配列。配列に明示的にリストされた値のみがプルされます。

パーティションID

プルするリストのパーティションを定義します。

プラー

プラーオブジェクトを定義します。これは、クエリがプラーに基づく動的フィールドにアクセスする場合に重要です。

全または無

このチェックボックスをオンにすると、[必要数]の値を一度にプルできるまでリストから値がプルされません。チェックボックスをオフにすると、値が利用できるようになるとプルされます。

エントリをリストに残す

このチェックボックスをオンにすると、リストから「プル」されたすべての値がリストに残ります。値は引き続き、[割り当て先]ラベルノードに割り当てられます。これは、特定のデータが追加されたときにリストを照会したり、リストを情報データベースとして使用したりする場合に便利です。このオプションは、すべての値が利用できるようになるまで値がまったく「プル」されないという点で、[全または無]のような動作をします。

最大待機タイマーの使用

トークンが指定された時間の経過後に必要な量をプルしていない場合、最大待機タイマーが評価されます。詳細については、「最大待機タイマー」を参照してください。

最大アイドルタイマーの使用

最大アイドルタイマーは、トークンが値をリストからプルするたびに評価されます。詳細については、「最大アイドルタイマー」を参照してください。

早期リリース時、バックオーダーを維持

このチェックボックスをオンにし、必要な量をプルする前にトークンを手動でリリースすると、バックオーダーは後で実行されるようリストに保持されます。