beatbox 32.1

简介

这是Simon Fell编写的beatbox模块的distutils包装和更新版本，它是一个Salesforce.com合作伙伴Web服务API的Python客户端实现。

此模块包含Salesforce.com客户端的2个版本

XMLClient

原始beatbox版本的客户端，返回xmltramp对象。

PythonClient

将返回的对象映射到正确的Python数据类型。例如，整数字段返回整数。

兼容性

Beatbox支持Salesforce合作伙伴Web服务API的16.0至32.0版本。然而，以下API调用尚未实现

• emptyRecycleBin

• executeListView

• invalidateSessions

• logout

• merge

• performQuickActions

• process

• queryAll

• undelete

• describeSObject

• sendEmail

• 所有除describeGlobal、describeSObjects和describeTabs之外的所有describe*调用

Beatbox已在Python 2.7上进行测试。

基本使用示例

实例化Python Salesforce.com客户端

>>> svc = beatbox.PythonClient()
>>> svc.login('username', 'passwordTOKEN')

（请注意，通过API与Salesforce.com交互需要使用“安全令牌”，该令牌必须附加到密码。）

查询姓为'Doe'的联系人

>>> res = svc.query("SELECT Id, FirstName, LastName FROM Contact WHERE LastName='Doe'")
>>> res[0]
{'LastName': 'Doe', 'type': 'Contact', 'Id': '0037000000eRf6vAAC', 'FirstName': 'John'}
>>> res[0].Id
'0037000000eRf6vAAC'

添加新的潜在客户

>>> contact = {'type': 'Lead', 'LastName': 'Glick', 'FirstName': 'David', 'Company': 'Individual'}
>>> res = svc.create(contact)

获取新创建的潜在客户的ID

>>> res[0]['id']
'00Q7000000RVyiHEAT'

转换潜在客户

>>> res = svc.convertLead({
...     'leadId': '00Q7000000RVyiHEAT',
...     'convertedStatus': 'Closed - Converted',
... })

获取新联系人的ID

>>> str(res[0]['contactId'])
'0037000000TEGrsAAH'

更多示例

示例文件夹包含原始beatbox的示例。有关如何使用PythonClient的示例，请参阅src/beatbox/tests/test_pythonClient.py。

一些在beatbox之上构建的其他产品也可以提供使用示例

• Salesforce Base Connector

• Salesforce PFG Adapter

• Salesforce Auth Plugin

• RSVP for Salesforce

替代方案

simple-salesforce被推荐作为Salesforce.com REST API的客户端。

David Lanstein创建了一个基于suds SOAP库的Python Salesforce Toolkit。根据有限的测试，它似乎在返回大量数据的操作中比beatbox慢；然而，如果您想自动生成新WSDL（例如企业Web服务API）的服务代理，它可能是一个更好的选择。

Salesforce.com的Ron Hess已将beatbox修改为与Google App Engine一起使用。请参阅http://code.google.com/p/force-app-engine/

运行测试

首先，我们需要在您的Salesforce实例中的联系人对象中添加一些自定义字段

• 登录到您的Salesforce.com实例

• 浏览到设置 –> 定制 –> 联系人 –> 字段 –> “新建”按钮

• 添加一个标记为“最喜欢的水果”的多选下拉列表，然后添加

  • 苹果

  • 橙子

  • 梨

• 保留默认的3行，字段名应默认为“Favorite_Fruit”

• 添加一个标记为“最喜欢的整数”的数字，18位，0位小数

• 添加一个标记为“最喜欢的浮点数”的数字，13位，5位小数

在您的python路径中创建一个sfconfig文件，格式如下

USERNAME='your salesforce username'
PASSWORD='your salesforce passwordTOKEN'

其中TOKEN是您的Salesforce API登录令牌。

将‘./src’添加到您的PYTHONPATH

运行测试

python src/beatbox/tests/test_beatbox.py
python src/beatbox/tests/test_pythonClient.py

变更日志