Effortlessly deploy SharePoint Online apps and extensions
This article describes how to programmatically deploy the Muhimbi SharePoint Online App, the optional SharePoint Framework Extension for Modern Views, as well as the optional SharePoint Designer workflow actions.
For Muhimbi's Microsoft Power Automate (Flow), Azure Logic Apps and API integration(opens in a new tab), no deployment steps are required. Microsoft makes our facilities available out-of-the-box.
Please keep in mind that the provided PowerShell scripts are a starting point. Adjust it for your exact requirements.
Programmatically deploying the App
SharePoint Online Apps are typically easy to deploy, a few clicks in the SharePoint Online App Store and you are done.
However, some organisations need to deploy our App to thousands of site collections. We recommend using SharePoint Online's built in mechanism for automating this, the App Catalog.(opens in a new tab) However, for some scenarios the facilities of the App Catalog are too limited.
The logical next step is to automate the deployment using code, typically using PowerShell. The steps for doing this are as follows:
Download(opens in a new tab) the Muhimbi Document Converter App.
Download(opens in a new tab) the sample PowerShell script for deploying the App.
If not already done, install(opens in a new tab) the SharePoint Online management shell.
Edit the PowerShell script for your requirements, or use it as is, and execute it.
Once the App has been deployed programmatically it needs to be trusted. Follow the 'Centrally elevate the App on all site collections' instructions in this Knowledge Base article. At the time of writing it is not possible to programmatically trust a SharePoint Online App.
Programmatically deploying the SharePoint Designer Workflow Actions
The Muhimbi Document Converter for SharePoint Online comes with an optional set of SharePoint Designer Workflow Actions(opens in a new tab) to automate processes. Manual deployment is easy, but if the workflow actions need to be rolled out to a large number of site collections, then a little bit of automation goes a long way.
Steps are as follows:
For sites that have been created as 'Modern Sites', custom scripts are disabled by default. Please enable it as per this Microsoft Article(opens in a new tab).
Make sure that that App is deployed to all Site collections that require the workflow actions. The Workflow Actions will not work without the App being present on the same site collection.
Download(opens in a new tab) the Workflow Actions.
Download(opens in a new tab) the sample PowerShell script for deploying the App.
If not already done, install(opens in a new tab) the SharePoint Online management shell.
Edit the PowerShell script for your requirements, or use it as is, and execute it.
Once the WSP has been deployed programmatically the Feature is enabled by default at the root site collection. To enable it on sub-sites, add custom code to the script that matches your requirements, or manually execute steps 8-10 in the installation instructions.
Programmatically deploying the SPFx Extension
Use the steps described below to deploy the optional SPFx extension programmatically. This will make the extension available to all existing as well as new site collections in the tenant. Manual installation steps can be found here.
Download the sample PowerShell script(opens in a new tab) for deploying the extension.
If not already done, install the SharePoint Online management shell(opens in a new tab).
Make sure you have app catalog in your tenant. If not, follow these instructions to create one(opens in a new tab).
Edit the PowerShell script for your requirements, or use it as is, and execute it.
The script will upload the SPFx extension to the catalog and deploy it tenant wide.
Make sure you familiarise yourself with the manual installation steps, and related information outlined in this Knowledge Base article.