Feliratkozás és várakozás a munkafolyamatok http-webhookok használatával történő futtatására az Azure Logic Appsben
A következőkre vonatkozik: Azure Logic Apps (Használat + Standard)
Ahelyett, hogy olyan eseményindítót használ, amely rendszeresen ellenőriz vagy lekérdez egy olyan szolgáltatásvégpontot vagy műveletet, amely meghívja az adott végpontot, használhat http-webhook-eseményindítót vagy műveletet, amely feliratkozik egy szolgáltatásvégpontra, vár adott eseményekre, és futtat bizonyos műveleteket a munkafolyamatban.
Íme néhány példa webhookalapú munkafolyamatokra:
- Várjon, amíg egy esemény megérkezik az Azure Event Hubsból, mielőtt elindít egy munkafolyamat-futtatást.
- Várjon egy jóváhagyást, mielőtt folytatná a munkafolyamatot.
Ez az útmutató bemutatja, hogyan használhatja a HTTP Webhook-eseményindítót és a Webhook műveletet, hogy a munkafolyamat fogadni tudja és megválaszolhassa az eseményeket egy szolgáltatásvégponton.
Hogyan működnek a webhookok?
A webhook eseményalapú eseményindító, amely nem függ az új adatok vagy események rendszeres ellenőrzésétől vagy lekérdezésétől. Miután hozzáadott egy webhook-eseményindítót egy üres munkafolyamathoz, majd mentette a munkafolyamatot, vagy miután újra engedélyezte a letiltott logikai alkalmazás-erőforrást, a webhook-eseményindító előfizet a megadott szolgáltatásvégpontra egy visszahívási URL-cím regisztrálásával az adott végponton. Az eseményindító ezután megvárja, amíg a szolgáltatásvégpont meghívja az URL-címet, amely elindítja az eseményindítót, és elindítja a munkafolyamatot. A Kérés eseményindítóhoz hasonlóan egy webhook-eseményindító azonnal aktiválódik. A webhook-eseményindító a szolgáltatásvégpontra is előfizetve marad, kivéve, ha manuálisan hajtja végre a következő műveleteket:
- Módosítsa az eseményindító paraméterértékeit.
- Törölje az eseményindítót, majd mentse a munkafolyamatot.
- Tiltsa le a logikai alkalmazás erőforrását.
A webhook-eseményindítóhoz hasonlóan a webhookművelet is eseményalapú. Miután hozzáadott egy webhook-műveletet egy meglévő munkafolyamathoz, majd mentette a munkafolyamatot, vagy miután újra engedélyezte a letiltott logikai alkalmazás-erőforrást, a webhook művelet feliratkozik a megadott szolgáltatásvégpontra egy visszahívási URL-cím regisztrálásával az adott végponton. A munkafolyamat futtatásakor a webhook művelet szünetelteti a munkafolyamatot, és megvárja, amíg a szolgáltatásvégpont meghívja az URL-címet, mielőtt a munkafolyamat újraindul. A webhook-művelet leiratkozik a szolgáltatásvégpontról a következő feltételek fennállásakor:
- A webhook művelet sikeresen befejeződött.
- A munkafolyamat futtatása a válaszra való várakozás során megszakad.
- Mielőtt egy munkafolyamat elfogyna, időtúllépés történik.
- Módosíthatja a webhook-eseményindító által bemenetként használt webhook-műveleti paraméterértékeket.
Az Office 365 Outlook-összekötő Jóváhagyási e-mail küldése művelete például az ezt a mintát követő webhook-műveletet szemlélteti. Ezt a mintát bármely szolgáltatásra kiterjesztheti a webhook művelet használatával.
További információkért tekintse meg a következő dokumentációt:
A logikai alkalmazásba irányuló bejövő hívások titkosításáról, biztonságáról és engedélyezéséről, például a Transport Layer Security (TLS), korábbi nevén Secure Sockets Layer (SSL) vagy a Microsoft Entra ID Open Authentication (Microsoft Entra ID OAuth) szolgáltatásról további információt a Biztonságos hozzáférés és adatok – Hozzáférés a kérésalapú eseményindítók bejövő hívásaihoz című témakörben talál.
Csatlakozás or műszaki referencia
Az eseményindító és a műveleti paraméterekkel kapcsolatos további információkért lásd a HTTP Webhook paramétereit.
Előfeltételek
Azure-fiók és -előfizetés. Ha nem rendelkezik Azure-előfizetéssel, regisztráljon egy ingyenes Azure-fiókra.
Egy már üzembe helyezett végpont vagy API URL-címe, amely támogatja a webhook előfizetési és leiratkozási mintáját a munkafolyamatokban futó webhook-eseményindítókhoz, illetve a munkafolyamatokban végzett webhookműveletek url-címe, ha szükséges
A Standard vagy a Consumption logikai alkalmazás munkafolyamata, ahol a célvégponton meg szeretne várni bizonyos eseményeket. A HTTP Webhook-eseményindítóval való kezdéshez hozzon létre egy logikai alkalmazást egy üres munkafolyamattal. A HTTP Webhook művelet használatához indítsa el a munkafolyamatot a kívánt eseményindítóval. Ez a példa első lépésként a HTTP-eseményindítót használja.
HTTP Webhook-eseményindító hozzáadása
Ez a beépített eseményindító meghívja a feliratkozási végpontot a célszolgáltatáson, és regisztrál egy visszahívási URL-címet a célszolgáltatásban. A munkafolyamat ezután megvárja, amíg a célszolgáltatás kérést HTTP POST küld a visszahívási URL-címre. Amikor ez az esemény bekövetkezik, az eseményindító aktiválódik, és átadja a kérelemben szereplő adatokat a munkafolyamatnak.
Az Azure Portalon nyissa meg a Standard logikai alkalmazást és az üres munkafolyamatot a tervezőben.
-
Ez a példa átnevezi az eseményindítót HTTP Webhook-eseményindítóra, hogy a lépésnek leíróbb neve legyen. A későbbi példa egy HTTP Webhook-műveletet is hozzáad, és mindkét névnek egyedinek kell lennie.
Adja meg az előfizetéshez és leiratkozáshoz használni kívánt HTTP Webhook triggerparaméterek értékeit.
Tulajdonság Kötelező Leírás Előfizetés – Metódus Igen A célvégpontra való feliratkozáskor használandó módszer Feliratkozás – URI Igen A célvégpontra való feliratkozáshoz használandó URL-cím Feliratkozás – törzs Nem Bármely üzenettörzs, amely szerepel az előfizetési kérelemben. Ez a példa magában foglalja a visszahívási URL-címet, amely egyedileg azonosítja az előfizetőt, vagyis a logikai alkalmazást a @listCallbackUrl()kifejezés használatával a logikai alkalmazás visszahívási URL-címének lekéréséhez.Leiratkozás – Metódus Nem A célvégpontról való leiratkozáskor használandó módszer Leiratkozás – URI Nem A célvégpontról való leiratkozáshoz használandó URL-cím Leiratkozás – Törzs Nem Választható üzenettörzs, amely szerepel a leiratkozási kérelemben
Megjegyzés: Ez a tulajdonság nem támogatja alistCallbackUrl()függvény használatát. Az eseményindító azonban automatikusan tartalmazza és elküldi a fejléceket,x-ms-client-tracking-idésx-ms-workflow-operation-nameamelyeket a célszolgáltatás az előfizető egyedi azonosítására használhat.Feljegyzés
A Leiratkozás – Metódus és Leiratkozás – URI tulajdonságok esetében adja hozzá őket a művelethez a Speciális paraméterek lista megnyitásával.
A következő eseményindító például tartalmazza azokat a metódusokat, URI-kat és üzenettörzseket, amelyek a feliratkozási és leiratkozási műveletek végrehajtásakor használhatók.
Ha hitelesítést szeretne használni, hozzáadhatja a Feliratkozás – Hitelesítés és Leiratkozás – Hitelesítési tulajdonságokat. A HTTP Webhook által elérhető hitelesítési típusokkal kapcsolatos további információkért lásd: Hitelesítés hozzáadása kimenő hívásokhoz.
Folytassa a munkafolyamat összeállítását az eseményindító aktiválásakor futtatott műveletekkel.
Ha végzett, mentse a munkafolyamatot. A tervező eszköztárán válassza a Mentés lehetőséget.
A munkafolyamat mentése meghívja a feliratkozási végpontot a célszolgáltatásban, és regisztrálja a visszahívási URL-címet. A munkafolyamat ezután megvárja, amíg a célszolgáltatás kérést HTTP POST küld a visszahívási URL-címre. Amikor ez az esemény bekövetkezik, az eseményindító aktiválódik, és átadja a kérelemben szereplő adatokat a munkafolyamatnak. Ha ez a művelet sikeresen befejeződött, az eseményindító leiratkozik a végpontról, és a munkafolyamat a következő műveletet folytatja.
HTTP-webhook-művelet hozzáadása
Ez a beépített művelet meghívja az előfizetési végpontot a célszolgáltatáson, és regisztrál egy visszahívási URL-címet a célszolgáltatásban. A munkafolyamat ezután szünetelteti és megvárja, amíg a célszolgáltatás kérést HTTP POST küld a visszahívási URL-címre. Amikor ez az esemény bekövetkezik, a művelet a kérelemben szereplő adatokat átadja a munkafolyamatnak. Ha a művelet sikeresen befejeződött, a művelet leiratkozik a végpontról, és a munkafolyamat a következő műveletet folytatja.
Ez a példa első lépésként a HTTP Webhook eseményindítót használja.
Az Azure Portalon nyissa meg a Standard logikai alkalmazást és a munkafolyamatot a tervezőben.
Az alábbi általános lépéseket követve adja hozzá a HTTP Webhook nevű műveletet a munkafolyamathoz.
Ez a példa átnevezi a műveletet HTTP Webhook műveletre , hogy a lépésnek leíróbb neve legyen.
Adja meg a HTTP Webhook-eseményindító paramétereihez hasonló HTTP Webhook műveleti paraméterek értékeit, amelyeket a feliratkozási és leiratkozási hívásokhoz használni szeretne.
Tulajdonság Kötelező Leírás Előfizetés – Metódus Igen A célvégpontra való feliratkozáskor használandó módszer Feliratkozás – URI Igen A célvégpontra való feliratkozáshoz használandó URL-cím Feliratkozás – törzs Nem Bármely üzenettörzs, amely szerepel az előfizetési kérelemben. Ez a példa magában foglalja a visszahívási URL-címet, amely egyedileg azonosítja az előfizetőt, vagyis a logikai alkalmazást a @listCallbackUrl()kifejezés használatával a logikai alkalmazás visszahívási URL-címének lekéréséhez.Leiratkozás – Metódus Nem A célvégpontról való leiratkozáskor használandó módszer Leiratkozás – URI Nem A célvégpontról való leiratkozáshoz használandó URL-cím Leiratkozás – Törzs Nem Választható üzenettörzs, amely szerepel a leiratkozási kérelemben
Megjegyzés: Ez a tulajdonság nem támogatja alistCallbackUrl()függvény használatát. A művelet azonban automatikusan tartalmazza és elküldi a fejléceket, valamintx-ms-workflow-operation-nameazokat,x-ms-client-tracking-idamelyeket a célszolgáltatás felhasználhat az előfizető egyedi azonosítására.Feljegyzés
A Leiratkozás – Metódus és Leiratkozás – URI tulajdonságok esetében adja hozzá őket a művelethez a Speciális paraméterek lista megnyitásával.
Az alábbi művelet például a feliratkozási és leiratkozási műveletek végrehajtásához használandó metódusokat, URI-kat és üzenettörzseket tartalmazza.
Egyéb művelettulajdonságok hozzáadásához nyissa meg a Speciális paraméterek listát.
Ha például hitelesítést szeretne használni, hozzáadhatja a Feliratkozás – Hitelesítés és Leiratkozás – Hitelesítési tulajdonságokat. A HTTP Webhook által elérhető hitelesítési típusokkal kapcsolatos további információkért lásd: Hitelesítés hozzáadása kimenő hívásokhoz.
Ha végzett, mentse a munkafolyamatot. A tervező eszköztárán válassza a Mentés lehetőséget.
A művelet futtatásakor a munkafolyamat meghívja a célszolgáltatás előfizetési végpontját, és regisztrálja a visszahívási URL-címet. A munkafolyamat ezután szünetelteti és megvárja, amíg a célszolgáltatás kérést HTTP POST küld a visszahívási URL-címre. Amikor ez az esemény bekövetkezik, a művelet a kérelemben szereplő adatokat átadja a munkafolyamatnak. Ha a művelet sikeresen befejeződött, a művelet leiratkozik a végpontról, és a munkafolyamat a következő műveletet folytatja.
Trigger- és műveletkimenetek
Az alábbiakban további információt talál a HTTP Webhook-eseményindítók vagy -műveletek kimeneteiről, amelyek a következő információkat adják vissza:
| Tulajdonság neve | Típus | Leírás |
|---|---|---|
| Fejlécek | object | A kérelem fejlécei |
| törzs | object | A kérelem törzstartalmat tartalmazó objektum |
| állapotkód | egész | A kérés állapotkódja |
| Állapotkód | Leírás |
|---|---|
| 200 | OK |
| 202 | Elfogadva |
| 400 | Hibás kérés |
| 401 | Nem engedélyezett |
| 403 | Forbidden |
| 404 | Nem található |
| 500 | Belső kiszolgálóhiba. Ismeretlen hiba történt. |