使用Add-Ins 扩展 TIA Portal 功能Add-Ins 的基本知识 简介 使用 Add-Ins，可对 TIA Portal的功能进行扩展。安装“TIA Portal Openness”后，即可使用相 应 Add-Ins。 在 TIA Portal中，可编写并运行 Add-Ins 程序。为此，Add-Ins 的格式必须为具有扩展名 “*.addin”的数据包文件，且必须保存到TIA Portal 安装目录的“AddIns”文件夹中。Add-Ins 运 行之前，需在“Add-Ins”任务卡中分别激活。以下类型的 Add-Ins 可编程定制： • 通过快捷菜单执行的 Add-Ins通过快捷菜单命令，可在项目树、“设备与网络”(Devices & networks) 编辑器和 “库”(Libraries)任务卡中运行这些 Add-Ins。此外，在版本控制接口 (VCI) 的工作区编辑 器中，也可通过快捷菜单执行这些 Add-Ins。 •Add-Ins 与工作流一同执行 这些 Add-Ins 无需显式调用。如果某些工作流中包含并激活有相应 Add-Ins，则这些AddIns 将随相关的工作流一同运行。例如，如果工作流为“编译”，可以编写相应的 Add-Ins 程序，在特定点执行附加功能。 通过API，可使用 Add-In 访问 TIA Portal 的反馈服务，以便向 Add-In 用户发送消息，例如，错误消息或进度消息等。 另请参见：Add-In API 的基本知识 (页 178) 工作流 Add-Ins 程序可编写以下工作流 Add-Ins 程序： • 版本控制接口：工作区编辑器中的拖放操作和同步 另请参见：“扩展工作流” 有关工作流Add-Ins 程序编写的具体操作，请参见在线帮助中的相应章节。组态现有外部应用程序 要更改现有外部应用程序，请按以下步骤操作： 1.在菜单“工具 > 外部应用程序”(Tools > External Applications)中单击“组态”(Configure) 命令 或在菜单“选项 > 设置 > 外部应用程序”(Options >Settings > External Applications) 中打开 外部应用程序列表。在工作区中，随即显示应用程序列表。 2. 选择要更改的外部应用程序。 3. 单击“更改所选应用程序”(Change selectedapplication) 按钮，或在快捷菜单中选择“编 辑”(Edit)。 “更改外部应用程序”(Change externalapplication) 对话框随即打开。4. 根据需要更改组态。 5. 单击“更改”(Change)。更改列表中外部应用程序的顺序。 要更改列表中和“工具 > 外部应用程序”(Tools > ExternalApplications) 菜单中的外部应用程 序的顺序，请执行以下步骤： 1. 在菜单“工具 > 外部应用程序”(Tools> External Applications) 中单击“组态”(Configure) 命令 或在菜单“选项 > 设置> 外部应用程序”(Options > Settings > External Applications) 中打开外部应用程序列表。 在工作区中，随即显示应用程序列表。 2. 选择要更改其位置的外部应用程序。 3. 单击“上移”(Up)在列表中上移应用程序的位置，或从快捷菜单中选择“上移”(Up) 命令。 4. 单击“下移”(Down)在列表中下移应用程序的位置，或从快捷菜单中选择“下移”(Down) 命令。 5. 重复该步骤，使所有应用程序都更改为需要的顺序。删除现有外部应用程序 要删除现有外部应用程序，请按以下步骤操作： 1. 在菜单“工具 > 外部应用程序”(Tools >External Applications) 中单击“组态”(Configure) 命令 或在菜单“选项 > 设置 >外部应用程序”(Options > Settings > External Applications) 中打开外部应用程序列表。 在工作区中，随即显示应用程序列表。 2. 选择要删除的外部应用程序。 3. 单击“删除所选应用程序”(Deleteselected application) 按钮，或在快捷菜单中选择“删 除”(Delete) 命令。随即打开“确认删除”(Confirm Delete) 对话框。 4. 单击“是”(Yes) 删除外部应用程序。
运行 Add-In时的问题处理机制 如果运行 Add-In 时出错，系统在巡视窗口的“常规 > 信息”(General > Info)选项卡中显示错 误信息。根据错误类型生成崩溃报告，可通过“转到”(Go to) 列中的链接访问此报告。 TIA PortalAdd-In Development Tools Add-Ins 的编程工作通过 C# 编程语言完成。可以手动创建 C#项目以及所需的类和方法，也 可以使用 TIA Portal Add-In Development Tools。使用 TIAPortal Add-In Development Tools 可以更轻松地完成以下任务： • 创建 C# 项目可以使用项目模板来创建 Add-In 的 C# 项目。 • 创建程序代码 可以使用代码模板来创建所需 Add-In类型的程序框架。然后对所需的功能进行编程。 • 编译和调试 使用 TIA Portal Add-In DevelopmentTools 可以轻松编译和调试程序代码。 在 Microsoft Visual Studio 2019 或 2022 或 VisualStudio Code 中使用 TIA Portal Add-In Development Tools。 有关 TIA PortalAdd-In Development Tools 以及所需安装文件的更多信息，请参见 TIA Portal 安装包的 DVD2，路径为：“DVD > 支持 > TIA_Portal_Add-In_Tools > 开发”(DVD >Support > TIA_Portal_Add-In_Tools > Development)。 批量推送Add-Ins Add-Ins 可以通过批量推送机制在企业内分发。为此，Add-In 管理员需要将 Add-Ins 放置到定义的网络驱动器上。通过使用服务，这些 Add-Ins 被复制到Zui终用户的“CorporateAddIns” 目录。另请参见：批量推送 Corporate Add-Ins 的基本知识。④ “状态”下拉列表 ⑤ “详细信息”窗格 ⑥ “证书”区域 ⑦“所需权限”区域 工具栏 使用工具栏中的按钮可以执行以下操作： • 打开组态视图 • 更新 Corporate Add-Ins •更改窗格模式 “Corporate Add-Ins”文件夹 “CorporateAdd-Ins”文件夹中，包含有通过批量推送分发的所有 Add-Ins。如果无法与管理 Corporate Add-Ins的网络驱动器进行同步，则该文件夹上将显示一个符号。此时，可通过 工具栏中的“更新 Corporate Add-Ins”(UpdateCorporate Add-Ins) 按钮进行手动同步。 “Add-Ins”文件夹“Add-Ins”文件夹列出了用户已经复制到安装目录的“AddIns”文件夹中的 Add-Ins。 “状态”下拉列表两个窗格中均包含有“状态”(Status) 下拉列表。在此激活或禁用 Add-Ins。 “详细信息”窗格在“详细信息”窗格中，将显示所选元素的信息。 “证书”区域 有关所用证书的信息，将显示在“证书”(Certificates)区域内。单击链接“查看证书”(View certificate)，可显示该证书。“所需权限”区域 有关使用所选 Add-In时所需的权限信息，将显示在“所需权限”(Required permissions) 区域 中： • Add-In作者指定的权限，将显示在“常规权限”(General permissions) 区域中。 • 相应工作流中定义的工作流 Add-Ins权限，将显示在“工作流权限”(Workflow permissions) 区域中。工作流 Add-In的作者对此无任何影响。Add-Ins 编程简介 简介 通过 Add-Ins，可在 TIA Portal中集成各种用户自定义功能。此时，即可通过快捷菜单将这 些功能集成到 TIA Portal的用户界面中，也使用这些功能对既定工作流进行扩展。用户可编 辑以下区域的快捷菜单： • 项目树 • “库”(Libraries)任务卡：项目库和全局库 • 硬件与网络编辑器 • Version Control Interface 工作区在此，可定义需显示的可点击元件，或定义该元件的执行条件。在快捷菜单中，可使用以下元素： • 子菜单 • 可单击的简单按钮 •带复选框的按钮 • 带选项按钮的按钮 有关使用 Add-Ins 扩展的工作流的信息，请参见“Add-Ins 的基本信息(页 151)”。 使用 C# 和 TIA Portal Openness API，可创建 Add-In的程序代码。为此，需创建一个类库， 稍后可以从中生成 .addin 文件。本帮助文档中的说明和示例使用 MicrosoftVisual Studio 实 现此操作。使用其它开发环境时，如有任何疑问，请参阅该开发系统的相关文档。 要求 要编写 TIAPortal Add-In 程序，需具备以下技能： • 具有 C# 和 .NET 的基本知识 • 了解 TIA PortalOpenness 创建程序概述 编写 Add-In 程序时，需要先生成一个 C# 项目并插入所需的引用。Add-In 至少需包含以下两种类别： • 视图提供程序：在此类别中，可定义快捷菜单的显示区域。每个区域都需要单独编写一 个提供程序，即单独的类： –ProjectTreeAddInProvider：项目树 – GlobalLibraryTreeAddInProvider：全局库 –ProjectLibraryTreeAddInProvider：项目库 –DevicesAndNetworksAddInProvider：硬件与网络编辑器 –VciEditorAddInProvider：Version Control Interface 工作区 •快捷菜单：在此类中，可定义快捷菜单及其条目。如果 Add-In 的应用并不广泛，则可在 此类中创建程序代码。 使用 C# 和 TIAPortal Openness API，编写自定义按钮的可执行程序代码。此外，还可在 XML 格式的组态文件中，组态以下信息： •产品相关信息：名称、ID、版本 • 权限。