getpaid.SalesforcePloneFormGenAdapter 1.7

PloneFormGen GetPaid Salesforce 适配器

# # 一旦确定了最终主页，本节需要更新 #

产品主页为 http://plone.org/products/salesforcepfgadapter。文档区域和问题跟踪器可在以下链接位置找到：文档区域 和 问题跟踪器。

存在一个名为 Plone Salesforce Integration 的 Google Group，其唯一目的是讨论和开发使 Plone 与 Salesforce.com 良好集成的工具。如果您有问题，加入此组并向邮件列表发帖可能是获得支持的最佳方式。

如果不行，请尝试使用 Plone 用户邮件列表或 #plone irc 频道来请求支持。如果您在那里无法得到问题的答案，或者有兴趣帮助开发此产品，请参阅下面的致谢部分，了解您可能要联系的个人。

概述

此产品建立在由 PloneFormGen 提供的通过网页表单创建基础之上，以及 Salesforce Base Connector 和 Salesforce PloneFormGen 适配器提供的 Salesforce 连接之上。如果您不熟悉 PloneFormGen 的功能和它打算服务的领域问题，我们鼓励您先下载它，并阅读产品根目录中的 README.txt 文件。特别是，“概述”和“此产品的原因”部分是推荐的。

如果您不熟悉 Salesforce，请参阅 salesfoce.com。有关 Salesforce 基础连接器和 Salesforce PloneFormGen 适配器的更多信息，请参阅 http://plone.org/products/salesforcebaseconnector/releases/1.0.1 和 http://plone.org/products/salesforcepfgadapter。

一旦您设置了一个合适的 PloneFormGen 表单文件夹（并且正确安装和配置了 PloneFormGen GetPaid Salesforce 适配器及其依赖项），您将可以选择添加一个名为“GetPaid Salesforce 适配器”的新动作适配器。

一旦您在表单中添加了 GetPaid Salesforce 适配器，您将看到用于编辑适配器的“默认”和“字段映射”（除标准“覆盖”外）管理屏幕。默认屏幕由一个下拉菜单组成，其中包含所有在 Salesforce.com 实例中找到的 sObject 类型（即 Salesforce 对象），这些对象对应于在 ZMI 中创建 Salesforce Base Connector 时输入的凭据。这应包括标准对象和自定义 sObjects。

一旦您选择了 sObject 类型，转到“字段映射”管理屏幕将显示两组两列表单。每组用于设置来自您的表单或由 GetPaid 提供的数据的 Salesforce 字段。每个字段都由一行表示，左列为字段名称，右列为所有可用的 Salesforce 字段的选择下拉菜单。为每个字段选择所需的 Salesforce 字段并点击“保存”。

# 添加关于按行项目创建对象的章节

# 可能需要解释行项目成本和总成本之间的区别

注意：虽然不需要将每个表单字段映射到 Salesforce 字段，但您需要确保在 Salesforce 配置中定义为必填字段的 sObject 字段都应有映射。否则，在表单提交时，sObject 将无法成功创建。您选择的 sObject 的所有必填字段应相应标记并出现在选项列表的顶部。

如果您在任何时候提供了映射后返回并切换到不同的sObject类型，您将需要重新创建您想要的映射。这是预期行为，因为如果保持之前选择的sObject类型的映射，则更新将失败（或者更糟，会产生非常令人困惑的结果）。

此产品的理由

利用PloneFormGen提供的出色基础（以及PloneGetPaid和Plone本身），创建一个收集和验证一些所需信息并将其与第三方支付处理器集成以收集与信息相关的资金的表单，不再是一项需要开发者干预的任务。现在，任何熟悉Plone用户界面的内容编辑都可以完成这项工作。然而，将数据保留在CMS或通过电子邮件发送仅限于有限用途。

Salesforce.com提供了一种可扩展、功能强大的平台，可以用于执行各种客户关系管理（CRM）任务，包括销售、营销、非营利组织成员组织和客户服务。Salesforce PFG适配器象征着最佳CMS和CRM的实用结合，以便每个都可以专注于其自身的优势，并且易于非开发人员使用。

Salesforce.com提供了名为“Web-to-Lead”的功能，但除了PloneFormGen的许多优势超过Web-to-Lead表单构建器之外，此软件还提供以下附加功能：

• 可配置的单个表单字段验证

• 能够从单个表单结果中创建尽可能多的不同记录

• 能够使用表单创建自定义sObject记录

• 能够创建任何类型的sObject记录，而Web-to-Lead只能创建潜在客户记录，这些记录只能转换为联系人、帐户或机会记录。想直接从表单创建活动记录？那当然可以。

依赖项

依赖于beatbox库 >= 0.9.1.1，这是一个Salesforce.com API（版本7.0）的Python包装器。您必须有一个提供API访问权限的Salesforce.com帐户。

要下载和安装beatbox，请访问

http://code.google.com/p/salesforce-beatbox/

请参阅PloneFormGen 1.2.x+的依赖项。作为先决条件，以下所有条件都必须满足，才能使用PloneFormGen GetPaid Salesforce适配器。

SalesforcePFGAdapter请参阅http://plone.org/products/salesforcepfgadapter

SalesforceBaseConnector >= 1.0a3。请参阅http://plone.org/products/salesforcebaseconnector

DataGridField >= 1.6.x。早期版本没有正确禁用DataGridField的添加行功能，这在我们的情况下非常重要，因为用户不能在Salesforce适配器内部添加新的可能的表单字段进行映射。这些需要添加到表单本身。

安装

# # 待更新部分 #

典型的Zope/Plone产品

• 安装和配置依赖项（包括beatbox设置和在Plone站点根目录中创建带有凭证的Salesforce Base Connector。）

• 将产品包解压缩到Zope/Plone实例的Products文件夹中。检查您的所有权和权限。

• 重启Zope。

• 转到Plone界面中的站点设置页面，然后单击添加/删除产品链接。选择salesforcepfgadapter（勾选其复选框）并单击安装按钮。如果尚未完成，这将安装PloneFormGen以及salesforcepfgadapter。如果PloneFormGen不在添加/删除产品列表中，通常意味着产品由于缺少先决条件而没有加载。

权限

请参阅README.txt中的权限部分。

安全

请参阅README.txt中的安全部分。

已知问题

致谢

• Rob LaRubbio <rob –AT– onenw –DOT– org>

西雅图和波特兰的Plone & Salesforce团队，他们为Salesforce PFG适配器做出了贡献

• Jon Baldivieso <jonb –AT– onenw –DOT– org>

• Andrew Burkhalter <andrewb –AT– onenw –DOT– org>

• Brian Gershon <briang –AT– webcollective –DOT– coop>

• David Glick <davidglick –AT– onenw –DOT– org>

• Jesse Snyder <jesses –AT– npowerseattle –DOT– org>

特别嘉宾 PloneFormGen

• Steve McMahon <steve@dcn.org>

Jesse Snyder 和 NPower Seattle 为 Salesforce Base Connector 代码的建立奠定了基础

Simon Fell 为提供 Salesforce.com API 的 beatbox Python 包装器

Salesforce.com Foundation 和 Enfold Systems 为他们的礼物和对 beatbox 的工作（见：http://gokubi.com/archives/onenorthwest-gets-grant-from-salesforcecom-to-integrate-with-plone）

有关帮助特定功能或错误的人的日益增长的名单，请参阅 CHANGES.txt 文件。

许可协议

根据 GPL 分发。

有关详细信息，请参阅 LICENSE.txt 和 LICENSE.GPL。