機能フィールドに関するレポート

通常のフィールドはデータベースに値を格納しますが、関数フィールドはデータベースクエリの結果を表示します。関数フィールドは、他のフィールドと定数の計算に基づいて値を生成します。これらのフィールドは、他のフィールドと同様にレポートで使用できます。

機能フィールドの作成、編集、非アクティブ化の責任は、function_field_adminロールを持つユーザーにあります。アップグレード時に、このロールを持つユーザーはいません。管理者は、このロールを管理者以外のユーザーに付与する必要があります。「 ロールの作成」を参照してください。

機能フィールドの詳細については、「 機能フィールド」を参照してください。

機能フィールドの操作

機能フィールドでは、glidefunction:<operation> 構文を使用して次の操作を実行できます。

注:

定数は一重引用符または二重引用符で囲んで指定します。concat()、dayofweek()、position()、および substring() 操作の例は、関数フィールドでの定数の使用を示しています。

表 : 1. 機能フィールドの操作機能フィールドの操作テーブルには、機能フィールドの操作の名前の列、実行する操作の内容の詳細な説明、およびコードとコードが返す内容の両方を含む例が含まれています。

操作	説明	例
add()	2 つの数値フィールドを入力として取得し、これらを加算して、結果をフィールド値として返します。 さらにこの関数は、どちらの入力に対しても数値を取ります。数値は単一引用符または二重引用符で囲みます。	glidefunction:add(child_incidents, parent_incident) インシデントに 5 つの子インシデントと 1 つの親インシデントがある場合は、6 を返します。 可能な戻り値の型：10 進数、浮動小数点数、大きい整数、整数
subtract()	2 つの数値フィールドを入力として取得し、1 つ目の数値から 2 つ目の数値を減算して、結果をフィールド値として返します。 さらにこの関数は、どちらの入力に対しても数値を取ります。数値は単一引用符または二重引用符で囲みます。	glidefunction:subtract(u_num1, u_num2) num1 = 8 および num_2 = 6 の場合は 2 を返します。 可能な戻り値の型：10 進数、浮動小数点数、大きい整数、整数
multiply()	2 つの数値フィールドを入力として取得し、乗算を実行して、結果をフィールド値として返します。 さらにこの関数は、どちらの入力に対しても数値を取ります。数値は単一引用符または二重引用符で囲みます。	glidefunction:multiply(u_num1, u_num2) num1 = 8 および num_2 = 6 の場合は 48 を返します。 可能な戻り値の型：10 進数、浮動小数点数、大きい整数、整数
divide()	2 つの数値フィールドを入力として取得し、1 つ目の数値を 2 つ目の数値で除算して、結果をフィールド値として返します。 さらにこの関数は、どちらの入力に対しても数値を取ります。数値は単一引用符または二重引用符で囲みます。	glidefunction:divide(u_num2,u_num1) num2 = 10 および num1 = 2 の場合は 5 を返します。 可能な戻り値の型：10 進数、浮動小数点数、大きい整数、整数
concat()	任意の数のカンマ区切りフィールドと定数を入力として取得し、入力を連結して、単一の文字列をフィールド値として返します。	glidefunction:concat(incident_number, '/', short_description) 数値フィールドの値が「INC0001」で、short_description が「クライアントに新しいラップトップが必要」である場合には、「INC0001 /クライアントに新しいラップトップが必要」を返します。 戻り値の型：テキスト
datediff()	2 つの日時フィールドを入力として取得し、日時の差を日、分、および秒の単位で計算して、結果を期間フィールド値として返します。	glidefunction:datediff(closed_at, sys_created_on) 作成日からクローズ日までのインシデントの期間を返します。結果の例：10 日、8 時間 23 分 11 秒 戻り値の型：期間
dayofweek()	日付フィールドと '1' (日曜日に週が開始) または '2' (月曜日に週が開始) の定数の、2 つの引数を取得します。曜日を表す整数値として結果を返します。 dayofweek() 関数は UTC 日付を使用しますが、インスタンスのタイムゾーンに基づいて比較値を調整します。	glidefunction:dayofweek(resolved_at, '1'). resolved_at が水曜日に発生した場合、整数が 1 の場合は 4 を返し、整数が 2 の場合は 3 を返します。 戻り値の型：整数
length()	文字列フィールドを入力として取得し、フィールド長を文字数単位で計算して、結果をフィールド値として返します。	glidefunction:length(short_description) short_description =「This application is performing a test」の場合は 37 を返します。 戻り値の型：整数
coalesce()	任意の数のカンマ区切りフィールドを入力として取得し、最初の空でない値を返します。	glidefunction:coalesce(closed_at, resolved_at, sys_updated_on) closed_at の値が空の場合、関数は値 [resolved_at] を返します。[resolved_at] の値も空の場合、関数は値 [sys_updated_on] を返します。 戻り値の型：テキスト
position()	2 つのテキストフィールド、または 2 つのテキストフィールドと 1 つの整数を入力として取得します。テキストフィールドの一方または両方を文字列にすることもできます。 2 つ目のものの最初のテキストフィールドの最初の文字列の位置を返します。 整数を指定した場合、この関数は整数の位置の後の 2 番目のテキストフィールドの位置を返します。 最初のテキストフィールドが 2 番目に存在しない場合は、0 を返します (指定されている場合は整数の位置の後)。	glidefunction:position('e',short_description) short_description フィールドの値が「This computer is performing an upgrade」の場合は、12 を返します。 glidefunction:position('e',short_description,'14') short_description フィールドの値が「This computer is performing an upgrade」の場合は、19 を返します。 戻り値の型：整数
substring()	テキストフィールドと 2 つの整数を入力として取得します。最初の整数の位置から始まり、2 番目の長さである文字列の最初のインスタンスを返します。	glidefunction:substring(short_description, '7', '2') short_description フィールドの値が「We're going to the store」の場合は、「go」を返します。 戻り値の型：テキスト

• 機能フィールドの構成
  レポートデザイナーを使用したレポートで使用するために、テーブルごとに最大 20 個のアクティブな関数フィールドを設定できます。テーブルに関数フィールドを設定すると、関数の計算結果によってグループ化または積み重ねることができます。