関数フィールドの作成

関数フィールドを作成して、フィールドの計算結果でレポートをグループ化して積み重ねることができるようにします。

始める前に

必要なロール:admin、function_field_admin

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

注:

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

手順

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

   注:

   戻り値の型が関数の論理結果でない場合、メッセージは表示されません。
8. 操作を選択します。
   [ 構文 ] テキストボックスには、 glidefunction: が前に付いた関数名が表示されます。

   

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

    

タスクの結果

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

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