関数フィールドを作成する

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:2分
  • フィールドの計算結果によってレポートをグループ化および積み重ねることができるように、機能フィールドを作成します。

    始める前に

    必要なロール:admin、function_field_admin

    各関数フィールドには、ラベル、戻り値の型、および定義が必要です。定義は、操作と、操作が実行される 1 つ以上のフィールドで構成されます。

    注:
    関数フィールドを保存した後に、ラベルや戻り値の型を変更することはできません。必要に応じて、機能フィールドを非アクティブ化して、最初からやり直してください。

    手順

    1. 移動先 すべて > レポート > 新規作成.
    2. 関数フィールドを追加するレポートを選択します。
      テーブルに関数フィールドを設定すると、同じテーブルのレポートを含め、 Now Platform上のテーブルを使用するすべての場所で使用できます。たとえば、オープン インシデントの経過時間を計算する関数フィールドは、インシデント テーブルのすべてのレポートで使用できます。
    3. 構成 」タブを開き、「 関数フィールドの構成」をクリックします。
    4. オプション: 検索バーにフィールド名を入力して、誰かが関数フィールドを既に作成しているかどうかを確認します。
      検索結果をポイントすると、関数の定義が表示されます。
    5. [作成] をクリックします。
      レポートの基になるテーブルには、最大 20 個のアクティブな関数フィールドを設定できます。テーブルに既に 20 個の関数フィールドがある場合、フィールドの 1 つまたはplatform_adminの作成者は、フィールドを非アクティブ化または削除する必要があります。
    6. ラベルを指定します。
      ラベルは、ユーザーがレポート内のデータをグループ化または積み重ねるときに表示される名前です。
    7. [戻り値の型] を選択します。
      戻り値の型は、関数が生成する情報の種類です。たとえば、 datediff() 関数は 2 つの日付間の期間を計算するため、Duration 型を返します。
      注:
      戻り値の型が関数の論理結果でない場合、メッセージは表示されません。
    8. 操作を選択します。
      [構文] テキストボックスには、関数名の前に glidefunction: が表示されます。

      [ラベル]、[戻り値の型]、および [操作を追加] の吹き出しが表示された [関数フィールドを作成] ウィンドウ。減算操作が強調表示されます。

    9. 関数が動作するフィールドを選択します。
      一部の関数には 1 つのフィールドしか必要ありません。2 つまたは 3 つのフィールドが必要なものもあります。「関数フィールドに関するレポート」を参照してください。フィールドは必ずカンマで区切ってください。
    10. 構文が正しければ、関数フィールドを保存できます。
      構文が正しくない場合は、「 構文エラー:無効な式」というメッセージが表示されます。他のメッセージも表示される場合があります。

      [フィールドを追加] のコールアウトと [構文が正しいです] メッセージが表示された [関数フィールドを作成] ウィンドウ。[子インシデント] フィールドが強調表示されます。

    タスクの結果

    レポートを保存した後に、構成済みの関数フィールドが [グループごと] および [他のグループ化] リストに表示されます。

    作成した関数フィールドをレポート構成で使用します。Now Platformの他の場所で関数フィールドを使用する方法については、「関数フィールド」を参照してください。