Force.com Canvas Developer's Guide

Getting Started
Introducing Force.com Canvas
Quick Start
Quick Start—Advanced
Prerequisites
Clone the Project from GitHub
Run the Web App Locally
Create the Canvas App
Configure Who Can Access the Canvas App
Deploy the Web App to Heroku
Update the Canvas App
Package the Canvas App
Upload the Canvas App Package
Install the Canvas App
Configure Who Can Access the Installed Canvas App
Using Force.com Canvas
Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Update the Canvas App

In this step, you’ll update the canvas app to run the “hello world” app that’s now running on Heroku.

  1. In Salesforce, from Setup, click Create | Apps.
  2. In the Connected Apps related list, click Hello World.
  3. Click Edit.
  4. In the Logo Image URL field, enter https://appName.herokuapp.com/images/salesforce.png. This is the default Salesforce “No Software” image. This image appears on the installation screen and on the detail screen for the app. The appName is the name of Heroku app that you just created.
  5. In the Icon URL field, enter https://appName.herokuapp.com/examples/hello-world/logo.png. This is the default Salesforce “No Software” image.

    This is the image that appears next to the app name on the Chatter tab or in the Canvas App Previewer. If you leave this field blank, a default cloud image appears next to the app name. The appName is the name of Heroku app that you just created.

  6. In the Callback URL field, enter https://appName.herokuapp.com/sdk/callback.html. The appName is the name of Heroku app that you just created.
  7. In the Canvas App URL field, enter https://appName.herokuapp.com/examples/hello-world/index.jsp. The appName is the name of Heroku app that you just created.
  8. Click Save. After the canvas app is saved, the detail page appears.
  9. In Salesforce, from Setup, click Canvas App Previewer. You can use the Canvas App Previewer to test out your canvas app before repackaging it.
  10. Click the Hello World link on the left.

    The app should appear and you’ll see the message Hello User.FullName. The canvas app works in this context because when you click the app name in the previewer, the signed request is sent to the endpoint https://appName.herokuapp.com/examples/hello-world/index.jsp.

In this example, we’re using the same canvas app that we just created, but updating it to point to the “hello world” Web app running on Heroku. Therefore, the consumer secret that we previously added to our “hello world” app doesn’t need to be updated.

If you want to create a new canvas app in Salesforce that displays the “hello world” app running on Heroku, then go to Create the Canvas App to create the new app, update the consumer secret in the app, and then deploy the changes to Heroku.