Skip to content

Commit d567b31

Browse files
authored
Merge pull request SharePoint#5506 from jackwi-alt/patch-4
Edit scrub and updated steps with new UI.
2 parents 750519c + 723a481 commit d567b31

File tree

1 file changed

+46
-56
lines changed

1 file changed

+46
-56
lines changed

docs/business-apps/power-automate/get-started/create-your first-flow.md

Lines changed: 46 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -8,136 +8,126 @@ localization_priority: Priority
88

99
# Send an email when a new item is created or modified in a SharePoint list
1010

11-
Using Microsoft Flow you can easily automate day-to-day tasks or build repetetive tasks in SharePoint that help you stay productive.
11+
Using Power Automate, you can easily automate day-to-day tasks or build repetitive tasks in SharePoint that help you stay productive.
1212

13-
In this tutorial, you will create a flow that will send an email when a new item is added or modified in a SharePoint list.
13+
In this tutorial, you will create a flow that sends an email when a new item is added or modified in a SharePoint list.
1414

1515
## Required setup
1616

17-
Before following the steps in this artucle, make sure your SharePoint site is set up with the required lists and libraries.
17+
Before proceeding with these instructions, make sure your SharePoint site is set up with the required lists and libraries.
1818

1919
## Create a flow
2020

21-
1. Browse to the *Projects* list in your SharePoint site.
21+
1. In your SharePoint site, browse to the **Projects** list.
2222

23-
2. You can create and manage flows for a list or a library by clicking on the *Flow* button on the command bar on the list or library page.
24-
25-
3. Clicking on the *Flow* button exapnds to show you more options:
23+
2. To create and manage flows for a list or a library, from the command bar, on the list or library page, select **Automate** > **Power Automate**. Selecting **Power Automate** expands to show you more options:
2624

2725
* Create a flow
2826
* See your flows
27+
* Configure flows
2928

30-
> **Note:** You may see other options as well such as 'Request sign-off' and other flows if they are available for the list or library here.
29+
> **Note:** If they are available for the list or library here, you may see other options such as **Set a reminder** and other flows.
3130
3231
![Create a flow from Projects list](../../../images/gs01-create-a-flow-command-bar.png)
3332

34-
4. Click on *Create a flow*.
35-
36-
5. In the *Create a flow* panel, you can explore various templates available for your list.
33+
3. Select **Create a flow**. In the **Create a flow** panel, you can explore various templates available for your list.
3734

3835
![Create a flow panel in lists](../../../images/gs01-create-a-flow-panel.png)
3936

40-
6. Click on the template that reads:
37+
4. Select the template that reads:
4138
> Send a customized email when a new SharePoint list item is added.
4239
43-
7. This will take you to the Flow website where it will display more options:
44-
* Template information
45-
* Name and description of the template.
46-
* Connection information
47-
* Varioius services this flow connect to.
48-
* The credentials those services will use to connect to.
49-
8. Verify the connection information to ensure it uses your credentials.
40+
On a new browser tab, the **Power Automate** website appears and displays:
41+
* Template information
42+
* Name and description of the template.
43+
* Connection information
44+
* Varioius services this flow connect to.
45+
* The credentials those services will use to connect to.
46+
47+
5. Using the dropdowns, verify the connection information (**SharePoint Site Address** and **SharePoint List Name**) is accurate to ensure it uses your credentials.
5048
> A green checkmark icon indicates a connection to the service was succesfully made using your credentials.
5149
5250
![Flow template - send email when an item is added in a list](../../../images/gs01-create-a-flow-when-item-is-added-template.png)
5351

54-
9. Click *Continue* to create the flow. Any connections that requires a connection will also be attempted during this step.
55-
56-
10. Once the flow is created successfully, you will be redirected to the flow designer where you can edit and modifify the flow if needed.
52+
6. To create the flow, select **Create Flow**. Any connections that require a connection is also attempted during this step. After the flow is created successfully, you are redirected to the flow designer where you can edit and modifify the flow if needed.
5753

5854
![Flow designer - send email when an item is added in a list](../../../images/gs01-designer-when-item-is-added-template.png)
5955

60-
11. Click on the name of the flow that reads *Send a customized email when a new SharePoint list item is added* and enter the following name for the flow:
56+
7. Select the name of the flow that reads **Send a customized email when a new SharePoint list item is added**, and enter the following name for the flow:
6157
* Send an email for new projects
6258

63-
12. The SharePoint actions are represented with the SharePoint logo in the flow designer.
59+
The SharePoint actions are represented with the SharePoint logo in the flow designer.
6460

65-
13. In the *When the new item is created* action, click on *Edit* to expand the action.
61+
8. In the **When the new item is created** action, to expand the action, select **Edit**. Note the input configured to the SharePoint site address and list name from where you created the flow.
6662

67-
14. Notice the input configured to the SharePoint site address and list name from where you created the flow.
63+
9. In the **Send Email** action, to expand the action, select **Edit**. All the input is filled in with dynamic values from the **Get my profile** and **When the new item is created** actions.
6864

69-
15. In the *Send Email* action, click on *Edit* to expand the action.
70-
71-
16. Notice all the input is filled in with dynamic values from the *Get my profile* and *When the new item is created* actions.
72-
73-
17. Hover over the dynamic values to see what properties they refer. For example, hovering over the *Email* shows that the property is read from the *Get my profile*'s *Mail* property.
65+
10. Hover over the dynamic values to see what properties they reference. For example, hovering over **Email** shows that the property is read from the **Mail** property in **Get my profile**.
7466

7567
![Flow designer - hover to see dynamic content](../../../images/gs01-designer-hover-dynamic-content.png)
7668

77-
18. Click *Save* to save the flow.
69+
11. To save the flow, select **Save**.
7870

79-
Your flow is active as soon as you save the flow. In our case, this flow *Send an email for new projects* is now active and will run whenever new items are added to the *Projects* list in the specified SharePoint site.
71+
Your flow is active as soon as you save the flow. In this case, this flow **Send an email for new projects** is now active, and runs whenever new items are added to the **Projects** list in the specified SharePoint site.
8072

8173
## Test your flow
8274

83-
In order to test your flow, you can test it by adding a new item in SharePoint list by adding a new item or initiating the test run directly from the flow designer. Follow the steps below to test the flow from the designer. Testing the flow from the designer helps you to quickly see the flow run as the flow is executed.
75+
To test your flow, either add a new item in SharePoint list by adding a new item, or initiate the test run directly from the flow designer. To test the flow from the designer, follow these steps. Testing the flow from the designer helps you to quickly see the flow run as the flow is executed.
8476

85-
1. In the flow designer, click on *Test* on the top command bar.
77+
1. In the flow designer, on the top command bar, select **Test**.
8678

87-
2. In the *Test Flow* panel, click on *I'll perform the trigger action* and then click on *Save & Test* button.
79+
2. In the **Test Flow** panel, select **I'll perform the trigger action**, and then select **Save & Test**.
8880

8981
![Flow designer - hover to see dynamic content](../../../images/gs01-designer-test-flow.png)
9082

91-
3. You should see a message that instructs to add a new list item to the SharePoint list you selected.
83+
A message appears instructing you to add a new list item to the SharePoint list you selected.
9284

9385
![Flow designer - test flow message](../../../images/gs01-designer-test-flow-message.png)
9486

95-
4. You should have the browser tab with the *Projects* list opened already. If not, open a new browser tab and browse to the *Projects* list.
87+
3. You should have the browser tab with the **Projects** list opened already. If not, open a new browser tab, and browse to the **Projects** list.
9688
> Do not close the flow designer. Make sure you keep the flow designer browser tab open.
9789
98-
5. In the *Projects* list, click on the *New* button on the command bar, add the item as specified below and click *Save*:
90+
4. In the **Projects** list, on the command bar, select **New**, and add the following items, and then select **Save**:
9991
* Title: Project 4
100-
* Owner: pick a user from people picker
101-
102-
6. Switch to the flow designer tab.
92+
* Owner: Select a user from people picker
10393

104-
7. You should see the flow run history. If all of the actions were executed successfully, you will a green checkmark icon besides every action.
94+
5. Switch to the flow designer tab. The flow run history appears. If all of your actions were executed successfully, a green checkmark icon appears aside every action.
10595

10696
![Flow designer - flow run history](../../../images/gs01-designer-test-flow-run.png)
10797

108-
8. You can also click on the action to see the inputs and outputs used in the flow run. This is also a good place to see the actual values translated from those dynamic content properties used in that action.
98+
6. Select the action to see the inputs and outputs used in the flow run. This is also a good place to see the actual values translated from those dynamic content properties used in that action.
10999

110-
9. As a result of this flow, you should have received an email as well regarding the new project information.
100+
As a result of this flow, you receive an email regarding the new project information.
111101

112102
## Modify your flow
113103

114-
1. In the flow designer, click *Edit* to edit your flow.
104+
1. In the flow designer, to edit your flow, select **Edit**.
115105

116-
2. Click on the *Send Email* action.
106+
2. Select the **Send Email** action.
117107

118-
3. In the *Body* input, append the following string after the *Name* dynamic property:
108+
3. In the **Body** input, after the **Name** dynamic property, append the following string:
119109
* Owner:
120110

121-
4. While you are still editing the *Body* input, notice the *dynamic content* list that appears beside the action.
111+
4. While you are still editing the **Body** input, note the **dynamic content** list that appears aside the action.
122112

123-
5. In the *dynamic content* list, you can pick values from the actions in your flow. For example: The project owner information is available in the *When the new item is created* trigger.
113+
5. In the **dynamic content** list, select values from the actions in your flow, (for example, in the **When the new item is created** trigger, the project owner information is available.
124114

125-
6. To add the owner information, search for *owner* in the search box in the *dynamic content* list.
115+
6. To add the owner information, in the **dynamic content** list, in the search box, search for **owner**.
126116

127117
![Flow designer - add owner dynamic content](../../../images/gs01-designer-append-owner-dynamic-content.png)
128118

129-
7. In the results, click on *Owner DisplayName*. As you can see, it also displays other information such as email, job title, picture and more. Since the *Owner* is a person column in SharePoint, SharePoint passes along the person details as individual properties to the flow.
119+
7. In the results, select **Owner DisplayName**. As you can see, it also displays other information, such as email, job title, picture and more. Because the **Owner** is a **person** column in SharePoint, SharePoint passes along the person details as individual properties to the flow.
130120

131-
8. The modified *Body* input should now look like this with the included *Owner* information.
121+
The modified **Body** input appears like this with the included **Owner** info.
132122

133123
![Flow designer - add owner dynamic content](../../../images/gs01-designer-email-body-with-owner.png)
134124

135-
9. Repeat the steps to test the flow.
125+
8. To test the flow, repeat these steps.
136126

137-
10. You should now get an email with the updated owner information in it.
127+
You receive an email with the updated owner information in it.
138128

139129
## Next steps
140130

141131
Congratulations on creating your first flow!
142132

143-
In the next topic, we will use the same flow and add the ability to interact with Microsoft Teams.
133+
In the next topic, we will use the same flow, and add the ability to interact with Microsoft Teams.

0 commit comments

Comments
 (0)