動的 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」演算子の場合、想定される戻り値の型は、フィールド名値のカンマ区切りリストか、結果に含める必要がある各フィールド名を含むアレイのいずれかです。

手順

1. 移動先 すべて > プラットフォームアナリティクス > ライブラリー > データの可視化.
2. 動的フィルターを追加するデータ可視化を開き、[ 編集] を選択します。
3. [ 構成 ] パネルで、フィルタリングするデータソースを選択します。
4. [フィルター] セクションで、フィルター条件を作成します。
   フィールドタイプと演算子のこれらの組み合わせを使用すると、動的 JavaScript ステートメントを指定できます。

   注:

   • 「between」演算子は、同じまたは異なる JavaScript URL をサポートできる 2 つのフィールドを提供します。
   • 「is」演算子は、想定されるタイプのデータ要素の配列を返すことができます。この場合、演算子は「is one of」演算子として扱われます。
   • リストフィールドは動的 JavaScript フィルターをサポートしていません。
5. フィールドタイプと演算子を選択し、JavaScript ステートメントを入力します。
   • 1 行の JavaScript ステートメントの場合は、 javascript:<JavaScript_Statement>; という形式を使用します。
   • スクリプトインクルードを呼び出す JavaScript ステートメントの場合は、 javascript:new <Record_Name>().<Function_Name>(); という形式を使用します。 この 形式では、Record_Name はスクリプトインクルードのレコード名に対応し、 Function_Name はフィルターで比較された値を返すスクリプトインクルード内の関数です。

   注:

   Javascript URL には、計算を実行して結果を返す関数に渡される 1 つ以上のパラメーターを含めることもできます。たとえば、スクリプトインクルードレコードに 2 つのパラメーターを渡す JavaScript 関数は、 javascript:new TextJSFilter().getGroupIDs("Professional Services","Sales"); と記述できます。

次のタスク

必要な JavaScript ステートメントと条件を追加し、レポートの残りの部分を設定したら、レポートをテストして、期待どおりの結果が返されて表示されることを確認します。