カスタムリストコントローラによるレコードの一括更新

一括更新を実行するページを作成するには、StandardSetController クラスに含まれるプロトタイプオブジェクトを使用します。

リストコントローラは、2 つのレコードセットを追跡します。1 つは、条件検索で選択されたすべてのレコードが含まれるプライマリリストで、もう 1 つはユーザが選択したレコードが含まれるセカンダリリストです。セカンダリリストは通常、ユーザがチェックボックスをオンにしてレコードを選択できる、標準リストビューページで設定されます。設定後、ユーザはカスタムリストボタンをクリックしてカスタム一括更新ページに移動できます。カスタム一括更新ページでは、プロトタイプオブジェクトが使用されて新しい項目値がユーザの選択したレコードに適用されます。プロトタイプオブジェクトは、ユーザが選択したすべてのレコードを操作します。カスタムコントローラでプロトタイプオブジェクトを取得するには、StandardSetController の getRecord メソッドを使用します。たとえば、Opportunities の一括更新を有効にするには、その関連付けられたオブジェクトの単数形 (Opportunity) を使用して、選択したすべてのレコードの項目値を設定します。

1. massupdatestages という Visualforce ページを作成します。
2. 次のコントローラを指定します。
3. 次のマークアップを指定します。
4. 商談のオブジェクト管理設定から、[ボタン、リンク、およびアクション] に移動します。
5. [新規ボタンまたはリンク] をクリックします。
6. [ボタン表示ラベル] を「フェーズの一括更新」に設定し、[名前] を「MassUpdateStages」に設定します。
7. [表示の種類] を「リストボタン」に設定し、[チェックボックスの表示 (複数レコード選択用)] がオンになっていることを確認します。[動作] を「サイドバーを持つ既存のウィンドウで表示」に設定し、[内容のソース] を「Visualforce ページ」に設定します。作成したページの名前をクリックしてこのボタンに関連付けます。
8. [保存] をクリックします。
9. 商談のオブジェクト管理設定から、[検索レイアウト] に移動します。次に、[商談] リストビューの横にある [編集] をクリックします。
10. [カスタムボタン] の下で、[フェーズの一括更新] ボタンを [選択したボタン] リストに移動します。
11. [保存] をクリックします。
12. [商談] タブをクリックします。変更するいくつかの既存の商談を表示する検索条件を選択するか、作成します。
13. 各結果の横にチェックボックスが表示されます。任意の数のチェックボックスをクリックし、[フェーズの一括更新] ボタンをクリックして、選択したフェーズを目的の値に変更します。
14. [保存] をクリックします。

この例では、1 つの項目を更新する方法を示していますが、プロトタイプオブジェクトの任意の数の項目を参照してユーザが選択したレコードに適用できます。プロトタイプオブジェクト内の、ユーザが設定しない項目は、選択したレコードに影響を与えません。プロトタイプオブジェクトでは、必須かどうかなど、項目のプロパティが保持されます。たとえば、Opportunity.StageName などの必須項目についてページに入力項目を含めた場合、ユーザはその項目に値を入力する必要があります。