Template Assets
Summary¶
Template Assets is a SharePoint document library within the Teamwork admin site. Within this library administrators can create folders and associate them with Valo Teamwork templates. Teamwork will then take care of provisioning the content of these folders to site collections created using Valo Teamwork.
Team extraction and the Template Assets library¶
In the Team's extraction form, administrators can choose which part of the Team to extract. If Team icon or Files and Folders from the Shared Document library is selected, Teamwork will create a new "template folder" inside the root folder of the Template Assets library. This folder will have the name provided during the extraction (template name) and will be used to store these assets in the following structure:
| Folder name | Content |
|---|---|
| Team icon | Contains the extracted Team icon |
| Shared Documents | Contains all files and folders from the Shared Documents library of the extracted Team. Teamwork will consider the order of this data when storing it |
In addition to that, Teamwork will link this template folder with the generated Valo Teamwork Team template. From now, Teamwork will use these assets during the creation of a Team which is based on the generated template:
| Asset | During Team creation |
|---|---|
| Team icon | Updates the Team icon of the target Team |
| Shared Documents | Uploads all files and folders into the Shared Documents library of the Office 365 group which is associated to the target Team |
Important
Teamwork recreates the "template folder" if a template name is reused during Team extraction. In detail, Teamwork moves the entire content of the "template folder" into the recycle bin of the Teamwork admin site and creates it again.
Template Assets library in other scenarios¶
Folders from the Template Assets library can be linked to different kind of Valo Teamwork templates:
| Valo Teamwork template | WebTemplateId |
|---|---|
| Interest Group Template | GroupTemplate5 |
| Project | GroupTemplate2 |
| Modern Communication site | SiteTemplateModern2 |
| Modern Team site | SiteTemplateModern1 |
| Steering Group | GroupTemplate3 |
| Team | GroupTemplate1 |
| HR Onboarding | GroupTemplateOnboarding6 |
| Extracted Team | GroupTemplate[random number] |
The only exception in this case is the Classic Publishing site template. Teamwork doesn't support the Template Assets approach when creating publishing site collections.
How to set up the template folder in the Template Assets library?¶
Within the root folder of the Template Assets library administrators can create a template folder. Therein, administrators can create the following folders:
| Supported folder | Description |
|---|---|
| Shared Documents | Corresponds to the Shared Documents library |
| Site Assets | Corresponds to the Site Assets library |
| Team Icon | Corresponds to the team icon which needs to be a format supported by Microsoft Teams such as png |
Important
The folder's name must be written correctly. During provisioning, Teamwork looks inside the template folder for these supported folders. If the supported folders are misspelled, assets won't be provisioned.
The usage of these folders depends on the Valo Teamwork template to link. The list below shows what folders are supported for the different kind of Valo Teamwork templates:
| Valo Teamwork templates | Supported folder |
|---|---|
| Interest Group Template, Project, Modern Communication site, Modern Team site and Steering Group | Shared Documents and Site Assets |
| Team and Extracted Team | Site Assets, Shared Documents and Team Icon |
How to link the template folder with a Valo Teamwork template?¶
To link a template folder with a Valo Teamwork template, administrators have to open the Valo Teamwork template file (XML file located in the Teamwork Web Templates library) and set the TemplateAssets attribute of the ModernSite XML element with the template folder's name. This is how it looks in a Valo Template of type Project:
<ModernSite TemplateAssets="Template">
</ModernSite>