diff --git a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-create-file-action.png b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-create-file-action.png index 1ec6500d3..189fd8da8 100644 Binary files a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-create-file-action.png and b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-create-file-action.png differ diff --git a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-file-content-using-path-action.png b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-file-content-using-path-action.png index a8aefe87f..0e4939a96 100644 Binary files a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-file-content-using-path-action.png and b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-file-content-using-path-action.png differ diff --git a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-folder-metadata-using-path-actio-name-property.png b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-folder-metadata-using-path-actio-name-property.png index 54239442e..e86cc87b8 100644 Binary files a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-folder-metadata-using-path-actio-name-property.png and b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-folder-metadata-using-path-actio-name-property.png differ diff --git a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-folder-metadata-using-path-action.png b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-folder-metadata-using-path-action.png index 6ba9f895c..898ddc7c8 100644 Binary files a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-folder-metadata-using-path-action.png and b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-get-folder-metadata-using-path-action.png differ diff --git a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-list-folder-action-second.png b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-list-folder-action-second.png index 6635d76f7..e966f2df3 100644 Binary files a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-list-folder-action-second.png and b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-list-folder-action-second.png differ diff --git a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-list-folder-action.png b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-list-folder-action.png index dfb256ebb..f95d8d9a2 100644 Binary files a/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-list-folder-action.png and b/articles/desktop-flows/actions-reference/media/sharepoint/sharepoint-list-folder-action.png differ diff --git a/articles/desktop-flows/actions-reference/sharepoint.md b/articles/desktop-flows/actions-reference/sharepoint.md index 5d670062a..893ddf7cc 100644 --- a/articles/desktop-flows/actions-reference/sharepoint.md +++ b/articles/desktop-flows/actions-reference/sharepoint.md @@ -4,13 +4,10 @@ description: SharePoint (preview) Actions Reference author: georgiostrantzas ms.subservice: desktop-flow ms.topic: reference -ms.date: 07/29/2022 +ms.date: 11/22/2022 ms.author: gtrantzas -ms.reviewer: marleon +ms.reviewer: dipapa contributors: -- Yiannismavridis -- NikosMoutzourakis -- PetrosFeleskouras search.app: - Flow search.audienceType: @@ -20,42 +17,49 @@ search.audienceType: # SharePoint (preview) -The SharePoint (preview) group of actions allows the utilization of the [SharePoint connector](/connectors/sharepointonline) from within desktop flows, alleviating the need to create a cloud flow in order to use its actions. This connector is the same as the one used across Power Automate cloud flows, PowerApps, and Logic Apps. It uses the same parameters and returns the same type of data. +The SharePoint (preview) group of actions allows the utilization of the [SharePoint connector](/connectors/sharepointonline) from within desktop flows, alleviating the need to create a cloud flow in order to use its actions. This connector is the same as the one used across Power Automate cloud flows, PowerApps, and Logic Apps. It uses the same parameters and returns the same type of data. ## Prerequisites and limitations - During preview, you need an Attended RPA license. -- Sharing desktop flows with SharePoint cloud actions isn't supported. Co-owners won't be able to run such desktop flows unless they overwrite the connection references with their own. **Users** with read access are unable to run such flows. +- Sharing desktop flows with SharePoint cloud actions isn't supported. Co-owners won't be able to run such desktop flows unless they overwrite the connection references with their own. **Users** with read access are unable to run such flows. -- DLPs that include SharePoint cloud actions aren't enforced within desktop flows. During preview, machine administrators can disable the SharePoint actions by modifying the [appropriate registry setting](../governance.md#prevent-power-automate-for-desktop-from-running-flows-containing-cloud-connectors). +- Data loss prevention policies (DLP) that include SharePoint cloud actions aren't enforced within desktop flows. During preview, machine administrators can disable the SharePoint actions by modifying the [appropriate registry setting](../governance.md#prevent-power-automate-for-desktop-from-running-flows-containing-cloud-connectors). - Refrain from modifying a response’s properties directly as it may lead to an erroneous state after future updates. Instead, opt for storing the properties you want to utilize (from the response retrieved) directly into separate variables. -## Why should I use SharePoint actions inside desktop flows instead of cloud flows? +## Why should I use SharePoint actions inside desktop flows instead of cloud flows? -Users can still combine SharePoint actions with the **Run a flow built with Power Automate for desktop** action. However, SharePoint actions inside desktop flows improve performance and ease of use for users that need to loop between cloud and desktop actions. +Users can still combine SharePoint actions with the **Run a flow built with Power Automate for desktop** action. However, SharePoint actions inside desktop flows improve performance and ease of use for users who need to loop between cloud and desktop actions. ## List of SharePoint actions -- [Get file content by path](#get-file-content-using-path) -- [Get folder by path](#get-folder-metadata-using-path) -- [Get file metadata by path](#get-file-metadata-using-path) -- [Create file](#create-file) - [Update file](#update-file) - [Delete file](#delete-file) +- [Get file content using path](#get-file-content-using-path) +- [Get file content](#get-file-content) +- [Create file](#create-file) - [List folder](#list-folder) +- [Get all lists and libraries](#get-all-lists-and-libraries) +- [Get file metadata](#get-file-metadata) +- [Get file metadata using path](#get-file-metadata-using-path) +- [Get folder metadata](#get-folder-metadata) +- [Get folder metadata using path](#get-folder-metadata-using-path) +- [List root folder](#list-root-folder) +- [Extract folder](#extract-folder) +- [Get lists](#get-lists) ## Getting started with SharePoint actions in desktop flows -### How to download the content of a SharePoint folder +This section presents examples on how to use SharePoint actions in your desktop flows. + +### How to download the content of a SharePoint folder > [!IMPORTANT] > Before replicating the following steps, ensure that you are familiar with [lists](../variable-data-types.md#list), [custom objects](../variable-data-types.md#custom-object), [loops](../use-loops.md), [conditionals](../use-conditionals.md), and the [percentage notation](../variable-manipulation.md). -1. Create a SharePoint connection reference in any solution. You can find information regarding how to create connection references in [Use a connection reference in a solution](/power-apps/maker/data-platform/create-connection-reference). - -1. Ensure that you've installed the [latest version of Power Automate for desktop ](../install.md). +1. Ensure that you've installed the [latest version of Power Automate for desktop](../install.md). 1. Create a new desktop flow. @@ -79,9 +83,9 @@ Users can still combine SharePoint actions with the **Run a flow built with Powe ![Screenshot of the Convert binary data to file action.](media\sharepoint\convert-binary-data-file-action.png) -The previous steps cover the case where the target folder contains only files. However, if the folder contains subfolders with files inside them, modify your desktop flow accordingly: +The previous steps cover the case where the target folder contains only files. However, if the folder contains subfolders with files inside them, modify your desktop flow accordingly: -1. Add an **If** condition inside the previously deployed loop to check whether the currently selected item is a folder. To perform this check, use the **IsFolder** property of the current item. +1. Add an **If** condition inside the previously deployed loop to check whether the currently selected item is a folder. To perform this check, use the **IsFolder** property of the current item. ![Screenshot of the if action that checks whether the current item is a folder.](media\sharepoint\if-action-folder.png) @@ -89,7 +93,7 @@ The previous steps cover the case where the target folder contains only files. H ![Screenshot of the second Get folder metadata using path action.](media\sharepoint\sharepoint-get-folder-metadata-using-path-actio-name-property.png) -1. As you did before, deploy the **List folder** SharePoint action and populate the appropriate SharePoint URL and the previously retrieved identifier. +1. As you did before, deploy the **List folder** SharePoint action and populate the appropriate SharePoint URL and the previously retrieved identifier. ![Screenshot of the second List folder action.](media\sharepoint\sharepoint-list-folder-action-second.png) @@ -108,11 +112,9 @@ If you want to download only files of a specific type, add a conditional before ![Screenshot of a conditional that checks the current item's file type.](media\sharepoint\if-action-item-type.png) -### How to upload a local file to SharePoint +### How to upload a local file to SharePoint -1. Create a SharePoint connection reference in any solution. You can find information regarding how to create connection references in [Use a connection reference in a solution](/power-apps/maker/data-platform/create-connection-reference). - -1. Ensure that you've installed the [latest version of Power Automate for desktop ](../install.md). +1. Ensure that you've installed the [latest version of Power Automate for desktop](../install.md). 1. Create a new desktop flow. @@ -120,9 +122,9 @@ If you want to download only files of a specific type, add a conditional before ![Screenshot of the Convert file to binary data action.](media\sharepoint\convert-file-binary-data-action.png) -1. Find the **SharePoint (preview)** group of actions in the flow designer and deploy the **Create file** action in the workspace. +1. Find the **SharePoint (preview)** group of actions in the flow designer and deploy the **Create file** action in the workspace. -1. Select an existing connection reference and fill in the required parameters. Here's an example about how to fill the fields: +1. Select an existing connection reference and fill in the required parameters. Here's an example about how to fill the fields: > [!IMPORTANT] > Don't forget to add the appropriate file extension after the file name. @@ -131,24 +133,99 @@ If you want to download only files of a specific type, add a conditional before ## How to fill action’s input fields -Until dynamic suggestions of input fields become available, here's guidance on what data to fill in for each action. +Until dynamic suggestions of input fields become available, here's guidance on what data to fill in for each action. > [!NOTE] > Another way to see which properties are expected as input and output is to create a cloud flow with the same action and observe its dynamic data properties. To find more information regarding the SharePoint cloud actions, refer to [SharePoint](/connectors/sharepointonline). -### Get file content using path +### Update file + +Updates the contents of the file specified by the file identifier. + +#### Parameters + +|Name |Key |Required |Type |Description | +|-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|File Identifier |id |True |String |The unique id of the file to select. | +|File Content |body |True |Binary |The content of the file. | + +#### Returns + +|Name |Path |Type |Description | +|-------------|-------------|----------|------------------------------------------------------------------------| +|Id |Id |String |The unique id of the file or folder. | +|Name |Name |String |The name of the file or folder. | +|DisplayName |DisplayName |String |The display name of the file or folder. | +|Path |Path |String |The path of the file or folder. | +|LastModified |LastModified |Date-time |The date and time the file or folder was last modified. | +|Size |Size |Integer |The size of the file or folder. | +|MediaType |MediaType |String |The media type of the file or folder. | +|IsFolder |IsFolder |Boolean |A boolean value (true, false) to indicate whether the blob is a folder. | +|ETag |ETag |String |The etag of the file or folder. | +|FileLocator |FileLocator |String |The file locator of the file or folder. | + +### Delete file + +Deletes the file specified by the file identifier. + +#### Parameters + +|Name |Key |Required |Type |Description | +|-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|File Identifier |id |True |String |The unique id of the file to select. | + +### Get file content using path Gets file contents using the file path. -#### Parameters +#### Parameters + +|Name |Key |Required |Type |Description | +|-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|File Path |path |True |String |The path of the target file, for example: "/Shared Documents/MyFolderName/myfilename.xlsx". | +|Infer Content Type |inferContentType| |Boolean|This parameter isn't needed when using the **Get file content using path** action in desktop flows, as the maker can define the file extension to use with the **Convert binary data to file** action. | + +#### Returns + +|Name |Path |Type |Description | +|-------------|-------------|----------|------------------------------------------------------------------------| +|File Content |FileContent |Binary |The content of the file in binary format. | + +### Get file content + +Get file contents using the file identifier. The contents can be copied somewhere else, or be used as an attachment. + +#### Parameters |Name |Key |Required |Type |Description | |-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| -|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
https://contoso.sharepoint.com/sites/sitename | -|File Path |path |True |String |The path of the target file, for example: "/Shared Documents/MyFolderName/myfilename.xlsx" | +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|File Identifier |id |True |String |The unique id of the file to select. | |Infer Content Type |inferContentType| |Boolean|This parameter isn't needed when using the **Get file content using path** action in desktop flows, as the maker can define the file extension to use with the **Convert binary data to file** action. | -#### Returns +#### Returns + +|Name |Path |Type |Description | +|-------------|-------------|----------|------------------------------------------------------------------------| +|File Content |FileContent |Binary |The content of the file in binary format. | + +### Create file + +Uploads a file to a SharePoint site. Make sure to pick an existing library. + +#### Parameters + +|Name |Key |Required |Type |Description | +|-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|Folder Path |folderPath |True |String |Must start with an existing library. Add folders if needed. | +|File Name |name |True |String |The name of the file. | +|File Content |body |True |Binary |The content of the file. | + +#### Returns |Name |Path |Type |Description | |-------------|-------------|----------|------------------------------------------------------------------------| @@ -162,24 +239,23 @@ Gets file contents using the file path. |MediaType |MediaType |String |The media type of the file or folder. | |IsFolder |IsFolder |Boolean |A boolean value (true, false) to indicate whether the blob is a folder. | |ETag |ETag |String |The etag of the file or folder. | -|FileLocator |FileLocator |String |The filelocator of the file or folder. | +|FileLocator |FileLocator |String |The file locator of the file or folder. | -### Get folder metadata using path +### List folder -Gets information about the folder. Uses a folder path to pick the folder. +Returns files contained in a SharePoint folder. -#### Parameters +#### Parameters |Name |Key |Required |Type |Description | |-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| -|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
https://contoso.sharepoint.com/sites/sitename | -|Folder Path |path |True |String |The path of the target folder, for example: "/Shared Documents/MyFolderName | +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|File Identifier |id |True |String |The unique id of the folder. | -#### Returns +#### Returns |Name |Path |Type |Description | |-------------|-------------|----------|------------------------------------------------------------------------| -|ItemId |ItemId |Integer |The value to use to get or update file properties in libraries. | |Id |Id |String |The unique id of the file or folder. | |Name |Name |String |The name of the file or folder. | |DisplayName |DisplayName |String |The display name of the file or folder. | @@ -189,20 +265,36 @@ Gets information about the folder. Uses a folder path to pick the folder. |MediaType |MediaType |String |The media type of the file or folder. | |IsFolder |IsFolder |Boolean |A boolean value (true, false) to indicate whether the blob is a folder. | |ETag |ETag |String |The etag of the file or folder. | -|FileLocator |FileLocator |String |The filelocator of the file or folder. | +|FileLocator |FileLocator |String |The file locator of the file or folder. | + +### Get all lists and libraries + +Get all lists and libraries. + +#### Parameters + +|Name |Key |Required |Type |Description | +|-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | -### Get file metadata using path +#### Returns -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. +|Name |Path |Type |Description | +|-------------|-------------|----------------|------------------------------------------------------------------------| +|value |value |array of Tables |List of Tables | -#### Parameters +### Get file metadata + +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. + +#### Parameters |Name |Key |Required |Type |Description | |-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| -|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
https://contoso.sharepoint.com/sites/sitename | -|File Path |path |True |String |The path of the target file, for example: "/Shared Documents/MyFolderName/myfilename.xlsx" | +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|File Identifier |id |True |String |The unique id of the folder. | -#### Returns +#### Returns |Name |Path |Type |Description | |-------------|-------------|----------|------------------------------------------------------------------------| @@ -216,22 +308,20 @@ Gets information about the file such as size, etag, created date, etc. Uses a fi |MediaType |MediaType |String |The media type of the file or folder. | |IsFolder |IsFolder |Boolean |A boolean value (true, false) to indicate whether the blob is a folder. | |ETag |ETag |String |The etag of the file or folder. | -|FileLocator |FileLocator |String |The filelocator of the file or folder. | +|FileLocator |FileLocator |String |The file locator of the file or folder. | -### Create file +### Get file metadata using path -Uploads a file to a SharePoint site. Make sure to pick an existing library. +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. -#### Parameters +#### Parameters |Name |Key |Required |Type |Description | |-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| -|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
https://contoso.sharepoint.com/sites/sitename | -|Folder Path |folderPath |True |String |Must start with an existing library. Add folders if needed. | -|File Name |name |True |String |The name of the file. | -|File Content |body |True |Binary |The content of the file. | +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|File Path |path |True |String |The path of the target file, for example: "/Shared Documents/MyFolderName/myfilename.xlsx". | -#### Returns +#### Returns |Name |Path |Type |Description | |-------------|-------------|----------|------------------------------------------------------------------------| @@ -245,24 +335,24 @@ Uploads a file to a SharePoint site. Make sure to pick an existing library. |MediaType |MediaType |String |The media type of the file or folder. | |IsFolder |IsFolder |Boolean |A boolean value (true, false) to indicate whether the blob is a folder. | |ETag |ETag |String |The etag of the file or folder. | -|FileLocator |FileLocator |String |The filelocator of the file or folder. | +|FileLocator |FileLocator |String |The file locator of the file or folder. | -### Update file +### Get folder metadata -Updates the contents of the file specified by the file identifier. +Gets information about the folder. Uses a file identifier to pick the folder. -#### Parameters +#### Parameters |Name |Key |Required |Type |Description | |-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| -|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
https://contoso.sharepoint.com/sites/sitename | -|File Identifier |id |True |String |The unique id of the file to select. | -|File Content |body |True |Binary |The content of the file. | +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|File Identifier |id |True |String |The unique id of the folder. | -#### Returns +#### Returns |Name |Path |Type |Description | |-------------|-------------|----------|------------------------------------------------------------------------| +|ItemId |ItemId |Integer |The value to use to get or update file properties in libraries. | |Id |Id |String |The unique id of the file or folder. | |Name |Name |String |The name of the file or folder. | |DisplayName |DisplayName |String |The display name of the file or folder. | @@ -272,34 +362,50 @@ Updates the contents of the file specified by the file identifier. |MediaType |MediaType |String |The media type of the file or folder. | |IsFolder |IsFolder |Boolean |A boolean value (true, false) to indicate whether the blob is a folder. | |ETag |ETag |String |The etag of the file or folder. | -|FileLocator |FileLocator |String |The filelocator of the file or folder. | +|FileLocator |FileLocator |String |The file locator of the file or folder. | -### Delete file +### Get folder metadata using path -Deletes the file specified by the file identifier. +Gets information about the folder. Uses a folder path to pick the folder. -#### Parameters +#### Parameters |Name |Key |Required |Type |Description | |-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| -|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
https://contoso.sharepoint.com/sites/sitename | -|File Identifier |id |True |String |The unique id of the file to select. | +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|Folder Path |path |True |String |The path of the target folder, for example: "/Shared Documents/MyFolderName. | -### List folder +#### Returns -Returns files contained in a SharePoint folder. +|Name |Path |Type |Description | +|-------------|-------------|----------|------------------------------------------------------------------------| +|ItemId |ItemId |Integer |The value to use to get or update file properties in libraries. | +|Id |Id |String |The unique id of the file or folder. | +|Name |Name |String |The name of the file or folder. | +|DisplayName |DisplayName |String |The display name of the file or folder. | +|Path |Path |String |The path of the file or folder. | +|LastModified |LastModified |Date-time |The date and time the file or folder was last modified. | +|Size |Size |Integer |The size of the file or folder. | +|MediaType |MediaType |String |The media type of the file or folder. | +|IsFolder |IsFolder |Boolean |A boolean value (true, false) to indicate whether the blob is a folder. | +|ETag |ETag |String |The etag of the file or folder. | +|FileLocator |FileLocator |String |The file locator of the file or folder. | -#### Parameters +### List root folder + +Returns files in the root SharePoint folder. + +#### Parameters |Name |Key |Required |Type |Description | |-------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| -|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
https://contoso.sharepoint.com/sites/sitename | -|File Identifier |id |True |String |The unique id of the folder. | +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | -#### Returns +#### Returns |Name |Path |Type |Description | |-------------|-------------|----------|------------------------------------------------------------------------| +|ItemId |ItemId |Integer |The value to use to get or update file properties in libraries. | |Id |Id |String |The unique id of the file or folder. | |Name |Name |String |The name of the file or folder. | |DisplayName |DisplayName |String |The display name of the file or folder. | @@ -309,17 +415,58 @@ Returns files contained in a SharePoint folder. |MediaType |MediaType |String |The media type of the file or folder. | |IsFolder |IsFolder |Boolean |A boolean value (true, false) to indicate whether the blob is a folder. | |ETag |ETag |String |The etag of the file or folder. | -|FileLocator |FileLocator |String |The filelocator of the file or folder. | +|FileLocator |FileLocator |String |The file locator of the file or folder. | + +### Extract folder + +Extracts an archive file into a SharePoint folder (example: zip). + +|Name |Key |Required |Type |Description | +|------------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | +|Source File Path |source |True |String |The path of the source file. | +|Destination Folder Path |destination |True |String |The path of the destination folder. | +|Overwrite Flag |overwrite | |BooleanSpecifies whether to overwrite the destination file if it exists. | + +#### Returns + +|Name |Path |Type |Description | +|-------------|-------------|----------|------------------------------------------------------------------------| +|ItemId |ItemId |Integer |The value to use to get or update file properties in libraries. | +|Id |Id |String |The unique id of the file or folder. | +|Name |Name |String |The name of the file or folder. | +|DisplayName |DisplayName |String |The display name of the file or folder. | +|Path |Path |String |The path of the file or folder. | +|LastModified |LastModified |Date-time |The date and time the file or folder was last modified. | +|Size |Size |Integer |The size of the file or folder. | +|MediaType |MediaType |String |The media type of the file or folder. | +|IsFolder |IsFolder |Boolean |A boolean value (true, false) to indicate whether the blob is a folder. | +|ETag |ETag |String |The etag of the file or folder. | +|FileLocator |FileLocator |String |The file locator of the file or folder. | + +### Get lists + +Gets SharePoint lists from a site. + +#### Parameters + +|Name |Key |Required |Type |Description | +|------------------------|----------------|---------|-------|-------------------------------------------------------------------------------------------------| +|Site Address |dataset |True |String |The URL of the SharePoint site, for example:
'https://contoso.sharepoint.com/sites/sitename'. | + +#### Returns + +|Name |Path |Type |Description | +|-------------|-------------|----------------|------------------------------------------------------------------------| +|value |value |array of Tables |List of Tables | -## Upcoming features +## Upcoming features -- Dynamic suggestion of input fields - Dynamic content for output variables: cloud actions’ output variables can be expanded to show its underlying properties -- Create new connection reference from within Power Automate for desktop - Share to **users** brings their own connection references upon each run - Co-owners can use the same connection references - ALM dependencies management (dependency checker upon import, add required objects, show dependencies) - Connection references are visible in desktop flows details pages - Exponential/manual retry policies in case the connector responds an error - DLPs that include SharePoint cloud actions are enforced in desktop flows -- New SharePoint actions \ No newline at end of file +- New SharePoint actions