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

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

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

1. massupdatestages という Visualforce ページを作成します。
2. 次のコントローラを指定します。
   1swfobject.registerObject("clippy.codeblock-0", "9");public class selectedSizeWorkaround {
   2
   3    ApexPages.StandardSetController setCon;
   4
   5    public selectedSizeWorkaround(ApexPages.StandardSetController controller) {
   6        setCon = controller;
   7    }
   8
   9    public integer getMySelectedSize() {
   10        return setCon.getSelected().size();
   11    }
   12    public integer getMyRecordsSize() {
   13        return setCon.getRecords().size();
   14    }
   15}
   16

3. 次のマークアップを指定します。
   1swfobject.registerObject("clippy.codeblock-1", "9");<apex:page 
   2    standardController="Opportunity"
   3    recordSetVar="opportunities"
   4    extensions="selectedSizeWorkaround"
   5    showHeader="false"
   6    id="muopp"
   7>
   8    <apex:form id="muform">
   9        <apex:pageMessage 
   10            summary="Selected Collection Size: {!mySelectedSize}" 
   11            severity="info"
   12            id="mupms"
   13        />
   14        <apex:pageMessage
   15            summary="Record Set Size: {!myRecordsSize}"
   16            severity="info"
   17            id="mupmr"
   18        />
   19        <apex:pageBlock title="Opportunity Mass-Update" mode="edit" id="mub1">
   20            <apex:pageMessages />
   21            <apex:pageBlockSection id="mus1">
   22                <apex:inputField value="{!opportunity.stagename}" id="stagename">
   23                    <apex:actionSupport event="onchange" rerender="muselectedlist"/>
   24                </apex:inputField>
   25            </apex:pageBlockSection>
   26            <apex:pageBlockButtons location="bottom" id="mubut">
   27                <apex:commandButton value="Save" action="{!save}" id="butsav"/>
   28                <apex:commandButton value="Cancel" action="{!cancel}" id="butcan"/>
   29            </apex:pageBlockButtons>
   30        </apex:pageBlock>
   31        <apex:pageBlock title="Selected Opportunities" id="muselectedlist">
   32            <apex:pageBlockTable value="{!selected}" var="opp" id="mutab">
   33                <apex:column value="{!opp.name}" id="oppname"/>
   34                <apex:column value="{!opp.stagename}" id="oppstage"/>
   35            </apex:pageBlockTable>
   36        </apex:pageBlock>
   37    </apex:form>
   38</apex:page>

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

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