调用Dynamics CRM WebApi发起GET请求提示缺少EntityName字段如何解决

云上老周

2026-9-26

问题原因

RetrieveEntityRibbon是Dynamics CRM WebApi提供的OData标准函数，参数不能以普通查询字符串（?key=value）的形式拼接，必须放在函数名后的括号内传递，字符串类型参数需要用单引号包裹，这是你收到参数缺失报错的核心原因。
GET请求的参数本身就不支持通过send()方法传递，send()方法携带的内容仅会在POST/PUT等请求中作为请求体发送，GET请求的所有参数都必须拼接在URL中。
现有代码还存在收尾语法错误、请求头配置不全的潜在问题。

修复后的代码示例

// 1. 正确构造OData函数调用URL，参数放在括号内，字符串加单引号
// 注意RetrieveEntityRibbon还需要必填参数RibbonLocationFilters，可选值为All/Form/HomeGrid/SubGrid
let url = this._data.OrgInfo.CrmUrl + "/api/data/v" + this._data.OrgInfo.ApiVersion + "/RetrieveEntityRibbon(EntityName='account', RibbonLocationFilters='All')";

var xmlHttpRequest = require('xhr2');
var req = new xmlHttpRequest();
req.open("GET", url, true);

// 2. 补全必要的请求头，你原来的setRequestHeaders()要确保包含以下配置
req.setRequestHeader("Accept", "application/json");
req.setRequestHeader("OData-MaxVersion", "4.0");
req.setRequestHeader("OData-Version", "4.0");
// 如果需要身份认证，还要在这里加Authorization头，比如Bearer token

req.addEventListener("load", function() {
    if (req.status >= 200 && req.status < 300) {
        let result = JSON.parse(req.response);
        // 处理返回结果
    } else {
        // 处理请求错误
        console.log(req.responseText);
    }
}, false);

req.send();