Simple Loops: Do While Loop Snippet

Overview

Performing the same action on your data over and over again is a time sink. Using a loop for your data makes this process more efficient. A loop is a repeating process that's based on a condition. This might be an API call, a set number of iterations, or another action.

The Do While Loop is one of the Simple Loop snippets. A do while loop is controlled by a condition you set. Unlike a while loop, it verifies the condition after the action. For example, if you have a list of submissions in real time, the loop can identify people from a certain organization. From there, the loop applies to everyone in the organization.

Similar Loops

There are many loop templates that serve different purposes. Here are the loops compared:

• For Loop: Processes data based on the number of data rows.

• While Loop: Processes data based on a data condition. This loop confirms the condition is true before running the action.

• Do While Loop: Processes data based on a data condition. This loop confirms the condition is true after running the action.

• Batch Loop: Processes arrays based on either the number of data rows or condition.

Your snippet doesn't show anything in Express View except the Start Loop button. Because the loop happens behind the scenes, you only see activity in the DevTools Console.

Here's how the snippet looks in Express View, with a sneak peek at the DevTools Console:

And here's how the snippet looks in the Module Builder:

What You'll Learn

In this article, you'll learn:

• How to add the Do While Loop snippet to your module.

• How the Do While Loop snippet works.

• How to configure the Do While Loop snippet.

• How to remove the Do While Loop snippet.

Adding the Snippet

To add the Simple For Loop snippet to your module:

1.

In the left sidebar of the Module Builder, click Snippets.

2.

Enter Do While Loop in the search bar.

3.

Drag and drop the Do While Loop snippet onto your canvas.

4.

Save your module.

How the Snippet Works

This snippet relies heavily on the Data Workflow component. In Express View, the only component you see is the Start Loop button. This triggers the initializer to begin your Data Workflow.

While other loops rely on data for their input, a do while loop uses the result because it's looking for the condition first. The Data Workflow uses the condition from the result Hidden component to generate the result. Then, it performs these actions:

• Start Loop Again: Continues the loop for anything that matches the condition (in the result Hidden component).

• End Loop: Stops the loop when the condition is no longer met.

• Call Plugin: Calls the pluginAction Plug-In component for the action you want to take with your data.

Once complete, the initEndLoop Initializer component stops the workflow.

Configuring the Snippet

Out of the box, the Do While Loop snippet has the basic logic components ready to go. All you need to do is connect your data, adjust the pluginAction component, and create a condition.

Let's say you're capturing email addresses of people who just enrolled in a course. Some people created a new account, and you want to send a welcome email only to those people. Here's how it works.

NOTE  This example uses the SendGrid service. To learn more, search SendGrid Single Email Module Integration Template in our In-Product Help.

Add a Data Table Component

This example uses a Data Table to get input information. To get started, enter the email addresses in the Data Table. This is the data your condition applies to.

1.

Hover over the exampleArrayToProcess Data Table component.

2.

Click the (Settings) button to open the Configuration window.

3.

Enter dtInputData in the Label and Property Name fields.

4.

In the table, enter:

5.

Click Save.

Update the Plug-In Component

The automatic email information goes in the pluginAction Plug-In. This example uses SendGrid to get the email information.

1.

Hover over the exampleArrayToProcess Data Table component.

2.

Click the (Settings) button to open the Configuration window.

3.

Select External as the Service Type.

4.

Select SendGrid from the External Services drop-down.

5.

Enter mail/send at the end of the Data Source URL.

6.

Select Post as the Request Type.

7.

In the Inputs table, enter:

8.

Click Save.

Update the Data Workflow Component

Finally, you need to set the condition the loop looks for. For this example, you'll send an email to everyone except those with email addresses ending in @dailybugle.com.

1.

Hover over the dwfLoop Data Workflow component.

2.

Click the (Settings) button to open the Configuration window.

3.

In the Formula node, replace the Formula/Expression field with this formula: =ISNUMBER(SEARCH("@dailybugle.com",A2:C4))

4.

Click Save.

When you click Start Loop in Express View, everyone in your Data Table receives an email. In the DevTools Console, you'll see the rows of data and the SendGrid action:

Removing the Snippet

If you find you no longer need the For Loop feature in your module, you can remove it. To remove the Do While Loop snippet:

1.

In the Module Builder, hover over the panelDoWhileLoop Panel component.

A 5-button toolbar displays above the component on hover-over.

2.

Using the toolbar, click the (Remove) button.

3.

Save your module.