Technical details

Technical details for the Welcome app by Accelerator 365

Jump to

Required API permissions

The following Microsoft Graph API permissions are required:

Scope Purpose
User.ReadBasic.All Read all users' basic profiles for audience targeting.
GroupMember.Read.All Read group memberships for audience targeting.

These permissions are delegated and organisation-wide and require approval by a user with the Global Administrator role after the app has been deployed.

Data storage

Data for Welcome is stored in SharePoint lists and libraries. These are provisioned from the app as and when required. The lists/libraries provisioned are:

List/library title Relative URL Purpose
Welcome Web Part Weather /Lists/WMW_WMReplyWelcomeWebPartWeather A cache of the last updated weather information per location.
Welcome Web Part Errors  /Lists/WMW_WMReplyWelcomeWebPartErrors  Errors logged by Welcome when failing to obtain weather information.
Welcome Web Part - Custom Layouts /WMW_WMReplyWelcomeWebPartLayouts Storage of the custom layouts.

Tenant settings

Some apps require configuration settings to be stored either at a tenant level or at an individual app level.

An optional feature allows the Welcome app to display local weather. The weather feature will require an API key from a third-party provider (OpenWeather). A free API key can be acquired and then set for the web part in the property pane.

This property is stored at an individual app level.

Note: The Free plan from OpenWeather offers 1,000,000 calls per month to be made to OpenWeather. Should the weather API call limit exceed this at your organisation, it is recommended to purchase a paid plan from OpenWeather at your expense.

Recommended deployment scope

It is expected that the Welcome app is made available only on specific areas of your SharePoint tenant as necessary, e.g., a home site or landing site.

Therefore, it is recommended to select the Only enable this app option on deployment (see the Installation instructions page). This means the app is available for Site Owners to manually add to their site.