在 Controls Advisor 中包括新的服务器类型或自定义连接器
Controls Advisor 可以展开以显示来自新服务器类型或自定义连接器的信息。
添加新的服务器类型或自定义连接器
1. 在 ThingWorx Composer 中，创建一个包含以下设置的新资源提供者事物模板：
◦ 名称 - 事物模板的名称，例如 MyConnector_ResourceProviderThingTemplate。
◦ 基本事物模板 - GenericThing
◦ 实现的事物形态 - PTC.SCA.SCO.RemoteConnectionResourceProviderThingShape
2. 创建资源提供者事物以实施步骤 1 中创建的事物模板：
◦ 名称 - 例如，MyConnector_ResourceProviderThing。
◦ 基本事物模板 - 指定在步骤 1 中新建的资源提供者事物模板。在本示例中为 MyConnector_ResourceProvider_ThingTemplate。
◦ 实现的事物形态 - 将此字段留空白。
3. 为您的新服务器类型或自定义连接器创建事物模板：
◦ 名称 - 例如，MyConnector_ThingTemplate。
◦ 基本事物模板 - RemoteThing
◦ 实现的事物形态 - PTC.SCA.SCO.RemoteConnectionThingShape。
4. 将新服务器类型或自定义连接器添加到启动点配置事物中。
a. 打开 PTC.Factory.C_LaunchPointConfigurationThing_[发布版本]。
b. 单击“配置”。
c. 在 RemoteConnectionSettings 表中添加一个包含以下设置的新行：
▪ ConnectionType - 输入新服务器类型或自定义连接器在 Controls Advisor 中的“创建连接”窗口中显示的名称。例如，MyConnector。
▪ ResourceProviderName - 输入在步骤 2 中创建的资源提供者事物。在本示例中为 MyConnector_ResourceProviderThing。
▪ RemoteConnectionThingTemplateName - 输入在步骤 3 中创建的事物模板名称。例如，MyConnector_ThingTemplate。
▪ EnabledInControlsAdvisor - 选中此复选框可使连接类型在 Controls Advisor 中可见。
最佳做法是：清除相应表行的复选框来禁用某个连接类型，而不是删除该行。
▪ EnabledInTagPicker - 选中此复选框可使该连接类型在标记选取器中可见。
 |
ConnectionType、ResourceProviderName 和 RemoteConnectionThingTemplateName 的值在 RemoteConnectionSettings 表的每一行必须都是唯一的。
|
现在，在 Controls Advisor 中单击 创建新服务器时，新的服务器类型或自定义连接器出现在“连接类型”下拉列表中。
用新服务器或自定义连接器中的数据填充 Controls Advisor 列
当创建新的服务器或自定义连接器时，仅在 Controls Advisor 主页中填充服务器详细信息页面的链接，以及“名称”、“状况”和“连接类型”的值。要填充其他列值，可转至在
添加新的服务器类型或自定义连接器的步骤 2 中创建的资源提供者事物，并改写其中 GetServerList 服务的实现。
在改写 GetServerList 服务时，可使用默认的服务实现作为参考。默认实施代码中包括详细注释，可以指引您进行自定义。
| | • Name 和 connectionType 属性为必需。 • Controls Advisor 主页上的表格由 PTC.SCA.SCO.RemoteConnectionServerListDataShape 数据形状控制。 |
针对每个新的服务器或自定义连接器自动填充以下属性，如果需要可覆盖：
属性名称 | Controls Advisor 中相应的列 |
|---|---|
Name | 名称 |
Description | 说明 |
connectionType | 连接类型 |
serverStatus | 状况 |
DetailsPageLink | 视图 |
下列属性需要对已改写的 GetServerList 服务进行一些修改，以在 Controls Advisor 主页上显示数据。
属性名称 | Controls Advisor 中相应的列 |
|---|---|
CurrentServerTime | 连接时间 |
AlertIcon | 警报 |
hasAlerts | （不显示）- 用于 AlertIcon 确定 |
以下属性专属于与设备进行交互的服务器或连接器。在大多数情况下，这些属性仅用于 KEPServerEX 类型服务器。
属性名称 | Controls Advisor 中相应的列 |
|---|---|
displayDevicesStatus | 设备状况 |
NumberOfDevices | 设备 |
clientCount | 客户端计数 |
aggregateThing | 聚合器名称 |
isCustomRemoteOPCServer | （不显示）- 用于内部计算 |
TagCount | 标记计数 |
isRemoteServer | （不显示）- 用于内部计算 |
devicesStatus | （不显示）- 用于 displayDeviceStatus 确定 |
为新服务器或自定义连接器执行自定义混搭
初次以新服务器或自定义连接器的“连接类型”创建新服务器时，“创建连接”窗口、Controls Advisor 页脚和新建服务器的“详细信息”页面上都会显示一条消息，提示尚未完成设置。以下部分提供了实施必要自定义混搭的说明。
要显示新服务器或自定义连接器对应的自定义混搭：
1. 在 ThingWorx Composer 中，打开 PTC.Factory.C_LaunchPointConfigurationThing_[发布版本]事物。
2. 在“配置”下，找到 RemoteConnectionSettings 表。
3. 在新服务器或自定义连接器对应的表行中，单击以下列中默认混搭名称右侧的 X 来删除指定的默认混搭，并为各列添加自定义的混搭：
◦ FooterMashupName - Controls Advisor 页脚的混搭
◦ ServerDetailMashupName -“详细信息”页面的混搭
◦ ConnectionInfoMashupName - “创建连接”窗口的混搭
4. 单击“保存”。