The "Get Data Source List Info" flow is designed to be executed as a child flow and accepts two parameters: the site URL
and library/list Id
, as provided by the environment variables.
Version 1.0.1 of the flow returns the following information:
parameter name | description | example |
---|---|---|
host_name |
The URL of the root SharePoint site | contoso.sharepoint.com |
site_url |
The URL of the current SharePoint site, as defined in the site URL parameter. |
https://contoso.sharepoint.com/sites/XYZ |
site_title |
Title of the current SPO site | Project XYZ |
site_id |
The id of the current SPO site in a guid format. |
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
web_id |
The id of the current SPO web object in a guid format. |
yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy |
list_absolute_url |
The full URL of the list. | https://contoso.sharepoint.com/sites/xyz/Archives or https://contoso.sharepoint.com/sites/xyz/Lists/Issue tracker |
list_name |
The RootFolder . Used in the URL, is generated automatically and cannot be changed by users. It can be changed with PowerShell. |
Archive |
list_title |
The title of the list. This property can be changed by the user. | The Archive Library |
list_id |
The value provided as List Id parameter |
zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz |
list_drive_id |
Used by Graph API when referencing libraries. Only for document libraries. | b!S3SdNSBmTUGa4v5ffh_rslLJssoXH4xEuShkEO-uxKg9bblUMeoaTbQC5t69DJ-x |
error_message |
The error message if any of the actions failed, or empty string. | {"Error":"Send_an_HTTP_request_to_SharePoint:_get_Site_with_MS_Graph:[...]},{"Error":"Send_an_HTTP_request_to_SharePoint:_get_list_URL: \\"401 UNAUTHORIZED[...]\\""} |
success |
True or False |
The solution consits of:
- Get Data Source List Info cloud flow,
- test flow, used for evaluating the "Get Data Source List Info" flow
- 3 environment variables: v_SiteUrl, v_List and v_Library, used in the test flow
- SharePoint Online connection reference
-
To use the workflow, import either managed or unmanaged solution available under Releases. If you want to be able to edit the flow, choose unmanaged:
-
During the import process, update the connection references and environment variables.
-
After the solution is imported, configure the Get Data Source List Info cloud flow, to be executed as a child flow. Configured the
run only
permissions, using the flow owner’s embedded connection:
Click on Edit link and change the connection in the Connections Used section
- Add a service principal as an additional owner to ensure business continuity.
⚠️ ImportantYou are now installing a workflow from an unknown source in the internet. I appreciate your trust and I'm happy if you find this workflow useful. The least you can do to ensure you are not installing malicious flow that will leak data from your company, is to review it. Always check if there are any actions that might send information to an external endpoint.
This action is using GET
method, which means it's reading information from your SharePoint site.
It retrieves list information for the list defined as a parameter, and and retrieves parameters that are returned by the flow.
This action is also only reading (GET
method) data from your SharePoint site.
It's using _api/v2.0/drive api to list availabled drives.
This api doesn't support filtering, so after retrieving all available drives (libraries) the flow filters results to find the requested library:
Helpful tips for using Child Flows