Technical details
Technical details for the Look Book tool by Accelerator 365
Jump to
- Overview
- What's involved in the provisioning process?
- What permissions are required to provision a template?
- What happens if something goes wrong?
- Required API permissions
Overview
The Look Book tool is crafted to provide customers with a practical experience of the Accelerator 365 suite of products. With minimal effort, users can generate sample sites using Accelerator 365 products in their environment, reflecting real-world scenarios.
What's involved in the provisioning process?
Provisioning a template is an intricate, multi-step process managed by our Look Book tool. It involves executing a sequence of commands through an enterprise application, which will be installed in your Microsoft Entra tenant once you sign in (refer to 'How to install a template from the Look Book' for more information).
A typical sequence of background activities in the Look Book provisioning process includes:
- A new SharePoint site collection is created within your environment.
- The site is configured and styled based on the selected template’s design, including branding and navigation setup.
- All required pages, site assets (such as images), and supporting lists or libraries for data storage are created and populated.
- Accelerator 365 products are installed directly from the SharePoint Store, and a free 60-day trial is automatically activated.
Note: any additional Microsoft Graph API permissions required by Accelerator 365 products will also be approved automatically at this stage.
The process typically takes a few minutes to complete but may vary depending on the complexity of the template being provisioned.
Once provisioning is complete, your site is fully functional and ready to use immediately. However, the template is just a starting point, and you have full flexibility to customise the site further to meet your specific needs.
What permissions are required to provision a template?
To provision a template for the first time, you must have the Global Administrator role in your Microsoft 365 tenant. This is necessary because the provisioning process includes creating and granting consent to an enterprise application within your Microsoft Entra tenant. The enterprise app is responsible for managing the steps outlined above to provision the template end-to-end.
After the enterprise application has been installed and consented to, users with lower-level permissions, such as those with the SharePoint Administrator role, may be able to provision additional templates from the Look Book site, depending on your organisation’s permission settings.
What happens if something goes wrong?
While the Look Book tool is designed to provision templates reliably, issues can occasionally arise. For example, if the user does not have adequate permissions or an installation times out.
If provisioning fails or completes only partially, an error message will be displayed to notify you of what went wrong. You can attempt to re-run the process, or contact our support team for assistance to ensure your template is set up correctly.
Required API permissions
The following Microsoft Graph API permissions are required by the 'Accelerator 365 – Look Book' enterprise application installed in Microsoft Entra:
These are delegated and organisation-wide permissions that will be automatically approved during provisioning by a user with the Global Administrator role.
Scope | Purpose |
openid | Required to sign users in securely. |
profile | Allows the app to retrieve basic profile details to personalise the experience. |
offline_access |
Enables the app to maintain access for completing provisioning tasks.
|
User.Read |
Allows the app to retrieve basic profile details to personalise the experience.
|
Sites.FullControl.All |
Grants the necessary access to create and configure SharePoint sites as part of the provisioning process.
|
Application.ReadWrite.All |
Allows the app to register and configure itself within your environment for secure operation.
|
Directory.ReadWrite.All |
Enables the app to set up the enterprise application and manage its permissions within your directory
|