Azure Logic Apps 中的內建連接器
內建連接器可讓您控制工作流程的排程和結構、執行您自己的程式碼、管理或操作資料,以及完成工作流程中的其他工作。 不同於受控連接器,某些內建連接器不會繫結至特定服務、系統或通訊協定。 例如,您可以使用定期觸發程序,在排程上啟動幾乎任何工作流程。 或者,您可以讓工作流程等候到使用要求觸發程式呼叫為止。 所有內建連接器都會在 Azure Logic Apps 執行階段上以原生方式執行。 有些連接器不需要您在使用前先建立連線。
針對較少的服務、系統和通訊協定,Azure Logic Apps 提供內建版本以及受控版本。 內建連接器的數目和範圍會根據您建立在多租用戶 Azure Logic Apps 中所執行的取用邏輯應用程式工作流程,或是在單一租用戶 Azure Logic Apps 中所執行的標準邏輯應用程式工作流程而有所不同。 在大部分情況下,內建版本可提供更佳的效能、功能、定價等等。 在少數情況下,某些內建連接器只能在一個邏輯應用程式工作流程類型中使用,而無法在另一個邏輯應用程式工作流程類型中使用。
例如,標準工作流程可同時使用 Azure Blob 儲存體、Azure Cosmos DB、Azure 事件中樞、Azure 服務匯流排、FTP、IBM DB2、IBM MQ、SFTP 和 SQL Server 的受控連接器和內建連接器。 取用工作流程沒有內建版本。 取用工作流程可使用適用於 Azure API 管理和 Azure App Service 的內建連接器,而標準工作流程則沒有這些內建連接器。
在標準工作流程中,某些具有特定屬性的內建連接器稱為「服務提供者」(非正式名稱)。 某些內建連接器僅支援透過單一方法驗證與基礎服務的連線。 其他內建連接器可供選擇,例如使用連接字串、Microsoft Entra ID 或受控識別。 所有內建連接器皆在與 Azure Logic Apps 執行階段的同一個處理程序中執行。 如需詳細資訊,請檢閱 Azure Logic Apps 中的單一租用戶與多租用戶。
本文提供取用工作流程與標準工作流程中內建連接器的一般概觀。
內建的取用量與標準連接器
下表列出可供取用與標準工作流程使用之內建作業集合的目前和擴充資源庫。 針對標準工作流程,星號 (*) 會根據「服務提供者」模型標記內建連接器,稍後會進行更詳細的說明。
耗用 | 標準 |
---|---|
Azure API 管理 Azure App Service Azure Functions Azure Logic Apps 批次作業 控制 資料作業 日期時間 一般檔案 HTTP 內嵌程式碼 整合帳戶 Liquid 作業 要求 排程 變數 XML 作業 |
AS2 (v2) Azure AI 搜尋服務* Azure API 管理 Azure 自動化* Azure Blob 儲存體* Azure Cosmos DB* Azure 事件方格發佈者* Azure 事件中樞* Azure 檔案儲存體* Azure Functions Azure Key Vault* Azure OpenAI* Azure 佇列儲存體* Azure 服務匯流排* Azure 表格儲存體* 批次作業 控制 資料對應工具作業 資料作業 日期時間 EDIFACT 檔案系統* 一般檔案 FTP* HTTP IBM 3270* IBM CICS* IBM DB2* IBM 主機檔案* IBM IMS* IBM MQ* 內嵌程式碼 整合帳戶 JDBC* Liquid 作業 要求 RosettaNet SAP* 排程 SFTP* SMTP* SQL Server* SWIFT 變數 工作流程作業 X12 XML 作業 |
服務提供者型內建連接器
在標準工作流程中,具有下列屬性的內建連接器稱為「服務提供者」(非正式名稱):
以 Azure Functions 擴充性模型為基礎。
提供從標準工作流程到服務的存取權,例如 Azure Blob 儲存體、Azure 服務匯流排、Azure 事件中樞、SFTP 和 SQL Server。
某些內建連接器僅支援透過單一方法驗證與基礎服務的連線。 其他內建連接器可供選擇,例如使用連接字串、Microsoft Entra ID 或受控識別。
在與重新設計的 Azure Logic Apps 執行階段同一處理程序中執行。
服務提供者型內建連接器會與其受控連接器版本一起提供。
相反地,「不是服務提供者」的內建連接器具有下列屬性:
不以 Azure Functions 擴充性模型為基礎。
直接實作為 Azure Logic Apps 執行階段內的作業,例如排程、HTTP、要求和 XML 作業。
內建連接器的 HTTP
針對標準工作流程,您可以使用服務提供者型內建連接器所使用的相同內建連接器擴充性模型來建立自己的內建連接器,例如 Azure Blob 儲存體、Azure 事件中樞、Azure 服務匯流排、SQL Server 等等。 此介面實作是以 Azure Functions 擴充性模型為基礎,並且讓您能夠建立自訂的內建連接器,讓任何人員都可在標準工作流程中使用。
針對取用工作流程,您無法建立自己的內建連接器,但可建立自己的受控連接器。
如需詳細資訊,請參閱下列文件:
一般內建連接器
您可以使用下列內建連接器來執行一般工作,例如:
使用自訂和進階排程來執行工作流程。 如需關於排程的詳細資訊,請檢閱 Azure Logic Apps 中連接器的週期行為。
例如,使用迴圈和條件來組織及控制工作流程的結構。
使用變數、日期、資料作業、內容轉換和批次作業。
使用 HTTP 觸發程序和動作與其他端點進行通訊。
接收和回應要求。
呼叫您自己的函式 (Azure Functions) 或其他可接收要求的 Azure Logic Apps 工作流程等等。
[排程]
週期:根據指定的週期觸發工作流程。
滑動視窗
(僅取用工作流程)
觸發需要以連續區塊處理資料的工作流程。
延遲:在指定的持續時間內暫停工作流程。
延遲至:暫停工作流程,直到指定的日期和時間。
HTTP
使用 HTTP 觸發程式或動作呼叫 HTTP 或 HTTPS 端點。
您也可以使用這些其他的內建 HTTP 觸發程序和動作:
要求
收到 HTTP 要求時:等候來自另一個工作流程、應用程式或服務的要求。 此觸發程序讓您無須依排程檢查或輪詢即可呼叫工作流程。
回應:回應藉由相同工作流程中 [收到 HTTP 要求時] 觸發程序所收到的要求。
檔案系統
(僅標準工作流程)
連線到網路機器上的檔案系統,以建立和管理檔案。
FTP
(僅標準工作流程)
連線至 Azure 虛擬網路中的 FTP 或 FTPS 伺服器,以便使用檔案和資料夾。
SFTP
(僅標準工作流程)
連線至 Azure 虛擬網路中的 SFTP 伺服器,以便使用檔案和資料夾。
SMTP
(僅標準工作流程)
連線至 SMTP 伺服器,以便傳送電子郵件。
特定服務和系統的內建連接器
您可以使用下列內建連接器來存取特定服務和系統。 在標準工作流程中,其中一些內建連接器也稱為「服務提供者」(非正式名稱),這在某些方面可能與其受控連接器對應項目不同。
Azure AI 搜尋服務
(僅標準工作流程)
連線到 AI 搜尋,讓您可以在工作流程中執行文件的索引編製和搜尋作業。
Azure API 管理
呼叫使用 Azure API 管理所定義、管理及發佈 API 中的自有觸發程序和動作。
注意:使用 API 管理的取用層時不支援。
Azure App Service
(僅取用工作流程)
呼叫您在 Azure App Service 上建立及裝載的應用程式,例如 API Apps 和 Web Apps。
如果包含 Swagger,則這些應用程式所定義的動作與觸發程序看起來會像是 Azure Logic Apps 中任何其他第一級觸發程序和動作。
Azure 自動化
(僅標準工作流程)
連線到您的 Azure 自動化帳戶,以便建立和管理 Azure 自動化作業。
Azure Blob 儲存體
(僅標準工作流程)
連線到您的 Azure Blob 儲存體帳戶,以便建立和管理 Blob 內容。
Azure Cosmos DB
(僅標準工作流程)
連線至 Azure Cosmos DB 以便您能夠存取和管理 Azure Cosmos DB 文件。
Azure 事件方格發佈者
(僅標準工作流程)
使用 pub-sub 語意連線到 Azure 事件方格以進行事件型程式設計。
Azure 事件中樞
(僅標準工作流程)
透過事件中樞取用和發佈事件。 例如,透過事件中樞從工作流程取得輸出,然後將該輸出傳送給即時分析提供者。
Azure 檔案儲存體
(僅標準工作流程)
連線到您的 Azure 儲存體帳戶,以便建立、更新及管理檔案。
Azure Functions
呼叫 Azure 裝載的函 式,從工作流程執行您自己的程式碼 (C# 或 Node.js)。
Azure Key Vault
(僅標準工作流程)
連線到 Azure Key Vault,以儲存、存取及管理秘密。
Azure Logic 應用程式
(取用工作流程)
-或-
工作流程作業
(標準工作流程)
呼叫以名為 [收到 HTTP 要求時] 的「要求」觸發程式做為開頭的其他工作流程。
Azure OpenAI
(僅標準工作流程)
連線至 Azure OpenAI,以在大型語言模型上執行作業。
Azure 服務匯流排
(僅標準工作流程)
管理非同步訊息、佇列、工作階段、主題和主題訂用帳戶。
Azure 資料表儲存體
(僅標準工作流程)
連線到 Azure 儲存體帳戶,以便讓您建立、更新、查詢和管理表格。
Azure 佇列儲存體
(僅標準工作流程)
連線到您的 Azure 儲存體帳戶,以便建立、更新及管理佇列。
IBM 3270
(僅標準工作流程)
從您的工作流程呼叫 IBM 大型主機上的 3270 螢幕驅動應用程式。
IBM CICS
(僅標準工作流程)
從工作流程呼叫 IBM 大型主機上的 CICS 程式。
IBM DB2
(僅標準工作流程)
連線至雲端或內部部署中的 IBM DB2。 更新資料列、取得資料表等等。
IBM 主機檔案
(僅標準工作流程)
連線 IBM 主機檔案並產生或剖析內容。
IBM IMS
(僅標準工作流程)
從您的工作流程呼叫 IBM 大型主機上的 IMS 程式。
IBM MQ
(僅標準工作流程)
連線到 IBM MQ 內部部署或 Azure 以傳送及接收訊息。
JDBC
(僅標準工作流程)
使用 JDBC 驅動程式連線到關聯式資料庫。
SAP
(僅標準工作流程)
連線到 SAP,讓您可以傳送或接收訊息並叫用動作。
SQL Server
(僅標準工作流程)
連線到內部部署 SQL Server 或雲端中的 Azure SQL Database,以便管理記錄、執行預存程序,或執行查詢。
從工作流程執行程式碼
Azure Logic Apps 提供下列內建動作,可供您在工作流程中執行自有的程式碼:
Azure Functions
呼叫 Azure 裝載的函 式,從工作流程執行您自己的程式碼 (C# 或 Node.js)。
本機函式作業
(僅限標準工作流程)
從工作流程建立和執行 .NET Framework 程式碼。
控制工作流程
Azure Logic Apps 提供下列內建動作,可供您建構和控制工作流程中的動作:
Condition
評估條件,並根據條件是否成立來執行不同的動作。
套用至每一個
對陣列中的每個項目執行相同的動作。
Scope
將動作分成數個「範圍」,這些範圍會在範圍中的動作執行完成後取得自己的狀態。
Switch
將動作分成數個「案例」,這些案例會獲派唯一值 (預設案例除外)。 僅執行指派的值與運算式、物件或權杖的結果相符的案例。 如果沒有相符項目,則執行預設案例。
終止
停止正在執行的工作流程。
Until
重複此動作,直到指定的條件成立或某些狀態變更為止。
管理或操作資料
Azure Logic Apps 提供下列內建動作,以供使用資料輸出及其格式:
資料作業
執行資料相關作業。
區塊文字:將內容分割成片段,以用於 AI 解決方案或 AI 服務作業,例如 Azure OpenAI 和 Azure AI 搜尋作業。 如需詳細資訊,請參閱 剖析或區塊內容。
撰寫:從各種類型的多個輸入中建立單一輸出。
建立 CSV 資料表:從 JSON 物件陣列建立以逗號分隔 (CSV) 的資料表。
建立 HTML 資料表:從 JSON 物件陣列建立 HTML 資料表。
篩選陣列:從符合您準則的另一個陣列建立陣列。
加入:從陣列中的所有項目建立字串,並使用指定的分隔符號來分隔這些項目。
剖析檔:建立令牌化字串,以用於 AI 解決方案或 AI 服務作業,例如 Azure OpenAI 和 Azure AI 搜尋作業。 如需詳細資訊,請參閱 剖析或區塊內容。
剖析 JSON:從 JSON 內容中的屬性及其值,建立使用者易記的語彙基元,以便在您的工作流程中使用這些屬性。
選取:轉換另一個陣列中的項目或值,並將這些項目對應至指定的屬性,以建立 JSON 物件陣列。
日期時間
執行時間戳記相關作業。
新增至時間:將指定的單位數新增至時間戳記。
轉換時區:將時間戳記從來源時區轉換為目標時區。
目前時間:傳回目前的時間戳記作為字串。
取得未來時間:傳回目前時間戳記加上指定時間單位的結果。
取得過去時間:傳回目前時間戳記減去指定時間單位的結果。
從時間減去:從時間戳記減去時間單位數字。
變數
執行變數相關作業。
附加到陣列變數:插入一個值,作為變數所儲存陣列中的最後一個項目。
附加到字串變數:插入一個值,作為變數所儲存字串中的最後一個字元。
遞減變數:依常數值遞減變數。
遞增變數:依常數值遞增變數。
初始化變數:建立變數,並宣告其資料類型和初始值。
設定變數:將不同的值指派給現有的變數。
XML 作業
使用 XML 執行作業。
使用架構撰寫 XML:使用標準工作流程的架構從 JSON 建立 XML。
使用架構剖析 XML:使用標準工作流程的架構剖析 XML。
轉換 XML:使用對應轉換 XML。
驗證 XML:使用架構驗證輸入或輸出 XML。
企業對企業 (B2B) 內建作業
Azure Logic Apps 透過各種企業對企業 (B2B) 內建作業支援 B2B 通訊案例。 根據您是否有取用或標準工作流程和您想要使用的 B2B 作業,您可能必須建立整合帳戶,並將整合帳戶連結至邏輯應用程式資源。 接著,您可以使用此整合帳戶來定義 B2B 成品,例如合作對象、合約、地圖、結構描述、憑證等等。
取用工作流程
在工作流程中使用任何 B2B 作業之前,您必須先建立整合帳戶,並將整合帳戶連結至邏輯應用程式資源。 建立整合帳戶之後,您必須接著定義 B2B 成品,例如、合約、地圖、結構描述、憑證等等。 然後,您可以使用 B2B 作業來編碼和解碼訊息、轉換內容等等。
標準工作流程
某些 B2B 作業會要求您建立整合帳戶,並將整合帳戶連結至邏輯應用程式資源。 連結可讓您跨多個標準工作流程及其子工作流程共用成品。 根據您想要使用的 B2B 作業,請先完成下列其中一個步驟,然後再使用作業:
對於需要對應或結構描述的作業,您可以:
使用 Azure 入口網站或 Visual Studio Code 將這些成品上傳至邏輯應用程式資源。 然後,您可以在相同邏輯應用程式資源的所有子工作流程中使用這些成品。 如需詳細資訊,請檢閱新增對應以與 Azure Logic Apps 中的工作流程搭配使用,以及新增結構描述以與 Azure Logic Apps 中的工作流程搭配使用。
對於需要連線至整合帳戶的作業,請在您將作業新增至工作流程時建立連線。
如需詳細資訊,請參閱下列文件:
AS2 (v2)
(僅標準工作流程)
編碼和解碼使用 AS2 通訊協定的訊息。
EDIFACT
編碼和解碼使用 EDIFACT 通訊協定的訊息。
一般檔案
編碼和譯碼合作對象之間的 XML 訊息。
整合帳戶成品查閱
在您的整合帳戶中取得成品 (例如合作對象、合約、結構描述等等) 的自訂中繼資料。
Liquid 作業
使用 Liquid 範本來轉換下列格式:
- JSON 至 JSON
- JSON 至 TEXT
- XML 至 JSON
- XML 至 TEXT
RosettaNet
編碼和解碼使用 RosettaNet 通訊協定的訊息。
SWIFT
(僅標準工作流程)
編碼和解碼採用一般檔案 XML 訊息格式的環球銀行金融電信協會 (SIWFT) 交易。
X12
編碼和解碼使用 X12 通訊協定的訊息。
XML 作業
使用 XML 執行作業。
使用架構撰寫 XML:使用標準工作流程的架構從 JSON 建立 XML。
使用架構剖析 XML:使用標準工作流程的架構剖析 XML。
轉換 XML:使用對應轉換 XML。
驗證 XML:使用架構驗證輸入或輸出 XML。