为搜索服务定义配置服务实体

约束与限制

• 实体数量约束

  同一搜索服务定义最多支持在“服务配置”中添加20个搜索实体。

• 实体范围约束

  仅支持添加数据库中存在对应物理表的实体，包括用户自定义实体模型及xDM-F内置模型（如Folder、LifecycleState）。

• 索引关联约束
  • 每个已定义的索引必须至少关联一个实体及其对应属性，否则无法保存。
  • 属性类型须与索引类型严格兼容（如：长整型索引仅可映射长整型/整型属性）。类型不匹配时系统将提示冲突。
• 路径选择约束
  • 当搜索实体与目标实体间存在多条关联路径时，需手动选择唯一路径。如果仅存在一条路径，系统将自动选中，无需手动操作。
  • 与搜索实体直接相连且无出边的单跳节点，支持配置多条路径。而非单跳关系节点或存在出边的节点，仅允许选择一条路径。
  • 关联路径不能形成闭环（即目标节点不可重复出现在当前链路中）。

前提条件

• 已登录应用运行态。
• 已完成搜索服务定义的索引规则配置，具体操作请参见为搜索服务定义配置索引规则。

在“服务配置”设置搜索实体

1. 在左侧导航栏中，选择“搜索服务管理 > 搜索服务定义”，进入“搜索服务定义”页面。
2. 找到目标搜索服务定义，单击，进入编辑页面。

   如果目标搜索服务定义的“状态”为“已发布”，需先单击，并在弹出的窗口中单击“确定”，进入修订状态后才能编辑。

3. 单击“服务配置”页签，切换至“服务配置”页签。
4. 在“搜索实体”右侧的下拉框中，选择需要纳入搜索范围的实体。

   可选实体范围：用户自定义实体模型、xDM-F内置模型（如Folder、LifecycleState）。即：只有在数据库中存在对应物理表的实体才可被添加。

   图1 添加搜索实体
   

5. 单击“添加”，系统将在下方自动添加并展开该搜索实体的配置模块。
6. 在展开的实体配置区域中（实体数据图谱下方），为已配置的索引指定数据来源，确保索引字段与实体属性正确映射。
   图2 配置索引与实体属性的映射
   
   • 实体名称：指定索引所绑定的数据来源实体。如果搜索实体已配置合法关联关系（如“设备台账 → 供应商”），支持选择关联实体，实现跨模型检索。
   • 属性名称：指定所选实体下的具体数据字段。所选属性的类型必须与索引类型兼容。

7. 根据指定的“实体名称”，在实体数据图谱中配置关联路径。
   • 唯一路径：如果指定实体与搜索实体之间仅存在一条路径时，系统自动选择该路径，无需手动操作。
     图3 存在一条路径
     
   • 多条路径：如果指定实体与搜索实体之间存在多条关联路径，需要为其指定一条或多条关联路径。具体配置请参见为搜索实体配置关联路径。
     图4 存在多条关联路径
     

8. 根据实际业务需求，重复执行4 - 6，配置多个搜索实体。
9. 配置完成后，单击底部“当前页签”中的“保存”。

为搜索实体配置关联路径

当搜索实体与指定实体之间存在多条可选关联路径时，需要手动指定路径。

1. 在实体数据图谱中，右键单击节点，选择“选择路径”。
   图5 选择路径
   

2. 在弹出的“选择路径步骤”窗口中，选择目标路径，单击“确定”。
   图6 选择路径步骤
   

   路径配置完成后，所选路径将在图谱中高亮展示。不同路径以不同颜色高亮展示，便于识别。

   图7 单跳关系指定多条路径
   
   如需移除某条路径，右键单击目标路径，选择“删除路径”。

   图8 删除路径
   

下一步操作

保存成功后，您需要发布该搜索服务定义，以使配置生效。具体操作请参见发布搜索服务定义。