定義済みの関連リストを作成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：3分

    • デフォルトの関連リストをフォームに追加して、すべてのユーザーがレコードを表示するときに表示できるようにすることができます。

    始める前に

    必要なロール:related_list_admin

    このタスクについて

    たとえば、問題レコードの下部に関連インシデントのリストを含めたり、グループレコードの下部にメンバーのリストを含めたりすることができます。この機能は、参照フィールドまたは多対多のテーブル関係に依存します。2 つのテーブルがシステム辞書を介して関連付けられている場合、一方を関連リストとして他方に表示できます。

    定義された関連リストを使用すると、任意のテーブル間の関係を関連リストとして表すことができます。論理的な関係を持つことができる 2 つのテーブルは、関連リストを介して親子ペアとして表示できます。以下にいくつかの例を示します。
    • インシデントレコードで、同じ発信者によってオープンされたすべてのインシデントを表示します。
    • ユーザーレコードで、ユーザーが行った最近の 20 件のトランザクションを表示します。
    • インシデントレコードで、報告された CI のオープン中の問題をすべて表示します。

    これらの関係は、参照フィールドや多対多の関係を通じてシステムディクショナリで通常定義される関係を超えています。

    すべての関連リストには関係レコードが必要です。関係を作成する前に、必要な情報を既に提供している既存の関係レコードがないことを確認してください。関係レコードを作成するには、次の手順に従います。

    手順

    1. Click システム定義 > 関係性.
    2. [新規] をクリックします。
    3. 関係レコードのフィールドを指定します。
      表 : 1. リレーションレコードフィールド
      フィールド 説明
      名前 関連リストの名前を入力します。フォーム設定ページでは、使用可能なリストのリストにこの名前が表示されます。
      詳細 [ テーブルに適用 ] および [テーブルからのクエリー] フィールドの代わりに JavaScript を使用するには、このチェックボックスをオンにします。
      テーブルに適用 関連リストが表示されるテーブルを選択します。

      たとえば、ユーザーフォームに関連リストを追加するには、ユーザー [sys_user] テーブルを選択します。

      このフィールドは、詳細な関係レコードでは非表示になります。
      テーブルからのクエリ この関連リストのデータの取得元となるテーブルを選択します。

      たとえば、関連するタスクレコードを関連リストに追加するには、タスク [task] テーブルを選択します。

      このフィールドは、詳細な関係レコードでは非表示になります。
      適用先 ユーザーが目的のテーブルでフォームを開いたときに answer 変数を true に設定するスクリプトを入力します。このフィールドは、[ 詳細] チェックボックスがオンになっている場合にのみ表示されます。
      クエリ元 回答 変数を 関連リストがデータを取得するテーブルの名前に設定するスクリプトを入力します。このフィールドは、[ 詳細] チェックボックスがオンになっている場合にのみ表示されます。
      クエリ条件 スクリプトを入力して、含めるレコードを指定します。

      例：

      current.addQuery('opened_by', parent.sys_id);
      • 現在のオブジェクトは、スクリプトがトリガーされる現在のレコードを指定します。
      • addQuery メソッドは、指定された条件を満たすレコードを返すフィルターを追加します。
      • opened_by変数は、[テーブルからのクエリー] からテーブルでクエリーするフィールド名です。
      • parent.sys_id 変数は、[適用先] テーブルと表示されているレコードの ID を参照します。
      コールバックを挿入 挿入アクションが成功した後に実行するスクリプトを入力します。このフィールドは、[ 詳細] チェックボックスがオンになっている場合にのみ表示されます。
    4. [送信] をクリックします。