Permalink
Switch branches/tags
Nothing to show
Find file Copy path
47 lines (29 sloc) 2.84 KB

Preparing your tenant for the PnP SharePoint Starter Kit

In this document you can find detailed information about preparing your tenant to run the PnP SharePoint Starter Kit. In the main ReadMe file of this repository you can find general information about the project.

In fact, here is the list of requirements, which need some manual steps, to be accomplished in order to properly run the solution:

In the following sections you can find detailed instructions about the above tasks.

Create a Custom Property in the User Profile Service

In order to register a custom property in the User Profile Service, you need to browse with your web browser to the SharePoint Admin Center of SharePoint Online, which is available at the URL https://<tenant-name>-admin.sharepoint.com/. There, you need to select the User Profiles menu item on the left menu and select Manage User Properties under the People category of links, as you can see in the following figure.

The User Profiles Admin UI

In the Manage User Properties page, select to create a New Property as it is illustrated in the following figure.

The add New Property button

Configure the new property with the following settings:

  • Name: PnP-CollabFooter-MyLinks
  • Display name: PnP-CollabFooter-MyLinks
  • Type: string (Single Value)
  • Length: 3600 (which is the maximum allowed)
  • Policy Setting: Optional
  • Allow users to edit values for this property: Checked

Leave all the other properties with their default values.

Note: We cannot automate this step because it is not yet possible to use the Client Side Object Model, or the REST API of SharePoint Online, to create a custom User Profile property.

Request a custom API key to Alpha Vantage

The StockInformation Web Part uses the live stocks service provided by Alpha Advantage. However, to use it you need a software key, that you can ask for free to the API provider. You will simply need to go to the page to Claim your API Key, fill in the form, and store the generated key in a safe place.

The key should be configured at tenant level, by creating a storage entity using the following PowerShell script:

Set-PnPStorageEntity -Key "PnP-Portal-AlphaVantage-API-Key" -Value "your-api-key" -Comment "API Key for Alpha Advantage REST Stock service" -Description "API Key for Alpha Advantage REST Stock service"