XrmEmulator.MetadataSync 1.6.0

xrm-metadata-sync

Interactive CLI tool to sync Dataverse metadata into XrmMockup format for use with XrmEmulator.

Install

dotnet tool install --global XrmEmulator.MetadataSync

Usage

xrm-metadata-sync

Or run directly without installing:

dnx XrmEmulator.MetadataSync

The tool will interactively guide you through:

1. Connection setup - Choose between connection string, client secret, or interactive browser authentication
2. Solution selection - Pick a Dataverse solution to sync metadata from
3. Entity selection - Multi-select which entities to include (default XrmMockup entities are always included)
4. Scope selection - Choose what to sync: entity metadata, plugins, workflows, security roles, option sets, currencies
5. Output directory - Where to write the metadata files (default: ./Metadata)

CLI Arguments

You can pre-populate connection settings via CLI arguments or user secrets:

xrm-metadata-sync \
  --environment-url https://myorg.crm.dynamics.com \
  --client-id 00000000-0000-0000-0000-000000000000 \
  --client-secret mysecret \
  --tenant-id 00000000-0000-0000-0000-000000000000

Output

The tool produces files in XrmMockup's expected format:

• Metadata.xml - Serialized entity metadata (DataContractSerializer)
• Workflows/*.xml - Individual workflow definitions
• SecurityRoles/*.xml - Individual security role definitions
• TypeDeclarations.cs - Security role GUID constants