ISVforce ガイド
jキャンバスアプリケーションとしての接続アプリケーションの公開
接続アプリケーションをキャンバスアプリケーションとして公開できます。キャンバスアプリケーションは、組織の Salesforce システム管理者がインストールするアプリケーションとして使用できるほか、さまざまな組織のユーザがインストールする個人用アプリケーションとしても使用できます。ユーザが [Chatter] タブからキャンバス個人用アプリケーションにアクセスすると、そのアプリケーションが Salesforce データに接続できるように促されます。ユーザはアプリケーションをキャンバス個人用アプリケーションにするように選択できます。
| 使用可能なインターフェース: Salesforce Classic (使用できない組織もあります) および Lightning Experience の両方 |
| 接続アプリケーションを作成可能なエディション: Group Edition、Professional Edition、Enterprise Edition、Essentials Edition、Performance Edition、Unlimited Edition、および Developer Edition 接続アプリケーションをインストール可能なエディション: すべてのエディション |
| 必要なユーザ権限 | |
|---|---|
| 接続アプリケーションを参照、作成、更新または削除する | 「アプリケーションのカスタマイズ」および 「すべてのデータの編集」または「接続アプリケーションの管理」のいずれか |
| プロファイル、権限セット、およびサービスプロバイダの SAML 属性以外のすべての項目を更新する | 「アプリケーションのカスタマイズ」および 「すべてのデータの編集」または「接続アプリケーションの管理」のいずれか |
| プロファイル、権限セット、およびサービスプロバイダの SAML 属性を更新する | 「アプリケーションのカスタマイズ」および「すべてのデータの編集」および「プロファイルと権限セットの管理」 |
| 接続アプリケーションをインストールおよびアンインストールする | 「アプリケーションのカスタマイズ」および 「すべてのデータの編集」または「接続アプリケーションの管理」のいずれか |
| パッケージ化された接続アプリケーションをインストールおよびアンインストールする | 「アプリケーションのカスタマイズ」および 「すべてのデータの編集」または「接続アプリケーションの管理」のいずれか および「AppExchange パッケージのダウンロード」 |
キャンバスアプリケーションについての詳細は、『Canvas 開発者ガイド』を参照してください。
- 接続アプリケーションを作成し、その基本情報を完了します。
- [キャンバスアプリケーション設定] セクションで [キャンバス] を選択し、接続アプリケーションをキャンバスアプリケーションとして公開します。
- サードパーティアプリケーションへのキャンバスアプリケーション URL を入力します。キャンバスアプリケーションへのリンクをクリックすると、ユーザはこの URL に転送されます。
-
アクセス方法を選択し、キャンバスアプリケーションで OAuth 認証フローを開始する方法を指定します。
- 署名付き要求 (POST) — OAuth 認証を使用しますが、Salesforce システム管理者がキャンバスアプリケーションをインストールする場合、キャンバスアプリケーションはユーザのアクセスを暗黙的に許可します。ユーザは、アプリケーションがユーザ情報にアクセスすることを許可するように促されません。このアクセス方法を使用する場合、認証はキャンバスアプリケーションの URL に直接 post 送信されます。
キャンバスアプリケーションで署名付き要求認証を使用する場合は、[選択した OAuth 範囲] に [ユーザに代わっていつでも要求を実行] を選択しないでください。
- OAuth Webflow (GET) — OAuth 認証が使用され、ユーザはユーザ情報へのアプリケーションのアクセスを許可するように促されます。このアクセス方法を使用する場合、キャンバスアプリケーションで OAuth 認証フローが開始されるようにする必要があります。
- 署名付き要求 (POST) — OAuth 認証を使用しますが、Salesforce システム管理者がキャンバスアプリケーションをインストールする場合、キャンバスアプリケーションはユーザのアクセスを暗黙的に許可します。ユーザは、アプリケーションがユーザ情報にアクセスすることを許可するように促されません。このアクセス方法を使用する場合、認証はキャンバスアプリケーションの URL に直接 post 送信されます。
-
キャンバスアプリケーションの認証に SAML シングルサインオン (SSO) を使用している場合、[SAML の開始方法] 項目を選択します。この項目では、次のいずれかのオプションを選択できます。
- ID プロバイダによる開始 — Salesforce が SSO フローを開始する最初の要求を行います。
- サービスプロバイダによる開始 — キャンバスアプリケーションは呼び出された後に SSO フローを開始します。
-
[場所] で、ユーザにキャンバスアプリケーションを表示する場所を選択します。
- Chatter フィード — キャンバスアプリケーションをフィードに表示します。このオプションを選択すると、CanvasPost フィード項目を作成して現在のユーザがキャンバスアプリケーションにアクセスできるようにします。
- Chatter タブ — キャンバスアプリケーションを Chatter タブのアプリケーションナビゲーションリストに自動的に表示します。
- コンソール — キャンバスアプリケーションを Salesforce コンソールのフッターまたはサイドバーに表示します。このオプションを選択した場合、キャンバスアプリケーションをカスタムコンソールコンポーネントとして追加して、コンソールのどこにキャンバスアプリケーションを表示するのかを選択する必要があります。
- レイアウトおよびモバイルカード — キャンバスアプリケーションをページレイアウトまたはモバイルカードに表示できます。このオプションを選択した場合、キャンバスアプリケーションをページレイアウトに追加して、表示する場所を選択します。
- モバイルナビゲーション — キャンバスアプリケーションを Salesforce アプリケーションのナビゲーションメニューからアクセス可能にします。
- Open CTI — キャンバスアプリケーションを通話制御ツールに表示します。このオプションを選択した場合、キャンバスアプリケーションを表示するにはコールセンターの定義ファイルにキャンバスアプリケーションを指定します。
- パブリッシャー — キャンバスアプリケーションをパブリッシャーに表示します。このオプションを選択した場合、キャンバスカスタムクイックアクションを作成して、グローバルレイアウトまたはオブジェクトレイアウトに追加します。
- Visualforce ページ — キャンバスアプリケーションを Visualforce ページに表示できます。Visualforce ページにキャンバスアプリケーションを公開するために <apex:canvasApp> コンポーネントを追加する場合は、キャンバスアプリケーションの表示場所にこの場所を必ず選択してください。これ以外の場所を選択するとエラーになります。
-
キャンバスアプリケーションのグローバルアクションを作成するには、[アクションの自動作成] を選択します。[場所] で [パブリッシャー] を選択します。
このオプションを使用しない場合、グローバルアクションは作成されません。アクションは後で作成することもできます。
-
独自の Canvas.CanvasLifecycleHandler Apex クラスを実装する場合、[ライフサイクルクラス] にクラス名を入力します。
Canvas.CanvasLifecycleHandler Apex クラスを指定すると、コンテキスト情報をカスタマイズし、キャンバスアプリケーションにカスタム動作を追加できます。
-
アプリケーションをユーザがインストールできるようにするには、[キャンバス個人用アプリケーションとして有効化] を選択します。Chatter タブは、キャンバス個人用アプリケーションをサポートしている唯一の場所です。
- 接続アプリケーションのすべての設定が完了したら、[保存] をクリックします。