カスタムデータルックアップの作成

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:8分
  • カスタムデータルックアップの作成には、ルックアップ値の追加、定義の作成、およびデータルックアップの有効化が含まれます。

    カスタムデータルックアップテーブルの作成

    ルックアップデータを格納するカスタムテーブルを作成します。

    カスタムテーブルでは、データルックアップ照合ルール [dl_matcher] テーブルを拡張する必要があります。たとえば、このカスタムルックアップテーブルには、VIP の発信者とインシデントの割り当てに関する情報が保存されます。

    表 : 1. カスタムデータルックアップテーブル
    フィールド サンプル値
    ラベル VIP 発信者ルックアップ
    テーブル名 u_vip_caller_lookup
    拡張ベース テーブル dl_matcher
    新規モジュールの作成 true
    モジュールをメニューに追加 システムポリシー

    データルックアップテーブルにデータルックアップ値を追加します。

    データルックアップテーブルの列には、照合フィールドとセッターフィールドの両方のデータが含まれています。

    このタスクについて

    各データルックアップは、照合フィールドに一致する値を含む行を検索するクエリーです。次に、データルックアップはセッターフィールドにリストされた値を返します。たとえば、この優先度データルックアップ [dl_u_priority] テーブルには、特定の優先度値 (セッターフィールド) を生成する影響度と緊急度 (照合フィールド) の組み合わせが一覧表示されます。

    表 : 2. ルックアップテーブル
    照合フィールド セッターフィールド
    影響 緊急度 優先度
    1 - 高 1 - 高 1 - 重大
    1 - 高 2 - 中 2 - 高
    1 - 高 3 - 低 3 - 中
    2 - 中 1 - 高 2 - 高
    2 - 中 2 - 中 3 - 中
    2 - 中 3 - 低 4 - 低
    3 - 低 1 - 高 3 - 中
    3 - 低 2 - 中 4 - 低
    3 - 低 3 - 低 5 - 計画中

    手順

    1. ナビゲーションフィルターで、新しいカスタムルックアップテーブルの名前を入力します。
      たとえば、「u_vip_caller_lookup.list」と入力します。
    2. リストを構成し、新しいフィールドを作成します。

      この例では、次のテーブルに新しいフィールドを作成します。

      表 : 3. 新しいフィールド
      名前 タイプ 参照するフィールド長またはテーブル
      問い合わせユーザー 参照 ユーザー [sys_user]
      優先度 整数
      アサイン先グループ 参照 グループ [sys_user_group]

      詳細については、「でのリストの構成 Now Platform」を参照してください。

    3. テーブルリストから [新規] をクリックし、照合フィールドとセッターフィールドに適切な値を入力します。

      例:

      表 : 4. 新しい照合フィールドとセッターフィールドの値
      照合フィールド セッターフィールド
      問い合わせユーザー 優先度 アサイン先グループ
      Beth Anglin 2 VIP の問題
      Fred Luddy 1 VIP の問題
      カスタムルックアップ値
      注:
      データルックアップテーブルの各行は一意でなければなりません。

    データルックアップ定義レコードを作成します。

    データルックアップには、指定された条件が満たされたときに 1 つ以上のフィールド値を設定する方法を指定する定義レコードが必要です。

    始める前に

    必要なロール:admin

    手順

    1. 次のように移動する。 All (すべて) > システムポリシー > Rules (ルール) > データルックアップの定義.
    2. [New (新規)] を選択します。
    3. データルックアップルールを選択します。
    4. 次のテーブルを使用して、データルックアップルールフォームに入力します。
      表 : 5. データルックアップ定義のフィールド
      フィールド 説明
      名前 定義レコードを識別する一意の名前を入力します。
      ソーステーブル ルックアップ値で自動的に更新するフィールドを含むテーブルを選択します。データルックアップ定義は拡張テーブルに継承されません。たとえば、タスクテーブルのデータルックアップ定義を、インシデントテーブルの値と一致させることはできません。
      照合テーブル ルックアップ値を含むテーブルを選択します。このテーブルは、常に u_ prefix で始まる必要があります。このテーブルは、ルックアップ値を含む現在のスコープ内の任意のテーブルにすることができます。
      注:
      リストには、カタログデータルックアップ定義と同じスコープ内にあるテーブルおよびデータベースビューのみが表示されます。
      [Active (アクティブ)] このデータルックアップルールを実行するには、このチェックボックスをオンにします。このデータルックアップルールを無視するには、チェックボックスをオフにします。
      フォーム変更時に実行

      ユーザーまたは onChange クライアントスクリプトがソーステーブルフォームのフィールド値を変更するたびに値を自動的にルックアップするには、このチェックボックスをオンにします。

      注:
      これには、優先度ルックアップルールなど、他のデータルックアップルールによって自動的に行われた変更は含まれません。
      挿入時に実行 ユーザーが新しいレコードを作成するたびに値を自動的にルックアップするには、このチェックボックスをオンにします。
      更新時に実行 ユーザーがレコードを保存または更新するたびに値を自動的にルックアップするには、このチェックボックスをオンにします。
    5. フォームヘッダーを右クリックし、[Save (保存)] を選択します。
    6. [照合フィールドの定義] 関連リストから [新規] をクリックします。
    7. 次のテーブルを使用して、照合フィールドの定義を完了します。

      データルックアップは、照合フィールド定義が設定されたフィールドでのみ行われます。データルックアップでは、ソーステーブルフィールドの値を使用して、照合テーブルから 1 つ以上の値をルックアップします。データルックアップはジャーナルタイプのフィールドでは機能しないことに注意してください。

      表 : 6. 照合フィールド定義のフィールド
      フィールド 説明
      データルックアップ 親データルックアップ定義レコードの名前を表示します。
      ソーステーブルフィールド 一致させるデータを含むソーステーブルからフィールドを選択します。
      照合テーブルフィールド 一致させるデータを含む照合テーブルのフィールドを選択します。このテーブルは、ルックアップ値を含む現在のスコープ内の任意のテーブルにすることができます。
      ルックアップの完全一致

      使用可能な値のすべての組み合わせ (空白値を含む) に一致する行が照合テーブルに含まれることを必須にするには、このチェックボックスをオンにします。このチェックボックスをオフにすると、照合テーブルの空白の値がすべての値と一致します。たとえば、照合テーブルの [優先度] フィールドが空白であるとします。このチェックボックスをオンにすると、ソーステーブルの行の [優先度] の値が空白の場合にのみ一致します。このチェックボックスをオフにすると、空の照合フィールド値がソーステーブルフィールドの任意の値と一致します。

      注:
      ルックアップが完全一致を必要としない場合、空白値を含む照合テーブル行は、すべての値と一致するワイルドカードとして扱われます。
    8. [Submit (送信)] を選択します。
    9. [セッターフィールドの定義] 関連リストから [新規] をクリックします。
    10. 次のテーブルを使用して、[セッターフィールドの定義] フォームを完了します。
      表 : 7. セッターフィールドの定義のフィールド
      フィールド 説明
      データルックアップ 親データルックアップ定義レコードの名前を表示します。
      ソーステーブルフィールド データルックアップで更新するソーステーブルのフィールドを選択します。
      照合テーブルフィールド 更新の新しい値を提供する照合テーブルからフィールドを選択します。
      常に置換 既存の値をデータルックアップの値に置き換えるには、このチェックボックスをオンにします。フィールドに既存の値がある場合に更新を無視するには、このチェックボックスをオフにします。
    11. [Submit (送信)] を選択します。
    12. [Update (更新)] を選択します。

      たとえば、次のデータルックアップ定義では、[発信者] フィールドに基づいて、インシデントを VIP の問題グループに割り当てます。また、インシデントは、発信者に基づいて重大または高優先度に設定されます。

      データルックアップの定義

    データルックアップモジュールを作成する

    データルックアップ用のモジュールを作成して、インスタンスアプリケーションナビゲーターに表示することができます。

    手順

    1. 次のように移動する。 All (すべて) > システム定義 > アプリケーションメニューをクリックし、モジュールを追加するアプリケーションを選択します。
    2. [モジュール] 関連リストで、[新規] をクリックします。
    3. 次のプロパティを使用して、作成したデータルックアップテーブルのモジュールを構成します。
      表 : 8. モジュールのプロパティ
      プロパティ 必要な値
      テーブル 手順 2 で作成したデータルックアップテーブルを選択します。例:u_vip_caller_lookup。
      リンクタイプ レコードリスト
    4. [送信] をクリックします。

    データルックアップのトラブルシューティング

    カスタムデータルックアップ定義ルールが期待どおりに動作しない場合は、特定の条件を確認します。

    • データルックアップ定義が適切なイベントで実行されるように設定されていることを確認します。
    • 照合フィールドが読み取り専用でないことを確認します。ユーザーは読み取り専用フィールドを変更できないため、読み取り専用フィールドのフォーム変更イベントをユーザーの操作によってトリガーすることはできません。
    • クライアントスクリプトがフィールド値を変更していないことを確認します。クライアントスクリプトは、読み取り専用フィールドでも Run on form change イベントをトリガーできます。
    • 照合テーブル内のデータが正しいことを確認します。
    • ルックアップで完全一致が必要とされている場合は、使用可能な各組み合わせ (空白値を含む) の照合テーブル行があることを確認します。一致する値が見つからない場合、ルックアップは失敗します。
    • 次のような再帰ルールを作成していないことを確認します。

      フィールド A = 1 の場合、フィールド B = 2。フィールド B = 2 の場合、フィールド A = 2。