画布开发（2）快速入门

学习目标

完成本单元后，您将能够了解到：

• 先决条件
  
• 创建应用程序
  
• 设置应用程序位置

这个简单的快速入门向您展示了如何使用Heroku快速入门开始使用Canvas。 Heroku Quick Start在Heroku上用Java或Ruby创建一个“hello world”应用程序，具体取决于您选择的模板。 同时，它在Salesforce中创建相应的画布应用程序。

Heroku应用程序是一个“hello world”网页，它调用Canvas SDK来显示有关当前用户的信息，并允许您发布到当前用户的Chatter提要。

先决条件

您需要适当的访问和工具来完成快速启动步骤。

• 访问Developer Edition组织。
  如果您还不是Lightning Platform开发人员社区的成员，请访问developer.salesforce.com/signup并按照注册Developer Edition组织的说明进行操作。即使您已经拥有Enterprise Edition，Unlimited Edition或Performance Edition，也可以使用Developer Edition根据示例数据开发，暂存和测试您的解决方案，以保护您组织的实时数据。对于插入，更新或删除数据的应用程序（与简单地读取数据相反）尤其如此。
  如果您有现有的Developer Edition组织，并且从安装程序中看不到菜单项Canvas App Previewer，请联系Salesforce。
  
• “自定义应用程序”和“修改所有数据”用户权限。如果您是管理员，则很可能已拥有这些权限。否则，您需要添加它们，以便您可以看到Canvas应用程序预览器并创建画布应用程序。
  
• Heroku帐户。转到此处创建一个Heroku帐户：https：//api.heroku.com/signup。
  
• Java版本1.6或1.7以运行您创建的“hello world”应用程序的本地实例。 （该应用程序的Heroku实例自动下载正确版本的Java。）

创建应用程序

在此步骤中，您将在Salesforce组织中创建Heroku“hello world”应用程序和关联的画布应用程序。

1. 在Salesforce中，从“设置”中，在“快速查找”框中输入Canvas App Previewer，然后选择“Canvas App Previewer”。
   
2. 单击Heroku Quick Start。
   
3. 在“模板”字段中，选择“ Java – Quick Start Template ”。
   
4. 在Canvas App Name字段中，输入最多30个字符的唯一名称。
   
5. 在Heroku App Name（Heroku应用程序名称）字段中，输入最多30个字符的唯一名称，该字符以字母开头，仅包含小写字母，数字和短划线。所有Heroku应用程序中的newappName必须是唯一的。此名称将成为应用程序URL的一部分，例如newappName.herokuapp.com。
   
6. 在“身份验证类型”字段中，选择OAuth或API密钥。如果您已登录Heroku，Heroku OAuth会启动Heroku OAuth流程或使用Heroku令牌。在Heroku我的帐户页面上找到与您的帐户关联的API密钥。
   
7. 单击“Create”。该应用程序显示在左侧导航窗格中。
   如果您看到错误“错误[读取超时]执行POST到Heroku克隆REST服务，”这意味着操作已经超时尝试联系Heroku。您可以在http://status.heroku.com上查看Heroku的状态。
   注意：如果您启用了双因素身份验证并选择了OAuth，请先输入您的Heroku用户名和密码，然后输入您的双因素身份验证信息。关闭OAuth提示并再次单击“Create”，应用程序现在将显示在导航窗格中。
   
8. 单击左侧新应用程序的链接。
   该应用程序出现，您将看到消息Hello User.FullName，以及有关当前用户的其他信息。

你刚刚创建了一个画布应用程序祝贺！您只能在Canvas应用程序预览器中看到您的画布应用程序，直到您按照设置应用程序位置中的步骤设置它可以显示的位置。这定义了用户在组织中安装应用后的位置。

在幕后，Heroku快速入门设置了画布应用程序的允许用户，其中包括管理员批准的用户和您的个人资料。例如，如果您的用户配置文件是系统管理员，则该配置文件将添加到您刚刚创建的画布应用程序中，并且具有该配置文件的任何用户都可以访问画布应用程序。

我们建议您检查代码以查看画布应用程序的工作方式。该应用程序的源代码可以在Java app和Ruby app的公共GitHub存储库中找到。使用这些应用中的示例代码，了解如何在应用中解码和验证画布签名请求。

Set the App Location

在此步骤中，您将指定画布应用程序在Salesforce中向用户显示的位置。

1. 在Salesforce应用程序中，从“设置”中，在“快速查找”框中搜索应用程序，然后在Lightforce Experience中选择应用程序管理器或在Salesforce Classic中选择已连接的应用程序。
   
2. 在相关列表中，单击刚刚创建的应用程序的下拉箭头，然后单击“编辑”。
   
3. 在“Canvas应用程序设置”部分的“位置”字段中，选择画布应用程序向用户显示的位置。在本演练中，选择Chatter选项卡。
   • Chatter Feed-画布应用程序显示在Feed中。如果选择此选项，则必须创建CanvasPost订阅源项并确保当前用户可以访问画布应用程序。
     
   • Chatter选项卡 – 画布应用程序显示在Chatter选项卡上的应用程序导航列表中。如果选择此选项，画布应用程序将自动显示在那里。
     
   • 控制台 – 画布应用程序显示在Salesforce控制台的页脚或侧边栏中。如果选择此选项，则必须通过将画布应用程序添加为自定义控制台组件来选择画布应用程序在控制台中显示的位置。
     
   • 布局和移动卡 – 画布应用程序可以显示在页面布局或移动卡上。如果选择此选项，则可以通过将画布应用程序添加到页面布局来选择画布应用程序的显示位置。
     
   • Mobile Nav-可从导航菜单访问画布应用程序。
     
   • 打开CTI – 画布应用程序出现在呼叫控制工具中。如果选择此选项，则必须在呼叫中心的定义文件中指定画布应用程序才能显示。
     
   • Publisher – 画布应用程序显示在Chatter发布者和操作栏中。如果选择此选项，则还必须创建画布自定义操作并将其添加到全局发布者布局或对象的页面布局。
     
   • Visualforce页面 – 画布应用程序可以显示在Visualforce页面上。如果添加组件以在Visualforce页面上公开画布应用程序，请确保为画布应用程序选择此位置;否则，你会收到一个错误。
4. 单击“保存”。

由于您选择了Chatter选项卡，因此您的画布应用程序现在会显示在Chatter选项卡的左侧导航窗格中。