Terugkerende werkstromen plannen en uitvoeren met de trigger Terugkeerpatroon in Azure Logic Apps

Van toepassing op: Azure Logic Apps (verbruik + standaard)

Als u uw werkstroom volgens een schema wilt starten en uitvoeren, kunt u als eerste stap de algemene trigger Terugkeerpatroon gebruiken. U kunt een datum, tijd en tijdzone instellen voor het starten van de werkstroom en een terugkeerpatroon voor het herhalen van die werkstroom. De volgende lijst bevat enkele patronen die door deze trigger worden ondersteund, samen met geavanceerdere terugkeerpatronen en complexere schema's:

• Voer uit op een specifieke datum en tijd en herhaal vervolgens elk n aantal seconden, minuten, uren, dagen, weken of maanden.

• Voer onmiddellijk uit en herhaal elke n aantal seconden, minuten, uren, dagen, weken of maanden.

• Voer onmiddellijk uit en herhaal dit dagelijks op een of meer specifieke tijdstippen, zoals 8:00 uur en 17:00 uur.

• Direct uitvoeren en wekelijks herhalen op specifieke dagen, zoals zaterdag en zondag.

• Direct uitvoeren en wekelijks herhalen op specifieke dagen en tijden, zoals maandag tot en met vrijdag om 8:00 uur en 17:00 uur.

Notitie

Als u uw werkstroom in de toekomst slechts eenmaal wilt starten en uitvoeren, gebruikt u een werkstroomsjabloon met de naam Scheduler: Eenmaal uitvoeren taken. Deze sjabloon maakt gebruik van de aanvraagtrigger en de HTTP-actie in plaats van de trigger Terugkeerpatroon, die dit terugkeerpatroon niet ondersteunt. Zie Taken slechts één keer uitvoeren voor meer informatie.

De trigger Terugkeerpatroon is niet gekoppeld aan een specifieke service, dus u kunt de trigger gebruiken met vrijwel elke werkstroom, zoals logische app-werkstromen voor verbruik en stateful werkstromen voor standaard logische apps. Deze trigger is momenteel niet beschikbaar voor stateless standaard logische app-werkstromen.

De trigger Terugkeerpatroon maakt deel uit van de ingebouwde planningsconnector en wordt systeemeigen uitgevoerd in de Azure Logic Apps-runtime. Zie Terugkerende geautomatiseerde, taken en werkstromen plannen en uitvoeren met Azure Logic Apps voor meer informatie over de ingebouwde planningtriggers en -acties.

Vereisten

• Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meld u dan aan voor een gratis Azure-account.

• Basiskennis van werkstromen voor logische apps.

De trigger Terugkeerpatroon toevoegen

1. Maak in de Azure Portal een lege logische app en werkstroom.

   Notitie

   Als u een standaardwerkstroom voor logische apps hebt gemaakt, moet u een stateful werkstroom maken. De trigger Terugkeerpatroon is momenteel niet beschikbaar voor stateless werkstromen.

2. Voer in de ontwerpfunctie de bijbehorende stappen uit, afhankelijk van het feit of de werkstroom van de logische app Verbruik of Standaard is.

Verbruik

1. Selecteer in de ontwerpfunctie onder het zoekvak de optie Ingebouwd.

2. Typ terugkeerpatroon in het zoekvak.

3. Selecteer in de lijst met triggers de trigger met de naam Terugkeerpatroon.

   

Standard

1. Selecteer bewerking kiezen in de ontwerpfunctie.

2. Selecteer in het deelvenster Een trigger toevoegen onder het zoekvak de optie Ingebouwd.

3. Typ terugkeerpatroon in het zoekvak.

4. Selecteer in de lijst met triggers de trigger met de naam Terugkeerpatroon.

   

1. Stel het interval en de frequentie voor het terugkeerpatroon in. In dit voorbeeld stelt u deze eigenschappen in om uw werkstroom elke week uit te voeren, bijvoorbeeld:

   Verbruik

   

   Standard

   

   Eigenschap	JSON-naam	Vereist	Type	Beschrijving
   Interval	interval	Ja	Geheel getal	Een positief geheel getal dat beschrijft hoe vaak de werkstroom wordt uitgevoerd op basis van de frequentie. Dit zijn de minimum- en maximumintervallen: - Maand: 1-16 maanden - Week: 1-71 weken - Dag: 1-500 dagen - Uur: 1-12.000 uur - Minuut: 1-72.000 minuten - Seconde: 1-9.999.999 seconden Als het interval bijvoorbeeld 6 is en de frequentie 'Maand' is, is het terugkeerpatroon elke 6 maanden.
   Frequentie	frequency	Ja	Tekenreeks	De tijdseenheid voor het terugkeerpatroon: Seconde, Minuut, Uur, Dag, Week of Maand

   Belangrijk

   Als u de frequentie Dag, Week of Maand gebruikt en u een toekomstige datum en tijd opgeeft, moet u het terugkeerpatroon vooraf instellen. Anders kan de werkstroom het eerste terugkeerpatroon overslaan.

   • Dag: Stel het dagelijkse terugkeerpatroon ten minste 24 uur van tevoren in.

   • Week: stel het wekelijkse terugkeerpatroon ten minste 7 dagen van tevoren in.

   • Maand: stel het maandelijkse terugkeerpatroon ten minste één maand van tevoren in.

   Als een terugkeerpatroon geen specifieke begindatum en -tijd opgeeft, wordt het eerste terugkeerpatroon onmiddellijk uitgevoerd wanneer u de logische app opslaat of implementeert, ondanks de instelling van het terugkeerpatroon van de trigger. Om dit gedrag te voorkomen, geeft u een begindatum en -tijd op waarop het eerste terugkeerpatroon moet worden uitgevoerd.

   Als u een uitgeschakelde werkstroom Verbruik implementeert met een terugkeerpatroontrigger met behulp van een ARM-sjabloon, wordt de trigger direct geactiveerd wanneer u de werkstroom inschakelt, tenzij u de parameter Begintijd instelt vóór de implementatie.

   Als een terugkeerpatroon geen andere geavanceerde planningsopties opgeeft, zoals specifieke tijden voor het uitvoeren van toekomstige terugkeerpatronen, zijn deze terugkeerpatronen gebaseerd op de laatste uitvoeringstijd. Als gevolg hiervan kunnen de begintijden voor deze terugkeerpatronen afwijken vanwege factoren zoals latentie tijdens opslagoproepen. Probeer de volgende opties om ervoor te zorgen dat uw logische app geen terugkeerpatroon mist, met name wanneer de frequentie in dagen of langer is:

   • Geef een begindatum en -tijd op voor het terugkeerpatroon en de specifieke tijden waarop volgende terugkeerpatronen moeten worden uitgevoerd. U kunt de eigenschappen gebruiken met de namen Op deze uren en Op deze minuten, die alleen beschikbaar zijn voor de dag - en weekfrequenties .

   • Gebruik voor logische app-werkstromen verbruik de trigger Sliding Window in plaats van de trigger Recurrence.

2. Als u geavanceerde planningsopties wilt instellen, opent u de lijst Nieuwe parameter toevoegen . Alle opties die u selecteert, worden weergegeven op de trigger na selectie.

   Verbruik

   

   Standard

   

   Eigenschap	JSON-naam	Vereist	Type	Description
   Tijdzone	timeZone	Nee	Tekenreeks	Is alleen van toepassing wanneer u een begintijd opgeeft, omdat deze trigger geen UTC-verschuiving accepteert. Selecteer de tijdzone die u wilt toepassen.
   Begintijd	startTime	Nee	Tekenreeks	Geef een begindatum en -tijd op. Deze hebben een maximum van 49 jaar in de toekomst en moeten voldoen aan de ISO 8601-datumtijdspecificatie in UTC-datumtijdnotatie, maar zonder UTC-verschuiving: JJJJ-MM-DDThh:mm:ss als u een tijdzone selecteert -of- JJJJ-MM-DDThh:mm:ssZ als u geen tijdzone selecteert Als u bijvoorbeeld 18 september 2020 om 14:00 uur wilt, geeft u '2020-09-18T14:00:00' op en selecteert u een tijdzone zoals Pacific (standaardtijd). Of geef '2020-09-18T14:00:00Z' op zonder een tijdzone. Belangrijk: Als u geen tijdzone selecteert, moet u de letter 'Z' aan het einde toevoegen zonder spaties. Deze "Z" verwijst naar de equivalente zeetijd. Als u een tijdzonewaarde selecteert, hoeft u geen Z toe te voegen aan het einde van de begintijdwaarde . Als u dit doet, negeert Logic Apps de tijdzonewaarde omdat de 'Z' een UTC-tijdnotatie aangeeft. Voor eenvoudige planningen is de begintijd het eerste exemplaar, terwijl voor complexe schema's de trigger niet eerder wordt geactiveerd dan de begintijd. Op welke manieren kan ik de begindatum en -tijd gebruiken?
   Deze dagen	weekDays	No	Tekenreeks of tekenreeksmatrix	Als u 'Week' selecteert, kunt u een of meer dagen selecteren waarop u de werkstroom wilt uitvoeren: maandag, dinsdag, woensdag, donderdag, vrijdag, zaterdag en zondag
   Deze uren	hours	No	Geheel getal of matrix met gehele getallen	Als u 'Dag' of 'Week' selecteert, kunt u een of meer gehele getallen van 0 tot 23 selecteren als de uren van de dag waarop u de werkstroom wilt uitvoeren. Als u bijvoorbeeld '10', '12' en '14' opgeeft, krijgt u 10:00, 12:00 en 14:00 uur voor de uren van de dag, maar worden de minuten van de dag berekend op basis van wanneer het terugkeerpatroon begint. Als u specifieke minuten van de dag wilt instellen, bijvoorbeeld 10:00, 12:00 en 14:00 uur, geeft u deze waarden op met de eigenschap met de naam Op deze minuten.
   Deze minuten	minutes	No	Geheel getal of matrix met gehele getallen	Als u 'Dag' of 'Week' selecteert, kunt u een of meer gehele getallen van 0 tot 59 selecteren als de minuten van het uur waarop u de werkstroom wilt uitvoeren. U kunt bijvoorbeeld '30' opgeven als minuutmarkering en als u het vorige voorbeeld gebruikt voor uren van de dag, krijgt u 10:30 uur, 12:30 uur en 14:30 uur. Opmerking: Soms kan het tijdstempel voor de geactiveerde uitvoering variëren tot 1 minuut ten opzichte van de geplande tijd. Als u de tijdstempel exact zoals gepland wilt doorgeven aan volgende acties, kunt u sjabloonexpressies gebruiken om het tijdstempel dienovereenkomstig te wijzigen. Zie Datum- en tijdfuncties voor expressies voor meer informatie.

   Stel dat het vandaag vrijdag 4 september 2020 is. De volgende trigger terugkeerpatroon wordt niet eerder geactiveerd dan de opgegeven begindatum en -tijd, namelijk vrijdag 18 september 2020 om 8:00 uur Pacific Time. Het terugkeerschema is echter alleen ingesteld op 10:30, 12:30 en 14:30 op maandag. De eerste keer dat de trigger wordt geactiveerd en een werkstroomexemplaren wordt gemaakt, is maandag om 10:30 uur. Zie deze voorbeelden van begintijden voor meer informatie over de werking van begintijden.

   Toekomstige uitvoeringen vinden plaats om 12:30 uur en 14:30 uur op dezelfde dag. Elk terugkeerpatroon maakt een eigen werkstroomexemplaren. Daarna wordt het hele schema volgende maandag opnieuw herhaald. Wat zijn enkele andere voorbeelden?

   Notitie

   De trigger geeft alleen een voorbeeld weer voor het opgegeven terugkeerpatroon wanneer u 'Dag' of 'Week' als de frequentie selecteert.

   Verbruik

   

   Standard

   

3. Ga nu verder met het bouwen van uw werkstroom met andere acties.

Werkstroomdefinitie - Terugkeerpatroon

U kunt zien hoe de definitie van de terugkeerpatroontrigger wordt weergegeven met de gekozen opties door de onderliggende JSON-definitie voor uw werkstroom te bekijken in Logische apps voor verbruik en Logische standaard-apps (alleen stateful).

Kies een van de volgende opties op basis van het feit of uw logische app Verbruik of Standaard is:

• Verbruik: selecteer codeweergave op de werkbalk van de ontwerper. Als u wilt terugkeren naar de ontwerpfunctie, selecteert u Ontwerper op de werkbalk van de codeweergave-editor.

• Standaard: selecteer codeweergave in het werkstroommenu. Als u wilt terugkeren naar de ontwerpfunctie, selecteert u Ontwerper in het werkstroommenu.

In het volgende voorbeeld ziet u hoe een triggerdefinitie voor terugkeerpatroon kan worden weergegeven in de onderliggende JSON-definitie van de werkstroom:

"triggers": {
   "Recurrence": {
      "type": "Recurrence",
      "recurrence": {
         "frequency": "Week",
         "interval": 1,
         "schedule": {
            "hours": [
               10,
               12,
               14
            ],
            "minutes": [
               30
            ],
            "weekDays": [
               "Monday"
            ]
         },
         "startTime": "2020-09-07T14:00:00Z",
         "timeZone": "Pacific Standard Time"
      }
   }
}

Notitie

In de definitie van de terugkeerpatroontrigger wordt de evaluatedRecurrence eigenschap samen met de recurrence eigenschap weergegeven wanneer een expressie of parameterreferentie wordt weergegeven in de terugkeercriteria. Deze evaluatedRecurrence eigenschap vertegenwoordigt de geëvalueerde waarden uit de expressie of parameterreferentie. Als het terugkeercriterium geen expressies of parameterverwijzingen opgeeft, zijn de evaluatedRecurrence eigenschappen en recurrence hetzelfde.

In het volgende voorbeeld ziet u hoe u de triggerdefinitie bijwerkt, zodat de trigger slechts eenmaal wordt uitgevoerd op de laatste dag van elke maand:

"triggers": {
    "Recurrence": {
        "recurrence": {
            "frequency": "Month",
            "interval": 1,
            "schedule": {
                "monthDays": [-1]
            }
        },
        "type": "Recurrence"
    }
}

Terugkeerpatroon en afwijking activeren (zomertijd)

Als u taken wilt plannen, plaatst Azure Logic Apps het bericht voor verwerking in de wachtrij en geeft aan wanneer dat bericht beschikbaar is, op basis van de UTC-tijd waarop de laatste taak is uitgevoerd en de UTC-tijd waarop de volgende taak volgens de planning moet worden uitgevoerd. Als u een begintijd met uw terugkeerpatroon opgeeft, moet u een tijdzone selecteren , zodat de werkstroom van de logische app wordt uitgevoerd op de opgegeven begintijd. Op die manier verschuift de UTC-tijd voor uw logische app ook om de seizoensgebonden tijdswijziging tegen te gaan. Terugkerende triggers respecteren het schema dat u hebt ingesteld, inclusief eventuele tijdzones die u opgeeft.

Als u anders geen tijdzone selecteert, kunnen zomertijd -gebeurtenissen invloed hebben op het uitvoeren van triggers. De begintijd verschuift bijvoorbeeld één uur naar voren wanneer de DST begint en één uur naar achteren wanneer de DST eindigt. Sommige tijdvensters kunnen echter problemen veroorzaken wanneer de tijd verschuift. Zie Terugkeerpatroon voor zomertijd en standaardtijd voor meer informatie en voorbeelden.

Volgende stappen

• Werkstromen onderbreken met vertragingsacties
• Beheerde connectors voor Azure Logic Apps
• Ingebouwde connectors voor Azure Logic Apps