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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む9読むのに数分

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

    始める前に

    必要なロール：workspace_admin

    このタスクについて

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

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

    影響を受ける場所

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

    場所のモーダル。

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

    タスクの場所テーブル

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

    手順

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

        影響を受ける場所

    2. ワークスペースアクションを使用して、エージェントがインシデントに場所を追加できるようにする [追加 ] ボタンを作成します。
      1. 移動先 Now Experience フレームワーク > 宣言アクション > 関連リストアクション をクリックし、[ 新規] をクリックします。
      2. フォームのフィールドに入力します。
        表 : 1. アクションのアサインフォーム
        フィールド 説明
        アクションラベル [関連リスト] 領域のボタンに表示されるラベル。これ を追加します。前の画像では、[新規] ボタンの横に [追加] ボタンが表示されています。
        アクション名 関連リストアクションのリストに表示されるこのレコードの名前。 Now Experience フレームワーク > 宣言アクション > 関連リストアクション.
        注:
        このレコードは、アクションラベルを作成すると自動的に入力されます。
        実装方法 ボタンを作成するため 、[UI コンポーネント ] を選択します。
        UI コンポーネントを指定 [sn-multi-record-associator] を選択します。
        ボタンタイプ [プライマリ] を選択します。プライマリボタンは緑色です。セカンダリボタンはグレーです。
        レコードの選択が必要 レコードの選択を必須にするチェックボックス。
        ツールヒント エージェントが UI コンポーネントの上にマウスを置いたときに表示されるテキスト。
        説明 このワークスペースアクションの詳細な説明。
        アプリケーション このコンポーネントが適用されるアプリケーション。[グローバル (Global)] とは、コンポーネントがすべてのアプリケーションに適用されることを意味します。
        ワークスペース この UI コンポーネントが表示されるワークスペース。
        テーブル この関連リストアクションが表示されるテーブル。
        • O2M 関係の場合は、テーブルが O2M 関連リストテーブルであることを確認します。たとえば、incident などです。
        • m2m リレーションシップの場合は、テーブルが自分の m2m テーブルであることを確認してください。たとえば、task_location です。
        この例では、[task_location] を選択します。
        表示 ワークスペースを選択します。
        アクティブ この UI コンポーネントのオン (選択済み) とオフを切り替えます。
        順番 この UI コンポーネントが UI コンポーネントの水平リストに表示される順序。値が小さいほど、位置は左に離れます。
      3. [ Related Links (関連リンク)] で [ Advanced view (詳細ビュー )] をクリックして、コンポーネントが機能するために必要なプロパティを指定します。
      4. [ コンポーネント属性 ] タブで、フィールドに入力します。
        表 : 2. コンポーネント属性フォーム
        フィールド 説明
        ラベル [ 追加 ] ボタンをクリックしたときにモーダルの上部に表示される名前。
        extensionPoint この例では、空白のままにします。このフィールドは、モーダルのリストをフィルタリングします。エージェントが [ 追加] をクリックすると、cmn_locationテーブルとタスクテーブル間で考えられるすべての関連付けが表示されます。このフィールドは、これらの関連付けの一部を防止します。拡張ポイントの作成方法については、「 拡張ポイントを使用してアプリケーション機能を拡張する」を参照してください。
        userGivenTable モーダルに表示されるテーブル。この例では、エージェントが追加できる場所を開くため、[cmn_location] を選択します。
        • m2m リレーションシップの task_location を選択します。
        • O2M 関係の場合は、O2M の多くの部分に関連付けられたテーブルを選択します。たとえば、インシデントなどです。
        hideSelectAll [すべて選択] を非表示にできるフィールド。[すべて選択] を非表示にするには True を選択します。
        referencedfieldName userGivenTable からモーダルに表示されるフィールド。この例では、 location (小文字) を入力します。フィールド名を検索するには、多対多テーブル フォームの [ 場所 ] フィールドのタイトルを右クリックします。

        このフィールドは、O2M リレーションシップには使用されません。
        type レコードの関係性タイプ。レコードの o2m または m2m の関係を選択します。
        • O2M により、複数の子レコードを参照できる 1 つのテーブル内の親レコードが有効になります。
        • M2M では、テーブル内の複数のレコードを別のテーブルの複数のレコードに関連付けることができます。
        parentFieldName 参照元のフィールドの名前。この例では「 task」です。フィールド名を見つけるには、フィールドのタイトルを右クリックします。
        列 モーダルに表示する列のカンマ区切りリスト。たとえば、cmn_location テーブルでは、名前と市区町村が必要な場合があります。したがって、 名前、都市を入力します。
        view リストのビュー。値を追加しないでください。デフォルトのビューで問題ありません。
      5. [更新] をクリックします。
        インシデントレコードが開いたときに [関連リスト] 領域に表示される [追加 ] ボタンを作成しました。
    3. [ 追加 ] ボタンが表示され、機能することを確認します。
      1. インシデントを開くには、次の場所に移動します。 インシデント > オープン インシデントをクリックします
      2. [ 影響を受ける場所 ] 関連リストをクリックします。
        関連リストに [追加 ] ボタンが表示されます。
      3. 追加 をクリックします。
        場所を追加するためのモーダルが表示されます。
      4. これらの住所をインシデントレコードに追加するには、いくつかのチェックボックスをオンにして、[ 追加] をクリックします。
        選択した住所が [影響を受ける場所] に表示されます。
      5. フィルターナビゲーターに「task_location.list」と入力して、task_locationテーブルを表示します。
        新しい場所がテーブルに表示されます。
    4. 削除アクションを追加します。

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

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

    次のタスク

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

    レコードビュー