Tutorial: Create schedule-based automation workflows using Azure Logic Apps
Applies to: Azure Logic Apps (Consumption)
This tutorial shows how to build an example logic app workflow that runs on a recurring schedule. Specifically, this example workflow checks the travel time, including the traffic, between two places and runs every weekday morning. If the time exceeds a specific limit, the workflow sends you an email that includes the travel time and the extra time necessary to arrive at your destination. The workflow includes various steps, which start with a schedule-based trigger followed by a Bing Maps action, a data operations action, a control flow action, and an email notification action.
In this tutorial, you learn how to:
- Create a blank logic app and workflow.
- Add a Recurrence trigger that specifies the schedule to run your workflow.
- Add a Bing Maps action that gets the travel time for a route.
- Add an action that creates a variable, converts the travel time from seconds to minutes, and stores that result in the variable.
- Add a condition that compares the travel time against a specified limit.
- Add an action that sends an email if the travel time exceeds the limit.
When you're done, your workflow looks similar to the following high level example:
Prerequisites
An Azure account and subscription. If you don't have a subscription, sign up for a free Azure account.
An email account from an email provider that's supported by Azure Logic Apps, such as Office 365 Outlook, Outlook.com, or Gmail. For other providers, review the connectors list here. This quickstart uses Office 365 Outlook with a work or school account. If you use a different email account, the general steps stay the same, but your UI might slightly differ.
Important
If you want to use the Gmail connector, only G-Suite business accounts can use this connector without restriction in logic app workflows. If you have a Gmail consumer account, you can use this connector with only specific Google-approved services, or you can create a Google client app to use for authentication with your Gmail connector. For more information, see Data security and privacy policies for Google connectors in Azure Logic Apps.
To get the travel time for a route, you need an access key for the Bing Maps API. To get this key, follow the steps for how to get a Bing Maps key.
If your workflow needs to communicate through a firewall that limits traffic to specific IP addresses, that firewall needs to allow access for both the inbound and outbound IP addresses used by Azure Logic Apps in the Azure region where your logic app resource exists. If your workflow also uses managed connectors, such as the Office 365 Outlook connector or SQL connector, or uses custom connectors, the firewall also needs to allow access for all the managed connector outbound IP addresses in your logic app resource's Azure region.
Create a Consumption logic app workflow
In the Azure portal, sign in with your Azure account.
On the Azure home page, select Create a resource.
On the Azure Marketplace menu, select Integration > Logic App.
On the Create Logic App pane, on the Basics tab, provide the following information about your logic app resource.
Property Required Value Description Subscription Yes <Azure-subscription-name> Your Azure subscription name. This example uses Pay-As-You-Go. Resource Group Yes LA-TravelTime-RG The Azure resource group where you create your logic app resource and related resources. This name must be unique across regions and can contain only letters, numbers, hyphens ( -
), underscores (_
), parentheses ((
,)
), and periods (.
).Name Yes LA-TravelTime Your logic app resource name, which must be unique across regions and can contain only letters, numbers, hyphens ( -
), underscores (_
), parentheses ((
,)
), and periods (.
).Before you continue making selections, go to the Plan section. For Plan type, select Consumption to show only the settings for a Consumption logic app workflow, which runs in multi-tenant Azure Logic Apps.
The Plan type property also specifies the billing model to use.
Plan type Description Standard This logic app type is the default selection and runs in single-tenant Azure Logic Apps and uses the Standard billing model. Consumption This logic app type runs in global, multi-tenant Azure Logic Apps and uses the Consumption billing model. Now continue with the following selections:
Property Required Value Description Region Yes West US The Azure datacenter region for storing your app's information. This example deploys the sample logic app to the West US region in Azure.
Note: If your subscription is associated with an integration service environment, this list includes those environments.Enable log analytics Yes No This option appears and applies only when you select the Consumption logic app type. Change this option only when you want to enable diagnostic logging. For this tutorial, keep the default selection. When you're done, select Review + create. After Azure validates the information about your logic app resource, select Create.
After Azure deploys your app, select Go to resource.
Azure opens the workflow template selection pane, which shows an introduction video, commonly used triggers, and workflow template patterns.
Scroll down past the video and common triggers sections to the Templates section, and select Blank Logic App.
Next, add the Recurrence trigger, which runs the workflow based on a specified schedule. Every workflow must start with a trigger, which fires when a specific event happens or when new data meets a specific condition. For more information, see Create an example Consumption logic app workflow in multi-tenant Azure Logic Apps.
Add the Recurrence trigger
On the workflow designer, under the search box, select Built-in.
In the search box, enter recurrence, and select the trigger named Recurrence.
On the Recurrence shape, select the ellipses (...) button, and then select Rename. Rename the trigger with this description:
Check travel time every weekday morning
Inside the trigger, change these properties as described and shown here.
Property Required Value Description Interval Yes 1 The number of intervals to wait between checks Frequency Yes Week The unit of time to use for the recurrence Under Interval and Frequency, open the Add new parameter list, and select these properties to add to the trigger.
- On these days
- At these hours
- At these minutes
Now set the values for the additional properties as shown and described here.
Property Value Description On these days Monday, Tuesday, Wednesday, Thursday, Friday This setting is available only when you set the Frequency to Week. At these hours 7, 8, 9 This setting is available only when you set the Frequency to Week or Day. For this recurrence, select the hours of the day. This example runs at the 7
,8
, and9
-hour marks.At these minutes 0, 15, 30, 45 This setting is available only when you set the Frequency to Week or Day. For this recurrence, select the minutes of the day. This example starts at the zero-hour mark and runs every 15 minutes. This trigger fires every weekday, every 15 minutes, starting at 7:00 AM and ending at 9:45 AM. The Preview box shows the recurrence schedule. For more information, see Schedule tasks and workflows and Workflow actions and triggers.
To hide the trigger's details for now, collapse the shape by clicking inside the shape's title bar.
Save your workflow. On the designer toolbar, select Save.
Your logic app workflow is now live in the Azure portal but doesn't do anything other than trigger based on the specified schedule. So, add an action that responds when the trigger fires.
Get the travel time for a route
Now that you have a trigger, add an action that gets the travel time between two places. Azure Logic Apps provides a connector for the Bing Maps API so that you can easily get this information. Before you start this task, make sure that you have a Bing Maps API key as described in this tutorial's prerequisites.
In the workflow designer, under the Recurrence trigger, select New step.
Under Choose an operation, select Standard. In the search box, enter bing maps, and select the action named Get route.
If you don't have a Bing Maps connection, you're asked to create a connection. Provide the connection details as shown and described, and then select Create.
Property Required Value Description Connection Name Yes BingMapsConnection Provide a name for your connection. This example uses BingMapsConnection
.API Key Yes <Bing-Maps-API-key> Enter the Bing Maps API key that you previously received. If you don't have a Bing Maps key, learn how to get a key. Rename the action with this description:
Get route and travel time with traffic
.In the action, open the Add new parameter list, and select these properties.
- Optimize
- Distance unit
- Travel mode
Now enter the values for the properties shown and described here.
Property Required Value Description Waypoint 1 Yes <start-location> Your route's origin. This example specifies an example starting address. Waypoint 2 Yes <end-location> Your route's destination. This example specifies an example destination address. Optimize No timeWithTraffic A parameter to optimize your route, such as distance, travel time with current traffic, and so on. Select the parameter value, timeWithTraffic. Distance unit No <your-preference> The unit of distance for your route. This example uses Mile as the unit. Travel mode No Driving The travel mode for your route. Select Driving mode. For more information about these parameters and values, see Calculate a route.
On the designer toolbar, select Save.
Next, create a variable so that you can convert and store the current travel time as minutes, rather than seconds. That way, you can avoid repeating the conversion and use the value more easily in later steps.
Create a variable to store travel time
Sometimes, you might want to run operations on data in your workflow, and then use the results in later actions. To save these results so that you can easily reuse or reference them, you can create variables that store those results after processing. You can create variables only at the top level in your workflow.
By default, the Get route action returns the current travel time with traffic in seconds from the Travel Duration Traffic property. By converting and storing this value as minutes instead, you make the value easier to reuse later without converting again.
On the designer, under the Get route action, select New step.
Under Choose an operation, select Built-in. In the search box, enter variables, and select the action named Initialize variable.
Rename this action with this description:
Create variable to store travel time
Provide this information for your variable as shown in this table and in the steps below the table:
Property Required Value Description Name Yes travelTime The name for your variable. This example uses travelTime
.Type Yes Integer The data type for your variable Value No An expression that converts the current travel time from seconds to minutes (see the steps under this table). The initial value for your variable To create the expression for the Value property, click inside the box so that the dynamic content list appears. If necessary, widen your browser until the dynamic list appears. In the dynamic content list, select Expression, which shows the expression editor.
The dynamic content list shows the outputs from previous actions that are available for you to select as inputs to subsequent actions in your workflow. The dynamic content list includes an expression editor that you can use to select functions that perform operations in your expression. This expression editor is only available in the dynamic content list.
In the expression editor, enter this expression:
div(,60)
Within the expression, put your cursor between the left parenthesis (() and the comma (,), and select Dynamic content.
In the dynamic content list, under select the property value, Travel Duration Traffic.
After the property value resolves inside the expression, select OK.
The Value property now appears as shown here:
Save your workflow. On the designer toolbar, select Save.
Next, add a condition that checks whether the current travel time is greater than a specific limit.
Compare the travel time with limit
Under the Create variable to store travel time action, select New step.
Under Choose an operation, select Built-in. In the search box, enter condition. and from the actions list, select the action named Condition.
Rename the condition with this description:
If travel time exceeds limit
Build a condition that checks whether the travelTime property value exceeds your specified limit as described and shown here:
In the condition, on the condition's left side, click inside the Choose a value box.
From the dynamic content list that appears, under Variables, select the property named travelTime.
In the middle comparison box, select the operator named is greater than.
On the condition's right side, in the Choose a value box, enter this limit:
15
When you're done, the condition looks like this example:
Save your workflow. On the designer toolbar, select Save.
Next, add the action to run when the travel time exceeds your limit.
Send email when limit exceeded
Now, add an action that sends you email when the travel time exceeds your limit. This email includes the current travel time and the extra time necessary to travel the specified route.
In the condition's True branch, select Add an action.
Under Choose an operation, select Standard. In the search box, enter send email. The list returns many results, so to help you filter the list, first select the email connector that you want.
For example, if you have an Outlook email account, select the connector for your account type:
- For Azure work or school accounts, select Office 365 Outlook.
- For personal Microsoft accounts, select Outlook.com.
This example continues by selecting Office 365 Outlook.
When the connector's actions appear, select the action that sends email, for example:
If you don't already have a connection, sign in and authenticate access to your email account when prompted.
Azure Logic Apps creates a connection to your email account.
Rename the action with this description:
Send email with travel time
For the To property, enter the recipient's email address. For testing purposes, you can use your email address.
For the Subject property, specify the email's subject, and include the travelTime variable by following these steps:
Enter the text
Current travel time (minutes):
with a trailing space. Keep your cursor in the Subject box so that the dynamic content list stays open.From the dynamic content list, in the Variables heading, select See more so that the variable named travelTime appears.
Note
The dynamic content list doesn't automatically show the travelTime variable because the Subject property expects a string value, while travelTime is an integer value.
For the Body property, specify the content for the email body by following these steps:
Enter the text
Add extra travel time (minutes):
with a trailing space. Keep your cursor in the Body box so that the dynamic content list stays open.In the dynamic content list, select Expression, which shows the expression editor.
In the expression editor, enter sub(,15) so that you can calculate the number of minutes that exceed your limit:
Within the expression, put your cursor between the left parenthesis (() and the comma (,), and select Dynamic content.
Under Variables, select travelTime.
After the property resolves inside the expression, select OK.
The Body property now appears as shown here:
Save your workflow. On the designer toolbar, select Save.
Next, test and run your workflow, which now looks similar to this example:
Run your workflow
To manually start your workflow, on the designer toolbar, select Run Trigger > Run.
If the current travel time stays under your limit, your workflow does nothing else and waits or the next interval before checking again.
If the current travel time exceeds your limit, you get an email with the current travel time and the number of minutes above your limit. Here is an example email that your workflow sends:
Tip
If you don't get any emails, check your email's junk folder. Your email junk filter might redirect these kinds of mails. Otherwise, if you're unsure that your workflow ran correctly, see Troubleshoot your workflow.
Congratulations, you've now created and run a schedule-based recurring workflow.
To create other workflows that use the Recurrence trigger, check out these templates, which available after you create a new logic app resource:
- Get daily reminders sent to you.
- Delete older Azure blobs.
- Add a message to an Azure Storage queue.
Clean up resources
Your workflow continues running until you disable or delete the logic app resource. When you no longer need the sample workflow, delete the resource group that contains your logic app resource and related resources.
In the Azure portal's search box, enter the name for the resource group that you created. From the results, under Resource Groups, select the resource group.
This example created the resource group named
LA-TravelTime-RG
.Tip
If the Azure home page shows the resource group under Recent resources, you can select the group from the home page.
On the resource group menu, check that Overview is selected. On the Overview pane's toolbar, select Delete resource group.
In the confirmation pane that appears, enter the resource group name, and select Delete.
Next steps
In this tutorial, you created a logic app workflow that checks traffic based on a specified schedule (on weekday mornings), and takes action (sends an email) when the travel time exceeds a specified limit. Now, learn how to build a workflow that sends mailing list requests for approval by integrating Azure services, Microsoft services, and other Software-as-a-Service (SaaS) apps.
Povratne informacije
https://aka.ms/ContentUserFeedback.
Stiže uskoro: Tokom 2024. godine postepeno ćemo ukidati probleme sa uslugom GitHub kao mehanizam povratnih informacija za sadržaj i zameniti ga novim sistemom povratnih informacija. Dodatne informacije potražite u članku:Prosledite i prikažite povratne informacije za