Workday SOAP API：Get_Workers请求未返回员工文档数据问题

我尝试通过Workday SOAP API的Get_Workers请求获取员工文档数据，参考的是Human Resources v40.1版本的API文档。请求中已设置<bsvc:Include_Worker_Documents>为true，且已确认：

• 目标员工确实存在文档
• 调用API的账号具备所需权限

但响应仅返回Worker_ID和User_ID，未包含任何文档数据，也没有返回错误信息。

请求内容：

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:bsvc="urn:com.workday/bsvc">
    <soapenv:Header>
        <wsse:Security soapenv:mustUnderstand="1"
            xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
            xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
            <wsse:UsernameToken>
                <wsse:Username>my_username</wsse:Username>
                <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">my_password</wsse:Password>
            </wsse:UsernameToken>
        </wsse:Security>
    </soapenv:Header>
    <soapenv:Body>
        <bsvc:Get_Workers_Request xmlns:bsvc="urn:com.workday/bsvc" bsvc:version="v40.1">
            <bsvc:Response_Filter>
                <bsvc:Count>999</bsvc:Count>
                <bsvc:Page>1</bsvc:Page>
            </bsvc:Response_Filter>
            <bsvc:Response_Group>
                <bsvc:Include_Worker_Documents>true</bsvc:Include_Worker_Documents>
            </bsvc:Response_Group>
        </bsvc:Get_Workers_Request>
    </soapenv:Body>
</soapenv:Envelope>

响应示例：

<wd:Worker>
               <wd:Worker_Data>
                  <wd:Worker_ID>1234</wd:Worker_ID>
                  <wd:User_ID>abcdef</wd:User_ID>
               </wd:Worker_Data>
            </wd:Worker>

请问为何无法获取到员工文档数据？

1. 缺少基础Worker数据响应组配置 #

Workday的Get_Workers API中，仅设置Include_Worker_Documents不足以触发文档数据返回——文档数据依赖基础的Worker数据结构作为载体。需要同时启用Include_Personal_Information或Include_Employment_Information等基础响应组，确保Worker核心数据被加载后，文档数据才能嵌套返回。

修改请求中的Response_Group节点：

<bsvc:Response_Group>
    <bsvc:Include_Personal_Information>true</bsvc:Include_Personal_Information>
    <bsvc:Include_Worker_Documents>true</bsvc:Include_Worker_Documents>
</bsvc:Response_Group>

2. 文档的细粒度权限限制 #

即使账号具备全局文档权限，部分文档可能因文档类型的访问控制规则或员工数据范围限制（跨业务单元、跨租户）无法返回。需要确认：

• 目标文档所属的文档类型是否允许当前账号访问
• 账号的权限范围是否覆盖目标员工所在的业务单元或组织

3. 未指定精准的Worker筛选条件 #

当前请求未添加任何Worker筛选规则，会返回系统中所有符合条件的Worker。当返回数据量较大时，Workday可能会自动截断非核心数据以优化性能。建议添加筛选条件，精准定位到已知存在文档的员工：

<bsvc:Get_Workers_Request xmlns:bsvc="urn:com.workday/bsvc" bsvc:version="v40.1">
    <bsvc:Request_Criteria>
        <bsvc:Worker_Reference>
            <bsvc:ID bsvc:type="Employee_ID">1234</bsvc:ID>
        </bsvc:Worker_Reference>
    </bsvc:Request_Criteria>
    <!-- 其他节点保持不变 -->
</bsvc:Get_Workers_Request>

4. 文档数据的嵌套层级未被检查 #

文档数据通常嵌套在Worker_Data下的Worker_Document_Data节点中，若仅截取了响应的部分片段，可能会遗漏该嵌套节点。建议检查完整的响应XML内容，确认是否存在被忽略的文档数据节点。

5. API版本兼容性问题 #

虽然请求指定了v40.1版本，但部分环境可能存在版本配置差异。尝试确认API端点的实际版本是否与请求中的bsvc:version="v40.1"一致，或切换到相邻稳定版本（如v40.0、v41.0）测试。

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