変数

変数は、モジュールビルダーによって、Workshop モジュールを通じてデータがどのように移動するかを設定するために使用されます。変数のタイプには、オブジェクトセットとオブジェクトセットフィルター、文字列、ブーリアン、数値、日付、タイムスタンプがあり、これらはすべてシングルトン形式と配列形式の両方で存在します。

既存の変数にアクセスするため、または新しい変数を定義するためには、モジュール編集画面の左下に表示される変数メニューを開きます。

変数パネルの左側の1/3（上記の画像）には、モジュール内に存在する現在の変数が表示され、左下の変数を追加ボタンをクリックすると新しい変数を作成できます。左側の変数リストから任意の変数を選択すると、その変数の設定を表示し、また変更することができます。利用可能な設定オプションは以下の通りです：

• 変数名： 変数名をクリックするか、または鉛筆アイコンをクリックすると、変数の名前を編集できます。記述的な変数名を使用することが推奨されています。これにより、Workshop モジュールの設定が文書化され、設定プロセスの後半で希望する変数を見つけやすくなります。
• 変数定義タイプ： 変数名の隣には、ドロップダウンがあり、特定の変数がどのように定義され、データがどのように格納されるかのオプションが提供されます。選択した変数タイプに基づいて利用可能な選択肢が変わります。選択肢には以下のようなものが含まれます：
  • Static（手動で設定された変数値の場合）
  • Function（機能に基づいて動的に計算された変数の場合）
  • Object set aggregation（オブジェクトセットの集計から派生した変数の場合）
  • Object property（単一オブジェクトの選択されたプロパティ値に関連する変数の場合）
  • Object set definition（特に、選択したオブジェクトタイプ、フィルター、Search Arounds を介して定義されたオブジェクトセット変数の場合）
  • Variable transformation（変数値を一連の共通操作として定義し、他の変数を参照する可能性がある場合；詳しくは variable tansformations の文書を参照してください）。
• 変数の昇格（星のアイコン）： 昇格した変数を使うと、変数値を URL クエリパラメーターで初期化できます。例えば、?itemId=4 とすると、itemIdという外部IDを持つ変数を 4 で初期化します。
• 変数の削除（ゴミ箱アイコン）： モジュール内で未使用の変数（ウィジェットや下流の変数によって使用されていない）は、モジュールから削除することもできます。
• 変数定義の設定： 変数の詳細が設定される画面の主要な部分です。ここで提供されるオプションは、選択した変数タイプと変数定義タイプに基づいて変化し、画面上の指示が表示されます。

以下のスクリーンショットは、オブジェクトセット変数の例を示しています：

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

変数のタイプ

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

• Array： ブーリアン、日付、数値、文字列、タイムスタンプの配列を受け入れます。
• Boolean： true または false の値を受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Date： 日付を受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Filter： オブジェクトセット変数をフィルター処理するために使用される、プロパティタイプ / プロパティ値のペアのセットを格納します。オブジェクトタイプから初期化され、その後、プロパティタイプ / プロパティ値のフィルター処理ペアのセットから初期化されます。
• Numeric： 数値、整数と浮動小数点数を含む、を受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Object set： 1つ以上のオブジェクトのセットを格納します。全体のオブジェクトタイプか、別のオブジェクトセット変数から初期化し、その後、プロパティ値または Filter 変数でオプションによりフィルター処理されたり、Search Around により関連オブジェクトにピボットされることができます。また、共有プロパティタイプを介して、オントロジー間の他のオブジェクトタイプにもピボットできます。
• String： テキストを受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Timestamp： タイムスタンプを受け入れます。静的な値または関数、集約、オブジェクトプロパティの出力から初期化されます。
• Time series set： 単一のオブジェクトの時系列プロパティを格納し、オプションで時系列変換をそれに適用することを許可します。詳細は Workshop の時系列プロパティ をご覧ください。