Microsoft Graph 连接器搜索和验证索引内容
在连接测试期间找不到特定项时,可以使用索引浏览器 测试索引 。 如果需要 验证属性和用户访问,它有助于 查看索引项 (ACL) 元数据和访问控制列表 。 此外,它有利于 排查搜索问题;如果用户报告访问项时出现问题,此功能将确认是否已正确编制项目索引并包含正确的数据。
关于索引浏览器
输入项 ID 以检查其索引状态时,如果为该项编制了索引,则可以查看以下详细信息。
- 内容的名称 - 索引项的名称。
- 状态 - 项的当前状态及其上次刷新时间。
- 属性 - 指示在为项配置期间定义的所有属性的状态。
- 权限 - Lists与项目关联的所有组和单个用户。 如果状态 为“允许”,则这些组中的所有用户都可以查看该项目。 如果状态为 “拒绝”,则这些组中的用户无法访问该项目。 如果访问权限配置为 “允许所有人 而不是 只有有权访问连接的人员 ”,则索引中的所有项对每个人都可见,并且不会强制实施任何特定权限。
- 检查用户访问 - 允许搜索特定用户来验证他们对项目的访问权限。 输入用户名或电子邮件地址以显示用户所属的组列表。 如果用户被拒绝访问这些组中的任何一个,则其查看项目的总体权限将被撤销。
注意
- 在“权限”中,可以看到 (在数据源中的组) 和数据源中的组外部单独显示的用户。 若要为组中存在的用户检查,请使用“检查用户访问”。
- 如果用户未出现在 “检查用户访问”中,则可能是由于用户映射失败或用户未被发现 (例如,) 找不到 AAD 用户 ID。 若要解决此问题,检查用户是否有权访问数据源,请查看用户映射公式并报告错误。
若要搜索索引内容,请在索引浏览器中输入项的唯一标识符。
连接器或名称 | 每个项目 ID 的输入 | 在何处查找项 ID |
---|---|---|
ADO WI | ID | ID 是工作项 ID。 |
ADO Wiki | 组织名称、页面 ID | 可以在 URL 中找到它。 |
ServiceNow KB | Sys_Id.DisplayValue | 导航到要在其中查找sys_id的记录,右键单击标题栏,然后选择“复制sys_id”。还可以单击“汉堡副本 > ”sys_id。 有关详细信息,请参阅 ServiceNow 文档。 |
ServiceNow 目录 | Sys_Id.value | 导航到要在其中查找sys_id的记录,右键单击标题栏,然后选择“复制sys_id”。还可以单击“汉堡副本 > ”sys_id。 有关详细信息,请参阅 ServiceNow 文档。 |
ServiceNow 票证 | Sys_Id.value | 导航到要在其中查找sys_id的记录,右键单击标题栏,然后选择“复制sys_id”。还可以单击“汉堡副本 > ”sys_id。 有关详细信息,请参阅 ServiceNow 文档。 |
Salesforce | ID | 可以在 URL 中找到它。 |
Intranet (Cloud/OnPrem) | URL | 最终 URL(小写)。 Jira 问题 ID。 按照链接 (https://confluence.atlassian.com/jirakb/how-to-get-issue-id-from-the-jira-user-interface-1115156394.html#:~:text=User%20needs%20to%20get%20the%20issue%20id%20in%20an%20easier) 。 |
Confluence (Cloud/OnPrem) | 页面博客文章 ID | 可以在 URL 的项 ID 中找到它。 可以在数据源的 Confluence Cloud URL 中找到示例。 |
CSV | 唯一标识符列表、项键 | 管理员配置的详细信息。 |
Azure SQL、Oracle DB、MS SQL | 唯一键列中所有列的值 | 管理员配置的详细信息。 |
Mediawiki | 页面 ID、命名空间、sourceUrl | 管理员配置的详细信息。 |
ADLS gen 2 | 文件 URI | 管理员配置的详细信息。 |
Sharepoint | GUID | 管理员配置的详细信息。 |
FileShare | filepath | 管理员配置的详细信息。 |
自定义连接器 | 项目 ID | 管理员配置的详细信息。 |
SAP | 用户 ID | 管理员配置的详细信息。 |
示例
示例 1:项目状态已部分编制索引
它指示该项缺少某些信息(如属性、用户详细信息或内容),但在Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®中仍可搜索。 若要确保项目完成,请查看“错误”选项卡了解详细信息。
示例 2:项状态为“全部拒绝”
它指示该项已编制索引,但所有用户仍无法访问,如权限选项卡中的空响应所示。尽管索引中存在该项,但用户无法查看它。
对于 ServiceNow 连接器, “拒绝所有 ”状态可能由不同的原因导致
项的高级条件 - 如果高级条件应用于拒绝列表中的某个项,则可能将其标记为 “全部拒绝”。 若要解决此问题,请尝试删除高级条件并触发完全爬网。 有关详细信息,请参阅每个连接器的故障排除部分。
知识库上的高级条件 - 如果知识库拒绝列表的高级条件影响该知识库中的所有项目。 这可能会导致这些文章出现 “拒绝所有” 状态。 确定项所属知识库并删除高级条件。 有关详细信息,请参阅每个连接器的故障排除部分。
此外,临时问题可能会导致 “拒绝所有” 状态,这可以在下次完全爬网期间解决。
示例 3:允许所有人使用项状态
当项目配置为对每个人都可见时,无论数据源中设置的权限如何,组织中的所有用户都可以访问该项目。
如果发现某个项但未编制索引,检查“错误”选项卡查看阻止索引编制过程的任何问题。
注意
- 对 ACL) (用户或组权限的更改可能需要长达 24 小时才能反映在Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®中。
- 权限更新在完全爬网期间发生,而不是增量爬网期间发生。
- 如果数据源权限在上次完全爬网后发生更改,则必须按需触发新的完全爬网或计划更新索引。
- 在Microsoft搜索或智能 Microsoft 365 Copilot 副驾驶®进行测试时,请确保使用可搜索或可查询属性进行搜索。 有关详细信息,请参阅 管理架构。