Wbudowane łączniki w usłudze Azure Logic Apps
Wbudowane łączniki umożliwiają kontrolowanie harmonogramu i struktury przepływu pracy, uruchamianie własnego kodu, zarządzanie danymi lub manipulowanie nimi oraz wykonywanie innych zadań w przepływach pracy. Inaczej niż w przypadku łączników zarządzanych niektóre wbudowane łączniki nie są powiązane z określoną usługą, systemem ani protokołem. Można na przykład uruchomić niemal dowolny przepływ pracy zgodnie z harmonogramem przy użyciu wyzwalacza Cykl. Możesz też poczekać na wywołanie przepływu pracy przy użyciu wyzwalacza Żądania. Wszystkie wbudowane łączniki działają natywnie w środowisku uruchomieniowym usługi Azure Logic Apps. Niektóre nie wymagają utworzenia połączenia przed ich użyciem.
W przypadku mniejszej liczby usług, systemów i protokołów usługa Azure Logic Apps udostępnia wbudowaną wersję wraz z wersją zarządzaną. Liczba i zakres wbudowanych łączników różnią się w zależności od tego, czy tworzysz przepływ pracy aplikacji logiki Zużycie, który działa w wielodostępnej usłudze Azure Logic Apps, czy w standardowym przepływie pracy aplikacji logiki, który działa w usłudze Azure Logic Apps z jedną dzierżawą. W większości przypadków wbudowana wersja zapewnia lepszą wydajność, możliwości, ceny itd. W kilku przypadkach niektóre wbudowane łączniki są dostępne tylko w jednym typie przepływu pracy aplikacji logiki, a nie w drugim.
Na przykład standardowy przepływ pracy może używać łączników zarządzanych i wbudowanych łączników dla usług Azure Blob Storage, Azure Cosmos DB, Azure Event Hubs, Azure Service Bus, FTP, IBM DB2, IBM MQ, SFTP i SQL Server. Przepływ pracy Zużycie nie ma wbudowanych wersji. Przepływ pracy Zużycie może używać wbudowanych łączników dla usługi Azure API Management i usługi aplikacja systemu Azure, a standardowy przepływ pracy nie ma tych wbudowanych łączników.
Ponadto w standardowych przepływach pracy niektóre wbudowane łączniki z określonymi atrybutami są nieformalnie znane jako dostawcy usług. Niektóre wbudowane łączniki obsługują tylko jeden sposób uwierzytelniania połączenia z podstawową usługą. Inne wbudowane łączniki mogą oferować wybór, na przykład przy użyciu parametry połączenia, identyfikatora Entra firmy Microsoft lub tożsamości zarządzanej. Wszystkie wbudowane łączniki działają w tym samym procesie co środowisko uruchomieniowe usługi Azure Logic Apps. Aby uzyskać więcej informacji, zapoznaj się z artykułem Single-tenant versus multitenant in Azure Logic Apps (Pojedyncze dzierżawy i wielodostępne w usłudze Azure Logic Apps).
Ten artykuł zawiera ogólne omówienie wbudowanych łączników w przepływach pracy Zużycie i standardowych przepływów pracy.
Wbudowane łączniki w przypadku użycia i standardu
W poniższej tabeli wymieniono bieżące i rozszerzające galerie wbudowanych łączników dostępnych dla przepływów pracy Zużycie i Standardowe. W przypadku przepływów pracy w warstwie Standardowa gwiazdka (*) oznacza wbudowane łączniki oparte na modelu dostawcy usług, który został opisany bardziej szczegółowo w dalszej części.
| Zużycie | Standardowa |
|---|---|
| Usługa Azure API Management usługa aplikacja systemu Azure Azure Functions Azure Logic Apps Partia jakości Operacje na danych Data i godzina Plik prosty HTTP Kod wbudowany Konto integracji Ciecz Żądanie Harmonogram Zmiennych XML |
AS2 (wersja 2) Azure AI Search* Azure Automation* Azure Blob Storage* Azure Cosmos DB* Wydawca usługi Azure Event Grid* Azure Event Hubs* Azure File Storage* Azure Functions Azure Key Vault* Azure OpenAI* Azure Queue Storage* Azure Service Bus* Azure Table Storage* Operacje wsadowe jakości Operacje mapowania danych Operacje na danych Data i godzina EDIFACT System plików* Plik prosty FTP* HTTP IBM 3270* IBM CICS* IBM DB2* Plik hosta IBM* IBM IMS* IBM MQ* Kod wbudowany Konto integracji JDBC* Operacje liquid Żądanie RosettaNet SOK* Harmonogram SFTP* SMTP* SQL Server* SZYBKI Zmiennych Operacje przepływu pracy X12 Operacje XML |
Wbudowane łączniki oparte na dostawcy usług
W przypadku standardowych przepływów pracy wbudowany łącznik, który ma następujące atrybuty, jest nieformalnie znany jako dostawca usług:
Jest oparty na modelu rozszerzalności usługi Azure Functions.
Zapewnia dostęp z standardowego przepływu pracy do usługi, takiej jak Azure Blob Storage, Azure Service Bus, Azure Event Hubs, SFTP i SQL Server.
Niektóre wbudowane łączniki obsługują tylko jeden sposób uwierzytelniania połączenia z podstawową usługą. Inne wbudowane łączniki mogą oferować wybór, na przykład przy użyciu parametry połączenia, identyfikatora Entra firmy Microsoft lub tożsamości zarządzanej.
Działa w tym samym procesie co przeprojektowane środowisko uruchomieniowe usługi Azure Logic Apps.
Wbudowane łączniki oparte na dostawcy usług są dostępne wraz z ich zarządzanymi wersjami łączników.
Natomiast wbudowany łącznik, który nie jest dostawcą usług, ma następujące atrybuty:
Nie jest oparta na modelu rozszerzalności usługi Azure Functions.
Jest implementowany bezpośrednio jako zadanie w środowisku uruchomieniowym usługi Azure Logic Apps, takim jak harmonogram, http, żądanie i operacje XML.
Niestandardowe wbudowane łączniki
W przypadku standardowych przepływów pracy możesz utworzyć własny wbudowany łącznik z tym samym wbudowanym modelem rozszerzalności łącznika, który jest używany przez wbudowane łączniki oparte na dostawcy usług, takie jak Azure Blob Storage, Azure Event Hubs, Azure Service Bus, SQL Server i inne. Ta implementacja interfejsu jest oparta na modelu rozszerzalności usługi Azure Functions i zapewnia możliwość tworzenia niestandardowych wbudowanych łączników, których każdy może używać w standardowych przepływach pracy.
W przypadku przepływów pracy Zużycie nie można tworzyć własnych wbudowanych łączników, ale tworzysz własne łączniki zarządzane.
Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją:
- Łączniki niestandardowe w usłudze Azure Logic Apps
- Tworzenie niestandardowych wbudowanych łączników dla standardowych przepływów pracy
Ogólne wbudowane łączniki
Do wykonywania zadań ogólnych można użyć następujących wbudowanych łączników, na przykład:
Uruchamianie przepływów pracy przy użyciu niestandardowych i zaawansowanych harmonogramów. Aby uzyskać więcej informacji na temat planowania, zapoznaj się z artykułem Zachowanie cyklu łączników w usłudze Azure Logic Apps.
Organizowanie i kontrolowanie struktury przepływu pracy, na przykład przy użyciu pętli i warunków.
Praca ze zmiennymi, datami, operacjami danych, przekształceniami zawartości i operacjami wsadowymi.
Komunikacja z innymi punktami końcowymi przy użyciu wyzwalaczy i akcji HTTP.
Odbieranie żądań i odpowiadanie na nie.
Wywoływanie własnych funkcji (Azure Functions) lub innych przepływów pracy usługi Azure Logic Apps, które mogą odbierać żądania itd.
Zaplanuj
Cykl: wyzwalanie przepływu pracy na podstawie określonego cyklu.
Okno przesuwne
(Tylko przepływ pracy użycia)
Wyzwalanie przepływu pracy, który musi obsługiwać dane w ciągłych fragmentach.
Opóźnienie: Wstrzymaj przepływ pracy przez określony czas trwania.
Opóźnienie do: Wstrzymaj przepływ pracy do określonej daty i godziny.
HTTP
Wywołaj punkt końcowy HTTP lub HTTPS przy użyciu wyzwalacza HTTP lub akcji.
Możesz również użyć tych innych wbudowanych wyzwalaczy i akcji HTTP:
Zażądaj
Po odebraniu żądania HTTP: poczekaj na żądanie z innego przepływu pracy, aplikacji lub usługi. Ten wyzwalacz sprawia, że wywołanie przepływu pracy jest możliwe bez konieczności sprawdzania lub sondowania zgodnie z harmonogramem.
Odpowiedź: odpowiedz na żądanie odebrane przez wyzwalacz Po odebraniu żądania HTTP w tym samym przepływie pracy.
Batch
Komunikaty wsadowe: wyzwalacz przepływ pracy, który przetwarza komunikaty w partiach.
Wysyłanie komunikatów do partii: wywołaj istniejący przepływ pracy, który obecnie rozpoczyna się od wyzwalacza komunikatów usługi Batch.
System plików
(Tylko standardowy przepływ pracy)
Połącz się z systemem plików na maszynie sieciowej, aby utworzyć pliki i zarządzać nimi.
FTP
(Tylko standardowy przepływ pracy)
Połącz się z serwerem FTP lub FTPS w sieci wirtualnej platformy Azure, aby umożliwić pracę z plikami i folderami.
SFTP
(Tylko standardowy przepływ pracy)
Nawiąż połączenie z serwerem SFTP w sieci wirtualnej platformy Azure, aby umożliwić pracę z plikami i folderami.
SMTP
(Tylko standardowy przepływ pracy)
Połącz się z serwerem SMTP, aby móc wysyłać wiadomości e-mail.
Wbudowane łączniki dla określonych usług i systemów
Do uzyskiwania dostępu do określonych usług i systemów można użyć następujących wbudowanych łączników. W standardowych przepływach pracy niektóre z tych wbudowanych łączników są również nieformalnie znane jako dostawcy usług, które mogą różnić się od ich odpowiedników łączników zarządzanych w jakiś sposób.
Azure AI Search
(Tylko standardowy przepływ pracy)
Połącz się z wyszukiwaniem sztucznej inteligencji, aby móc wykonywać operacje indeksowania i wyszukiwania dokumentów w przepływie pracy.
Azure API Management
(Tylko przepływ pracy użycia)
Wywoływanie własnych wyzwalaczy i akcji w interfejsach API definiowanych, zarządzanych i publikowanych przy użyciu usługi Azure API Management.
Uwaga: Nieobsługiwane w przypadku korzystania z warstwy Zużycie dla usługi API Management.
Azure App Service
(Tylko przepływ pracy użycia)
Wywoływanie aplikacji tworzonych i hostujących w usłudze aplikacja systemu Azure Service, na przykład usługi API Apps i Web Apps.
Po dołączeniu struktury Swagger wyzwalacze i akcje zdefiniowane przez te aplikacje są wyświetlane jak wszystkie inne wyzwalacze i akcje pierwszej klasy w usłudze Azure Logic Apps.
Azure Automation
(Tylko standardowy przepływ pracy)
Nawiąż połączenie z kontami usługi Azure Automation, aby można było tworzyć zadania usługi Azure Automation i zarządzać nimi.
Azure Blob Storage
(Tylko standardowy przepływ pracy)
Nawiąż połączenie z kontem usługi Azure Blob Storage, aby można było tworzyć zawartość obiektów blob i zarządzać nią.
Azure Cosmos DB
(Tylko standardowy przepływ pracy)
Połącz się z usługą Azure Cosmos DB, aby uzyskać dostęp do dokumentów usługi Azure Cosmos DB i zarządzać nimi.
Wydawca usługi Azure Event Grid
(Tylko standardowy przepływ pracy)
Nawiąż połączenie z usługą Azure Event Grid w celu programowania opartego na zdarzeniach przy użyciu semantyki pub-sub.
Azure Event Hubs
(Tylko standardowy przepływ pracy)
Korzystanie z zdarzeń i publikowanie ich za pośrednictwem centrum zdarzeń. Na przykład pobierz dane wyjściowe z przepływu pracy za pomocą usługi Event Hubs, a następnie wyślij te dane wyjściowe do dostawcy analizy w czasie rzeczywistym.
Azure File Storage
(Tylko standardowy przepływ pracy)
Nawiąż połączenie z kontem usługi Azure Storage, aby można było tworzyć, aktualizować i zarządzać plikami.
Azure Functions
Wywołaj funkcje hostowane na platformie Azure, aby uruchamiać własne fragmenty kodu (C# lub Node.js) w przepływie pracy.
Azure Key Vault
(Tylko standardowy przepływ pracy)
Połącz się z usługą Azure Key Vault, aby przechowywać wpisy tajne, uzyskiwać do tego dostęp i zarządzać nimi.
Azure Logic Apps
(Przepływ pracy użycia)
— lub —
Operacje przepływu pracy
(Standardowy przepływ pracy)
Wywołaj inne przepływy pracy rozpoczynające się od wyzwalacza żądania o nazwie Po odebraniu żądania HTTP.
Azure OpenAI
(Tylko standardowy przepływ pracy)
Połącz się z usługą Azure OpenAI, aby wykonywać operacje na dużych modelach językowych.
Azure Service Bus
(Tylko standardowy przepływ pracy)
Zarządzanie komunikatami asynchronicznymi, kolejkami, sesjami, tematami i subskrypcjami tematów.
Azure Table Storage
(Tylko standardowy przepływ pracy)
Nawiąż połączenie z kontem usługi Azure Storage, aby można było tworzyć, aktualizować, wykonywać zapytania i zarządzać tabelami.
Azure Queue Storage
(Tylko standardowy przepływ pracy)
Nawiąż połączenie z kontem usługi Azure Storage, aby można było tworzyć, aktualizować kolejki i zarządzać nimi.
IBM 3270
(Tylko standardowy przepływ pracy)
Wywołaj aplikacje oparte na ekranie 3270 na komputerach mainframe IBM z przepływu pracy.
IBM CICS
(Tylko standardowy przepływ pracy)
Wywoływanie programów CICS na komputerach mainframe IBM z przepływu pracy.
IBM DB2
(Tylko standardowy przepływ pracy)
Łączenie z bazą danych IBM DB2 w chmurze lub lokalnie. Zaktualizuj wiersz, pobierz tabelę i nie tylko.
Plik hosta IBM
(Tylko standardowy przepływ pracy)
Połącz się z plikiem hosta IBM i wygeneruj lub przeanalizuj zawartość.
IBM IMS
(Tylko standardowy przepływ pracy)
Wywoływanie programów IMS na komputerach mainframe IBM z przepływu pracy.
IBM MQ
(Tylko standardowy przepływ pracy)
Połącz się z lokalnym rozwiązaniem IBM MQ lub na platformie Azure, aby wysyłać i odbierać komunikaty.
JDBC
(Tylko standardowy przepływ pracy)
Nawiąż połączenie z relacyjną bazą danych przy użyciu sterowników JDBC.
SAP
(Tylko standardowy przepływ pracy)
Nawiąż połączenie z oprogramowaniem SAP, aby móc wysyłać lub odbierać komunikaty i wywoływać akcje.
SQL Server
(Tylko standardowy przepływ pracy)
Połącz się z lokalną usługą SQL Server lub Azure SQL Database w chmurze, aby zarządzać rekordami, uruchamiać procedury składowane lub wykonywać zapytania.
Uruchamianie kodu z przepływów pracy
Usługa Azure Logic Apps udostępnia następujące wbudowane akcje do uruchamiania własnego kodu w przepływie pracy:
Azure Functions
Wywołaj funkcje hostowane na platformie Azure, aby uruchamiać własne fragmenty kodu (C# lub Node.js) w przepływie pracy.
Kod wbudowany
Dodawanie i uruchamianie wbudowanych fragmentów kodu JavaScript z przepływu pracy.
Operacje funkcji lokalnych
(Tylko standardowy przepływ pracy)
Utwórz i uruchom kod programu .NET Framework na podstawie przepływu pracy.
Kontrolowanie przepływu pracy
Usługa Azure Logic Apps udostępnia następujące wbudowane akcje do tworzenia struktury i kontrolowania akcji w przepływie pracy:
Warunek
Oceń warunek i uruchom różne akcje na podstawie tego, czy warunek ma wartość true, czy false.
Dla każdego
Wykonaj te same akcje na każdym elemencie w tablicy.
Scope
Grupuj akcje w zakresy, które uzyskują własny stan po zakończeniu działania akcji w zakresie.
Switch
Grupuj akcje w przypadkach, które są przypisane unikatowe wartości z wyjątkiem przypadku domyślnego. Uruchom tylko ten przypadek, którego przypisana wartość jest zgodna z wynikiem wyrażenia, obiektu lub tokenu. Jeśli nie istnieją dopasowania, uruchom przypadek domyślny.
Zakończ
Zatrzymaj aktywnie uruchomiony przepływ pracy.
Aż do
Powtarzaj akcje, dopóki określony warunek nie zostanie spełniony lub jakiś stan uległ zmianie.
Zarządzanie danymi lub manipulowanie nimi
Usługa Azure Logic Apps udostępnia następujące wbudowane akcje do pracy z danymi wyjściowymi danych i ich formatami:
Operacje na danych
Wykonywanie operacji przy użyciu danych.
Redagowanie: utwórz pojedyncze dane wyjściowe z wielu danych wejściowych z różnymi typami.
Tworzenie tabeli CSV: utwórz tabelę wartości rozdzielanej przecinkami (CSV) z tablicy z obiektami JSON.
Tworzenie tabeli HTML: utwórz tabelę HTML na podstawie tablicy z obiektami JSON.
Tablica filtrów: utwórz tablicę na podstawie elementów w innej tablicy spełniającej kryteria.
Sprzężenia: utwórz ciąg ze wszystkich elementów w tablicy i rozdziel te elementy określonym ogranicznikiem.
Analizowanie kodu JSON: utwórz przyjazne dla użytkownika tokeny na podstawie właściwości i ich wartości w zawartości JSON, aby można było używać tych właściwości w przepływie pracy.
Wybierz: Utwórz tablicę z obiektami JSON, przekształcając elementy lub wartości w innej tablicy i mapując te elementy na określone właściwości.
Data i godzina
Wykonywanie operacji ze znacznikami czasu.
Dodaj do czasu: dodaj określoną liczbę jednostek do znacznika czasu.
Konwertuj strefę czasową: konwertuj znacznik czasu ze źródłowej strefy czasowej na docelową strefę czasową.
Bieżąca godzina: zwraca bieżący znacznik czasu jako ciąg.
Uzyskaj przyszły czas: zwróć bieżący znacznik czasu oraz określoną liczbę jednostek czasu.
Pobierz czas przeszłości: zwróć bieżący znacznik czasu minus określoną liczbę jednostek czasu.
Odejmowanie od czasu: odejmij liczbę jednostek czasu z znacznika czasu.
Zmienne
Wykonywanie operacji ze zmiennymi.
Dołącz do zmiennej tablicy: wstaw wartość jako ostatni element w tablicy przechowywanej przez zmienną.
Dołącz do zmiennej ciągu: wstaw wartość jako ostatni znak w ciągu przechowywanym przez zmienną.
Zmienna dekrementacji: Zmniejsz zmienną o stałą wartość.
Zmienna przyrostowa: zwiększ zmienną o stałą wartość.
Inicjowanie zmiennej: utwórz zmienną i zadeklaruj jej typ danych i wartość początkową.
Ustaw zmienną: przypisz inną wartość do istniejącej zmiennej.
Wbudowane operacje między firmami (B2B)
Usługa Azure Logic Apps obsługuje scenariusze komunikacji między firmami (B2B) za pośrednictwem różnych wbudowanych operacji B2B. Na podstawie tego, czy masz przepływ pracy Zużycie, czy Standardowy oraz operacje B2B, których chcesz użyć, może być konieczne utworzenie i połączenie konta integracji z zasobem aplikacji logiki. Następnie użyjesz tego konta integracji, aby zdefiniować artefakty B2B, takie jak partnerzy handlowi, umowy, mapy, schematy, certyfikaty itd.
Przepływy pracy użycia
Aby móc używać dowolnych operacji B2B w przepływie pracy, musisz utworzyć i połączyć konto integracji z zasobem aplikacji logiki. Po utworzeniu konta integracji należy zdefiniować artefakty B2B, takie jak partnerzy handlowi, umowy, mapy, schematy, certyfikaty itd. Następnie możesz użyć operacji B2B, aby kodować i dekodować komunikaty, przekształcać zawartość i nie tylko.
Standardowe przepływy pracy
Niektóre operacje B2B wymagają utworzenia i połączenia konta integracji z zasobem aplikacji logiki. Łączenie umożliwia udostępnianie artefaktów w wielu standardowych przepływach pracy i ich podrzędnych przepływach pracy. Na podstawie operacji B2B, której chcesz użyć, przed użyciem operacji wykonaj jedną z następujących czynności:
W przypadku operacji wymagających map lub schematów można wykonać następujące czynności:
Przekaż te artefakty do zasobu aplikacji logiki przy użyciu witryny Azure Portal lub programu Visual Studio Code. Następnie możesz użyć tych artefaktów we wszystkich podrzędnych przepływach pracy w tym samym zasobie aplikacji logiki. Aby uzyskać więcej informacji, zobacz Dodawanie map do użycia z przepływami pracy w usłudze Azure Logic Apps i Dodawanie schematów do użycia z przepływami pracy w usłudze Azure Logic Apps.
Połącz zasób aplikacji logiki z kontem integracji.
W przypadku operacji wymagających połączenia z kontem integracji utwórz połączenie podczas dodawania operacji do przepływu pracy.
Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją:
- Przepływy pracy integracji z firmą (B2B) dla przedsiębiorstw
- Tworzenie kont integracji dla przepływów pracy B2B i zarządzanie nimi
AS2 (wersja 2)
(Tylko standardowy przepływ pracy)
Kodowanie i dekodowanie komunikatów używających protokołu AS2.
EDIFACT
Kodowanie i dekodowanie komunikatów korzystających z protokołu EDIFACT.
Flat File
Kodowanie i dekodowanie komunikatów XML między partnerami handlowymi.
Wyszukiwanie artefaktu konta integracji
Pobierz niestandardowe metadane artefaktów, takich jak partnerzy handlowi, umowy, schematy itd., na koncie integracji.
Operacje liquid
Przekonwertuj następujące formaty przy użyciu szablonów Liquid:
- JSON do JSON
- JSON do TEKSTU
- XML do JSON
- XML to TEXT
RosettaNet
Kodowanie i dekodowanie komunikatów używających protokołu RosettaNet.
SZYBKI
(Tylko standardowy przepływ pracy)
Kodowanie i dekodowanie transakcji Society for Worldwide Interbank Financial Telecommuncation (SIWFT) w formacie komunikatów XML prostego pliku.
Przekształcanie kodu XML
Przekonwertuj źródłowy format XML na inny format XML.
X12
Kodowanie i dekodowanie komunikatów używających protokołu X12.
Walidacja kodu XML
Zweryfikuj dokumenty XML względem określonego schematu.