自定义标记选取器通用组件
标记选取器通用组件可通过以下方式进行自定义:
禁用对上次选择的保留
默认情况下,单个会话中会保留用户在标记选取器中的上一次选择。
要禁用对此次选择的保留:
1. 在 ThingWorx Composer 中打开 PTC.Factory.Administration.TagConfigurationUtils。
2. 在“属性”中,将 isEquipmentSelectionPreserved 属性的值更改为 false。
3. 单击“保存”。
浏览自定义连接器的数据
可对标记选取器通用组件进行自定义,以浏览来自自定义连接器的数据。
1. 要将新的连接器设备类型添加到“设备类型”下拉列表中,请在 ThingWorx Composer 中使用以下设置创建新的资源提供者事物模板:
◦ 名称 - 事物模板的名称,例如 My_Connector_ResourceProvider_Thing_Template。
◦ 基本事物模板 - GenericThing
◦ 实现的事物形态 - PTC.SCA.SCO.RemoteConnectionResourceProviderThingShape
◦ 单击“服务”,然后在新的事物模板中覆盖与 PTC.SCA.SCO.RemoteConnectionResourceProviderThingShape 事物形态相关的服务。对于每个服务,单击 添加连接器脚本以覆盖并编辑各服务。
▪ BindServerTags - 此服务用于将远程服务器中定义的标记与远程服务器事物的属性进行绑定。如果从未绑定过标记,则将创建新属性。如果不需要远程绑定,则不需要此服务。
▪ GetConnectedServers - (可选) 此服务用于检索指定事物模板所有已连接的服务器、资源或设备。(可选) 您也可为此服务提供自己的脚本,或者继续使用此服务。
▪ GetServerTags - 此服务用于浏览指定路径和类型筛选器的标记。
▪ GetServerTreeStructure - 此服务用于在树形结构中检索已连接服务器上指定节点的下一层。
▪ RemovePropertyBinding - (可选) 此服务用于删除服务器标记和目标事物之间的绑定。还可将属性本身从目标事物中移除。(可选) 您也可为此服务提供自己的脚本,或者继续使用此服务。
有关示例脚本,请参阅对 PTC.SCA.SCO.NITestStandResourceProviderThingTemplate 和 PTC.Factory.KepServerResourceProviderThingTemplate 执行的服务。
2. 创建资源提供者事物以实施步骤 1 中创建的事物模板:
◦ 名称 - 例如,My_Connector_ResourceProviderThing。
◦ 基本事物模板 - 指定在步骤 1 中新建的事物模板。在此示例中则为 My_Connector_ResourceProvider_Thing_Template。
3. 创建一个代表所要公开的远程事物的事物模板:
◦ 名称 - 例如 My_RemoteThing_ThingTemplate。
◦ 基本事物模板 - RemoteThing
4. 创建一个代表单个设备的远程事物:
◦ 名称 - 例如 My_NewEquipment。
◦ 基本事物模板 - 指定在步骤 3 中创建的事物模板。例如,My_RemoteThing_ThingTemplate。
5. 将新设备类型添加到启动点配置事物。
a. 打开 PTC.Factory.C_LaunchPointConfigurationThing_[发布版本]。
b. 单击“配置”。
c. 在 RemoteConnectionSettings 表中添加一个包含以下设置的新行:
▪ ConnectionType - 输入该连接类型在标记选取器“设备类型”下拉列表中的显示名称。例如 New Equipment Type。
▪ ResourceProviderName - 输入在步骤 2 中创建的资源提供者事物。在本示例中为 My_Connector_ResourceProviderThing。
▪ RemoteConnectionThingTemplateName - 输入表示步骤 3 中所创建远程事物的事物模板的名称。例如,My_RemoteThing_ThingTemplate。
▪ EnabledInTagPicker - 选中此复选框可使该连接类型在标记选取器中可见。
最佳做法是:清除相应表行的复选框来禁用某个设备类型,而不是删除该行。
| 新建的设备类型不会显示在标记选取器的“设备类型”下拉列表中,除非已连接的远程事物显示该设备类型。 |