如何通过Python提取Salesforce报表的文本内容？

你遇到的问题本质是直接请求Lightning前端导出URL会触发页面重定向，这个URL是面向用户的前端路由，不是专门的API接口；另外sf.restful报错无效会话ID，大多是因为实例URL配置不对。下面给你两种可靠的解决方法：

方法一：用Salesforce Analytics REST API（推荐） #

官方API是获取报表数据的标准方式，不会有重定向问题，且数据结构规范，容易解析。

代码示例（simple_salesforce版） #

from simple_salesforce import Salesforce
import pandas as pd

# 初始化连接，注意instance_url要用my.salesforce.com域名，不是lightning前端域名
sf = Salesforce(
    username='你的用户名',
    password='你的密码',
    security_token='你的安全令牌',
    instance_url='https://gkg-mfsa.my.salesforce.com'
)

# 从你的导出URL里提取报表ID：00O9N000000JwK2UAK
report_id = '00O9N000000JwK2UAK'
# 选一个兼容的API版本，比如v59.0（可在Salesforce设置里查看当前版本）
api_version = 'v59.0'

# 构造API请求地址，includeDetails=true会返回明细数据
report_endpoint = f'/services/data/{api_version}/analytics/reports/{report_id}?includeDetails=true'

try:
    # 调用API获取报表数据
    report_data = sf.restful(report_endpoint)
    
    # 解析表头和行数据（针对普通表格型报表）
    columns = [col['label'] for col in report_data['reportExtendedMetadata']['detailColumns']]
    rows = []
    # 报表的明细行存在factMap['T!T']['rows']里
    for row in report_data['factMap']['T!T']['rows']:
        row_values = [cell['label'] for cell in row['dataCells']]
        rows.append(row_values)
    
    # 转成DataFrame，方便查看和保存
    df = pd.DataFrame(rows, columns=columns)
    print(df)
    df.to_csv('salesforce_report.csv', index=False, encoding='utf-8')
except Exception as e:
    print(f"出错了: {str(e)}")

方法二：用requests直接调用API #

如果不想用simple_salesforce的封装，直接用requests也可以，核心是带对认证信息和实例URL：

import requests
import pandas as pd

sf = Salesforce(
    username='你的用户名',
    password='你的密码',
    security_token='你的安全令牌',
    instance_url='https://gkg-mfsa.my.salesforce.com'
)

report_id = '00O9N000000JwK2UAK'
api_version = 'v59.0'
url = f"{sf.instance_url}/services/data/{api_version}/analytics/reports/{report_id}?includeDetails=true"

# 必须带Authorization头，值为Bearer加会话ID
headers = {
    'Authorization': f'Bearer {sf.session_id}',
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)
if response.status_code == 200:
    report_data = response.json()
    # 解析逻辑和上面一致
    columns = [col['label'] for col in report_data['reportExtendedMetadata']['detailColumns']]
    rows = []
    for row in report_data['factMap']['T!T']['rows']:
        row_values = [cell['label'] for cell in row['dataCells']]
        rows.append(row_values)
    df = pd.DataFrame(rows, columns=columns)
    print(df)
else:
    print(f"请求失败，状态码: {response.status_code}，内容: {response.text}")

解决无效会话ID的关键 #

• instance_url要正确：必须用xxx.my.salesforce.com格式的实例域名，不能用lightning.force.com的前端域名，API接口只认实例域名
• 检查账号权限：确保你的账号能访问该报表，且账号设置中"API Enabled"处于勾选状态
• 会话过期就重新登录：如果隔了很久没操作，会话可能过期，重新初始化Salesforce连接即可

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