Acumatica带参数通用查询（GI）的OData调用未生效问题求助

以下是针对该问题的具体排查方向：

1. 确认OData请求的语法正确性 #

• 严格按照OData函数调用格式构造URL：正确格式应为 {AcumaticaBaseURL}/OData/GenericInquiry/AR_Documents_PeriodSensitive(PPeriod='092025')，不能用Query参数（如?PPeriod=092025），因为元数据定义的是Function类型，必须通过函数调用语法传递参数。
• 确保字符串参数用单引号包裹，OData规范中字符串类型参数必须带单引号，缺少引号会导致参数无法被正确解析。

2. 检查GI参数的OData可见性配置 #

• 打开GI的设计界面，找到参数PPeriod，确认是否勾选了**“OData可见”**（或对应版本中的类似选项）。即使元数据中存在参数定义，若该开关未启用，OData服务仍会忽略传入的参数。

3. 验证OData服务的配置与版本兼容性 #

• 检查Acumatica实例的Web.config文件，确认OData相关配置是否支持函数调用，例如确保EnableUnqualifiedNameCall设置为true（部分版本默认关闭）。
• 确认Acumatica版本的OData服务是否支持带参数的GI调用，部分旧版本可能存在函数参数绑定的Bug，可尝试升级到对应版本的最新补丁。

4. 排查请求头与编码问题 #

• 对比REST API和OData请求的请求头，确保OData请求包含相同的Authorization头、Acumatica自定义头（如AcumaticaTenant等），缺少必要的头信息可能导致参数无法正确绑定到GI会话。
• 在Postman中使用Raw格式发送请求，避免自动编码导致参数变形；同时验证请求的Accept头设置为application/json或application/atom+xml，确保服务返回正确格式的响应。

5. 查看Acumatica系统日志 #

• 开启系统详细日志（路径：System > Management > System Logs，设置日志级别为Verbose），触发OData请求后，查看日志中关于GI执行、参数绑定的记录，确认参数是否被正确接收，以及GI执行时是否使用了传入的参数值，日志中通常会暴露参数未生效的具体原因。

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