配置商品列表排序与展示字段

围绕“配置商品列表排序与展示字段”完成必要设置，并通过测试账号验证生效范围。

概述

本文说明“配置商品列表排序与展示字段”的适用条件、配置步骤、验证方法和回退方式。

开始之前

[!IMPORTANT]

适用范围：订货通专业版。

角色权限：使用具备订货通管理权限的管理员账号。

前置配置：准备测试客户、商品和价格数据。

操作步骤与说明

商品_产品列表是否支持按照指定字段自定义排序？

目前商品、产品列表页默认按照商品/产品的更新时间排序，若客户想按照其他字段如单位、分类、自定义排序字段进行排序，可在订货管理 > 业务对象 > 商品/产品对象 > 业务场景

点击编辑场景，配置排序字段即可实现：

注意：在订货管理的业务对象中配置，才会在下游订货通生效，在后台管理预设对象中配置无法生效。

移动端效果：

商城列表卡片个性化

商城列表支持通过 dht.shopmall.list.render.before 钩子替换卡片组件。自定义卡片沿用标准列表的数据结构和事件协议。

接口参数

参数	类型	说明
`product`	`Object`	当前商品或产品数据。
`productFields`	`Object`	商品或产品的字段描述。
`shoppingCard`	`Component`	钩子返回的自定义卡片组件。

注册卡片组件

import Card from './card';

export default class Plugin {
  apply() {
    return [
      {
        event: 'dht.shopmall.list.render.before',
        functional: this.shopmallRenderBefore.bind(this)
      }
    ];
  }

  shopmallRenderBefore() {
    return Promise.resolve({
      shoppingCard: Card
    });
  }
}

自定义卡片通过 on-action 事件返回操作类型和商品数据。操作类型包括加入购物车、查看详情、收藏、选择规格、选择配置和选择属性。

配置入口

在商品或产品的列表页布局中，配置自定义卡片插件。

商城列表卡片个性化配置界面

预期结果与验证

重新打开配置页，确认“配置商品列表排序与展示字段”涉及的开关、范围或规则保持为保存值。
使用测试账号执行受影响流程，确认页面入口、数据范围和操作权限与本次配置一致。
检查本次配置影响的业务记录，确认其按正文规则生成或流转。

常见问题与故障排除

正式使用前，请先用测试数据验证。
功能不可见时，请检查版本、权限和数据范围。

撤销或回退

返回本文所述的配置入口。
恢复变更前的开关、布局或规则值。
使用测试账号重新验证受影响流程。