Integration Connector 工具

代理程式可以使用連接器工具，透過在「整合連接器」中設定的連線執行動作。每個連接器工具都設定為單一連線和一或多個動作。如有需要，您可以為單一連線建立多個工具，將不同動作歸類在一起，供代理程式使用。

連接器工具支援下列連接器類型：

建立連線

如要建立連結，請按照下列步驟操作：

  • 從代理程式建構工具前往「工具」>「建立」
  • 選取「整合連接器」工具類型
  • 選取所選的連接器類型
  • 使用「建立連線」按鈕。

系統會將您導向整合連接器建立頁面，並預先填入多個欄位。

或者，您也可以前往「整合連接器」，然後按照操作說明建立連線。

連接器動作

每個連接器工具都有兩種動作，可供代理程式使用 (詳情請參閱「實體、作業和動作」)：

  1. 實體 CRUD 作業

    每個連線都有對應於該資料來源物件的「實體」(如果是 BigQuery，這些是資料表；如果是 Salesforce，這些是物件，例如「Order」或「Case」)。

    您可以對每個實體執行 CRUD 作業：

    • 建立：使用指定欄位值建立實體
    • 清單：根據篩選條件搜尋實體例項
    • 更新：以篩選器為基礎的方法，可變更實體欄位值
    • 刪除：刪除實體
    • Get 會使用 entityId
      擷取單一實體

    如要進一步瞭解實體 CRUD 作業的詳細資料，請參閱 Connectors 說明文件。

  2. 連接器專屬動作

    許多連接器都支援「ExecuteCustomQuery」動作，可對資料來源執行 SQL 查詢，其中每個資料來源實體都可以做為資料表參照。如需支援的連結器，請參閱這份清單。

    其他動作會因連接器類型而異，例如請參閱 BigQuery 連接器動作或 Salesforce 連接器動作。

設定 CRUD 作業的輸入 / 輸出欄位

為連結器工具動作選取要使用的特定輸入或輸出欄位，即可限制代理程式的這些動作複雜度。

舉例來說，如果您只需要使用部分欄位建立實體，在動作中設定這組欄位可簡化代理程式的動作。

指定一組輸出欄位可縮減工具回應大小 (如果擔心權杖限制，這會很有幫助)，並只公開相關欄位，簡化服務專員處理輸出的方式。

驗證

如果使用的連線已設定為允許驗證覆寫，則可設定工具，從指定的會期參數傳遞憑證。

您是代理程式建構者，有責任將這些憑證填入工作階段參數，工具會在呼叫工具動作時，自動將憑證傳遞至資料來源，以用於驗證。