標準コントローラの使用

MVC 設計パターンでは、表示やスタイルを、基盤となるデータベースとロジックから簡単に分離することができます。MVC では、ビュー (Visualforce ページ) はコントローラーと連動し、コントローラーによってページに機能が提供されます。たとえば、コントローラーにはボタンをクリックしたときに実行されるロジックが実装されています。また、多くの場合、コントローラーはビューに表示するデータを利用可能にしたり、変更内容をデータベースに戻したりするモデル (データベース) とのやり取りも行います。

大部分の標準オブジェクトとすべてのカスタムオブジェクトには、オブジェクトに関連付けられたデータを操作するための標準コントローラーが用意されており、コントローラーのコードを自分で記述しなくても済むようになっています。必要に応じて、標準コントローラーを拡張して新しい機能を追加したり、カスタムコントローラーをゼロから作成したりすることも可能です。ここでは、標準コントローラーについて学習します。

1. 新しい Visualforce ページを作成するには、開発者コンソールを開き、[File (ファイル)] | [New (新規)] | [Visualforce Page (Visualforce ページ)] をクリックします。ページ名に AccountSummary と入力します。
2. エディターで、任意のマークアップを次のように置き換えます。

   <apex:page>
       <apex:pageBlock title="Account Summary">
           <apex:pageBlockSection>
           </apex:pageBlockSection>
       </apex:pageBlock>
   </apex:page>

   このマークアップは、いくつかの便利な情報を追加できるボックスを作成します。
3. [Preview (プレビュー)] をクリックして、変更処理中に確認できるページのプレビューを開きます。プレビューウィンドウに URL 項目が表示されることを確認してください。数ステップ後にこのウィンドウに戻ります。
4. 別のブラウザーウィンドウで組織のホームページに移動し、[取引先] タブを選択します。[取引先] タブが表示されない場合は、右上隅のアプリケーションメニューから [セールス] を選択して、セールスアプリケーションに切り替えます。
5. ビューメニューに [すべての取引先] が表示されていることを確認します。
6. [すべての取引先] ページで、取引先名をクリックします。
7. 取引先詳細ページの読み込みが完了したら、ページの URL を確認します。URL は https://MyDomainName.lightning.force.com/lightning/r/Account/001D000000JRBes/view のようになっています。レコードの識別子 (ID) は一連の文字と数字です。この例では、001D000000JRBes です (これは組織によって異なります)。この ID は、組織内のすべてのオブジェクト種別のすべてのレコードで一意です。
8. レコード ID を選択してクリップボードにコピーします。取引先詳細ページから移動する前に、ページ全体と表示されている情報を確認します。 これはレコード ID を取得するためだけの迂回ではありません。ここでの処理の完了時には、自分自身で Visualforce コードを使用して、同じ情報を表示するページを作成する方法を把握できるようになります。
9. 開発者コンソールから開いたプレビューページに切り替えます。ブラウザーウィンドウの URL 項目をクリックし、URL の末尾に &id= と入力してから、直前にコピーしたレコード ID を貼り付けます。URL は、https://MyDomainName.lightning.force.com/apex/AccountSummary?core.apexpages.request.devconsole=1&id=001D000000JRBes のようになります。
10. Enter キーを押して、新しい URL でページを読み込みます。

$A.get("e.force:navigateToURL").setParams(
    {"url": "/apex/pageName"}).fire();

$A.get("e.force:navigateToURL").setParams(
    {"url": "/apex/pageName?&id=00141000004jkU0AAI"}).fire();

1. ページマークアップの先頭で、<apex:page> タグ内に次の属性を追加します。

   standardController="Account"

   ここでページを保存すると、以前と同様のプレビューページが再読み込みされますが、ここでは取引先の標準コントローラーが有効になっています。ページの読み込み時に、標準コントローラーは URL のパラメーターを解析して id パラメーターを検索し、その値でレコードを取得してページで使用可能にします。ここではまだ表示されていませんが、すでに装備されています。
2. ページのボディで、次のマークアップを追加します。

   Name: {! Account.name }

   すごいでしょう? これでレコードが取得されました。URL に追加したレコード ID の取引先の名前が表示されます。
3. 取引先名が含まれるこの 1 行を、次のマークアップで置き換えます。

   Name: {! Account.Name } <br/>
   Phone: {! Account.Phone } <br/>
   Industry: {! Account.Industry } <br/>
   Revenue: {! Account.AnnualRevenue } <br/>

   完全なコードは次のようになります。

   <apex:page standardController="Account">
       <apex:pageBlock title="Account Summary">
           <apex:pageBlockSection>
               Name: {! Account.Name } <br/>
               Phone: {! Account.Phone } <br/>
               Industry: {! Account.Industry } <br/>
               Revenue: {! Account.AnnualRevenue } <br/>
           </apex:pageBlockSection>
       </apex:pageBlock>
   </apex:page>

   これで、1 つの取引先の概要が表示されます。

1. ページのボディで、取引先名の前に次の行を追加します。

   Account owner: {! Account.Owner.Name } <br/>

ここで説明されている簡単なデータアクセスに加えて、標準コントローラーでは、ボタンやリンクなどの標準ユーザーインターフェース要素を使用してページに追加できる、作成、編集、保存、削除などの一連の標準アクションも使用できます。Visualforce 入力フォームや、データベースへの変更の保存について学習するときに、これらの標準アクションの詳細を確認できます。

オブジェクトのページレイアウト内に埋め込む Visualforce ページは、オブジェクト固有のカスタムアクションとして使用するか、関連オブジェクトの標準コントロールの使用が必要な Salesforce アプリケーションのモバイルカードとして使用します。

取引先オブジェクトなどの標準オブジェクトではなく、独自に作成したカスタムオブジェクトの項目を参照する場合は、上記とは異なる手順を実行する必要があります。[設定] から [クイック検索] ボックスに「オブジェクトマネージャー」と入力し、[オブジェクトマネージャー] | <カスタムオブジェクト> | [項目とリレーション] を選択します。項目を見つけて選択します。カスタムオブジェクトの場合、Visualforce ページでの設定で使用する項目の名前は、[API 参照名] 項目に表示されます。たとえば、Foo という項目の API 参照名が Foo__c である場合、コード内で {! myobject__c.foo__c} のように指定を行えば、項目を参照できます。

標準コントローラーは強力ですが、別のコントローラーが必要になる場合もあります。Visualforce はその場合にも問題なく対応できます。標準コントローラーはいつでも置き換えや補強が可能で、Apex コードを使用して、独自のコントローラーや組み込みコントローラーの拡張機能を作成できます。

• 標準コントローラー
• 標準リストコントローラー
• 『Visualforce in Practice』の「The Standard Controller」
• 『Visualforce in Practice』の「The Standard List Controller」
• Twitter Bootstrap and Visualforce in Minutes (Twitter Bootstrap を使用して Visualforce ページを数分で作成)