多公司环境下InventOnHandItem表单默认库存过滤器配置咨询

嘿，这个问题我之前在多公司D365 FO项目里也碰到过——InventOnHandItem的默认查询逻辑确实没有直接的系统参数可以统一配置，出现差异大概率是因为不同公司的表单个性化设置、或者系统底层的隐性分支逻辑导致的。不过咱们可以通过表单扩展的方式强制统一默认过滤规则，具体实现步骤如下：

1. 扩展表单的查询初始化逻辑 #

核心思路是通过表单扩展，修改InventSum数据源的查询规则，覆盖掉系统默认的差异化逻辑。

示例代码实现 #

创建一个表单扩展类，在表单初始化阶段修改查询：

[ExtensionOf(formStr(InventOnHandItem))]
final class InventOnHandItem_UnifiedFilter_Extension
{
    void init()
    {
        // 先执行原表单的初始化逻辑
        next init();

        // 获取InventSum数据源的查询对象
        Query inventSumQuery = InventSum_ds.query();
        QueryBuildDataSource qbdsInventSum = inventSumQuery.dataSourceTable(tableNum(InventSum));
        QueryBuildRange existingRange;

        // 先移除系统自动添加的Closed/ClosedQty相关过滤范围，避免冲突
        existingRange = qbdsInventSum.findRange(fieldNum(InventSum, Closed));
        if (existingRange)
        {
            qbdsInventSum.removeRange(existingRange);
        }
        existingRange = qbdsInventSum.findRange(fieldNum(InventSum, ClosedQty));
        if (existingRange)
        {
            qbdsInventSum.removeRange(existingRange);
        }

        // 添加统一的过滤规则：这里以"排除已关闭库存（Closed=No）"为例
        QueryBuildRange unifiedClosedRange = qbdsInventSum.addRange(fieldNum(InventSum, Closed));
        unifiedClosedRange.value(queryValue(NoYes::No));

        // 如果需要基于ClosedQty过滤，比如只显示未关闭数量为0的记录，可添加下面的代码
        // QueryBuildRange unifiedClosedQtyRange = qbdsInventSum.addRange(fieldNum(InventSum, ClosedQty));
        // unifiedClosedQtyRange.value(queryValue(0));
    }
}

2. 处理特殊公司的例外情况（可选） #

如果部分公司需要保留原有过滤规则，可以在代码中加入公司维度的判断：

// 获取当前公司信息
CompanyInfo currentCompany = CompanyInfo::find();
// 排除需要保留原有规则的公司
if (currentCompany.dataAreaId != 'SPECCOMP')
{
    // 应用统一过滤规则
    QueryBuildRange unifiedClosedRange = qbdsInventSum.addRange(fieldNum(InventSum, Closed));
    unifiedClosedRange.value(queryValue(NoYes::No));
}

3. 部署后验证要点 #

• 部署扩展后，必须清除AOS缓存并重启客户端，确保代码生效。
• 检查是否有用户手动保存的表单个性化过滤器：如果有的话，需要让用户在表单中点击「选项 > 个性化 > 恢复默认值」，否则你的代码规则会被个性化设置覆盖。
• 切换到不同公司测试InventOnHandItem表单，确认默认过滤器已经统一。

额外提醒 #

如果你的环境中还有其他扩展修改了InventOnHandItem的查询逻辑，需要调整扩展的执行优先级（在扩展属性中设置），确保你的统一规则最后生效，避免被其他扩展覆盖。

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