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

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

始める前に

必要なロール：workspace_admin

このタスクについて

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

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

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

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

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

手順

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

      

2. ワークスペースアクションを使用して、エージェントがインシデントに場所を追加できるようにする [追加 ] ボタンを作成します。
   1. 移動先 ワークスペースエクスペリエンス > アクション & コンポーネント > 関連リストアクション をクリックし、[ New] をクリックします。
   2. フォームのフィールドに入力します。

      表 : 1. アクションのアサインフォーム

      フィールド	説明
      アクションラベル	[関連リスト] 領域のボタンに表示されるラベル。これ を追加します。前の画像では、[新規] ボタンの横に [追加] ボタンが表示されています。
      アクション名	関連リストアクションのリストに表示されるこのレコードの名前。 ワークスペースエクスペリエンス > アクション & コンポーネント > 関連リストアクション.
      Implemented as (実装方法)	ボタンを作成するため 、[UI コンポーネント ] を選択します。
      Specify UI component (UI コンポーネントを指定)	[sn-multi-record-associator] を選択します。
      ボタンタイプ	[プライマリ] を選択します。プライマリボタンは緑色です。セカンダリボタンはグレーです。
      レコードの選択が必要	レコードの選択を必須にするチェックボックス。
      ツールヒント	エージェントが UI コンポーネントの上にマウスを置くと表示されるテキスト。
      説明	このワークスペースアクションの詳細な説明。
      アプリケーション	このコンポーネントが適用されるアプリケーション。[グローバル (Global)] とは、コンポーネントがすべてのアプリケーションに適用されることを意味します。
      ワークスペース	この UI コンポーネントが表示されるワークスペース。
      テーブル	この関連リストアクションが表示されるテーブル。 O2M 関係の場合は、テーブルが O2M 関連リストテーブルであることを確認します。たとえば、incident などです。 m2m 関係の場合は、テーブルが自分の m2m テーブルであることを確認してください。たとえば、task_location などです。 この例では、[task_location] を選択します。
      ビュー	ワークスペースを選択します。
      アクティブ	この UI コンポーネントのオン (選択済み) とオフを切り替えます。
      順序	この UI コンポーネントが UI コンポーネントの水平リストに表示される順序。値が小さいほど、その場所から離れます。

   3. [関連リンク] で [詳細ビュー] をクリックし、コンポーネントが機能するために必要なプロパティを指定します。
   4. [ コンポーネント属性 ] タブで、フィールドに入力します。

      表 : 2. コンポーネント属性フォーム

      フィールド	説明
      ラベル	[ 追加 ] ボタンをクリックしたときにモーダルの上部に表示される名前。
      extensionPoint	この例では、空白のままにします。このフィールドは、モーダル内のリストをフィルタリングします。エージェントが [追加] をクリックすると、cmn_locationテーブルとタスクテーブルの間に考えられるすべての関連付けが表示されます。このフィールドは、これらの関連付けの一部を防ぎます。拡張ポイントの作成方法については、「 拡張ポイントを使用してアプリケーション機能を拡張する」を参照してください。
      userGivenTable	モーダルに表示されるテーブル。この例では、エージェントが追加できる場所を開くため、[cmn_location] を選択します。 m2m リレーションシップの task_location を選択します。 O2M リレーションシップの場合は、O2M の多部分に関連付けられたテーブルを選択します。たとえば、 インシデントです。
      hideSelectAll	[すべて選択] を非表示にできるフィールド。[すべて選択] を非表示にするには、[True] を選択します。
      参照フィールド名	userGivenTable からモーダルに表示されるフィールド。この例では、 場所 (小文字) を入力します。フィールド名を検索するには、多対多テーブルフォームの [ 場所 ] フィールドのタイトルを右クリックします。 このフィールドは、O2M 関係には使用されません。
      タイプ	レコードの関係性タイプ。レコードの O2M または M2M の関係を選択します。 O2M を使用すると、1 つのテーブル内の親レコードが複数の子レコードを参照できるようになります。 多対多手段では 、別のテーブルの複数のレコードに関連付けられたテーブル内の複数のレコードを使用できます。
      parentFieldName	参照元のフィールドの名前。この例では「 task」です。フィールド名を見つけるには、フィールドのタイトルを右クリックします。
      列	モーダルに表示する列のカンマ区切りリスト。たとえば、cmn_locationテーブルで、名前と市区町村が必要になる場合があります。「 name,city」と入力します
      表示	リストのビュー。値を追加しないでください。デフォルトのビューで問題ありません。

   5. [更新] をクリックします。
      インシデントレコードが開いたときに [関連リスト] 領域に表示される [追加 ] ボタンを作成しました。
3. [ 追加 ] ボタンが表示され、機能することを確認します。
   1. インシデントを開くには、次の場所に移動します。 インシデント > オープン インシデントをクリックします
   2. [ 影響を受ける場所 ] 関連リストをクリックします。
      関連リストに [Add ] ボタンが表示されます。
   3. [Add (追加)] をクリックします。
      モーダルが表示されます。

      

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

      

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

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

   1. 移動先 ワークスペースエクスペリエンス > アクション & コンポーネント > 関連リストアクション をクリックし、[ New] をクリックします。
   2. フォームのフィールドに入力します。

      表 : 3. アクションのアサインフォーム

      フィールド	説明
      アクションラベル	[関連リスト] 領域のボタンに表示されるラベル。アクションラベルに ({{count}}) が含まれていることを確認します。
      アクション名	関連リストアクションのリストに表示されるこのレコードの名前。 ワークスペースエクスペリエンス > アクション & コンポーネント > 関連リストアクション.
      Implemented as (実装方法)	「サーバー・スクリプト」を選択します。
      Specify UI component (UI コンポーネントを指定)	[sn-multi-record-associator] を選択します。
      ボタンタイプ	[プライマリ] を選択します。プライマリボタンは緑色です。セカンダリボタンはグレーです。
      レコードの選択が必要	レコードの選択を必須にするチェックボックス。チェックボックスを切り替えます。
      ツールヒント	エージェントが UI コンポーネントの上にマウスを置くと表示されるテキスト。
      説明	このワークスペースアクションの詳細な説明。
      アプリケーション	このコンポーネントが適用されるアプリケーション。[グローバル (Global)] とは、コンポーネントがすべてのアプリケーションに適用されることを意味します。
      ワークスペース	この UI コンポーネントが表示されるワークスペース。
      テーブル	この関連リストアクションが表示されるテーブル。 O2M 関係の場合は、テーブルが O2M 関連リストテーブルであることを確認します。たとえば、incident などです。 m2m 関係の場合は、テーブルが自分の m2m テーブルであることを確認してください。たとえば、task_location などです。 この例では、[task_location] を選択します。
      ビュー	ワークスペースを選択します。
      アクティブ	この UI コンポーネントのオン (選択済み) とオフを切り替えます。
      順序	この UI コンポーネントが UI コンポーネントの水平リストに表示される順序。値が小さいほど、その場所から離れます。

   3. メニューアイコン( メニュー )をクリックし 、[保存] をクリックします。
   4. [関連リンク] で、[詳細ビュー] をクリックします。
   5. 「 サーバー・スクリプト 」タブをクリックします。
   6. スクリプティングフィールドにサーバースクリプトを入力します。 current.deleteRecord(); [Server Script] フィールドに入力します。
      • m2m 関係の場合は、「 current.deleteRecord();」と入力します。
      • o2m 関係の場合は、 current を入力します。field_name] = '';current.update();です。
   7. [関連リンク] で [詳細ビュー] をクリックし、[確認設定] タブをクリックします。
   8. 確認が必要を切り替えます。
   9. [更新] をクリックします。

次のタスク

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

タブ 通知 フォームヘッダー UI アクション

リボン 次世代 BSM 関連アイテム フォームペイン アクション & コンポーネント

アクティビティストリーム コンテキストサイドパネル