Workshop で関数を使用する

Workshop モジュール内で、関数はさまざまな方法で使用できます。関数をバックアップしたアクションを使用することで、モジュールがオブジェクトの編集や書き戻しの複雑なセットをトリガーできます。メトリックカードなどのウィジェットを使用して、関数の出力をモジュール内に表示し、ユーザーの意思決定を支援できます。

Workshop での関数バックアップアクション

オントロジー マネージャで新しいアクション タイプを定義する際に、関数はそのアクション タイプの Rules ロジックの一部として使用できます。これは、Add Object、Delete Object、Modify Object、Add Link、Delete Link の組み込みオプションよりも複雑な書き戻しをアクション タイプで有効にするために一般的に役立ちます。関数バックアップアクションタイプを定義する方法について詳しくはこちら。

関数バックアップアクションタイプが定義されると、Workshop の他のアクションタイプと同様に使用できます。Workshop でアクションタイプを公開する方法について詳しくはこちら。

Workshop での関数バックアップ変数

関数はまた、Workshop でモジュール内の変数の値を入力するために使用できます。以下では、新しい数値変数を作成し、2つの空港間のフライト数を計算する関数の出力でそれを入力するという概念的な例を説明します。

まず、Workshop モジュール内から呼び出す関数を見てみましょう。以下に示すように、関数は flightsFromAirportToDestination と呼ばれ、入力として空港オブジェクト（出発空港）と文字列（目的地空港の3文字の空港コード）を受け入れ、それらの空港間のフライト数を表す数値を返します。

Copied!
1
2
3
4
5
6
7
8
@Function()
  // 空港から目的地までのフライト数を計算する関数
  public flightsFromAirportToDestination(airport: AirportObject, destinationAirportCode: string): Integer {
    // すべてのフライトのリストを取得し、目的地の空港コードに一致するものをフィルタリングし、その数を返す
    return airport.flightDestinationAirportLinkFlightObject.all()
      .filter(flight => flight.arrivalAirportCode === destinationAirportCode)
      .length;
}

次に、Workshop モジュールでこの関数を設定するプロセスを開始しましょう。目的は、モジュールから関数入力（空港オブジェクトと文字列）を渡し、関数出力（数値）をモジュール内に表示することです。

まず、画面の左下にある 変数 メニューから新しい数値変数を作成します。変数 メニューを開き、変数の追加 を選択し、次に下のように 数値 を選択します。

新しく作成された変数にマウスオーバーし、デフォルトの名前（$var1 のようなもの）が表示されたら、表示される編集アイコン（鉛筆）をクリックして、変数編集メニューを開きます。

上記の画面から、Value generation の切り替えを Function オプションに切り替え、この変数の入力として関数を設定します。

fx... ボタンを選択して、既存の関数をここで選択します。下のスクリーンショットでは、タイトルに Flight という言葉が含まれる関数だけを表示するようにフィルター処理されています。

目的の関数を選択した後、この例では flightsFromAirportToDestination 関数、表示される関数の入力を入力します。下の例は、flightsFromAirportToDestination 関数が Workshop モジュールから 2 つの変数入力を受け取る完全な設定を示しています。空港変数は、モジュールのオブジェクトテーブルから現在アクティブな空港オブジェクトを取得し、destinationAirportCode 変数は、Destination Airport という名前のユーザーが入力した文字列変数によって入力されます。

この関数の出力が Workshop モジュールでユーザーに表示される方法を確認するには、以下の 関数付きメトリックカード セクションに進んでください。

関数付きメトリックカード

メトリックカードウィジェットは、ビルダーがモジュール内で重要な情報を表示する方法を提供します。ここに表示される統計情報が関数によって生成されると便利です。メトリックカードの設定内で、上記の手順で定義した関数バックの フライトカウント 数値変数から特定のメトリックを取得するように設定できます。

以下のスクリーンショットは、関数バックのメトリックカードを右側に持つ結果のモジュールを示しています。ユーザーが左側のオブジェクトテーブルで選択を変更すると（出発空港）、右側の文字列エントリも変更されます（目的地空港）、メトリックカードは関数の結果として動的に更新され、選択した空港間のフライト数が表示されます。この場合、出発空港として FLL を選択し、目的地空港として JFK を選択すると、それらの空港間に 139 の既知のフライトがあることがわかります。