建立整合連接器
欲建立整合連接器，請執行下列動作：
1. 從 Composer 瀏覽 > ，然後按一下「新建」。
2. 選取下列物範本之一，然後按一下「確定」：
◦ GenericConnector
◦ HTTPConnector
◦ ODataConnector
◦ SAPODataConnector
◦ SwaggerConnector
◦ WindchillSwaggerConnector
如需上述物範本的詳細資訊，請參閱整合連接器概觀。
3. 輸入名稱與描述。
4. 根據所選物範本，在「組態」區域中建立與後端系統的連線。
|
物範本
|
描述
|
||||
|---|---|---|---|---|---|
|
「泛用連接器連線設定」
|
• 「重新整理間隔 (分鐘)」：指定重新整理端點快取的間隔。預設值為 60 分鐘。
• 「驗證類型」：輸入下列其中一項：
◦ 「無」
◦ 「固定」
此驗證類型需要使用後端應用程式上的服務帳戶。此帳戶不是實際的使用者；其目的在於提供存取另一個應用程式的能力。所有來自 ThingWorx 應用程式的存取動作都會使用後端應用程式上的此服務帳戶。
◦ SSO
詳情請參閱單一登入驗證。
• 「授權伺服器 ID」：僅適用於 SSO 驗證類型。
輸入欲連線的驗證伺服器的 ID。
針對 SSO 配置 ThingWorx 時，此 ID 由伺服器管理員指派。欲擷取此值，請參閱安裝 ThingWorx 所在的 sso-settings.json 檔案中的 authServerId.clientID 設定所使用的 <authServerId> 變數。欲請求授權伺服器 ID，可與您的 Apache Tomcat 伺服器管理員聯繫。
如需詳細資訊，請參閱配置 sso-settings.json 主題。
|
||||
|
「CSRF 設定」
|
在下列欄位中輸入值：
• 「CSRF 取得請求的相對 URL」
設定相對於基礎 URL 的值，CSRF 權杖將作為回應標題傳回。透過使用 Google Postman 外掛程式等工具發出 GET 請求來驗證 URL。請確保指定在進行請求時，後端系統將在其中傳回 CSRF 權杖的標題。將請求標題的值設定為 Fetch。回應應包含其值為有效權杖的標題。
例如，對於套用了 Windchill REST Services (WRS) 修補程式的 Windchill 實例，此組態的值可像 servlet/odata 一樣簡單。
• 「CSRF 權杖名稱」
後端系統將在其中傳回 CSRF 權杖之標題的名稱。對於帶有 WRS 的 Windchill 系統，標題的名稱為 CSRF_NONCE。
|
||||
|
「HTTP 連接器連線設定」：僅適用於「固定」驗證類型。
|
• 在下列欄位中輸入值：
◦ 「使用者名稱」
◦ 「密碼」
◦ 「確認密碼」
OData 後端系統的服務路由 URL。如果您有多個網域，請輸入多個列。若輸入下列「相對 URL」，該 URL 會用來作為路徑的一部份。
例如，若「相對 URL」是 /servlet/odata，且「服務路由 URL」是 /ProdMgmt 和 /DataAdmin，則相對於基礎 URL 的有效服務 URL 會是 /servlet/odata/ProdMgmt 和 /servlet/odata/DataAdmin。這些服務路由 URL 指定一或多個 OData 規格。系統會針對每個服務路由 URL 附加 /$metadata 路徑，並要求提供資源，以擷取 OData 規格。
• 針對所有驗證類型，在下列 URL 欄位中輸入資訊。如果物範本已提供預設值，請勿變更值。例如，為 SAPODataConnector 提供「相對 URL」與「連線 URL」。它們指向規格所在的目錄服務。
◦ 「基礎 URL」：必須使用基礎 URL 才能存取後端系統。這包括後端系統的主機、埠和應用程式。
若是 SSO，請輸入支援 OAuth 的 URL。詳情請參閱使用範圍。
◦ 「相對 URL」：提供 API 所在的 URL (相對於基礎 URL)。
◦ 「連線 URL」：用於確認連線的 URL (相對於「基礎 URL」)。
「擷取舊有資料」：如果未選取此核取方塊，將會顯示新顯露的參數。系統會根據最新對應在端點定義中引入新參數。如需詳細資訊，請參閱內容基礎類型。預設會選取此核取方塊。
|
||||
|
「OData 連接器連線設定」：僅適用於 ODataConnector
|
|||||
|
SAPODataConnector
|
|||||
|
「Swagger 連接器連線設定」
|
• 「Swagger 規格的相對 URL」：用於從後端系統取得 Swagger 規格的 URL。它相對於「基礎 URL」。
|
在「授權伺服器範圍設定」下：僅適用於 SSO 驗證類型。
輸入與授權伺服器中顯示的內容完全相同的範圍名稱。這些範圍是在資源提供者處定義，並在驗證伺服器上註冊。詳情請參閱使用範圍。
5. 繼續進行顯露整合連接器上的服務。
6. 按一下「儲存」。
 |
可從 > > 取得連線狀況資訊。詳情請參閱監視整合連接器的狀況。
|