如何使用simple_salesforce向Salesforce特定商机上传PDF至笔记与文件区

核心逻辑说明 #

Salesforce的「笔记与文件」版块依赖两个核心对象：

• ContentVersion：存储文件的实际内容与元数据
• ContentDocumentLink：建立文件与目标商机的关联关系

完整实现步骤与代码 #

1. 修正商机创建代码（修复语法错误） #

原代码存在括号不匹配问题，修正后：

from simple_salesforce import Salesforce
import base64
from datetime import date

# 初始化Salesforce连接
username = "你的用户名"
security_token = "你的安全令牌"
sf = Salesforce(username=username, password=security_token)

# 创建商机并获取ID
opportunity_data = {
    'Name': organization_name,
    'Amount': priceTotal,
    "Profitability__c": netMargin,
    "proposal_id__c": proposal_id,
    "StageName": "Qualification",
    "CloseDate": str(date.today())
}
opp_response = sf.Opportunity.create(opportunity_data)
opportunity_id = opp_response['id']

2. 读取PDF文件并上传为ContentVersion #

# 读取本地PDF文件，转成base64编码
pdf_file_path = "你的PDF文件路径.pdf"
with open(pdf_file_path, "rb") as f:
    pdf_content = base64.b64encode(f.read()).decode('utf-8')

# 创建ContentVersion记录
content_version_data = {
    'Title': "商机提案.pdf",  # 显示在Salesforce里的文件名
    'PathOnClient': pdf_file_path,  # 文件路径，用于识别文件类型
    'VersionData': pdf_content,  # base64编码的文件内容
    'IsMajorVersion': True  # 标记为主要版本
}
cv_response = sf.ContentVersion.create(content_version_data)
content_document_id = cv_response['id'].split('/')[-1]  # 提取ContentDocumentId

3. 关联文件到目标商机 #

# 创建ContentDocumentLink关联关系
cdl_data = {
    'ContentDocumentId': content_document_id,
    'LinkedEntityId': opportunity_id,
    'ShareType': 'V',  # 权限：V=查看，C=编辑，I=内部用户，E=外部用户
    'Visibility': 'AllUsers'  # 可见范围，可根据需求调整
}
sf.ContentDocumentLink.create(cdl_data)

关键注意事项 #

• 确保你的Salesforce账号拥有ContentVersion和ContentDocumentLink的创建权限
• VersionData必须是base64编码的字符串，不能直接传二进制数据
• ContentDocumentId需要从ContentVersion的返回ID中提取（格式为068xxxxxx，是返回ID的最后15位）
• 可根据实际需求调整ShareType和Visibility参数，控制文件的访问权限

内容的提问来源于stack exchange，提问作者Bilal Aslam