Apexコアデベロッパーセミナー070726 配布用

株式会社セールスフォース･ドットコム　ビジネス開発本部 Apex プラットフォームコア開発者向けセミナー

このセミナーの意図 Apex プラットフォームを、もっと深く知っていただく AppExchange アプリケーション開発のブートキャンプ開発者コミュニティの活性化質問についてご質問は随時承りますはじめに

Agenda なぜ Salesforce が「プラットフォーム」になったのか Apex アプリケーションについて Salesforce のデータベース Apex API & SOQL S コントロールと AJAX Toolkit コーディングにおける TIPS Summary

Salesforce が「プラットフォーム」になった理由当初：営業支援（ SFA ）のアプリをオンデマンドで提供ビジネスとしての成功には、「共有された環境」と「自由なカスタマイズ」を両立できるかどうかが大きな鍵だった柔軟かつ強固なアプリケーションプラットフォームの設計で、顧客ごとのカスタマイズ用件を吸収 SFA 分野での成功を活かし、さらなる飛躍のため、温めてきたプラットフォーム層を解放オンデマンドでのデータベース＋アプリケーション実行環境への発展  Apex プラットフォーム

Apex プラットフォームの特徴：マルチテナント型アーキテクチャ企業 A 企業 B 企業 C Salesforce 組織 A Salesforce 組織 B Salesforce 組織 C ユーザ管理者ユーザ管理者ユーザ管理者企業 A 企業 B 企業 C Salesforce 組織 A Salesforce 組織 B Salesforce 組織 C 申し込んだ企業にそれぞれ仮想的なデータベースインスタンス（ Salesforce 組織）が割り与えられるデータベースのスキーマ（テーブル構成）やレコード情報はそれぞれの企業ごとにプライベートに隔離

Apex アプリケーションについて

Apex アプリケーションの分類 Salesforce 上ですべて動作するアプリケーション外部の Web サイトから API を介して連携するアプリケーション Salesforce ネイティブオンデマンド連携クライアント連携クライアント端末やイントラネットから API を介して連携するアプリケーション

Salesforce ネイティブアプリケーションの特徴 Salesforce 外部のサーバやプログラムを必要としないユーザの導入が容易運用やスケーラビリティに気を使う必要がないサービス提供に関する固定コストが発生しないサービス拡大時の追加投資も必要なしサービスレベルが Salesforce と同等に保証される多彩なアプリケーションの可能性 S コントロールと Apex API を使えば、作成できるアプリケーションの幅はかなり大きい＜今回の内容はこの分類のアプリケーションの構築方法が中心＞

Salesforce のデータベース

Salesforce の標準データモデル Salesforce は「企業アプリケーション」のためのプラットフォーム一般的な企業活動に必要なデータモデルは、すでに標準で登録済み自社の営業社員、従業員、スタッフ  ユーザ (User) 顧客企業  取引先（ Account ）顧客企業の従業員　  　取引先責任者（ Contact ）スケジュール、活動履歴  行動予定（ Event ）、 TODO （ Task ）営業支援、マーケティング用途のためのデータモデル見込み客  リード（ Lead ）案件情報  商談（ Opportunity ）サポートサービスのためのデータモデル問い合わせ  ケース（ Case ） FAQ 情報  ソリューション（ Solution ）

標準データモデルの関連図（抜粋） Owner CreatedBy LastModifiedBy Who/What Tasks/Events/ OpenActivities/ActivityHistories Account Opportunities Contacts Account ※ 詳細は Appendix を参照取引先責任者 Contact 取引先 Account 商談 Opportunity ユーザ User ToDo Task 行動 Event

データベース・スキーマの拡張アプリケーション開発者が独自に必要なデータモデルを追加構築可能独自の「テーブル（表）」を追加できる既存のテーブルに新しい「カラム（列）」を追加できるテーブル間に任意の「リレーション（関連）」を定義できる従業員部署部署従業員部下上司所在地コストセンター従業員番号入社日年俸

用語の整理 RDB における「テーブル（表）」  Salesforce では　「オブジェクト」 RDB における「カラム（列）」  Salesforce では　「項目（フィールド）」標準で定義されているテーブル（ Account, Contact など）  「標準オブジェクト」アプリケーション開発者が追加で定義したテーブル  「カスタムオブジェクト」

カスタムオブジェクトの定義管理者が Salesforce にログインし、ブラウザ上で定義する設定  開発  カスタムオブジェクト  新規カスタムオブジェクト

オブジェクト ID レコードには常に一意のオブジェクト ID が付与される RDB における主キー（ Primary Key ）に相当 15 桁（ or 18 桁）の英数字詳細画面の URL に表示される実は全 Salesforce 内で一意になる関連（リレーション）は参照するレコードの ID をたどることによって実現

リレーションと親子関係 A が B を参照しているとき B は A の「親」であり、 A は B の「子」になっている A と B の関係は多：１標準オブジェクトのリレーションの例「取引先」は「取引先責任者」の親取引先責任者 Contact Contacts Account 親子取引先 Account

Apex API と SOQL Apex API : Salesforce 内のデータベースへのアクセス手段データベースの検索・更新・作成・削除 Web サービス標準に準拠（ SOAP 、 WSDL ）多彩な言語環境から利用可能 Java /.NET / JavaScript / PHP/ Ruby on Rails… SOQL : レコード検索のための問い合わせ言語 SOQL : Sforce Object Query Language Apex API の検索処理におけるメッセージ文として利用される

Apex API のメソッド種類 convertLead, merge, process SFDC 処理 getServerTimestamp, getUserInfo, setPassword, resetPassword ユーティリティ describeGlobal, describeSObject, describeLayout, describeTabs, describeSoftphoneLayout 定義情報 getUpdated, getDeleted 同期 create, update, delete, upsert, undelete データ処理 query, queryMore, retrieve, search, queryAll 検索 login ログインメソッド名メソッド種類

SOQL SQL に似たクエリ記述文テーブルをまたいだ検索 (SOQL-Relationship) SELECT Account.Id, Account.Name, (SELECT Contact.FirstName, Contact.LastName FROM Account.Contacts) FROM Account SELECT Id, Name FROM Account WHERE BillingState = ' 東京都 ' LIMIT 10 SELECT Contact.Id, Contact.FirstName, Contact.LastName, Account.Id, Account.Name FROM Contact

リレーションシップ・クエリ複数テーブルをまたがる問い合わせ（ SQL の JOIN に相当）親子のリレーションをたどってレコードを検索親：最大 5 階層、子：最大１階層 Owner Account Events 親１階層親２階層子１階層 SELECT Id, Name, Account.Id, Account.Name, Account.Owner.Id, Account.Owner.Name, (SELECT Id, Subject FROM Events) FROM Opportunity 商談 Opportunity 行動 Event 取引先 Account ユーザ User

条件（ WHERE 句）による絞込みサポートしている比較演算子 =, !=, <, <=, >, >=, LIKE, IN, NOT IN, INCLUDES, EXCLUDES 親レコードの項目でも条件指定が可能例：所有者名が「鈴木」である商談のみ表示子リレーションのレコードセットの絞込みも可能 SELECT Name FROM Opportunity WHERE Owner.Name = ‘ 鈴木’ SELECT Name, (SELECT FirstName FROM Contacts WHERE CreatedDate = THIS_MONTH) FROM Account

Count() 関数、 ORDER BY 、 LIMIT 句件数のみを取得したい場合、 count() 関数を利用 ORDER BY でレコードを整列、 LIMIT でレコード数上限指定 ORDER BY, LIMIT は子リレーションにも適用可能 SELECT count() FROM Opportunity WHERE CloseDate = THIS_MONTH AND Amount >= 1000000 SELECT Name, Amount, StageName FROM Opportunity ORDER BY CloseDate DESC LIMIT 5 SELECT Name, Amount, StageName, (SELECT CreatedDate FROM OpportunityHistories ORDER BY CreatedDate DESC LIMIT 5) FROM Opportunity

カスタムオブジェクトと Apex API 標準オブジェクト、項目の場合 API 参照名 = オブジェクト（項目）名カスタムオブジェクト、項目の場合 API 参照名 = オブジェクト（項目）名 +’__c’ ( アンダースコア 2 つ ) リレーションの API 参照名 = リレーション名 +’__r’ SELECT 　 Id, Name, Hiredate__c, Salary__c, 　　　　　　 Department__r.Id, Department__r.Name FROM Employee__c

標準項目カスタムオブジェクト定義時に自動的に作成される標準項目 CreatedById （項目名）、 CreatedBy （リレーション名）作成者　 LastModifiedById （項目名）、 LastModifiedBy （リレーション名）最終更新者 LastModifiedDate 最終更新日 OwnerId （項目名 ) 、 Owner （リレーション名）所有者 CreatedDate 作成日　 Name オブジェクト名 Id オブジェクト ID 項目名表示ラベル

カスタムオブジェクトでの問い合わせの例部署 Department__c Department__r Employees__r Manager__r Workers__r SELECT Name, Hiredate__c FROM Employee__c WHERE Department__r.Name = ‘ 営業部’ SELECT Name, Salary__c FROM Employee__c WHERE Manager__c = ‘ a0270000003lVks ’ SELECT Name, Location__c, (SELECT Name FROM Employees__r) FROM Department__c WHERE Name = ‘ 営業部’ 従業員 Employee__c

レコードの共有設定とアクセスコントロール通常カスタムオブジェクトを作成したときは、組織内の全ユーザがレコードを参照・更新可能になっている誰でもレコードの上書き更新ができてしまう状態オブジェクトのデフォルトの共有設定を「非公開」に設定できるレコードを所有している本人（およびスーパバイザ）しか参照も更新もできないようになるアクセスさせたいレコード情報に対してのみ個別で共有を許可させる＜注意＞個別にアクセス制御を「厳しく」することはできません！！

デフォルトの共有設定の変更 (1) (2) (3)

Apex API を利用したレコード個別の共有設定オブジェクトの共有設定を「非公開」あるいは「公開／参照のみ」とすると、データベース内に「 ( オブジェクト名 )__Share 」というオブジェクトが自動的に追加されるこのオブジェクトにアクセスコントロール設定を追加していく例：ユーザ ID ‘ 005700000011raw ’ に対してレコード ID ’ a0370000004clVH ’ に対する参照権限を与える var aci = new sforce.SObject(' Employee __Share'); aci.ParentId = 'a0370000004clVH'; // 対象となるレコードの ID aci.UserOrGroupId = '005700000011raw'; 　 // 権限を与えるユーザの ID aci.AccessLevel 　 = 'Read'; // 読み取り権限のみ sforce.connection.create([aci]);

項目の更新履歴カスタムオブジェクトの作成時に「項目履歴管理」をチェックしておくと、レコードの更新が記録されるデータベース内に「 ( オブジェクト名 )__History 」というオブジェクトが自動的に追加される例）ある従業員の給与の変更履歴を調べる SELECT CreatedDate, Field, OldValue, NewValue FROM Employee__History WHERE ParentId = 'a0370000004clVH' // 従業員のレコード ID AND Field = 'Salary__c'

S コントロールと AJAX Toolkit

S コントロールユーザインターフェースを記述する HTML コンポーネント HTML+JavaScript で画面を記述例： Google Maps 上に取引先データの住所位置をマッピングして表示

AJAX Toolkit S コントロールから Apex API にアクセスするための JavaScript で書かれたツールキット利用には S コントロール内に指定の JavaScript ライブラリを読み込む記述を追加するだけ <html> <head> <script type="text/javascript" src= "/soap/ajax/9.0/connection.js" ></script> 　　 </head> …

S コントロール + AJAX Toolkit のアーキテクチャ４． AJAX による API リクエストの送信 AJAX Toolkit S コントロール Apex API Salesforce データベース１． S コントロール内の HTML+JavaScript をダウンロード Web ブラウザユーザ２．スクリプトの実行＆描画処理５．検索、更新などの DB 処理３．ユーザ操作などのイベント６．画面の再描画標準オブジェクト　＆カスタムオブジェクト

例）　 Hello World <html> <head> <script type="text/javascript" src="/soap/ajax/9.0/connection.js"></script> <script type="text/javascript"> window.onload = function() { document.body.innerHTML = '<H1>Hello, ' + sforce.connection.getUserInfo() .userFullName + '</H1>'; } </script> </head> <body></body> </html>

例）　取引先を検索、テーブルで一覧表示 <html> <head> <script type="text/javascript" src="/soap/ajax/9.0/connection.js"></script> <script type="text/javascript"> function queryAccount() { var searchStr = document.getElementById('searchStr').value; var accounts = sforce.connection.query( "SELECT Id, Name FROM Account WHERE Name LIKE '%"+searchStr+"%'" ) .getArray('records'); var html = '<table border="1">'; for (var i=0; i<accounts.length; i++) { html += '<tr><td>'+accounts[i].Id+'</td>'+ ' <td>'+accounts[i].Name+'</td>'+ '</tr>'; } html += '</table>'; document.getElementById('output').innerHTML = html; } </script> </head> <body> <input type="text" id="searchStr"> <input type="button" value=" 検索 " onclick="queryAccount()"> <div id="output"></div> </body> </html>

Google Maps とのマッシュアップ地図情報に取引先情報を重ね表示する S コントロールチュートリアル Apex Developer Network ブログからアクセス http://adnblog.salesforce.co.jp/2007/04/post_b5a4.html

コーディングにおける TIPS

同期リクエストと非同期リクエスト AJAX Toolkit の API 呼び出しでは、同期および非同期リクエストの選択が可能同期  サーバから値が返却されるまで処理がストップする非同期  サーバから返却された値を指定したコールバック関数が受け取る同期非同期 var result = sforce.connection.query("SELECT Id, Name FROM Account"); sforce.connection.query( "SELECT Id, Name FROM Account", { onSuccess : handleResult, onFailure : handleError } );

どちらが望ましい？同期レスポンス待ちの間、ユーザの操作をブロックさせないためには、実アプリケーションではできるだけ非同期リクエストがよい同期リクエストの利用は API テスト時、あるいは時間のかからない単純な操作のみに限定する

オープンソース AJAX ライブラリの利用 AJAX の画面描画記述は煩雑になりがち  　既存の JavaScript UI ライブラリを利用して、アプリケーションのコードが複雑になるのを回避する Salesforce は AJAX 用ライブラリとして Dojo Toolkit ( http://dojotoolkit.org ) を公式にホスティングしている S コントロールに Dojo Toolkit を読み込む方法 <html> <head> <script type="text/javascript" src= "/js/dojo/0.4.1/dojo.js" ></script> 　　 </head> …

Dojo Toolkit の利用例 SWOT 分析表（ AppExchange 公開済）シンプル掲示板

S コントロールからの画像ファイルの利用画像をドキュメントファイルとしてアップロードドキュメントの参照 URL をコピーして HTML に貼り付け例 JavaScript ファイル、 CSS ファイルなども同様 AppExchange にアップロードする時には、忘れずにパッケージ内容に参照しているドキュメントを含める <img src="/servlet/servlet.FileDownload?file=0157000000084Un" >

S コントロールを含む画面遷移標準画面  カスタム S コントロールカスタムボタン、カスタムリンクなどを利用「差し込み項目」を利用してパラメータの受け取りが可能カスタム S コントロール  カスタム S コントロール LINKTO, URLFOR 関数の利用カスタム S コントロール  標準画面 LINKTO, URLFOR 関数の利用 describeSObject 関数で遷移先の URL テンプレートを取得 urlDetail / urlEdit / urlNew レコードの詳細画面なら、「” /”+{ オブジェクト ID} 」へ URL リダイレクト環境によっては URL を変更している可能性があり、注意が必要

差し込み項目でパラメータ受け取り {!Account.Id} 株式会社四川商会差し込み項目標準のレコード詳細画面カスタムボタン / カスタムリンクカスタム S コントロール展開された値 {!Account.Name} 0017000000Kh6OS

URLFOR 関数による画面遷移 S コントロールの差し込み項目内で URLFOR 関数を用いて、遷移先の URL を取得例） HelloWorld カスタム S コントロールの URL を取得して画面を遷移例）取引先の標準のレコードの編集画面に遷移難点： API で取得した値を埋め込めないため、使えるシーンが限られる  どうしても URL を直に生成する実装になってしまう  あまり遷移を必要としないアプリケーション設計に… location.href = '{!URLFOR($SControl.HelloWorld)}' parent.location.href = 　　　　 '{!URLFOR($Action.Account.Edit, Account.Id)}'

Apex アプリケーション開発について Salesforce ネイティブ環境のみでも、複雑なアプリケーション構築が可能 S コントロールと Apex API の組み合わせ運用開始後のスケーラビリティは一目を置くべき JavaScript による開発  リッチなユーザインターフェース既存の Web アプリケーション開発より若干難易度が高い UI ライブラリを活用して開発負荷を軽減その他にも Flex などの選択肢オンデマンド連携のアプリケーション外部サービスとして連携することの必然性とその付加価値サービスレベルを均一にする努力

Apex Platform Development Partner Program Apex プラットフォーム上でのアプリケーション開発能力のあるパートナーを認定する制度要件 AppExchange アプリケーションを 1 つ以上公開指定数以上の認定コンサルタント（ Apex ）メリットアプリケーションのアイディアを共有します個別案件などの獲得につながります詳細はお問い合わせください

Appendix ： AJAX Tools Apex API をオンライン上でテスト可能な開発者向けアプリケーション S コントロールの編集、 SOQL の実行、シェルによる対話的な API 実行 AppExchange サイトから組織ごとにインストールして使用する AppExchange サイトから、「 AJAX Tools 」で検索　注）　一部機能は IE で動かない場合あり、 Firefox を推奨 AJAX Tools は S コントロールと AJAX Toolkit を使って作られたネイティブアプリ名前が似ていて混乱しやすいので注意

Appendix : 開発用サンプルデータセット API や SOQL を試そうとしても… そもそもデータベースにレコードが入っていないとあまり意味がないデモや開発テストの際に必要になるダミーのデータを Salesforce にロードするためのアプリケーション AppExchange サイトからインストール可能パッケージに含まれるデータ：　取引先、取引先責任者、商談、リード、ケース、行動、 ToDo など約 700 件インストール後、ボタンクリックひとつで自動的にレコードがデータベースに登録される

Appendix ：　「ユーザ (User) 」 Salesforce 組織にアクセスするユーザの情報を管理ユーザ名とパスワードが付与され、 Salesforce にログインが可能営業支援の用途の場合　  　「ユーザ」＝自社の営業マン初期サインアップ時は管理ユーザの情報のみ登録されている管理者がユーザを必要に応じて追加するほぼすべてのオブジェクトに対して、レコードの「作成者」「所有者」「最終更新者」という形で関連付けられるユーザ User

Appendix ：　「取引先 (Account) 」顧客企業／事業者の情報を管理取引先名、電話番号、住所（請求先／発送先）、従業員数などの企業情報を格納 SOQL の例 SELECT Id, Name, Phone, NumberOfEmployees, BillingState, BillingCity, BillingStreet FROM Account 取引先 Account

Appendix ：　「取引先責任者 (Contact) 」取引先に所属している個人の情報を管理氏名、役職、電話番号、 E メールなどの個人情報を格納所属している取引先の情報が親として関連付けられる SOQL の例 SELECT LastName, FirstName, Email, Account.Name, Account.Phone FROM Contact 取引先責任者 Contact

Appendix ：　「商談 (Opportunity) 」現在進行中の（あるいは完了した）案件情報を管理現在のフェーズや商談全体の金額などの情報を格納商談に関連している取引先が参照関係で指定できる SOQL の例 SELECT Id, Name, StageName, Amount, Account.Name, Account.Phone FROM Opportunity 商談 Opportunity

Appendix ：　「 ToDo (Task) 」および「行動 (Event) 」行動 (Event) カレンダー上のスケジュール情報 ToDo(Task) 今後遂行すべき業務内容 (ToDo) の情報すでに終了した活動の履歴情報（訪問結果、メール送信など） 2 つまとめて「活動 (Activity) 」情報として取り扱われる「活動の記録」をサポートするすべてのオブジェクトに関連付けが可能 ToDo Task 行動 Event

Apexコアデベロッパーセミナー070726 配布用

More Related Content

What's hot (8)

Similar to Apexコアデベロッパーセミナー070726 配布用 (20)

Recently uploaded (12)

Apexコアデベロッパーセミナー070726 配布用