Post on 28-May-2015
description
キャンバス個人用アプリ 速習ガイド
株式会社セールスフォース・ドットコム
テクニカルエバンジェリスト 中嶋 一樹
Agenda
• キャンバス個人用アプリとは?
• 仕組み
• インストールを体験してみる
• 開発手順
• 参考情報
このガイドではデモアプリをベースにキャンバス個人用アプリのインストールの流れ、および開発方法を解説します。
キャンバス個人用アプリとは?
• Salesforce組織の管理者ではなく、一般ユーザーがキャンバスアプリをインストールできる仕組み。
• インストールしたキャンバス個人用アプリは自分のChatterタブにのみ表示されます。(他のユーザーには表示されません)
• システム管理者は組織単位でユーザーがキャンバス個人用アプリをインストールできるかどうかを設定できます。
仕組み
• キャンバス個人用アプリ本体はForce.com キャンバスと同様の仕組みでiFrameを通じてSalesforce外部から提供されます。
• Salesforce内のデータはAPIを通じてアプリと連携可能です。
Force.com 外部アプリ
iFrameで画面を描画
APIでデータ連携
インストールを体験してみる(1/3)
通常のパッケージインストールとは異なり、OAuthで「認可」をおこなうことでアプリをインストールします。また、インストールをおこなう組織はWinter’15以降でなければなりません。
• キャンバス個人用アプリをインストールする組織にシステム管理者でログインし、管理 > アプリケーションを管理する > 接続アプリケーションに遷移し、アプリケーションアクセス設定で「キャンバス個人用アプリケーションのインストールをユーザーに許可します」にチェックを入れます。
インストールを体験してみる(2/3)
• キャンバス個人用アプリをインストールする組織に一般ユーザー(システム管理者でないユーザー)でログインします。
• 下記のappexchangeリストで「今すぐ入手」をクリックします。https://appexchangejp.salesforce.com/listingDetail?listingId=a0N3000000B5kzaEAB
!• OAuth認証画面が表示されたら「許可」をクリックします。
インストールを体験してみる(3/3)
• 数秒でインストールが完了し、メールで完了通知が届きます。Salesforce組織のChatterタブに移動し、サイドバーにキャンバス個人用アプリがインストールされたことを確認します。
• アンインストールをおこなうには、私の設定 > 個人用 > 高度なユーザーの詳細に移動し、「OAuth接続アプリケーショ
ン」にて該当のキャンバス個人用アプリを取り消します。また、システム管理者は設定 > アプリケーションを管理する > 接続アプリケーションにて該当のキャンバス個人用アプリをアンインストールすることができます。
開発手順(1/2)• 開発組織で接続アプリケーションを作成します。
OAuth設定の有効化 ☑ ️ *必ずチェックが必要コールバックURL https://canvas-personal.herokuapp.com/install.php
デジタル署名を使用
選択したOAuth範囲 データへのアクセスと管理(api)
API(OAuth設定の有効化)
Force.com Canvas ☑ ️ *必ずチェックが必要キャンバスアプリケーションのURL https://canvas-personal.herokuapp.com/index.php
アクセス方法 署名付き要求(POST)
SAMLの開始方法
場所 [Chatter] タブ *必ずChatterタブを選択
ライフサイクルクラス
キャンバス個人用アプリケーションとして有効化 ☑ ️ *必ずチェックが必要
アクションの自動作成
パブリッシャーヘッダーを非表示
パブリッシャー共有ボタンを非表示
キャンバスアプリケーション設定
• 開発組織で管理パッケージを作成し、作成した接続アプリケーションをコンポーネントとして追加します。
• 管理パッケージを「管理 - リリース済み」としてアップロードします。
開発手順(2/2)
• キャンバスアプリ本体を用意します。(index.php)
• キャンバスアプリ本体については本ドキュメントの範疇を超えますので割愛します。詳しくはForce.com Canvas入門ガイド(http://www.slideshare.net/nkjm/forcecom-canvas-26902705)を参照ください。
• インストールページを用意します。(install.php)
• このページは接続アプリケーションのOAuth設定に合わせてOAuthフローを開始するためのものになります。
• ユーザーがOAuthでキャンバスアプリを認可した時点で、Salesforce組織にキャンバス個人用アプリがインストールされます。
• インストールページをユーザーに提示します。(https://canvas-personal.herokuapp.com/install.php)
• 先のデモ環境ではappexchangeリストで「今すぐインストール」ボタンをクリックした後にこのインストールページにリダイレクトされ、すぐさまOAuthフローが開始される仕組みになっています。
キャンバスアプリのソースコード(php)は下記のGithubで公開されています。https://github.com/nkjm/Canvas-Personal-Demo!*config.phpの各設定値は自身が作成した接続アプリケーションに合わせて設定する必要があります。
参考情報• Force.com Canvas入門ガイド
• http://www.slideshare.net/nkjm/forcecom-canvas-26902705
• Winter’15 リリースノート
• http://docs.releasenotes.salesforce.com/en-us/winter15/release-notes/rn_forcecom_canvas_personal_apps.htm
Force.com アプリケーションPaaS
開発者 製品
appexchange ビジネスアプリのマーケットプレイス ユーザー
出品
フィードバック
開発
i appexchange開発者向けに用意された無償トレーニングで開発と公開のノウハウを学べます。
appexchangeであれば全国のお客様にビジネスアプリを販売できますGetting
Started!