Collect Contact Info from Your User

Learning Objectives

In this project, you’ll use Flow Builder to build a working flow that:

Captures information from a user.
Queries your Salesforce org for a record that matches what the user enters.
Decides whether to update the matching record or create a new one.
Creates or updates a record.

Accessibility

This unit requires some additional instructions for screen reader users. To access a detailed screen reader version of this unit, click the link below:

Open Trailhead screen reader instructions.

Introduction

This project walks you through the motions of building a simple flow. Launch your Trailhead Playground now to follow along as we complete this project. Follow the instructions and observe how the various controls work in Flow Builder. By the end of this project, you’ll have a working flow. To open your Trailhead Playground, scroll down to the hands-on challenge and click Launch. Let’s get started!

Create the Flow and Add a Screen

From Setup, enter Flows in the Quick Find box, then select Flows.
Click New Flow, select Screen Flow, and click Create.
On the flow canvas, on the path after the Start element, hover over and click .
Click Screen. The New Screen window opens.
Under Screen Properties for Label, enter Contact Info.
The API Name is automatically set to Contact_Info.
Click Done. The canvas now includes three items: Start, Contact Info, and End.

Click Save, and enter these values.

Field	Value
Flow Label	`New Contact`
Flow API Name	`New_Contact`

Click Save.

Create a Record Variable for the Contact

Because you plan to capture contact information from the user, let’s create a record variable to store that contact record data in the flow.

Click to view the Toolbox.
In the Manager tab, click New Resource.
For Resource Type, select Variable.
For API Name, enter contact.
For Data Type, select Record.
For Object, enter Contact.
Click Done. In the toolbox, the Manager tab now contains a contact record variable resource.
Click Save.

Add a Name Input Component to the Screen

You need to create form fields for the user to enter contact information on the screen. Let’s start with an input component that collects the contact’s name.

On the canvas, double-click the Contact Info screen. The Edit Screen window opens.
In the Components pane, enter Name in the search box.
Drag Name onto the screen canvas.

The properties pane now represents the Name input component.
In the properties pane, for API Name, enter contactName.
Scroll down and click Advanced. Make sure Manually assign variables is selected.
Complete these steps to take what the user enters in the First Name and Last Name fields and store those values in the contact record variable.
1. For First Name, enter {!contact.FirstName}.
2. For Last Name, enter {!contact.LastName}.
Click Done.
Click Save.

Add a Picklist Input Component to the Screen

Now let’s add the picklist for the user to select the contact’s parent account.

On the canvas, double-click the Contact Info screen.
In the Screen Components pane, enter Picklist in the search box.
Drag Picklist onto the screen canvas just below the Name component.

The properties pane now represents the Picklist input component.

In the properties pane, enter these values.

Field	Value
Label	`Account`
API Name	`Account`
Data Type	Text

In the Configure Choices section, for Choice, select New Choice Resource. Enter these values.

Field	Value
Resource Type	Record Choice Set
API Name	`accounts`
Object	Account
Condition Requirements	None—Get All Account Records
Choice Label	Name
Data Type	Text
Choice Value	Id

In the Store More Account Field Values section, complete these steps to store the ID of the user-selected account in the contact record variable.
1. For Field, select Id.
2. For Variable, enter {!contact.AccountId}.
Click Done twice.
Click Save.

Add a Toggle Input Component to the Screen

Now let’s add the toggle for the user to specify whether (or not) to update an existing contact if one is found.

On the canvas, double-click the Contact Info screen.
From the Screen Components pane, drag Toggle onto the screen canvas just below the Account picklist component.

In the properties pane, enter these values.

Field	Value
API Name	`update_toggle`
Label	`If this contact already exists, update the existing record.`
Active Label	`Update existing`
Inactive Label	`Create other contact`
Manually assign variables (under Advanced)	unchecked
Revisited Screen Values (under Advanced)	Use values from when the user last visited this screen

Click Done.
Click Save.

Close and Open the Flow

To exit Flow Builder, click the back arrow.
The flow list page appears.
To reopen the flow in Flow Builder, find New Contact on the flow list page, and click it.

Run the Flow to View the Screen

At this point, your flow can collect contact information from the user and store that information in flow variables. Let’s see what the screen looks like to users who run the flow.

Above the canvas, click Run.
Enter any values, select any account from the list, and click Finish.

Because the flow has no elements to execute after the screen, nothing happens when the flow finishes. The flow simply runs again, which means that you see the screen again.

Congrats on building and even running a flow! So far, the flow only displays a screen that accepts user input. Next, you configure the flow to compare some of that user input with data in your org.