キャンバスアプリケーションの作成
ここでは、Salesforce 組織でキャンバスアプリケーションを作成する手順を説明します。キャンバスアプリケーションを作成するユーザには、「アプリケーションのカスタマイズ」権限と「すべてのデータの編集」権限が必要です。
- Salesforce で、[設定] から [クイック検索] ボックスに「アプリケーション」と入力し、[アプリケーション] を選択します。
- [接続アプリケーション] 関連リストで、[新規] をクリックします。
- [接続アプリケーション名] 項目で、「Hello World」と入力します。
- Hello_World のデフォルトの [API 名] を受け入れます。これは、キャンバスアプリケーションの内部名であり、保存後に変更することはできません。
- [取引先責任者 メール] 項目で、メールアドレスを入力します。
- [ロゴ画像 URL] 項目で、https://localhost:8443/images/salesforce.png と入力します。これは、Salesforce のデフォルトの「ソフトウェアなし」画像です。この画像は、インストール画面とアプリケーションの詳細画面に表示されます。
-
[アイコン URL] 項目で、https://localhost:8443/examples/hello-world/logo.png と入力します。これは、Salesforce のデフォルトの「ソフトウェアなし」画像です。
これは、ユーザインターフェースでアプリケーション名の横に表示される画像です。この項目を空白のままにすると、デフォルトの雲の画像がアプリケーション名の横に表示されます。
- API ([OAuth 設定の有効化]) セクションで、[OAuth 設定の有効化] 項目を選択します。
- [コールバック URL] 項目で、https://localhost:8443/sdk/callback.html と入力します。
- [選択した OAuth 範囲] 項目で、[基本情報へのアクセス] を選択します。
- [キャンバスアプリケーション設定] セクションで、[キャンバス] を選択します。
- [キャンバスアプリケーションの URL] 項目で、https://localhost:8443/examples/hello-world/index.jsp と入力します。
- [アクセス方法] 項目で、[署名付き要求 (POST)] を選択します。
- [場所] 項目で、Chatter タブを選択します。
- [保存] をクリックします。キャンバスアプリケーションを保存すると、詳細ページが表示されます。
- キャンバスアプリケーションの詳細ページで、[コンシューマの秘密] 項目の横にある [クリックして公開] リンクをクリックします。アプリケーションでは、コンシューマの秘密を使用して認証が行われます。
- コンシューマの秘密の値を選択し、Ctrl+C を押してコピーします。
- コマンドウィンドウに移動し、Ctrl+C を押して Jetty Web サーバを停止します。メッセージに従って、「Y」と入力します。
-
CANVAS_CONSUMER_SECRET という環境変数を作成し、コピーしたコンシューマの秘密にその値を設定します。この操作を Windows で行うには、コマンドウィンドウで set CANVAS_CONSUMER_SECRET=value_you_just_copied と入力します。
Unix/OS X を使用している場合は、コマンド export CANVAS_CONSUMER_SECRET=value_you_just_copied で環境変数を設定します。
次のコードに示すように、「hello world」ページ (c:\SalesforceCanvasFrameworkSDK\src\main\webapp\examples\hello-world\index.jsp) でコンシューマの秘密が使用されます。 - target\bin\webapp.bat コマンド (Windows) または sh target/bin/webapp (Unix/OS X) コマンドを実行して、Web サーバを再起動します。