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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：3分

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

    始める前に

    必要なロール：admin

    このタスクについて

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

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

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

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

    手順

    1. クリックします システム定義 > リレーションシップ.
    2. [New] をクリックします。
    3. 関係レコードのフィールドを指定します。
      表 : 1. 関係レコードフィールド
      フィールド 説明
      [Name (名前)] 関連リストの名前を入力します。フォーム設定ページでは、使用可能なリストのリストにこの名前が表示されます。
      詳細 [ 適用先テーブル ] フィールドと [クエリー元 テーブル] フィールドの代わりに JavaScript を使用するには、このチェックボックスをオンにします。
      Applies to table (適用先テーブル) 関連リストが表示されるテーブルを選択します。

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

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

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

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

      例：

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