diff --git a/samples/create-folder-with-link-back-to-list/README.md b/samples/create-folder-with-link-back-to-list/README.md index 39805f1..7b33d15 100644 --- a/samples/create-folder-with-link-back-to-list/README.md +++ b/samples/create-folder-with-link-back-to-list/README.md @@ -1,162 +1,4 @@ # Create folder with link back to list -## Summary - -This sample creates a folder in a *SharePoint* document library and then stores the link to the newly created folder inside of *Microsoft Lists* using *Power Automate*. The folder name is based on a combination of list columns and provides a better link experience compared to the default URL. - -![Flow overview](/samples/create-folder-with-link-back-to-list/assets/flow-overview.png "Flow overview") - - -## Applies to - -* [Power Automate](https://docs.microsoft.com/power-automate/) -* [SharePoint](https://learn.microsoft.com/en-us/sharepoint/) - -## Compatibility - -![Premium License](https://img.shields.io/badge/Premium%20License-Not%20Required-green.svg "Premium license not required") -![On-Premises Connectors](https://img.shields.io/badge/On--Premises%20Connectors-No-green.svg "Does not use on-premise connectors") -![Custom Connectors](https://img.shields.io/badge/Custom%20Connectors-Not%20Required-green.svg "Does not use custom connectors") - - -## Authors - -Solution|Author(s) ---------|--------- -create-folder-with-link-back-to-list | [Norm Young](https://github.com/nyoung30) ([@stormin_30](https://twitter.com/stormin_30)) - - -## Version history - -Version|Date|Comments --------|----|-------- -1.0|October 10, 2022|Initial release - - -## Features - -This sample illustrates the following concepts: - -* Expressions -* SharePoint REST API -* Variables - - -## Prerequisites - -This Flow requires the following list columns and settings: -* **Title** - * Settings: "Require that this column contains information" set to **Yes** -* **FolderLocation** - * Type: *Hyperlink* - - -## Minimal Path to Awesome - -1. Download the solution file [CreateFolderWithLinkBackToList.zip](/samples/create-folder-with-link-back-to-list/solution/CreateFolderWithLinkBackToList.zip) - -2. Import the solution using *Power Automate*. Click **My flows**, click **Import** and then click **Import Package (Legacy)** - - ![Flow import](/samples/create-folder-with-link-back-to-list/assets/flow-import.png "Flow import") - -3. Upload the solution by clicking **Upload** and select the downloaded file from Step 1 - - ![Upload package](/samples/create-folder-with-link-back-to-list/assets/upload-package.png "Upload package") - -4. Configure the *Flow* connections by clicking on **Configuration** for the *SharePoint Connection* - - ![Import configuration before image](/samples/create-folder-with-link-back-to-list/assets/import-configuration-before.png "Import configuration before image") - -5. Select an existing connection and click **Save** or add a new *SharePoint Connection* by clicking **Create new** (see Steps 5a, 5b) - - ![Existing or new connection](/samples/create-folder-with-link-back-to-list/assets/existing-new-connection.png "Existing or new connection") - - 5a. Click **Create a connection**, click **SharePoint** and then click **Create** - - ![New SharePoint connection](/samples/create-folder-with-link-back-to-list/assets/sharepoint-connection.png "New SharePoint connection") - - 5b. Select your account in the *Pick your account screen* - - 5c. Return to the *Import setup* screen, select your newly created *SharePoint Connection* and click **Save** - - ![New SharePoint connection](/samples/create-folder-with-link-back-to-list/assets/save-sharepoint-connection.png "New SharePoint connection") - -6. After our Flow connections have been created click **Import** to import the solution file. - - ![Import configuration after](/samples/create-folder-with-link-back-to-list/assets/import-configuration-after.png "Import configuration after") - - **Note:** If you receive a "GetTable" error during the import, click the **Save as a new flow** option and manually update the connections references. This error is caused by importing and exporting *Flows* between tenants. - - ![Flow import error](/samples/create-folder-with-link-back-to-list/assets/flow-import-error.png "Flow import error") - - Select your target connection to fix the "Invalid connection" error. Repeat for all SharePoint actions. - ![Fix connections](/samples/create-folder-with-link-back-to-list/assets/flow-fix-connections.png "Fix connections") - -7. Click **Open flow** to further configure the flow - - ![Open flow](/samples/create-folder-with-link-back-to-list/assets/open-flow.png "Open flow") - -8. Expand the *When an item is created*, change the *Site address* and *List name* to your desired site and list - - ![Configure When an item is created](/samples/create-folder-with-link-back-to-list/assets/when-an-item-is-created.png "Configure When an item is created") - -9. Expand *Initialize variable - varParameters*, change the *Site address* and *List name* to your desired site and list - - ![Configure Initialize variable](/samples/create-folder-with-link-back-to-list/assets/initialize-variable.png "Configure Initialize variable") - - Name | Value - ---- | ------ - *varSiteURL* | Replace with your site URL - *varListInternalName* | Replace with your internal list name; **Tip:** Use this API call in your browser to obtain the internal list name: *https://YourTenantName.sharepoint.com/sites/YourSiteName/_api/Web/Lists/GetByTitle(' - ---- \ No newline at end of file +> [!Important] +> This sample has now been migrated to the a [different repository](https://github.com/pnp/powerplatform-samples/tree/main/samples/create-folder-with-link-back-to-list). \ No newline at end of file diff --git a/samples/create-folder-with-link-back-to-list/assets/configure-flow.png b/samples/create-folder-with-link-back-to-list/assets/configure-flow.png deleted file mode 100644 index fac95ea..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/configure-flow.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/existing-new-connection.png b/samples/create-folder-with-link-back-to-list/assets/existing-new-connection.png deleted file mode 100644 index 49cc1ce..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/existing-new-connection.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/flow-fix-connections.png b/samples/create-folder-with-link-back-to-list/assets/flow-fix-connections.png deleted file mode 100644 index f35b7c8..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/flow-fix-connections.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/flow-import-error.png b/samples/create-folder-with-link-back-to-list/assets/flow-import-error.png deleted file mode 100644 index cdc0009..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/flow-import-error.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/flow-import.png b/samples/create-folder-with-link-back-to-list/assets/flow-import.png deleted file mode 100644 index 2747b22..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/flow-import.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/flow-overview.png b/samples/create-folder-with-link-back-to-list/assets/flow-overview.png deleted file mode 100644 index 1eb3ae8..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/flow-overview.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/flow-run.png b/samples/create-folder-with-link-back-to-list/assets/flow-run.png deleted file mode 100644 index de39539..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/flow-run.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/folder.png b/samples/create-folder-with-link-back-to-list/assets/folder.png deleted file mode 100644 index 481632e..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/folder.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/import-configuration-after.png b/samples/create-folder-with-link-back-to-list/assets/import-configuration-after.png deleted file mode 100644 index 28473f4..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/import-configuration-after.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/import-configuration-before.png b/samples/create-folder-with-link-back-to-list/assets/import-configuration-before.png deleted file mode 100644 index 952c5ed..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/import-configuration-before.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/initialize-variable.png b/samples/create-folder-with-link-back-to-list/assets/initialize-variable.png deleted file mode 100644 index fb1908d..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/initialize-variable.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/list-item.png b/samples/create-folder-with-link-back-to-list/assets/list-item.png deleted file mode 100644 index cba0548..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/list-item.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/open-flow.png b/samples/create-folder-with-link-back-to-list/assets/open-flow.png deleted file mode 100644 index 3350c7f..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/open-flow.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/previous-page.png b/samples/create-folder-with-link-back-to-list/assets/previous-page.png deleted file mode 100644 index 1091020..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/previous-page.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/save-sharepoint-connection.png b/samples/create-folder-with-link-back-to-list/assets/save-sharepoint-connection.png deleted file mode 100644 index ca95f3f..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/save-sharepoint-connection.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/save.png b/samples/create-folder-with-link-back-to-list/assets/save.png deleted file mode 100644 index 678ad11..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/save.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/sharepoint-connection.png b/samples/create-folder-with-link-back-to-list/assets/sharepoint-connection.png deleted file mode 100644 index 8a63510..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/sharepoint-connection.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/turn-on.png b/samples/create-folder-with-link-back-to-list/assets/turn-on.png deleted file mode 100644 index f972fda..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/turn-on.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/upload-package.png b/samples/create-folder-with-link-back-to-list/assets/upload-package.png deleted file mode 100644 index 72ab98b..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/upload-package.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/assets/when-an-item-is-created.png b/samples/create-folder-with-link-back-to-list/assets/when-an-item-is-created.png deleted file mode 100644 index 8014959..0000000 Binary files a/samples/create-folder-with-link-back-to-list/assets/when-an-item-is-created.png and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/solution/CreateFolderWithLinkBackToList.zip b/samples/create-folder-with-link-back-to-list/solution/CreateFolderWithLinkBackToList.zip deleted file mode 100644 index f13da28..0000000 Binary files a/samples/create-folder-with-link-back-to-list/solution/CreateFolderWithLinkBackToList.zip and /dev/null differ diff --git a/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/fb1f745f-2443-4daa-b3de-ba7abd83f2c7/apisMap.json b/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/fb1f745f-2443-4daa-b3de-ba7abd83f2c7/apisMap.json deleted file mode 100644 index db2a51d..0000000 --- a/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/fb1f745f-2443-4daa-b3de-ba7abd83f2c7/apisMap.json +++ /dev/null @@ -1 +0,0 @@ -{"shared_sharepointonline":"1f0d1f6d-4f8a-405f-95bb-300c3e97f557"} \ No newline at end of file diff --git a/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/fb1f745f-2443-4daa-b3de-ba7abd83f2c7/connectionsMap.json b/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/fb1f745f-2443-4daa-b3de-ba7abd83f2c7/connectionsMap.json deleted file mode 100644 index 91f3195..0000000 --- a/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/fb1f745f-2443-4daa-b3de-ba7abd83f2c7/connectionsMap.json +++ /dev/null @@ -1 +0,0 @@ -{"shared_sharepointonline":"64105521-ebb6-47dc-bfff-f44d6135fd97"} \ No newline at end of file diff --git a/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/fb1f745f-2443-4daa-b3de-ba7abd83f2c7/definition.json b/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/fb1f745f-2443-4daa-b3de-ba7abd83f2c7/definition.json deleted file mode 100644 index 7d3de60..0000000 --- a/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/fb1f745f-2443-4daa-b3de-ba7abd83f2c7/definition.json +++ /dev/null @@ -1 +0,0 @@ -{"name":"5b824d21-d215-4202-b924-6d53fdfb6fba","id":"/providers/Microsoft.Flow/flows/5b824d21-d215-4202-b924-6d53fdfb6fba","type":"Microsoft.Flow/flows","properties":{"apiId":"/providers/Microsoft.PowerApps/apis/shared_logicflows","displayName":"Create folder with link back to list","definition":{"metadata":{"workflowEntityId":null,"processAdvisorMetadata":null,"flowclientsuspensionreason":"None","flowclientsuspensiontime":null,"flowclientsuspensionreasondetails":null,"creator":{"id":"5b2bce1a-cc08-4e1b-bea4-b00625348744","type":"User","tenantId":"d45e3b06-d6e9-4606-8e92-5b5375b02bad"},"provisioningMethod":"FromDefinition","failureAlertSubscription":true,"clientLastModifiedTime":"2022-10-04T20:27:27.0054351Z"},"$schema":"https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#","contentVersion":"1.0.0.0","parameters":{"$connections":{"defaultValue":{},"type":"Object"},"$authentication":{"defaultValue":{},"type":"SecureObject"}},"triggers":{"When_an_item_is_created":{"recurrence":{"frequency":"Minute","interval":1},"splitOn":"@triggerOutputs()?['body/value']","metadata":{"operationMetadataId":"7890832d-bafb-455f-b25a-c834fa6eb2b1"},"type":"OpenApiConnection","inputs":{"host":{"apiId":"/providers/Microsoft.PowerApps/apis/shared_sharepointonline","connectionName":"shared_sharepointonline","operationId":"GetOnNewItems"},"parameters":{"dataset":"https://normyoung.sharepoint.com/sites/demo-site","table":"0061696a-68bf-4a2c-bd23-1ce36e36e9a4"},"authentication":"@parameters('$authentication')"},"description":"Replace Site Address and List Name to match your site and list."}},"actions":{"Create_new_folder":{"runAfter":{"Compose_-_varParameters":["Succeeded"]},"metadata":{"operationMetadataId":"ea64d6e9-1fcb-4f4f-a2eb-79d3e1cc637d"},"type":"OpenApiConnection","inputs":{"host":{"apiId":"/providers/Microsoft.PowerApps/apis/shared_sharepointonline","connectionName":"shared_sharepointonline","operationId":"CreateNewFolder"},"parameters":{"dataset":"@variables('varParameters')['varSiteURL']","table":"@variables('varParameters')['varDocumentDisplayLibraryName']","parameters/path":"@variables('varParameters')['varFolderName']"},"authentication":"@parameters('$authentication')"},"description":"If you rename this action be certain to update the outputs('Create_new_folder')?['body/{Link}'] expression included in the Send an HTTP request to SharePoint action"},"Send_an_HTTP_request_to_SharePoint":{"runAfter":{"Create_new_folder":["Succeeded"]},"metadata":{"operationMetadataId":"4140c059-c011-4c02-a159-3e375dd82090"},"type":"OpenApiConnection","inputs":{"host":{"apiId":"/providers/Microsoft.PowerApps/apis/shared_sharepointonline","connectionName":"shared_sharepointonline","operationId":"HttpRequest"},"parameters":{"dataset":"@variables('varParameters')['varSiteURL']","parameters/method":"POST","parameters/uri":"_api/web/lists/GetByTitle('@{variables('varParameters')['varListDisplayName']}')/items(@{triggerOutputs()?['body/ID']})","parameters/headers":{"Content-Type":"application/json;odata=verbose","X-HTTP-Method":"MERGE","IF-MATCH":"*"},"parameters/body":"{'__metadata': {'type':'SP.Data.@{variables('varParameters')['varListInternalName']}ListItem'}, '@{variables('varParameters')['varColumnInternalName']}':{'Description': '@{variables('varParameters')['varFolderName']}', 'Url': '@{outputs('Create_new_folder')?['body/{Link}']}'}}"},"authentication":"@parameters('$authentication')"}},"Initialize_variable_-_varParameters":{"runAfter":{},"metadata":{"operationMetadataId":"09ded3eb-54e7-4bdd-a8b6-598cf57fa4f6"},"type":"InitializeVariable","inputs":{"variables":[{"name":"varParameters","type":"object","value":{"varSiteURL":"https://normyoung.sharepoint.com/sites/demo-site","varListInternalName":"DemoFolders","varListDisplayName":"Demo Folders","varColumnInternalName":"FolderLocation","varDocumentDisplayLibraryName":"Documents","varFolderName":"@{concat(triggerOutputs()?['body/ID'], '-', triggerOutputs()?['body/Title'])}"}}]},"description":"The Object variable type is used in place of multiple variable declarations. See Comments for notes on each object variable in varParameters."},"Compose_-_varParameters":{"runAfter":{"Initialize_variable_-_varParameters":["Succeeded"]},"metadata":{"operationMetadataId":"4850603d-5ac6-48b7-aac7-ff9cb236aa35"},"type":"Compose","inputs":"@variables('varParameters')"}}},"connectionReferences":{"shared_sharepointonline":{"connectionName":"shared-sharepointonl-385b0290-d005-4eea-a8a9-3cfdfaa37846","source":"Embedded","id":"/providers/Microsoft.PowerApps/apis/shared_sharepointonline","tier":"NotSpecified"}},"flowFailureAlertSubscribed":false,"isManaged":false}} \ No newline at end of file diff --git a/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/manifest.json b/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/manifest.json deleted file mode 100644 index 3e140d4..0000000 --- a/samples/create-folder-with-link-back-to-list/sourcecode/Microsoft.Flow/flows/manifest.json +++ /dev/null @@ -1 +0,0 @@ -{"packageSchemaVersion":"1.0","flowAssets":{"assetPaths":["fb1f745f-2443-4daa-b3de-ba7abd83f2c7"]}} \ No newline at end of file diff --git a/samples/create-folder-with-link-back-to-list/sourcecode/manifest.json b/samples/create-folder-with-link-back-to-list/sourcecode/manifest.json deleted file mode 100644 index b02c040..0000000 --- a/samples/create-folder-with-link-back-to-list/sourcecode/manifest.json +++ /dev/null @@ -1 +0,0 @@ -{"schema":"1.0","details":{"displayName":"CreateFolderWithLinkBackToList","description":"","createdTime":"2022-10-05T12:01:43.6848192Z","packageTelemetryId":"9e374f94-e6c5-404c-b22d-708e6027c55e","creator":"N/A","sourceEnvironment":""},"resources":{"fb1f745f-2443-4daa-b3de-ba7abd83f2c7":{"type":"Microsoft.Flow/flows","suggestedCreationType":"New","creationType":"Existing, New, Update","details":{"displayName":"Create folder with link back to list"},"configurableBy":"User","hierarchy":"Root","dependsOn":["1f0d1f6d-4f8a-405f-95bb-300c3e97f557","64105521-ebb6-47dc-bfff-f44d6135fd97"]},"1f0d1f6d-4f8a-405f-95bb-300c3e97f557":{"id":"/providers/Microsoft.PowerApps/apis/shared_sharepointonline","name":"shared_sharepointonline","type":"Microsoft.PowerApps/apis","suggestedCreationType":"Existing","details":{"displayName":"SharePoint","iconUri":"https://connectoricons-prod.azureedge.net/releases/v1.0.1591/1.0.1591.2961/sharepointonline/icon.png"},"configurableBy":"System","hierarchy":"Child","dependsOn":[]},"64105521-ebb6-47dc-bfff-f44d6135fd97":{"type":"Microsoft.PowerApps/apis/connections","suggestedCreationType":"Existing","creationType":"Existing","details":{"displayName":"ny@normyoung.ca","iconUri":"https://connectoricons-prod.azureedge.net/sharepointonline/icon_1.0.1299.1858.png"},"configurableBy":"User","hierarchy":"Child","dependsOn":["1f0d1f6d-4f8a-405f-95bb-300c3e97f557"]}}} \ No newline at end of file