動的 JavaScript フィルターの追加
レポート可視化のフィルター基準の一部として、評価用の動的 JavaScript ステートメントを追加します。
始める前に
必要なロール：itil、report_user、report_group、report_global、report_admin、または admin。意味のあるレポートを作成するには、レポートするデータにアクセスする権限が必要です。
このタスクについて
JavaScript フィルターは、1 行のステートメント、またはより長いスクリプトにすることができます。長い JavaScript ステートメントの場合は、正しい形式とデータ型を返し、レポートでフィルタリングする必要がある特定のデータに準拠し、クライアント呼び出し可能なスクリプトインクルードを作成します。詳細については、「スクリプトインクルード」を参照してください。
次の表に、JavaScript フィルターをサポートする各フィールドタイプでサポートされている演算子を示します。この表にないフィールドタイプは JavaScript フィルターをサポートしていません。また、これらのフィールドタイプの条件ビルダーの [値 ] フィールドには、独自のステートメントを貼り付けるオプションがありません。
| フィールドタイプ | 許可された演算子 | 予想される戻り値のデータタイプ |
|---|---|---|
| Sys ID (GUID) | 「次の値に等しい」、「次の値ではない」、「次の値のいずれかである」、「次の値で始まる」、「次の値で終わる」、「次の値を含む」、「次の値を含まない」、「次の間」、「次の値以上」、「次の値以下」。 | 完全または部分的なsys_id値のテキスト表現。 "is one of" 演算子の場合、想定される戻り値の型は、sys_id値のカンマ区切りリストか、結果に含める必要がある各sys_idを含む配列のいずれかです。 |
| フリーテキスト文字列 | 「次の値に等しい」、「次の値ではない」、「次の値のいずれかである」、「次の値で始まる」、「次の値で終わる」、「次の値を含む」、「次の値を含まない」、「次の間」、「次の値以上」、「次の値以下」 | 1 つ以上のテキスト文字。「is one of」演算子の場合、予想される結果は、文字列値のカンマ区切りリストか、「is one of」検索値フィールドに含める各値を含むアレイのいずれかになります。 |
| 参照 | 「次の値で始まる」、「次の値で終わる」、「次の値を含む」、「次の値を含まない」 | テーブルまたはデータソースのこのフィールドで見つかった値または値の一部を表す 1 つ以上のテキスト文字。 |
| 文字列 (別のテーブルを参照) | 「含む」、「次で始まる」、「次の値で終わる」、「含まない」 | テーブルまたはデータソースのこのフィールドで見つかった値または値の一部を表す 1 つ以上のテキスト文字。 |
| ユーザー入力 | 「次の値に等しい」、「次の値ではない」 | テーブルまたはデータソース内のこのフィールドの一部のレコードの完全な値を表すことができるテキスト文字。 |
| テーブル名 | 「次の値に等しい」、「次の値ではない」、「次の値のいずれかである」、「次の値で始まる」、「次の値で終わる」、「次の値を含む」、「次の値を含まない」、「次の間」、「次の値以上」、「次の値以下」 | システム内の完全または一部のテーブル名のテキスト表現。「is one of」演算子の場合、想定される戻り値の型は、テーブル名値のカンマ区切りリストか、結果に含める必要がある各テーブル名を含むアレイのいずれかです。 |
| テンプレート値 | 「次の値に等しい」、「次の値ではない」 | インスタンスで見つかったテンプレートに従って値を満たすテキスト文字。 |
| ドメイン ID | 「次の値で始まる」、「次の値で終わる」、「次の値を含む」、「次の値を含まない」 | テーブルまたはデータソースのドメインフィールドで見つかった値または値の一部を表す 1 つ以上のテキスト文字。 |
| ユーザーロール | 「次の値に等しい」、「次の値ではない」 | ユーザーロール文字列値のテキスト表現。 |
| ドメインパス | 「次の値で始まる」、「次の値で終わる」、「含む」、「含まない」、「次の値に等しい」、「次の値ではない」、「次の値のいずれか」、「次の値以下」、または「次の値以上」、「次の間」 | テーブルまたはデータソースのこのフィールドで見つかった値または値の一部を表す 1 つ以上のテキスト文字。「is one of」演算子の場合は、テキスト値のカンマ区切りリストまたは含める必要がある各値を含むアレイオブジェクトのいずれかです。 |
| 翻訳されたテキスト | 「次の値に等しい」、「次の値ではない」、「次の値のいずれかである」、「次の値で始まる」、「次の値で終わる」、「次の値を含む」、「次の値を含まない」、「次の間」、「次の値以上」、「次の値以下」 | テキスト値。 「is one of」演算子の場合、想定される戻り値の型は、カンマ区切りのテキスト値のリストまたはテキスト値の配列のいずれかです。 |
| 翻訳 (変換) 済みフィールド | ||
| HTML | 「含む」、「含まない」 | このレポート基準で選択したフィールドのデータに対応する可能性があるテキスト値。 |
| HTML テンプレート | ||
| Email スクリプト | 「含む」、「含まない」 | [メールスクリプト] フィールドに含める必要がある (または含めるべきでない) 値を表すテキスト値。 |
| スクリプト (プレーン) | 「含む」、「含まない」 | [スクリプト] フィールドに含める必要がある (または含めるべきでない) 値を表すテキスト値。 |
| スクリプト (サーバー側) | ||
| スクリプト | ||
| 短いテーブル名 | 「次の値に等しい」、「次の値ではない」 | テキスト値 (40 文字未満)。 「is one of」演算子の場合、想定される戻り値の型は、カンマ区切りのテキスト値のリストか、短いテーブル名を表す各テキスト文字を含む配列のいずれかです。 |
| フィールド名 | 「次の値に等しい」、「次の値ではない」、「次の値のいずれかである」、「次の値で始まる」、「次の値で終わる」、「次の値を含む」、「次の値を含まない」、「次の間」、「次の値以上」、「次の値以下」 | 完全または部分的なフィールド名値のテキスト表現。 「is one of」演算子の場合、想定される戻り値の型は、フィールド名値のカンマ区切りリストか、結果に含める必要がある各フィールド名を含むアレイのいずれかです。 |
手順
次のタスク
必要な JavaScript ステートメントと条件を追加し、レポートの残りの部分を設定したら、レポートをテストして、期待どおりの結果が返されて表示されることを確認します。