Skip to content

Commit a3116b7

Browse files
authored
Merge pull request SharePoint#5454 from jackwi-alt/patch-1
Update sharepoint-actions-triggers.md
2 parents b92b6bc + ce43c85 commit a3116b7

File tree

1 file changed

+35
-35
lines changed

1 file changed

+35
-35
lines changed

docs/business-apps/power-automate/get-started/sharepoint-actions-triggers.md

Lines changed: 35 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -6,28 +6,28 @@ Microsoft SharePoint Connector in Power Automate supports the following flow tri
66
Triggers the flow when an item is created.
77

88
#### When an item is created or modified
9-
Triggers the flow when an item is created, and also each time it is modified, in a SharePoint list.
9+
Triggers the flow when an item is created, and each time it is modified, in a SharePoint list.
1010

1111
#### When an item is deleted
12-
Triggers the flow when an item is deleted in a list. To get the properties of the deleted item, this trigger will need to connect using a site collection user account to the associated SharePoint site on which the trigger is epxected to run.
12+
Triggers the flow when an item is deleted in a list. To get the properties of a deleted item, this trigger must connect to the associated SharePoint site on which it is expected to run using a site collection user account.
1313

1414
#### For a selected item
1515
Triggers the flow for a selected item in a list.
1616

1717
#### When a file is created (properties only)
18-
Triggers the flow when a file is created in a document library and returns only the custom file properties associated with that file.
18+
Triggers the flow when a file is created in a document library, and returns only the custom file properties associated with that file.
1919

2020
#### When a file is created in a folder
21-
Triggers the flow when a file is created in a SharePoint folder. This trigger does not run if a file is added or updated in a subfolder inside the folder this trigger is operating on. If it is required to trigger on subfolders, different flows for one or more subfolder should be created.
21+
Triggers the flow when a file is created in a SharePoint folder. This trigger does not run if a file is added or updated in a subfolder inside the folder this trigger is operating on. If the flow is required to trigger on subfolders, create different flows for one or more subfolder(s).
2222

2323
#### When a file is created or modified (properties only)
24-
Triggers the flow when a file is created, and also each time if the file properties are modified in a library. Returns only the custom file properties associated with that file.
24+
Triggers the flow when a file is created, and each time the file properties are modified in a library. Returns only the custom file properties associated with that file.
2525

2626
#### When a file is created or modified in a folder (properties only)
27-
Triggers the when a file is created, and also each time the file properties are modified in the selected SharePoint folder. The trigger does not fire if a file is added/updated in a subfolder. If it is required to trigger on subfolders, different flows for one or more subfolder should be created.
27+
Triggers the flow when a file is created, and each time the file properties are modified in the selected SharePoint folder. The trigger does not activate if a file is added/updated in a subfolder. If the flow is required to trigger on subfolders, create different flows for one or more subfolder(s).
2828

2929
#### When a file is deleted
30-
Triggers the flow when a file is deleted in a document library. You can optionally specify a folder to watch as well. When a folder is deleted, the trigger will fire only once for the deleted folder including its subfolders. To get the properties of the deleted file, this trigger will need to connect using a site collection user account to the associated SharePoint site on which the trigger is epxected to run.
30+
Triggers the flow when a file is deleted in a document library. You can optionally specify a folder to watch. When a folder is deleted, the trigger activates only once for the deleted folder, including its subfolders. To get the properties of the deleted file, this trigger must connect to the associated SharePoint site on which the trigger is epxected to run using a site collection user account.
3131

3232
#### For a selected file
3333
Triggers the flow for a selected file in a document library.
@@ -41,25 +41,25 @@ Triggers a flow upon hub site join approval request.
4141
Adds a new attachment to the specified list item.
4242

4343
### Approve hub site join request
44-
Approve hub site join request. This will return an approval token that can be used to complete the join request using the join hub site action.
44+
Approves hub site join request. This action returns an approval token to complete the join request using the join hub site action.
4545

4646
### Cancel hub site join request
47-
Cancel hub join request. If applicable, you should specify the same Approval Correlation Id as used in the "Set hub site join status to pending" action.
47+
Cancels hub join request. If applicable, specify the same Approval Correlation Id as used in the "Set hub site join status to pending" action.
4848

4949
### Check in file
50-
Check in a checked out file in a document library, which makes the version of the document available to others.
50+
Checks in a checked out file in a document library, which makes the version of the document available to others.
5151

5252
### Check out file
53-
Check out a file in a document library to prevent others from editing the document, and your changes from being visible until the documented is checked in.
53+
Checks out a file in a document library to prevent others from editing the document, and your changes from being visible until you check in the document.
5454

5555
### Copy file
56-
Copies a file. Works in a similar way to the "Copy to" command in SharePoint libraries. Returns information about the new file after copy.
56+
Copies a file. Works similarly to the "Copy to" command in SharePoint libraries. Returns info about the new file after copying.
5757

5858
### Copy file (deprecated)
5959
Copies a file to a SharePoint site.
6060

6161
### Copy folder
62-
Copies a folder. Works in a similar way to the "Copy to" command in SharePoint libraries. Returns information about the new folder after copy.
62+
Copies a folder. Works similarly to the "Copy to" command in SharePoint libraries. Returns info about the new folder after copying.
6363

6464
### Create file
6565
Uploads a file to a SharePoint site. Make sure to pick an existing library.
@@ -71,7 +71,7 @@ Creates a new item in a SharePoint list.
7171
Creates a new folder or folder path.
7272

7373
### Create sharing link for a file or folder
74-
Create sharing link for a file or folder.
74+
Creates a sharing link for a file or folder.
7575

7676
### Delete attachment
7777
Deletes the specified attachment.
@@ -82,20 +82,20 @@ Deletes the file specified by the file identifier.
8282
### Delete item
8383
Deletes an item from a SharePoint list.
8484

85-
### Discard check out
86-
If you check out a file and don’t make changes to it, or you make changes that you don’t want to keep, you can simply discard the checkout, rather than saving the file. If your organization tracks versions, a new version is created each time you check a file back into the library. By discarding the checkout, you can avoid making new versions when you haven’t made any changes to the file.
85+
### Discard checkout
86+
Discards the checkout, rather than saves the file, if you check out a file and don’t make changes to it, or you make changes that you don’t want to keep. If your organization tracks versions, a new version is created each time you check a file back into the library. By discarding the checkout, you can avoid making new versions when you haven’t made any changes to the file.
8787

8888
### Extract folder
89-
Extracts an archive file into a SharePoint folder (example: .zip).
89+
Extracts an archive file into a SharePoint folder (for example, .zip).
9090

9191
### Get all lists and libraries
92-
Get all lists and libraries.
92+
Gets all lists and libraries.
9393

9494
### Get attachment content
9595
Returns file contents using the file identifier. The contents can be copied somewhere else, or be used as an attachment.
9696

9797
### Get attachments
98-
Returns the list of attachments for the specified list item. You can add a "Get attachment content" step and use the "File identifier" property returned by this action to get to the contents of the file.
98+
Returns the list of attachments for the specified list item. To get to the contents of the file, add a "Get attachment content" step, and use the "File identifier" property returned by this action.
9999

100100
### Get file content
101101
Gets file contents using the file identifier. The contents can be copied somewhere else, or be used as an attachment.
@@ -104,22 +104,22 @@ Gets file contents using the file identifier. The contents can be copied somewhe
104104
Gets file contents using the file path.
105105

106106
### Get file metadata
107-
Gets information about the file such as size, etag, created date, etc. Uses a file identifier to pick the file. Use "Get file properties" action to get to the values stored in the columns in the library.
107+
Gets info about the file, such as size, etag, created date, and so on. Uses a file identifier to pick the file. To get to the values stored in the columns in the library, use "Get file properties" action.
108108

109109
### Get file metadata using path
110-
Gets information about the file such as size, etag, created date, etc. Uses a file path to pick the file. Use "Get file properties" action to get to the values stored in the columns in the library.
110+
Gets info about the file, such as size, etag, created date, and so on. Uses a file path to pick the file. To get to the values stored in the columns in the library, use "Get file properties" action.
111111

112112
### Get file properties
113-
Gets the properties saved in the columns in the library for the item specified by the item id. You can add a "Get file content" step and use the "File identifier" property returned by this action to get to the contents of the file. When using this with the On-Premises Data Gateway, the name of the library to connect to may need to be entered manually.
113+
Gets the properties saved in the columns in the library for the item specified by the item id. To get to the contents of the file, add a "Get file content" step, and use the "File identifier" property returned by this action. When using this with the On-Premises Data Gateway, you may need to manually enter the name of the library to connect to.
114114

115115
### Get files (properties only)
116-
Gets the properties saved in the columns in the library for all folders and files stored in the library. You can also filter down to the items that match a condition. An "Apply to each" section is usually used to work with the output from this action. When using this with the On-Premises Data Gateway, the name of the library to connect to may need to be entered manually.
116+
Gets the properties saved in the columns in the library for all folders and files stored in the library. You can also filter down to the items that match a condition. Use "Apply to each" section to work with the output from this action. When using this with the On-Premises Data Gateway, you may need to be manually enter the name of the library to connect to.
117117

118118
### Get folder metadata
119-
Gets information about the folder. Uses a file identifier to pick the folder.
119+
Gets info about the folder. Uses a file identifier to pick the folder.
120120

121121
### Get folder metadata using path
122-
Gets information about the folder. Uses a folder path to pick the folder.
122+
Gets info about the folder. Uses a folder path to pick the folder.
123123

124124
### Get item
125125
Gets a single item by its id from a SharePoint list.
@@ -134,10 +134,10 @@ Gets views from a SharePoint list.
134134
Gets SharePoint lists from a site.
135135

136136
### Grant access to an item or a folder
137-
Grant access to an item or a folder in SharePoint to specific people.
137+
Grants access to an item or a folder in SharePoint to specific people.
138138

139139
### Join hub site
140-
Join the requested site to the hub site. An Approval Token is required to complete the join successfully if that hub requires approval. If applicable, you should specify the same Approval Correlation Id as used in the "Set hub site join status to pending" action.
140+
Joins the requested site to the hub site. An Approval Token is required to complete the join successfully if that hub requires approval. If applicable, specify the same Approval Correlation Id as used in the "Set hub site join status to pending" action.
141141

142142
### List folder
143143
Returns files contained in a SharePoint folder.
@@ -146,31 +146,31 @@ Returns files contained in a SharePoint folder.
146146
Returns files in the root SharePoint folder.
147147

148148
### Move file
149-
Moves a file. Works in a similar way to the "Move to" command in SharePoint libraries. Returns information about the new file after move.
149+
Moves a file. Works similarly to the "Move to" command in SharePoint libraries. Returns info about the new file after its move.
150150

151151
### Move folder
152-
Moves a folder. Works in a similar way to the "Move to" command in SharePoint libraries. Returns information about the new folder after move.
152+
Moves a folder. Works similarly to the "Move to" command in SharePoint libraries. Returns info about the new folder after its move.
153153

154154
### Resolve person
155-
Returns a single matching user value so it can be assigned to a column of type person. If there are no matches, or multiple matches, this action will error out.
155+
Returns a single matching user value so it can be assigned to a column of type person. If there are no matches, or multiple matches, this action errors out.
156156

157157
### Send an HTTP request to SharePoint
158-
Construct a SharePoint REST API to invoke. NoteThis action may execute any SharePoint REST API you have access to. Please proceed with caution.
158+
Constructs a SharePoint REST API to invoke. Note: This action may execute any SharePoint REST API you have access to. Proceed with caution.
159159

160160
### Set content approval status
161161
Sets the content approval status for an item in a list or library that has content approval turned on. You must provide an ETag for pages and files. You can get the ETag using the Get File Metadata action. This action is only available for SharePoint Online and SharePoint 2019.
162162

163163
### Set hub site join status to pending
164-
Set the requested site's hub join request status to pending. The Approval Correlation Id is an optional parameter that helps SharePoint identify a particular hub join request. The requesting site can only have one pending request at a given time.
164+
Sets the requested site's hub join request status to pending. The Approval Correlation Id is an optional parameter that helps SharePoint identify a particular hub join request. The requesting site can only have one pending request at a given time.
165165

166166
### Stop sharing an item or a file
167-
Delete all links giving access to an item or a file and remove all people with direct access except for owners.
167+
Deletes all links giving access to an item or a file, and removes all people with direct access, except for owners.
168168

169169
### Update file
170170
Updates the contents of the file specified by the file identifier.
171171

172172
### Update file properties
173-
Updates the properties stored in columns in a library for the item specified by the item id. Use "Update file" action to update file contents. When using this with the On-Premises Data Gateway, the name of the library to connect to may need to be entered manually.
173+
Updates the properties stored in columns in a library for the item specified by the item id. To update file contents, use the "Update file" action. When using this with the On-Premises Data Gateway, you may need to manually enter the name of the library to connect to.
174174

175175
### Update item
176-
Updates an item in a SharePoint list.
176+
Updates an item in a SharePoint list.

0 commit comments

Comments
 (0)