restore-template-configs

Restore customised ESS Workday HCM template records from backup files.

25|8|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit --skill restore-template-configs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: restore-template-configs
Source: https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit/tree/main/solutions/ess-maker-skills/src/skills/restore-template-configs
Command: npx skills add https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit --skill restore-template-configs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Installing a new ESS Workday HCM package release resets all your customised template reference-data records to default values, requiring hours of manual rework to re-apply your customisations. This Skill automates the restoration of these customisations from a pre-captured backup file, eliminating repetitive manual effort.

Core Features & Use Cases

  • Cross-Environment Customisation Promotion: Use the same backup file to restore customisations across different environments (e.g., move changes from development to production) with clear warnings when the backup and target environments do not match.
  • Idempotent Safe Restores: Re-running the restore operation is completely safe, as it overwrites existing customisations with identical values from the backup without creating duplicate or conflicting records.
  • Actionable Error Guidance: Provides specific, step-by-step guidance for full successes, partial failures (with full diagnostic details for the first failure), and hard failures (e.g., invalid or stale backup files), so you can resolve issues quickly and retry.

Quick Start

Run the restore-template-configs skill to restore your custom ESS Workday HCM template configurations from a backup file after installing a new package release.

Frequently Asked Questions about restore-template-configs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I restore custom ESS Workday HCM template configs after a package update resets them?

To restore custom ESS Workday HCM template configs, run the restore process using a pre-captured backup file to overwrite msdyn_value fields for matched records. This automates the recovery of customised reference-data records that package updates reset to default values.

Can I promote Copilot Studio ESS template customisations between different Dataverse environments?

Yes, you can promote ESS template customisations across Dataverse environments by using the same backup file. The restore operation applies customisations to the target environment and provides clear warnings when the backup and target environments do not match.

What do I need to restore Employee Self-Service template configurations in Copilot Studio?

Restoring ESS template configurations requires a valid Dataverse endpoint configuration, a backup file generated by the backup-template-configs skill, and the accompanying restore_template_configs.py script to execute the overwrite process.

Is it safe to re-run the template config restore operation if the first attempt fails partially?

Re-running the template config restore operation is completely safe because it is idempotent. It overwrites existing customisations with identical values from the backup without creating duplicate records or conflicting data.

What happens if the backup file is invalid or the ESS template restore encounters errors?

If the ESS template restore encounters errors, it provides actionable step-by-step guidance for partial failures with full diagnostic details for the first failure, or hard failure messages for invalid or stale backup files so you can resolve issues quickly and retry.