配置索引仪表板
本主题适用于 Windchill 业务管理员。
 |
如果您先前已使用“Windchill AI 助手”插件版本 2026.0.0.21 或更早版本为电子仓库内容建立了索引，请更新插件并对现有内容重新建立索引，以确保与未来插件版本兼容。有关详细信息，请参阅重新建立索引。
|
通过“索引仪表板”，可以配置 Windchill AI 助手如何为 Windchill 数据建立索引并将其与 Azure 搜索服务同步。
在开始操作之前，请确保 Windchill AI 助手插件已连接到所需的 Azure 服务。有关详情，请参阅配置 Windchill AI 助手插件。
连接该插件后，请按照以下步骤配置索引并启动索引进程。
1. 打开“Windchill AI 助手”选项卡，单击 
，然后选择“索引仪表板”。
，然后选择“索引仪表板”。2. 单击“编辑”并指定“索引用户”。
系统仅为索引用户可访问的文档建立索引。要获得最佳结果，请使用有权访问相关产品或项目的专用索引用户。
有关创建索引用户的信息，请参阅创建索引用户。
| | 由于此版本存在限制，在更改“索引用户”设置后，您必须立即单击“保存”以应用更改。要进行其他更改，请单击“编辑”并指定其余详情。 |
3. 要在 Windchill 中添加、修改或移除文档时启用后台自动建立索引，选择“索引已启用”。
4. 在“时间间隔”部分中，对索引排期以控制何时运行索引。
◦ 选择时间范围 (例如，中午 12:00 - 半夜 11:59)。
◦ 单击 
，可以添加其他时间间隔。
，可以添加其他时间间隔。| | 建立索引会产生基于使用情况的成本，此类成本取决于已建立索引的文档的数量和大小。 配置排期时，索引建立仅在指定的时间间隔内运行。如果在这些时间间隔之外添加、修改或移除文档，则将在下一个已排期窗口期间建立索引。 示例：如果将索引时间安排在上午 11:00 到下午 6:00，则在下午 6:00 之后添加或修改的任何文档都将在下一个排定的索引窗口 (从第二天上午 11:00 开始) 建立索引。 |
5. 在“选定的容器”部分中，选择要建立索引的容器：
◦ 单击“添加”，可以将选定的容器从“可用容器”移至“选定的容器”。
，可以将选定的容器从“可用容器”移至“选定的容器”。◦ 单击“全部添加”，可以选择所有可用容器。
，可以选择所有可用容器。◦ 单击“移除”
，可以移除选定的容器。
，可以移除选定的容器。◦ 单击“全部移除”，可以移除所有容器。
，可以移除所有容器。| | 移除的容器在索引中仍然可用。但是，这些容器中对文件所做的任何后续更改都不会同步。要从索引中完全移除特定容器，还必须使用“策略管理”实用程序移除索引用户对这些容器的访问权限。 |
 | 建立索引会产生基于使用情况的成本，此类成本取决于已建立索引的文档的数量和大小。容器将按优先级顺序进行处理。要管理成本和处理时间，可首先对少量较小容器进行索引。为大型容器建立索引可能需要数天或数周时间。 |
6. 在“选定的实体类型”部分中，选择要建立索引的实体类型：
◦ 文档
◦ CAD 文档
◦ 动态文档
◦ 变更请求
◦ 变更通告
◦ 变更任务
◦ 问题报告
◦ 部件
◦ CAPA
7. 选择“自动每周同步”，排期 Windchill 与 Azure 搜索索引之间的每周同步。如果启用，系统会将 Azure 索引与 Windchill 中的最新变更进行协调。
a. 在“配置每周同步”中，选择一周中的某一天。
b. 选择时间 (例如，早上 06:00)。
8. 单击“保存”，应用变更。
9. 要手动将 Azure 索引与 Windchill 中的所有文档同步：
a. 转至“同步索引”。
b. 单击“启动”。
| | 单击“启动”后，当系统列出 Windchill 电子仓库的内容时，该按钮会暂时禁用 (灰显)。同步完成后，“启动”按钮将再次变为启用状态。但是，这并不表示建立索引已完成。此时，所有必需的索引事件均已创建完成，并已放入索引队列中，索引继续在后台运行。 |
此操作会为索引用户可访问的所有现有文档建立索引，并将 Azure 搜索索引与 Windchill 同步。
如果跳过此步骤，则在运行“自动每周同步”之前，仅对启用索引后添加或修改的文档建立索引。
Azure 资源诊断
“Azure 资源诊断”会显示运行 Windchill AI 助手插件所需的 Azure 服务的健康状况。
状况指示器显示连接的每个 Azure 服务是否按预期运行。利用此信息来确定可能影响索引或查询结果的连接或服务可用问题。
索引器状况
“索引器状况”会显示索引建立过程的当前状况和进度。
下表介绍可用字段：
字段 | 说明 |
|---|---|
状况 | 显示索引进程的当前状况。 |
上次索引运行 | 显示最近索引运行的日期和时间。 |
文档处理进度 | 显示文档的处理进度。 |
索引队列详情
索引采用增量式、事件驱动的方式，基于队列机制实现。管理员可以检查此队列的详情并识别索引失败。
队列每行显示一个文档作为事件。
下表介绍可用状态码：
完成的条目将在定义的时间段后自动从队列中移除。失败的条目将保留在队列中，以供审阅和调查之用。事件详情可能包括来自索引服务的消息，用于帮助确定失败的原因。
| | • Windchill AI 助手使用索引文档中的知识。允许在完成索引进程后，再提交与产品相关的查询。 • 在 SaaS 环境中，如果一个或多个 Azure 服务长时间处于“不可用”状态，请联系 PTC Windchill+ 管理员。 • 该插件将对可供索引用户访问的所有数据建立索引。如需了解与可建立索引的文档数有关的限制，请参阅 SaaS 环境的已知问题。 • 如果授予“索引用户”对其他上下文的访问权限，并运行索引，这可能会导致 Azure 订阅产生费用。 • 如果索引失败，请查看文档索引规范中的表，因为对不支持的类型建立索引可能会导致索引事件失败。 |