納入 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_[ReleaseVersion]。
b. 按一下「組態」。
c. 透過下列設定，將新的列新增至 RemoteConnectionSettings 表中：
▪ ConnectionType - 輸入您要在 Controls Advisor 的「建立連線」視窗中，顯示的新伺服器類型或自訂連接器之名稱。例如 MyConnector。
▪ ResourceProviderName - 輸入在步驟 2 中建立的資源提供者物件。在此範例中則為 MyConnector_ResourceProviderThing。
▪ RemoteConnectionThingTemplateName - 輸入在步驟 3 中建立的物範本之名稱。在此範例中則為 My_Connector_ThingTemplate。
▪ EnabledInControlsAdvisor - 選取此核取方塊，以於 Controls Advisor 中顯示連線類型。
要停用連線類型的最佳作法，就是取消勾選表格列的核取方塊，而不是刪除該列。
▪ EnabledInTagPicker - 選取此核取方塊，以於標籤選取器一般元件中顯示連線類型。
 |
對於 RemoteConnectionSettings 表格中的每一列，ConnectionType、ResourceProviderName 與 RemoteConnectionThingTemplateName 的值必須具有唯一性。
|
現在只要按一下 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_[ReleaseVersion] 項目。
2. 在「組態」之下找到 RemoteConnectionSettings 組態表。
3. 在新伺服器或自訂連接器表的列中，只要點擊預設混搭名稱右側的「X」，即可移除下列欄位中所指定的預設混搭，並為各個混搭新增自己的自訂混搭：
◦ FooterMashupName - 適用於 Controls Advisor 頁尾的混搭
◦ ServerDetailMashupName - 適用於 詳細資訊頁面的混搭
◦ ConnectionInfoMashupName - 用於「建立連線」視窗的混搭
4. 按一下「儲存」。