関数フィールドの作成

フィールドの計算結果に基づいてレポートをグループ化および積み上げることができる機能フィールドを作成します。

始める前に

必要なロール:admin、function_field_admin

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

注:

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

手順

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

   注:

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

   

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

    

タスクの結果

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

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