PI Builder 使用手册模板

PIBuilder使用手册前言：PIBuilder是AVEVAPISystem旗下一款基于MicrosoftExcel的插件工具，核心功能是通过Excel界面实现对PIDataArchive（PI数据归档）和PIAssetFramework（PIAF，资产框架）的高效管理，支持PI点、AF元素、分析参数、事件框架等内容的批量导入、导出、编辑与发布，大幅提升PISystem运维效率，减少手动操作失误。本手册适用于PIBuilder插件的日常使用者（如PI系统管理员、运维工程师、数据分析师），详细介绍插件的安装配置、核心操作、故障排查及注意事项，帮助用户快速掌握使用方法，规范操作流程，充分发挥工具的批量管理优势。本手册内容基于PIBuilder最新稳定版本编写，结合实际运维场景补充实操细节，未尽事宜可参考AVEVA官方技术文档或联系厂商技术支持。版权声明：本手册所涉及的AVEVA、PISystem、PIBuilder等商标及相关技术，均为AVEVA集团的知识产权，未经AVEVA书面许可，不得擅自复制、传输、转录或修改本手册及相关配置文件。第一部分系统概述1.1软件简介PIBuilder作为PISystem与Excel的桥梁工具，无需复杂的编程操作，通过Excel熟悉的表格界面，即可实现对PI系统核心数据的批量管理。其核心价值在于简化PI点、AF元素等对象的创建、编辑与维护流程，支持批量操作替代逐一对象手动配置，尤其适用于大规模PI系统的运维场景，同时支持数据的导入导出，便于数据备份、批量修改及跨系统同步，有效提升工作效率，降低操作成本。PIBuilder需与PIAFClient（PI资产框架客户端）配合使用，支持与PIDataArchive、PIAFServer建立连接，兼容主流版本的MicrosoftExcel（建议使用Excel2016及以上版本，不支持WindowsStore应用版本的Excel），不同版本的PIBuilder功能略有差异，具体以对应版本的官方说明为准。1.2核心功能批量管理PI点：支持从Excel导入、导出PI点配置信息（如点名称、描述、点类型、扫描频率等），可批量创建、编辑、删除PI点，无需逐一在PIDataArchive中操作。AF元素与属性管理：支持对PIAF元素、元素模板、属性进行批量导入、导出与编辑，可快速批量创建AF层级结构，批量修改元素属性值。分析与事件框架管理：可通过Excel编辑分析参数、事件框架信息，支持批量发布分析规则，目前暂不支持为事件框架添加或编辑注释/批注，该操作需通过PISystemExplorer（PSE）完成。数据导入导出：支持将PI系统中的配置数据（PI点、AF元素等）导出为Excel表格，便于数据备份、审核与修改；也支持将编辑好的Excel表格数据导入PI系统，实现批量配置。批量发布与校验：编辑完成的数据可通过插件一键批量发布至PI系统，发布前可进行数据校验，减少配置错误；支持对导入数据的表头进行校验，若表头拼写错误，可设置提示报错功能。1.3运行环境要求1.3.1硬件要求处理器：IntelCorei5及以上，或同等性能的AMD处理器。内存：至少8GBRAM，建议16GBRAM（大规模批量操作时可提升效率）。硬盘：至少预留100MB存储空间（用于安装插件），额外预留足够空间用于存储Excel配置文件及导出数据。网络：需与PIDataArchive服务器、PIAFServer处于同一局域网，网络通畅，无防火墙拦截相关端口。1.3.2软件要求操作系统：Windows10及以上（64位），兼容Windows11系统。Excel版本：MicrosoftExcel2016及以上（桌面版），不支持WindowsStore应用版本的Excel。依赖软件：需提前安装PIAFClient（建议与PIBuilder版本匹配），确保能正常连接PI系统。其他：安装.NETFramework4.8及以上版本，确保插件正常运行。第二部分安装与初始化配置2.1安装前准备权限准备：安装需使用管理员权限登录Windows系统，避免因权限不足导致安装失败。软件准备：下载与PIAFClient版本匹配的PIBuilder安装包（可从AVEVA官方网站或PISystem安装介质中获取）。环境检查：确认已安装符合要求的Excel版本和PIAFClient，关闭所有Excel进程，避免安装过程中出现冲突。2.2安装步骤双击PIBuilder安装包，启动安装向导，点击“下一步”。阅读许可协议，勾选“我接受许可协议中的条款”，点击“下一步”。选择安装路径（建议使用默认路径，若需修改，确保路径无中文、无特殊符号），点击“下一步”。确认安装配置信息，点击“安装”，等待安装完成（安装过程中请勿关闭安装向导）。安装完成后，点击“完成”，重启Excel使插件生效。2.3初始化配置（核心步骤）初始化配置的核心是建立PIBuilder与PI系统（PIDataArchive、PIAFServer）的连接，确保插件能正常获取和操作PI系统数据，具体步骤如下：启动Excel，在菜单栏中找到“PIBuilder”选项卡（若未显示，参考4.2节排查Ribbon显示问题），点击进入插件界面。点击“连接”按钮，在弹出的连接窗口中，选择“PIAFServer”和“PIDataArchiveServer”，输入服务器名称或IP地址，点击“确定”。若服务器需要身份验证，输入正确的用户名和密码（需具备PI系统操作权限），点击“登录”。登录成功后，插件会显示当前连接的服务器信息，此时即可开始使用PIBuilder的各项功能；若连接失败，检查服务器地址、网络连通性及权限是否正确。（可选）点击“PIBuilder”选项卡中的“设置”，可配置数据更新间隔、导入导出规则等，建议保留默认设置，后续根据需求调整。2.4安装验证安装完成后，启动Excel，确认“PIBuilder”选项卡正常显示；点击“连接”按钮，成功连接至PI系统后，尝试导出一个简单的PI点列表，若能正常导出，说明安装和初始化配置成功。第三部分日常操作指南3.1基础操作：连接与断开服务器3.1.1连接服务器启动Excel，切换至“PIBuilder”选项卡。点击“连接”，在弹出的窗口中选择或输入PIAFServer和PIDataArchiveServer地址。输入登录凭据（用户名、密码），点击“确定”，连接成功后，插件会显示服务器连接状态。3.1.2断开服务器完成操作后，点击“PIBuilder”选项卡中的“断开连接”，即可断开与PI系统的连接；关闭Excel时，插件会自动断开连接，无需手动操作。3.2核心操作：PI点批量管理3.2.1导出PI点配置连接至PIDataArchive服务器后，点击“PIBuilder”选项卡中的“导出”，选择“PI点”。在弹出的导出窗口中，设置筛选条件（如PI点名称、点类型、数据源等），选择需要导出的PI点属性（如点描述、扫描频率、工程单位等）。点击“确定”，插件会将筛选后的PI点配置信息导出至当前Excel工作表中，可直接查看、编辑或保存。3.2.2导入/批量创建PI点在Excel中，按照PIBuilder要求的模板填写PI点配置信息（可先导出一个模板，参考模板格式填写，确保表头与PI系统属性一致，避免拼写错误）。填写完成后，切换至“PIBuilder”选项卡，点击“导入”，选择“PI点”。在弹出的导入窗口中，确认导入范围（当前工作表或指定区域），点击“校验”，检查数据格式是否正确、必填项是否缺失。校验通过后，点击“发布”，插件会将Excel中的PI点配置批量导入至PIDataArchive中，创建新的PI点；若校验失败，根据提示修改错误数据后重新校验。3.2.3批量编辑PI点导出需要编辑的PI点配置至Excel工作表中。在Excel中直接修改PI点的属性值（如修改点描述、调整扫描频率等），注意不要修改PI点名称（若需修改，需通过PIDataArchive手动操作）。修改完成后，点击“PIBuilder”选项卡中的“导入”，选择“PI点”，校验数据无误后点击“发布”，即可完成PI点的批量编辑。3.3核心操作：AF元素批量管理3.3.1导出AF元素与属性连接至PIAFServer后，点击“PIBuilder”选项卡中的“导出”，选择“AF元素”。在弹出的窗口中，选择需要导出的AF数据库、元素模板或具体元素，勾选需要导出的属性（如元素名称、描述、属性值等）。点击“确定”，插件会将AF元素信息导出至Excel工作表中，可查看AF层级结构及元素属性。3.3.2导入/批量创建AF元素在Excel中，按照AF元素模板格式填写元素信息（包括元素名称、父元素、元素模板、属性值等），确保层级关系清晰。切换至“PIBuilder”选项卡，点击“导入”，选择“AF元素”，确认导入范围。点击“校验”，检查元素层级、属性格式是否正确，校验通过后点击“发布”，批量创建AF元素及属性。3.4数据导入导出高级操作格式设置：导出数据时，可选择保留Excel单元格格式（需在设置中开启相关选项），避免导出后格式丢失；目前PIBuilder检索数据时会覆盖单元格格式，可通过后续版本更新优化该问题。批量备份：定期将PI点、AF元素配置导出为Excel文件，保存至本地或异地备份，便于数据恢复。AF表格导入导出：目前PIBuilder暂不支持AF表格的导入导出，该功能需等待官方版本更新支持。3.5常见操作技巧表头校验：若编辑数据时表头拼写错误，可在设置中开启“表头错误提示”功能，避免因表头错误导致数据无法正常导入。批量删除：若需批量删除PI点或AF元素，可在导出的Excel表格中删除对应行，然后通过“导入”功能校验发布，即可完成批量删除（操作前请做好数据备份）。单元格引用：可在设置中配置单元格引用方式（绝对引用/相对引用），根据操作需求灵活调整。第四部分故障排查与解决方案4.1故障排查思路PIBuilder故障主要集中在插件无法启动、服务器连接失败、导入导出异常、Ribbon选项卡不显示等场景，排查时遵循“先环境、再连接、最后操作”的思路，重点检查Excel版本、依赖软件、网络连接及数据格式，优先采用简单排查方法（如重启Excel、重新连接服务器），再进行复杂排查。4.2高频故障与解决方案故障现象可能原因解决方案Excel中无“PIBuilder”选项卡（Ribbon不显示）1.插件未安装成功；2.Excel禁用了PIBuilder插件；3.安装了WindowsStore版本的Excel；4.Ribbon配置异常1.重新安装PIBuilder，确保使用管理员权限；2.在Excel“文件-选项-加载项”中，启用PIBuilder插件；3.卸载WindowsStore版本Excel，安装桌面版；4.通过PowerShell脚本修复Ribbon问题（参考AVEVA官方知识库）无法连接至PI服务器1.服务器地址输入错误；2.网络不通，防火墙拦截端口；3.登录凭据错误；4.PIAFClient未安装或版本不匹配1.核对服务器名称/IP地址；2.测试网络连通性，关闭防火墙或开放相关端口；3.输入正确的用户名和密码，确保具备操作权限；4.安装与PIBuilder版本匹配的PIAFClient导入数据失败，校验不通过1.数据格式错误（如必填项缺失、属性值不符合要求）；2.表头拼写错误；3.PI点/AF元素名称重复；4.权限不足1.检查数据格式，补充必填项，确保属性值符合PI系统要求；2.核对表头，修正拼写错误；3.修改重复的名称，确保唯一性；4.联系管理员提升操作权限导出数据时格式丢失未开启“保留单元格格式”设置，或PIBuilder版本不支持该功能1.进入PIBuilder设置，开启“保留单元格格式”选项；2.更新PIBuilder至最新版本无法编辑或添加事件框架注释PIBuilder目前暂不支持该功能，需通过PSE操作打开PISystemExplorer（PSE），通过PSE编辑或添加事件框架注释/批注批量操作时速度缓慢1.数据量过大；2.网络速度慢；3.内存不足1.分批次进行批量操作，减少单次操作的数据量；2.检查网络速度，确保网络通畅；3.关闭其他占用内存的程序，提升电脑运行效率4.3日志分析技巧PIBuilder会生成操作日志，用于排查故障，日志默认存储在系统用户目录下（路径可在设置中查看），重点关注以下内容：连接日志：记录服务器连接、断开的时间及状态，若出现“连接失败”“权限错误”等信息，可定位连接相关故障。导入导出日志：记录导入导出的操作时间、数据量、错误信息（如“表头错误”“数据格式错误”），可快速定位导入导出失败的原因。系统日志：记录插件启动、关闭及异常崩溃信息，若插件闪退，可通过系统日志排查是否为环境或版本兼容问题。第五部分安全管理与操作规范5.1安全管理权限控制：严格控制PIBuilder的使用权限，仅授权人员可使用插件进行操作；避免使用管理员权限进行日常操作，降低误操作风险。凭据安全：登录PI服务器时，妥善保管用户名和密码，禁止共享账号；操作完成后，及时断开服务器连接，避免账号泄露。数据安全：导出的PI系统配置数据（Excel文件）