建立連線
某些系統可能不支援 OAuth 機制。這些系統可能使用其他機制進行驗證，例如透過使用者名稱與密碼進行基礎驗證，或者可能支援以金鑰為基礎的機制。對於不支援 OAuth 的所有系統，都需要定義連線。
欲建立新連線，請執行下列操作：
1. 從指令提示中，執行下列指令：
a. cd <user project root directory>
b. flow add connection <name>
連線格式為 <service-name>-<connection-name>
服務名稱會由 CLI 自動新增。會在您的本機目錄中建立一個新資料夾：connector name-connection name，該資料夾中會包含 connection.json 檔案與 index.js 檔案。
此指令有下列選項可用。
|
選項
|
描述
|
資料類型
|
|---|---|---|
|
--version
|
顯示版本編號。
|
[布林值]
|
|
--help
|
顯示說明。
|
[布林值]
|
|
--parentDir,-d
|
專案的父目錄。
|
[預設："."]
|
|
--logLevel,-1
|
設定記錄層級。
|
[預設："info"]
|
|
--artifactVersion,-v
|
要建立的加工品的版本。
|
[預設："v1"]
|
2. 確定要連線至系統所需收集的資訊。
 |
資訊形式可以為 URL、使用者名稱、密碼或 App 金鑰，或連線至系統所需的其他任何資訊。
|
上述資訊必須在 connection.json 檔案中以 JSON 結構描述表示。ThingWorx Flow 使用此資訊來在 ThingWorx Flow 工作流程編輯器中顯示表單。
index.js 檔案會轉換儲存在表單中的資訊，以及「動作」與「觸發器」可以使用的資訊。由表單傳回的此資訊會加密並儲存在 ThingWorx Flow 資料庫中。
經過格式化的結構描述 connection.json 檔案與輸入表單會如下所示顯示：
下表描述 JSON 結構描述中使用的內容。
內容 | 在 JSON 檔案中輸入內容 |
|---|---|
type | 頂層類型應始終為 object 類型。 |
title | 在 ThingWorx Flow 首頁作為驗證視窗的標題使用。 |
format | 在 ThingWorx Flow 畫布上顯示表單時所使用的版面配置。 |
properties | 包含從使用者處取得，用來驗證目標系統的屬性。 這可以包含任意數量的子屬性。所有子屬性都必須有標題、類型及描述。類型可以是 JSON 結構描述支援的任何類型。 例如，我們可以看到電子郵件、subscription_id、account_url 及 API 權杖是連線至系統所必需。 |
契約
JavaScript 檔案 (例如 index.js) 必須匯出包含下列兩種方法的 JavaScript 物件：
• connect - 可將輸入轉換為適合供「動作」、「觸發器」與「查詢」使用的表單。
• validate - 可用來驗證連線。通常，您可以使用某些 API (例如 npm request 程式庫) 連線至目標系統。
如需可在「連線」中使用之 SDK for API 的相關資訊，請參閱
ThingWorx Flow 連接器 SDK 部份。
以下視訊用於示範如何使用 ThingWorx Flow CLI 建立連線。