XrmMockup.MetadataGenerator 1.0.0

XrmMockup Metadata Generator

A .NET CLI tool for generating metadata from Microsoft Dataverse/Dynamics 365 environments. This tool is a companion to XrmMockup, extracting the metadata files required for local CRM simulation in your tests.

Installation

Install the tool globally:

dotnet tool install --global XrmMockup.MetadataGenerator

Or install locally in your project:

dotnet new tool-manifest # if you don't have a manifest yet
dotnet tool install XrmMockup.MetadataGenerator

Quick Start

1. Create an appsettings.json in your project directory
2. Run the tool:

dotnet tool xrmmockup-metadata

The tool will connect to Dataverse using interactive authentication and generate metadata files.

Authentication

This tool uses the DataverseConnection library for authentication via Azure Default Credentials. See the DataverseConnection documentation for configuration details.

Set the Dataverse URL via environment variable or appsettings.json:

Configuration

JSON Configuration (appsettings.json)

Create an appsettings.json file in your working directory:

{
  "DATAVERSE_URL": "https://your-org.crm4.dynamics.com",
  "XrmMockup": {
    "Metadata": {
      "OutputDirectory": "./Metadata",
      "Solutions": ["MySolution", "AnotherSolution"],
      "Entities": ["account", "contact", "opportunity"],
      "PrettyPrint": false
    }
  }
}

Configuration Options

Environment-Specific Configuration

The tool supports environment-specific configuration files. Set the DOTNET_ENVIRONMENT environment variable and create a matching config file:

• appsettings.json - Base configuration (always loaded)
• appsettings.Development.json - Loaded when DOTNET_ENVIRONMENT=Development
• appsettings.Production.json - Loaded when DOTNET_ENVIRONMENT=Production

Environment-specific files override values from the base configuration.

CLI Options

All CLI options override corresponding values from the configuration file.

xrmmockup-metadata [options]

Options:
  -o, --output <path>        Output directory for generated metadata files
  -s, --solutions <names>    Comma-separated list of solution unique names
  -e, --entities <names>     Comma-separated list of additional entity logical names
  -c, --config <path>        Path to appsettings.json configuration file
  -p, --pretty-print         Format XML output for readability
  --help                     Show help information
  --version                  Show version information

Examples

Generate metadata for a specific solution:

xrmmockup-metadata --solutions "MySolution"

Generate metadata with custom output directory:

xrmmockup-metadata -o "./tests/Metadata" -s "MySolution,CoreSolution"

Include additional entities not in any solution:

xrmmockup-metadata -s "MySolution" -e "account,contact,lead"

Use a specific configuration file:

xrmmockup-metadata --config "/path/to/appsettings.json"

Enable pretty-printed XML output:

xrmmockup-metadata --pretty-print

Default Entities

The following entities are always included regardless of solution or entity configuration:

• businessunit
• systemuser
• transactioncurrency
• role
• systemuserroles
• team
• teamroles
• activitypointer
• roletemplate
• fileattachment

These entities are required for XrmMockup's core functionality (security model, user management, etc.).

Generated Files

The tool generates the following files in the output directory:

Using with XrmMockup

Configure XrmMockup to use the generated metadata:

var settings = new XrmMockupSettings
{
    MetadataDirectoryPath = "./Metadata",
    // ... other settings
};

using var crm = XrmMockup365.GetInstance(settings);

CI/CD Integration

Configure Azure Default Credentials for your pipeline (see DataverseConnection documentation) and set DATAVERSE_URL:

# Azure DevOps example
- task: DotNetCoreCLI@2
  displayName: 'Generate XrmMockup Metadata'
  env:
    DATAVERSE_URL: $(DataverseUrl)
  inputs:
    command: 'custom'
    custom: 'tool'
    arguments: 'run xrmmockup-metadata -o ./tests/Metadata -s "$(SolutionName)"'

# GitHub Actions example
- name: Generate XrmMockup Metadata
  env:
    DATAVERSE_URL: ${{ secrets.DATAVERSE_URL }}
  run: dotnet tool run xrmmockup-metadata -o ./tests/Metadata -s "${{ vars.SOLUTION_NAME }}"

Troubleshooting

Authentication Issues

• Verify DATAVERSE_URL is correct and accessible
• See DataverseConnection documentation for authentication troubleshooting
• Ensure the authenticating user/service principal has the System Administrator or System Customizer security role

Missing Entities

• Verify the entity is included in one of the specified solutions, or add it explicitly to the Entities list
• Check that the authenticating user has read access to the entity metadata

Large Metadata Files

• Keep PrettyPrint disabled (default) for production use
• Consider limiting the number of solutions/entities to only those needed for testing