変数

変数は、モジュールビルダーがWorkshopモジュールを通じてデータが移動する方法を設定するために使用されます。利用可能な変数タイプのリストは以下にあります。

既存の変数にアクセスしたり、新しい変数を定義したりするためには、左サイドバーにある Variables メニューを開きます。

Variablesパネル（上記）は、モジュール内に存在する現在の変数のリスト、新しい変数を追加するためのプラス + ボタン、名前で変数を検索するための入力欄、変数依存関係グラフを開くためのボタン、および定義タイプや有効になっている設定に基づいて変数を表示するフィルターを表示します。

左側のリストから変数を選択すると、その変数の設定を表示し、変更するためのウィンドウが変数リストの右側に開きます。以下の設定オプションが利用可能です：

• 変数名： 変数名または鉛筆アイコンを選択すると、変数名を編集できます。ワークショップモジュールの設定を文書化し、設定プロセスの後で所望の変数を見つけやすくするために、記述的な変数名を使用することをお勧めします。
• 変数定義タイプ： 変数名の隣には、特定の変数がどのように定義され、データで満たされるかについてのオプションを提供するドロップダウンメニューがあります。選択した変数タイプに基づいて利用可能な選択肢が変わり、以下のようなオプションが含まれる場合があります：
  • Static： 手動で設定された変数値のためのもの
  • Function： 関数を利用した、動的に計算される変数のためのもの
  • Object set aggregation： オブジェクトセットの集約から導き出された変数のためのもの
  • Object property： 単一のオブジェクトの選択されたプロパティ値に関連する変数のためのもの
    • Note： 複雑な非パフォーマンスのオブジェクトプロパティはWorkshopの変数としてはサポートされていません。
  • Object set definition： 選択されたオブジェクトタイプ、フィルター、リンクオブジェクトのトラバーサルによって定義されるオブジェクトセット変数のためのもの
  • Variable transformation： 変数の値を一連の一般的な操作として定義するためのもので、他の変数を参照する可能性があります。詳細については変数トランスフォームのドキュメンテーションを参照してください。
• 変数の削除（ゴミ箱アイコン）： モジュール内で未使用の変数（ウィジェットや下流の変数によって使用されていない）は削除できます。
• 変数定義の設定： 変数の詳細を設定する画面の主要な部分です。ここで提供されるオプションは、選択した変数タイプと変数定義タイプに基づいて変更され、画面上の指示が表示されます。
• 変数設定： 変数設定パネルでは、外部IDの設定と、以下の機能のどれを特定の変数に有効にするかの設定が可能です。
  • モジュールインターフェース
  • ルーティング
  • ステートの保存

以下のスクリーンショットは、Object Set変数の設定例を示しています：

以下のスクリーンショットは、文字列配列変数の設定例を示しています：

変数タイプ

Workshopは以下の変数タイプをサポートしています：

• Array： Boolean、date、numeric、string、またはtimestamp値の配列を受け入れます。
• Boolean： trueまたはfalseの値を受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Date： 日付を受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Numeric： 数値（整数と浮動小数点数を含む）を受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Object set： 1つ以上のオブジェクトのセットを保存します。全体のオブジェクトタイプまたは別のオブジェクトセット変数から初期化し、その後、プロパティ値またはフィルター変数でオプションでフィルター処理したり、Search Aroundを介してリンクオブジェクトにピボットすることができます。また、共有プロパティタイプを通じて、オントロジー間で他のオブジェクトタイプにピボットすることもできます。
• Object set filter： オブジェクトセット変数をフィルターするために使用されるプロパティタイプ/プロパティ値のペアのセットを保存します。オブジェクトタイプから初期化し、その後、プロパティタイプ/プロパティ値フィルターペアのセットを設定します。
• String： テキストを受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Struct： 文字列フィールドIDを値にマッピングする複合タイプを保存します。現在、ネストされた構造体はサポートされていないが、構造体フィールドの値に対しては他のWorkshop変数タイプがすべて受け入れられます。関数の出力から初期化します。詳細については、Struct変数を参照してください。
• Timestamp： タイムスタンプを受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Time series set： 単一のオブジェクトの時間系列プロパティを保存し、オプションでそれに時間系列トランスフォームを適用することを可能にします。詳細については、Workshopの時間系列プロパティを参照してください。

変数依存関係グラフ

Variables パネルのヘッダーには、グラフノードアイコンのボタンがあります。このボタンを押すと、変数依存関係グラフが開きます。この依存関係グラフは、変数をデバッグする方法を提供し、モジュール内の変数とウィジェットの依存関係グラフを表示します。グラフ内の変数ノードを選択すると、以下の情報が表示されます：

• 現在の値
• 変数がどのように使われているか
• 変数の値の設定

特筆すべきは、変数の値の設定の隣には値をクリアするオプションがあり、変数の定義を空の状態にリセットします。

ウィジェットはグラフ内のノードとして表示されますが、選択したときに追加情報は提供されません。