Share:

The following documentation will show you how to reigster 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 tennant, 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 tennant.

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]