Title: SharePoint Templates

Description: Configure SharePoint template folder creation with variable substitution

Tags: sharepoint, templates, storage

---

SharePoint Template Folder Configuration Example

This example shows how to configure the SharePointFolderInputWidget to support template folder creation.

Type Schema Configuration

Add this configuration to your type schema to enable the template functionality:

{
  "type": "string",
  "title": "Project Folder",
  "description": "Select or create a project folder from template",
  "x-type-schema": {
    "inputWidget": "SharePointFolderInputWidget",
    "inputWidgetConfiguration": {
      "sharepointTemplateUsage": {
        "sharepointTemplateFolder": {
          "driveId": "b!template-drive-id-here",
          "folderId": "template-folder-id-here"
        },
        "newSharepointFolderLocation": {
          "driveId": "b!target-drive-id-here",
          "folderId": "parent-folder-id-here"
        },
        "newSharepointFolderName": "#{show address.street} #{show address.streetNumber} #{show address.zip} #{show address.city}"
      }
    }
  }
}

Configuration Properties

sharepointTemplateFolder
The source template folder to copy from:
driveId: SharePoint drive ID (starts with b!)
folderId: (Optional) Folder ID within the drive. If omitted, uses root folder

newSharepointFolderLocation  
The target location where new folders will be created:
driveId: SharePoint drive ID where new folders should be created
folderId: (Optional) Parent folder ID. If omitted, creates in root

newSharepointFolderName
The name for the new folder with variable substitution support:
Use ${variable} syntax to insert form data
Supports nested properties like ${address.street}
Variables are resolved from the current form data

UI Behavior

When all three properties are configured:
The widget shows both "Select Folder" and "Use Template" buttons
Clicking "Use Template" creates a new folder with the specified name
Progress feedback shows folder creation and content copying
On success, the new folder is automatically selected
Error handling provides user-friendly messages

Variable Substitution Examples

// Form data example:
{
  "address": {
    "street": "Main Street", 
    "streetNumber": "123",
    "zip": "12345",
    "city": "Springfield"
  },
  "projectName": "New Development"
}

// Template name: "Real Estate #{show address.street} #{show address.streetNumber} #{show address.zip} #{show address.city}"
// Result: "Real Estate Main Street 123 12345 Springfield"

// Template name: "Project #{show projectName} - #{show address.city}"  
// Result: "Project New Development - Springfield"

Notes
Template functionality only appears when all three configuration properties are provided
The widget maintains backward compatibility - existing configurations continue to work unchanged
Uses user-delegated permissions that don't require admin consent for most SharePoint operations
Progress feedback includes percentage completion and user-friendly status messages