Kentico 10自定义模块类间多对多关系UI管理及数据存储问询

我之前在Kentico 10项目里刚好处理过几乎一模一样的场景——带额外标识字段的多对多关联管理，结合官方最佳实践，给你一套落地的步骤：

一、先搞定自定义模块的类结构配置 #

Kentico默认的自动多对多关联不支持额外字段，所以咱们得手动构建三个类的关系：

• Company类：创建基础企业信息字段（名称、联系人、电话等），常规配置就行。
• PostalCode类：添加Country（建议用下拉列表绑定国家选项）、Latitude（数字类型，保留小数位）、Longitude（同纬度字段），确保每个邮编记录唯一。
• CompanyPostalCodes连接类：这是核心，必须手动创建：
  • 添加两个外键字段：CompanyID（关联到Company类）、PostalCodeID（关联到PostalCode类），记得把这两个字段的「允许空值」关掉。
  • 添加布尔字段IsDeliveryService（或者你需要的标识名称，比如IsServiceArea），设置默认值为false，显示名称改成“服务模式（配送/上门）”这类易懂的文字。
  • 关键：在这个类的「常规」设置里，把「显示在菜单中」关掉——用户不需要直接管理这个连接表，所有操作都通过Company的详情页来做。

二、配置类之间的关联关系 #

在Kentico后台的「模块」→「自定义模块」→「类」里，给三个类设置关系：

• 打开Company类的「关系」标签，添加一对多关系：关联到CompanyPostalCodes类，命名为“服务邮编关联”，这样在Company详情页就能看到关联的邮编记录。
• 同样，打开PostalCode类的「关系」标签，添加一对多关系关联到CompanyPostalCodes，方便从邮编反向查看哪些企业服务它（可选，根据你的需求）。

三、构建后台管理UI（核心步骤） #

咱们要给Company的详情页加一个专属Tab，用来管理它的服务邮编：

1. 添加新Tab到Company详情页：
   • 进入自定义模块的「UI」→「页面模板」，找到Company的详情页模板，添加一个新Tab，比如命名为「服务邮编管理」。
2. 在Tab里添加UniGrid展示关联数据：
   • 拖放UniGrid控件到Tab的内容区域，配置数据源为CompanyPostalCodes类，添加过滤条件：WhereCondition="CompanyID = {% EditedObject.ID %}"（针对自定义对象类）。
   • 配置UniGrid的列：

     <Columns>
       <Column Source="PostalCode.PostalCodeValue" Caption="邮编" />
       <Column Source="PostalCode.Country" Caption="所属国家" />
       <Column Source="IsDeliveryService" Caption="服务模式" DataType="boolean" />
       <Column Source="Edit" Caption="编辑" />
       <Column Source="Delete" Caption="删除" />
     </Columns>
     

   • 这样UniGrid会自动关联展示PostalCode的详情，不用自己写JOIN逻辑。
3. 添加「新增服务邮编」按钮：
   • 在UniGrid上方加一个按钮，点击弹出模态框（用Kentico的ModalDialog控件），模态框里放：
     • ObjectSelector控件：绑定PostalCode类，设置过滤条件（比如按国家筛选）方便用户快速找到目标邮编。
     • CheckBox控件：绑定IsDeliveryService字段，让用户选择服务模式。
   • 提交模态框时，后台代码获取选中的PostalCodeID、当前CompanyID和布尔值，插入到CompanyPostalCodes表。

四、优化体验的小技巧 #

• 批量操作：如果需要批量添加邮编，可以用MultiObjectSelector控件，允许用户一次性选多个邮编，批量插入到连接表。
• 即时编辑布尔字段：在UniGrid的IsDeliveryService列里，用<EditFormControl>指定用CheckBox控件，这样用户直接在列表里就能切换服务模式，不用跳转到编辑页：

  <Column Source="IsDeliveryService" Caption="服务模式">
    <EditFormControl ControlName="CheckBox" />
  </Column>
  

• 邮编搜索过滤：在UniGrid上方添加搜索框，过滤邮编或国家，提升查找效率。

注意事项 #

• 一定要给CompanyPostalCodes类添加唯一约束：确保同一个Company和PostalCode的组合只存在一条记录，避免重复关联。
• 在后台代码处理插入/更新时，要先检查是否已存在相同的关联记录，防止重复插入。

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