関連リストへのレコードの追加の設定

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

    • エージェントが関連リストにレコードを追加できるように [追加 ] ボタンを作成します。

    始める前に

    必要なロール：workspace_admin

    このタスクについて

    エージェントがリストにレコードを追加できるようにする [追加 ] ボタンを作成できます。この機能は、1 対多 (o2m) および多対多 (m2m) のテーブルをサポートしています。次の例では、task_locationテーブルを使用して、インシデントの [追加 ] ボタンを作成します。したがって、インシデントを開いたときに、新しい関連リストの [ 影響を受ける場所] をクリックすると、同じ場所で発生したインシデント (タスク) を表示できます。多くのインシデントが 1 つの場所で発生し、1 つのインシデントに複数の場所が含まれる場合があります。

    一般的な手順では、多対多テーブルに関連付けられている関連リスト、 影響を受ける場所 、task_locationを追加し、ワークスペースアクションを作成して、この例ではインシデントに場所を追加する [ 追加 ] ボタンを作成します。

    関連リストの [追加] ボタン

    エージェントが [追加] をクリックすると、インシデントを追加できるエージェントの場所を示すモーダルが開きます。

    場所のモーダル。

    次の例を理解するには、フィルターナビゲーターに「task_location.list」と入力してtask_locationテーブルを表示します。

    場所タスクテーブル。

    このテーブルは、場所 (cmn_location) テーブルとタスク (task) テーブルの間の関連性を示しています。この例では、ありません。

    手順

    1. 新しい関連リストの [影響を受ける場所] を追加します。これはインシデントレコードとともに表示されます。
      1. に移動してインシデントを開く インシデント > オープン をクリックし、インシデントをクリックします。
      2. プロファイルアイコン ( メニューアイコン) をクリックし、[ ページを構成]、[ フォームレイアウト] の順に選択して、ワークスペースビューが開いていることを確認します。
      3. プロファイルアイコン ( メニューアイコン) をクリックし、[ ページを構成] を選択して、[ 関連リスト] を選択し、インシデントテーブルの関連リストを設定します。
      4. [インシデント] フォームの [関連リストの構成] フォームの [ビュー名] で、[ ワークスペース] を選択します。
      5. [影響を受ける場所] を選択し、矢印を使用して [選択済み] 列に移動します。
        task_location値は 「影響を受ける場所」と呼ばれます。
      6. [Save (保存)] をクリックします。
        すべてのインシデントレコードの関連リストとして 、影響を受ける場所 を追加しました。

        影響を受ける場所。

    2. ワークスペースアクションを使用して、エージェントがインシデントに場所を追加できるようにする [追加 ] ボタンを作成します。
      1. 次のように移動する。 ワークスペースエクスペリエンス > アクション & コンポーネント > 関連リストアクション をクリックし、[ 新規] をクリックします。
      2. フォームのフィールドに入力します。
        表 : 1. アクションのアサインフォーム
        フィールド 説明
        Action label (アクションラベル) [関連リスト] 領域のボタンに表示されるラベル。これ を追加します。前の画像では、[新規] ボタンの横に [追加] ボタンが表示されます。
        アクション名 関連リストアクションのリストに表示されるこのレコードの名前 ワークスペースエクスペリエンス > アクション & コンポーネント > 関連リストアクション.
        実装方法 ボタンを作成しているため、[ UI コンポーネント ] を選択します。
        UI コンポーネントを指定 sn-multi-record-associator を選択します。
        ボタンタイプ [プライマリ] を選択します。プライマリボタンは緑色です。セカンダリボタンはグレーです。
        レコードの選択が必要 レコードの選択を必須にするチェックボックス。
        ツールヒント エージェントが UI コンポーネントの上にマウスを置いたときに表示されるテキスト。
        説明 このワークスペースアクションの詳細な説明。
        アプリケーション このコンポーネントが適用されるアプリケーション。[グローバル (Global)] とは、コンポーネントがすべてのアプリケーションに適用されることを意味します。
        ワークスペース この UI コンポーネントが表示されるワークスペース。
        テーブル この関連リストアクションが表示されるテーブル。
        • o2m 関係の場合は、テーブルが o2m 関連リストテーブルであることを確認します。たとえば、incident などです。
        • m2m 関係の場合は、テーブルが自分の m2m テーブルであることを確認します。例:task_location。
        この例では、[task_location] を選択します。
        ビュー ワークスペースを選択します。
        [Active (アクティブ)] この UI コンポーネントのオンとオフを切り替えます。
        順序 この UI コンポーネントが UI コンポーネントの水平リストに表示される順序。値が小さいほど、場所は左に離れます。
      3. [ 関連リンク] で、[ 詳細ビュー ] をクリックして、コンポーネントが機能するために必要なプロパティを指定します。
      4. [ コンポーネント属性 ] タブで、フィールドに入力します。
        表 : 2. コンポーネント属性フォーム
        フィールド 説明
        label [ 追加 ] ボタンをクリックしたときにモーダルの上部に表示される名前。

        モーダルのタイトル。
        extensionPoint この例では、空白のままにします。このフィールドは、モーダルのリストをフィルタリングします。エージェントが [ 追加] をクリックすると、cmn_locationテーブルとタスクテーブルの間に考えられるすべての関連付けが表示されます。このフィールドでは、これらの関連付けの一部が防止されます。拡張ポイントの作成方法については、「 拡張ポイントを使用してアプリケーション機能を拡張する」を参照してください。
        userGivenTable モーダルに表示されるテーブル。この例では、エージェントが追加できる場所を開くため、[cmn_location] を選択します。
        • m2m 関係の task_location を選択します。
        • o2m 関係の場合は、o2m の多くの部分に関連付けられたテーブルを選択します。例: インシデント。
        hideSelectAll [すべて選択] を非表示にできるフィールド。[すべて選択] を非表示にするには 、[True ] を選択します。
        参照フィールド名 userGivenTable からモーダルに表示されるフィールド。この例では、 場所 (小文字) を入力します。フィールド名を見つけるには、多対多テーブルフォームの [場所 ] フィールドタイトルを右クリックします。

        フィールド名。

        このフィールドは、o2m の関係には使用されません。
        type レコード関係タイプ。レコードの o2m または m2m 関係を選択します。
        • o2m では、1 つのテーブルで複数の子レコードを参照できる親レコードを有効にします。
        • m2m を使用すると、テーブル内の複数のレコードを別のテーブルの複数のレコードに関連付けることができます。
        parentFieldName 参照元のフィールドの名前。この例では タスクです。フィールド名を見つけるには、フィールドタイトルを右クリックします。

        タスクフィールド。
        columns モーダルに表示する列のカンマ区切りリスト。たとえば、cmn_locationテーブルに、名前と市区町村が必要な場合があります。したがって、 名前、市区町村を入力します。
        view リストのビュー。値を追加しないでください。デフォルトのビューで問題ありません。
      5. [Update (更新)] をクリックします。
        インシデントレコードが開いたときに [関連リスト] 領域に表示される [追加 ] ボタンを作成しました。
    3. [追加] ボタンが表示され、機能することを確認します。
      1. に移動してインシデントを開く インシデント > オープン インシデントをクリックします。
      2. [影響を受ける場所] 関連リストをクリックします。
        [Related Lists] に [ Add ] ボタンが表示されます。
      3. [追加] をクリックします。
        モーダルが表示されます。

        場所のモーダル。

      4. いくつかのチェックボックスをオンにして、これらの住所をインシデントレコードに追加し、[ 追加] をクリックします。
        選択した住所が [影響を受ける場所] に表示されます。

        影響を受ける場所。

      5. フィルターナビゲーターに「task_location.list」と入力して、task_locationテーブルを表示します。
        新しい場所がテーブルに表示されます。
    4. 削除アクションを追加します。

      エージェントが関連リストからレコードを削除し、親テーブルからそのレコードの関連付けを解除できるようにする削除ボタンを作成できます。この機能は、o2m および m2m テーブルをサポートしています。

      1. 次のように移動する。 ワークスペースエクスペリエンス > アクション & コンポーネント > 関連リストアクション をクリックし、[ 新規] をクリックします。
      2. フォームのフィールドに入力します。
        表 : 3. アクションのアサインフォーム
        フィールド 説明
        Action label (アクションラベル) [関連リスト] 領域のボタンに表示されるラベル。アクションラベルに ({{count}}) が含まれていることを確認します。
        アクション名 関連リストアクションのリストに表示されるこのレコードの名前 ワークスペースエクスペリエンス > アクション & コンポーネント > 関連リストアクション.
        実装方法 [サーバースクリプト] を選択します。
        UI コンポーネントを指定 sn-multi-record-associator を選択します。
        ボタンタイプ [プライマリ] を選択します。プライマリボタンは緑色です。セカンダリボタンはグレーです。
        レコードの選択が必要 レコードの選択を必須にするチェックボックス。チェックボックスを切り替えます。
        ツールヒント エージェントが UI コンポーネントの上にマウスを置いたときに表示されるテキスト。
        説明 このワークスペースアクションの詳細な説明。
        アプリケーション このコンポーネントが適用されるアプリケーション。[グローバル (Global)] とは、コンポーネントがすべてのアプリケーションに適用されることを意味します。
        ワークスペース この UI コンポーネントが表示されるワークスペース。
        テーブル この関連リストアクションが表示されるテーブル。
        • o2m 関係の場合は、テーブルが o2m 関連リストテーブルであることを確認します。たとえば、incident などです。
        • m2m 関係の場合は、テーブルが自分の m2m テーブルであることを確認します。例:task_location。
        この例では、[task_location] を選択します。
        ビュー ワークスペースを選択します。
        [Active (アクティブ)] この UI コンポーネントのオンとオフを切り替えます。
        順序 この UI コンポーネントが UI コンポーネントの水平リストに表示される順序。値が小さいほど、場所は左に離れます。
      3. メニューアイコン( メニューアイコン)をクリックし、[ 保存]をクリックします。
      4. [関連リンク] で、[詳細表示] をクリックします。
      5. [サーバースクリプト] タブをクリックします。
      6. スクリプトフィールドにサーバースクリプトを入力します。 current.deleteRecord(); [サーバースクリプト] フィールドに入力します。
        • m2m 関係の場合は、「 current.deleteRecord();」と入力します。
        • o2m リレーションシップの場合は、「 current.[」と入力します。field_name] = '';current.update();です。
      7. [関連リンク] で [詳細表示] をクリックし、[確認設定] タブをクリックします。
      8. トグル の確認が必要です。
      9. [Update (更新)] をクリックします。

    次のタスク

    設定するコンポーネントをクリックします。

    レコードビュー