Skapa loopar för att upprepa åtgärder i arbetsflöden med Azure Logic Apps
Gäller för: Azure Logic Apps (Förbrukning + Standard)
Azure Logic Apps innehåller följande loopåtgärder som du kan använda i arbetsflödet:
Om du vill upprepa en eller flera åtgärder för objekt i en matris lägger du till åtgärden För varje i arbetsflödet.
Om du har en utlösare som tar emot en matris och vill köra en iteration för varje matrisobjekt kan du också diskutera matrisen med egenskapen SplitOn-utlösare.
Om du vill upprepa en eller flera åtgärder tills ett villkor uppfylls eller ett tillstånd ändras lägger du till åtgärden Till i arbetsflödet.
Arbetsflödet kör först alla åtgärder i loopen och kontrollerar sedan villkoret eller tillståndet. Om villkoret uppfylls stoppas loopen. Annars upprepas loopen. För standard- och maxgränser för antalet Until-loopar som ett arbetsflöde kan ha, se Begränsningar för samtidighet, loopning och utfasning.
Förutsättningar
Ett Azure-konto och prenumeration. Om du inte har någon prenumeration kan du registrera ett kostnadsfritt Azure-konto.
Grundläggande kunskaper om arbetsflöden för logikappar
För varje
Åtgärden För varje fungerar bara på matriser och upprepar en eller flera åtgärder för varje objekt i en matris. Följande lista innehåller några saker att tänka på när du vill använda en För varje åtgärd:
Åtgärden För varje kan bearbeta ett begränsat antal matrisobjekt. Den här gränsen finns i Begränsningar för samtidighet, loopning och utfasning.
Som standard körs cyklerna eller iterationerna i en För varje åtgärd samtidigt parallellt.
Det här beteendet skiljer sig från Power Automate's Apply för varje loop där iterationer körs en i taget eller sekventiellt. Du kan dock konfigurera sekventiella för varje iterationer. Om du till exempel vill pausa nästa iteration i en För varje åtgärd med hjälp av åtgärden Fördröjning måste du konfigurera varje iteration så att den körs sekventiellt.
Ett undantag från standardbeteendet är att en kapslad för varje åtgärds iterationer alltid körs sekventiellt, inte parallellt. Om du vill köra åtgärder parallellt för objekt i en kapslad loop skapar och anropar du ett underordnat logikapparbetsflöde.
Kör iterationerna sekventiellt för att få förutsägbara resultat från åtgärder på variabler under varje iteration. När en iteration som körs samtidigt slutar returnerar variabeln Increment, Decrement variable och Append to variable operations förutsägbara resultat. Men under varje iteration i loopen som körs samtidigt kan dessa åtgärder returnera oförutsägbara resultat.
Åtgärder i en För varje loop använder
item()
funktionen för att referera till och bearbeta varje objekt i matrisen. Om du anger data som inte finns i en matris misslyckas arbetsflödet.
I följande exempelarbetsflöde skickas en daglig sammanfattning för en webbplats RSS-feed. Arbetsflödet använder en För varje åtgärd som skickar ett e-postmeddelande för varje nytt objekt.
Baserat på om du har ett förbruknings- eller standardarbetsflöde följer du motsvarande steg:
I Azure Portal skapar du ett exempel på arbetsflödet för förbrukningslogikappen med följande steg i angiven ordning:
RSS-utlösaren med namnet När ett flödesobjekt publiceras
Mer information finns i de här allmänna stegen för att lägga till en utlösare.
Åtgärden Outlook.com eller Office 365 Outlook med namnet Skicka ett e-postmeddelande
Mer information finns i de här allmänna stegen för att lägga till en åtgärd.
Följ samma allmänna steg för att lägga till åtgärden För varje mellan RSS-utlösaren och Skicka en e-poståtgärd i arbetsflödet.
Skapa nu loopen:
Välj i rutan Välj utdata från föregående steg så att listan med dynamiskt innehåll öppnas.
I listan Lägg till dynamiskt innehåll går du till avsnittet När ett flödesobjekt publiceras och väljer Feed-länkar, som är en matrisutdata från RSS-utlösaren.
Kommentar
Om feedlänkarna inte visas bredvid utlösaravsnittsetiketten väljer du Visa mer. I listan med dynamiskt innehåll kan du bara välja utdata från föregående steg.
När du är klar visas de valda matrisutdata som i följande exempel:
Om du vill köra en befintlig åtgärd för varje matrisobjekt drar du åtgärden Skicka ett e-postmeddelande till för varje loop.
Nu ser arbetsflödet ut som i följande exempel:
Spara arbetsflödet när du är klar.
Om du vill testa arbetsflödet manuellt går du till verktygsfältet designer och väljer Kör utlösarkörning>.
För varje åtgärdsdefinition (JSON)
Om du arbetar i kodvyn kan du definiera For_each
åtgärden i arbetsflödets JSON-definition, till exempel:
"actions": {
"For_each": {
"actions": {
"Send_an_email_(V2)": {
"type": "ApiConnection",
"inputs": {
"body": {
"Body": "@{item()}",
"Subject": "New CNN post @{triggerBody()?['publishDate']}",
"To": "me@contoso.com"
},
"host": {
"connection": {
"name": "@parameters('$connections')['office365']['connectionId']"
}
},
"method": "post",
"path": "/v2/Mail"
},
"runAfter": {}
}
},
"foreach": "@triggerBody()?['links']",
"runAfter": {},
"type": "Foreach"
}
},
För varje: Kör sekventiellt
Som standard körs iterationerna i en För varje loop samtidigt parallellt. Men när du har kapslade loopar eller variabler i looparna där du förväntar dig förutsägbara resultat måste du köra dessa loopar en i taget eller sekventiellt.
I för varje åtgärds övre högra hörn väljer du ellipser (...) >Inställningar.
Under Samtidighetskontroll ändrar du inställningen från Av till På.
Flytta skjutreglaget Grad av parallellitet till 1 och välj Klar.
För varje åtgärdsdefinition (JSON): Kör sekventiellt
Om du arbetar i kodvyn med For_each
åtgärden i arbetsflödets JSON-definition kan du använda Sequential
alternativet genom att lägga till parametern operationOptions
, till exempel:
"actions": {
"For_each": {
"actions": {
"Send_an_email_(V2)": { }
},
"foreach": "@triggerBody()?['links']",
"runAfter": {},
"type": "Foreach",
"operationOptions": "Sequential"
}
}
Do Until
Till-åtgärden körs och upprepar en eller flera åtgärder tills det angivna villkoret är uppfyllt. Om villkoret uppfylls stoppas loopen. Annars upprepas loopen. För standard- och maxgränser för antalet Till-åtgärder eller iterationer som ett arbetsflöde kan ha, se Samtidighet, loopning och utfasningsgränser.
Följande lista innehåller några vanliga scenarier där du kan använda en Until-åtgärd :
Anropa en slutpunkt tills du får det svar du vill ha.
Skapa en post i en databas. Vänta tills ett visst fält i posten godkänns. Fortsätt bearbetningen.
I följande exempelarbetsflöde, som börjar kl. 08:00 varje dag, ökar åtgärden Until en variabel tills variabelns värde är lika med 10. Arbetsflödet skickar sedan ett e-postmeddelande som bekräftar det aktuella värdet.
Kommentar
Det här exemplet använder Office 365 Outlook, men du kan använda valfri e-postprovider som Azure Logic Apps stöder. Om du använder ett annat e-postkonto förblir de allmänna stegen desamma, men användargränssnittet kan se lite annorlunda ut.
I Azure Portal skapar du en förbrukningslogikappresurs med ett tomt arbetsflöde.
I upprepningsutlösaren anger du intervallet, frekvensen och timmen på dagen för utlösaren som utlöses.
Property Värde Intervall 1 Frekvens dag Vid dessa timmar 8 Om du vill lägga till parametern Vid dessa timmar öppnar du listan Lägg till ny parameter och väljer Vid dessa tider, som visas först när du har angett Frekvens till Dag.
När du är klar ser upprepningsutlösaren ut som i följande exempel:
Under utlösaren följer du de här allmänna stegen för att lägga till den inbyggda åtgärden Variabler med namnet Initiera variabel i arbetsflödet.
I åtgärden Initiera variabel anger du följande värden:
Property Värde Beskrivning Namn Gräns Variabelns namn Typ Heltal Din variabels datatyp Värde 0 Variabelns startvärde Under åtgärden Initiera variabel följer du de här allmänna stegen för att lägga till den inbyggda åtgärden Kontroll med namnet Until to your workflow (Kontrollera inbyggd åtgärd med namnet Until to your workflow).
I åtgärden Till anger du följande värden för att konfigurera stoppvillkoret för loopen.
Välj i rutan längst till vänster med namnet Välj ett värde, som automatiskt öppnar listan med dynamiskt innehåll.
I listan under Variabler väljer du variabeln Med namnet Gräns.
I listan med mellanoperatorer väljer du är lika med operatorn.
I den högra rutan med namnet Välj ett värde anger du 10 som jämförelsevärde.
I åtgärden Till väljer du Lägg till en åtgärd.
I sökrutan Välj en åtgärd följer du de här allmänna stegen för att lägga till den inbyggda åtgärden Variabler med namnet Increment variable (Öka variabel) i åtgärden Until (Till).
I åtgärden Öka variabel anger du följande värden för att öka värdet för gränsvariabeln med 1:
Property Värde Namn Välj variabeln Gräns . Värde 1 Utanför och under Till-åtgärd följer du dessa allmänna steg för att lägga till en åtgärd som skickar e-post.
Det här exemplet fortsätter med office 365 Outlook-åtgärden med namnet Skicka ett e-postmeddelande.
Ange följande värden i e-poståtgärden:
Property Värde beskrivning To <e-address@domain> Mottagarens e-postadress. Använd din egen e-postadress för testning. Ämne Aktuellt värde för variabeln "Gräns" är: Gräns E-postämnet. I det här exemplet kontrollerar du att du inkluderar variabeln Gräns för att bekräfta att det aktuella värdet uppfyller ditt angivna villkor:
1. Välj i rutan Ämne så att listan med dynamiskt innehåll visas.
2. I listan med dynamiskt innehåll bredvid avsnittet Variabler väljer du Visa mer.
3. Välj Gräns.Brödtext <e-postinnehåll> E-postmeddelandets innehåll som du vill skicka. I det här exemplet anger du vilken text du vill. När du är klar ser e-poståtgärden ut ungefär som i följande exempel:
Spara arbetsflödet.
Testa arbetsflödet
Om du vill testa logikappens arbetsflöde manuellt följer du stegen baserat på om du har en förbruknings- eller standardlogikapp.
I designerverktygsfältet väljer du Kör utlösarkörning>.
När arbetsflödet har börjat köras får du ett e-postmeddelande med det innehåll som du har angett:
Förhindra oändliga loopar
Åtgärden Till stoppar körningen baserat på följande egenskaper, som du kan visa genom att välja Ändra gränser i åtgärden. Kontrollera att du anger dessa egenskapsvärden i enlighet med detta:
Property | Beskrivning |
---|---|
Antal | Det maximala antalet iterationer som körs innan loopen avslutas. För standard- och maxgränser för antalet Till-åtgärder som ett arbetsflöde kan ha, se Begränsningar för samtidighet, loopning och utfasning. |
Tidsgräns | Den maximala tid som till-åtgärden , inklusive alla iterationer, körs innan loopen avslutas. Det här värdet anges i ISO 8601-format och utvärderas för varje iteration. Om någon åtgärd i loopen tar längre tid än tidsgränsen stoppas inte den aktuella iterationen. Nästa iteration startar dock inte eftersom tidsgränsvillkoret är uppfyllt. Standard- och maxgränser för tidsgränsvärdet finns i Begränsningar för samtidighet, loopning och utfasning. |
"Until"-definition (JSON)
Om du arbetar i kodvyn kan du definiera en Until
åtgärd i arbetsflödets JSON-definition, till exempel:
"actions": {
"Initialize_variable": {
// Definition for initialize variable action
},
"Send_an_email": {
// Definition for send email action
},
"Until": {
"type": "Until",
"actions": {
"Increment_variable": {
"type": "IncrementVariable",
"inputs": {
"name": "Limit",
"value": 1
},
"runAfter": {}
}
},
"expression": "@equals(variables('Limit'), 10)",
// To prevent endless loops, an "Until" loop
// includes these default limits that stop the loop.
"limit": {
"count": 60,
"timeout": "PT1H"
},
"runAfter": {
"Initialize_variable": [
"Succeeded"
]
}
}
}
I det här exemplet anropar Until-loopen en HTTP-slutpunkt som skapar en resurs. Loopen stoppas när HTTP-svarstexten returneras med Completed
status. För att förhindra oändliga loopar stoppas loopen även om något av följande villkor inträffar:
Loopen kördes 10 gånger enligt attributet
count
. Standardvärdet är 60 gånger.Loopen kördes i två timmar enligt
timeout
attributet i ISO 8601-format. Standardvärdet är en timme.
"actions": {
"myUntilLoopName": {
"type": "Until",
"actions": {
"Create_new_resource": {
"type": "Http",
"inputs": {
"body": {
"resourceId": "@triggerBody()"
},
"url": "https://domain.com/provisionResource/create-resource",
"body": {
"resourceId": "@triggerBody()"
}
},
"runAfter": {},
"type": "ApiConnection"
}
},
"expression": "@equals(triggerBody(), 'Completed')",
"limit": {
"count": 10,
"timeout": "PT2H"
},
"runAfter": {}
}
}