Introducing button flows

What are button flows?

There are many repetitive tasks that we all wish we could run with just a tap of a button. For example, you may need to quickly email your team to remind them to join the daily team sync, or you may want to start a new Visual Studio Online build of your code base after you've been notified that there are no more checkins planned for the day. Button flows allow you to accomplish these and many other tasks simply by tapping a button on your mobile device.

Note You can create button flows either from your mobile device or from the Flow portal.
Overview image

Why create buttons?

Create buttons so that you can easily run repetitive tasks from anyplace, at anytime via your mobile device. Executing buttons saves you time and, since the tasks they perform are automated, there will be less errors than if you manually did them.

Create a button

Prerequisites

  • Access to Flow. Your administrator can provide you with access.
  • An account with permissions to use the connectors to create your button. For example, you will need a Dropbox account in order to create a button that accesses Dropbox.

From the portal

In this walk-through, let's create a button that starts a Visual Studio Online (VSO) build and sends notifications to let you know when the build starts:

  1. Select the Showing drop down list and choose the Button category. This filters the list of templates to only those that can be used in button flows.
    Overview image
  2. Select the Trigger a new build in VSO template from the list of templates.
    Overview image
  3. Select the Use this template button on the Trigger a new build in VSO page.
    Overview image
  4. If you aren't signed in, you'll be prompted to do so at this point:
    Overview image
  5. After you've signed into Flow, you'll be prompted to sign into the connectors used in the template you've selected. In this example, in step 2 above we selected the Trigger a new build in VSO template, so we have to sign into VSO (and any other connectors you are working with), if you're not already signed in:
    Overview image
  6. Select the Accept button if you agree to authorize Flow to access your VSO account.
    Overview image
    Note You'll need to authorize each connector similarly. The designer should appear like this when you are ready to move on to the next step. Select the Continue button to move on:
    Overview image
  7. You are now ready to configure the properties for the build you wish to start:
    Overview image
  8. Select or enter the Account name, Project name, Build definition Id, Source branch and optionally, Parameters, in the Queue a new build card:
    Overview image
  9. Next, configure the properties of the push notification on the Send a push notification card. By default, this push notification is configured to send an HTML link to a Web page that displays the status of the build:
    Overview image
  10. Select the Create flow button to save your button flow: Overview image
  11. You should see this success message within a few moments:
    Overview image

Congratulations, you've created a button flow! You can now run this button flow anytime, anyplace, from the Buttons tab in the Flow app. Simply press the "button" and it will run! The Microsoft Flow mobile app is available for Android, iOS, or Windows Phone.

From your mobile device

Note: While this walk-through displays screens from an Android device, the screens and experience on an iOS device are similar.

In the Flow app:

  1. Select the Browse tab and scroll to the Button category.
    Overview image
  2. Select the See all link. This displays all ready-to-go button templates.
    Overview image
  3. Select the Send an email to remind your team to join a meeting template
    Overview image
  4. Select the USE THIS TEMPLATE link, at the bottom of the page.
    Overview image
  5. You'll need to sign into all services that this template uses:
    Overview image
  6. Select the Next link after you've signed in to all services.
    Overview image
  7. Select the Create link. Here you can also review the flow and make any changes you require to personalize the email, for example.
    Overview image
  8. After a few moments, the button flow is created. Select SEE MY FLOW:
    Overview image
  9. View all your flows on the My flows tab
    Overview image

Congratulations, you've created a button flow! You can now run this button flow anytime, anyplace, from the Buttons tab in the Flow app. Simply press the "button" and it will run! The Flow app is currently available on Android and iOS mobile devices.

Overview image

Trigger a button flow

Now that you've created a button flow, it's time to run it. Since you can only run button flows from the Flow app, be sure you've installed Flow on your Android or iOS mobile device.

  1. Now, launch the flow app, tap the Buttons tab that's located at the bottom of the page, and tap the button that represents the button flow you wish to trigger:
    Overview image
  2. See the progress while the flow runs:
    Overview image
  3. Finally, the page updates, indicating that the button flow has completed:
    Overview image

That's all there is to running a flow.

You should now receive the push notification, indicating that the email has been sent.

Monitor your button flow runs

You can monitor button flows from the Activity tab of the flow app:
Overview image

Note: Tap any activity to drill into the results of the run to learn about the run.

Overview image

Manage button flows

You have full control of your button flows so you can enable/disable, edit or delete a button anytime, anyplace. From the mobile app or from the flow portal, select My flows to get started managing your flows.

On the My flows tab of the Flow app:

  1. Select the flow you wish to manage:
    Overview image
  2. You can tap any of these options, based on what you'd like to accomplish:
    Overview image
  3. Tap Delete flow to delete a flow.

Note All run history is deleted when you delete a flow:
Overview image

  1. Tap Update after you are done editing a button flow, to save your changes:
    Overview image
  2. Tap Run history to see the results of all runs of a particular button flow:
    Overview image
  3. If you disable a flow, it will no longer be available on the Buttons tab:
    Overview image

Next steps