The following documentation will show you how to register with and set up our provider hosted SharePoint Online App.
Step 1: Register App in SPO
Provider-hosted Apps must be registered with SharePoint to have sufficient rights and be able to communicate with Remote Services. Additionally, registration with SharePoint grants access to the site resources (e.g. permission Groups) of the site to which the App is deployed:
Navigate to:
https://<tenant>.sharepoint.com/<siteUrl> /_layouts/15/AppRegNew.aspx
The following page should appear:
The following values must be set:
Client Id: 67bd1769-d13c-4f9a-bd28-573f04ec04bb
Client Secret: mIDz8S6+3GLdzwvX8yx5kWaRgmaD+a/Oht37jIsbcVw=
Title: IKSSolution
App Domain: ikssolution.azurewebsites.net
Redirect URI: https://ikssolution.azurewebsites.net
Click create.
Step 2: Set App permissions
Navigate to:
https://<tenant>.sharepoint.com/<siteUrl> /_layouts/15/AppInv.aspx
Enter the following App-ID
67bd1769-d13c-4f9a-bd28-573f04ec04bb
and click Lookup.
The form will be filled with the previously entered data. Enter the following XML into the Permission Request XML textbox:
Click create.
Step 3: Activate Custom Actions
If Custom Actions are already activated, this step is obsolete.
For the App to function correctly, Custom Actions must be activated for the site where it is deployed. The App uses Custom Actions to inject the SharePoint styled navigation onto the App's main page.
To activate Custom Actions open the Sharepoint Online Management Shell (Download link: https://www.microsoft.com/en-us/download/details.aspx?id=35588) and enter the following two commands (Admin permissions needed):
1. Command:
Connect-SPOService -Url https://firestartbpm-admin.sharepoint.com
or
Connect-SPOService -Url https://<tenant>-admin.sharepoint.com
2. Command:
Set-SPOSite -Identity https://firestartbpm.sharepoint.com/sites/devsite -DenyAddAndCustomizePages 0
or
Set-SPOSite -Identity https://<tenant>.sharepoint.com/<site-URL> -DenyAddAndCustomizePages 0
Step 4: Add an App Catalog to the Website Collection and upload the App
If you don't yet have an App Catalog on your SharePoint tenant, you have to add an one via the admin section of your SPO. An App Catalog allows you to upload and install Apps that are not listed in the MS App-Store.
After the App Catalog is created, you can upload the App to SharePoint. The App is now available for deployment to a SharePoint site within your tenant.
Step 5: Add App to site
Navigate to the desired site and choose Website Contents. Choose App and select the IKS Solution. Within the language options you can choose between English and German. Click Trust App. The App is deployed to the site, if you can see the FireStart icon.
The application sets up all the data it needs in the background. The Installation is finished, as soon as the navigation shows up on the left side of the page when you open the App.
FAQ
1. How do I find the list settings within the App?
SharePoint deactivates the standard list settings button within an app. To edit those settings you have to use a workaround.
Navigate to the desired list → Tab List → Change view
On the edit view page click settings
2. How can I remove an App registration
From within the SharePoint Online PowerShell Console (Admin User needed) call:
· Connect-AzureAD
· Get-AzureADServicePrincipal (search for the ObjectId of IKSSolution)
· Remove-AzureADServicePrincipal -ObjectId [objectId]