如何通过Oracle RightNow SOAP API的QueryCSV获取Outreach Activity数据

我之前帮不少开发者解决过类似的RightNow SOAP API查询问题，结合你提到的ma_trans表，咱们来一步步捋清楚怎么搞定：

1. 别用SELECT *，先明确ma_trans的核心字段 #

RightNow的自定义模块表（比如ma_trans这类Marketing Automation相关的表）不支持直接用SELECT *查询，因为这类表有特殊的字段关联和权限控制。你可以先通过RightNow控制台的Schema Browser（路径：Configuration > Database > Schema Browser）查看ma_trans的所有可用字段，常用的核心字段包括：

• id：记录唯一标识
• contact_id：关联的联系人ID
• outreach_id：关联的Outreach活动ID
• status：活动状态（如已发送、已打开、已点击）
• created_time：记录创建时间
• modified_time：记录修改时间

基础的有效查询语句应该像这样：

SELECT id, contact_id, outreach_id, status, created_time FROM ma_trans WHERE outreach_id = '12345'

2. 检查API账号的权限 #

ma_trans属于Marketing Automation模块的数据，你的API登录账号必须拥有Marketing Automation数据访问权限，否则肯定会返回权限错误。你可以让管理员在RightNow控制台的用户角色设置里，确认是否给该账号分配了对应的权限组（比如“Marketing Automation Access”）。

3. 排查常见错误原因 #

如果还是收到错误，大概率是以下情况之一：

• 表名/字段名错误：RightNow的表名和字段名虽然不严格区分大小写，但建议和Schema Browser里显示的一致，避免拼写错误
• 日期格式不对：查询时间范围时，日期必须用单引号包裹，格式为'YYYY-MM-DD HH:MM:SS'，比如created_time >= '2024-01-01 00:00:00'
• 关联查询语法错误：如果需要关联其他表（比如联系人表），要使用RightNow支持的JOIN语法，示例如下：

SELECT mt.id, c.last_name, c.email FROM ma_trans mt JOIN contact c ON mt.contact_id = c.id WHERE mt.outreach_id = '12345'

4. 示例SOAP API请求片段 #

给你一个简化版的QueryCSV请求示例，你可以参考调整：

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:quer="urn:query.ws.rightnow.com/v1_4">
   <soapenv:Header>
      <quer:ClientInfoHeader>
         <quer:AppID>你的应用ID</quer:AppID>
      </quer:ClientInfoHeader>
      <quer:SecurityHeader>
         <quer:Username>你的API账号</quer:Username>
         <quer:Password>你的API密码</quer:Password>
      </quer:SecurityHeader>
   </soapenv:Header>
   <soapenv:Body>
      <quer:QueryCSV>
         <quer:Query>SELECT id, contact_id, outreach_id, status, created_time FROM ma_trans WHERE created_time >= '2024-01-01 00:00:00'</quer:Query>
         <quer:Delimiter>,</quer:Delimiter>
         <quer:IncludeHeaders>true</quer:IncludeHeaders>
      </quer:QueryCSV>
   </soapenv:Body>
</soapenv:Envelope>

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