Skip to content

emmetienne/Emmetienne.SolutionReplicator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build and Release

Emmetienne.SolutionReplicator

Solution Replicator is a plugin for XrmToolbox that allows you to replicate a solution between environments. It is useful, for example, when you need to compare the customization.xml file between two environments.

Changelog

  • 1.2026.2.1 - Refactored component cache, improved connections handling and added handles to split container
  • 1.2025.10.1 - Fixed a bug that prevented the tool from working when some apps were not present in the target environment, refactored the component cache engine, other minor improvements
  • 1.2025.3.1 - Fixed a bug that prevents the tool to perform entity key replication, QoL improvements (added component name column in the solution components pane, optimization for the component cache engine and visualization of the component types when only the source environment is selected), added handling for Environment Variable Definition and Environment Variable Value components, added new state for the components that cannot be replicated for various reason (e.g. Ribbon Customization for the Applications Ribbons component)
  • 1.2024.12.2 - Minor fix
  • 1.2024.12.1 - Fixed a bug that prevents the tool from loading after it has been previously closed
  • 1.2024.8.1 - Fixed some bugs and refactored some code, renamed the “Replication status” column in the solution components pane to “Component search result”, added “Replicated” and “Error message” columns to the solution components pane to show if the components have been successfully replicated
  • 1.2024.7.2 - Added a checkbox to show managed solutions in the solution pane (they're hidden by default), added handling for components of type Custom Control (66) and Canvas App (300), implemented solution name validation
  • 1.2024.7.1 - Minor refactoring
  • 1.2024.6.1 - First nuget release of the tool

Features

  • Replicate the solution between environments
  • Filter the solution by name
  • Filter out managed solutions (the default behaviour is to not show managed solutions)
  • Show the solution components names
  • Export the source solution and the target solution
  • Open the source and the target solution

How to use the tool

  1. Open the tool and select the source environment by clicking the "Connect to source environment" button (if not already connected to one)
  2. Connect to a target environment by clicking the "Connect to target environment" button
  3. Click the "Load solution from ..." buttons
  4. Pick a solution to replicate on the target environment
  5. In the "Target solution" pane, fill the "Solution name" and "Publisher" fields
  6. Finally, click the "Replicate solution" button and wait for the replication process to complete
  7. At the end of the process, you can see the following for each component:
    • In the “Component search status” column of the solution components pane, you can see if the components have been found in the target environment (please refer to the “How to read the “Component search status” column” paragraph for more info)
    • In the "Replicated" column of the solution components pane you can see if the component has been successfully replicated, components that have been found in the target environment but not replicated will not be checked and will be highlighted with a black background color
    • In the "Error message" column of the solution components pane you can see the error message if the component has not been replicated

How to read the "Component search status" column

The "Component search status" column can have five states:

  • Not yet searched -> Default state, it is not yet known if the component exists or not in the target environment
  • Found on target environment -> The component has been found on the target environment and it's replicated in the target solution
  • Not found on target environment -> The component has not been found on the target environment and thus it's not replicated in the target solution
  • Found multiple on target environment -> Multiple components have been found and each one has been added to the solution
  • Component type not yet handled by the tool -> The component type is not handled by the current version of the tool. If you find a component not handled, please open an issue
  • Component cannot be replicated -> The component cannot be replicated for various reasons, such as when uniqueness cannot be guaranteed or in specific scenarios like Ribbon Customization for Application Ribbons
  • Error -> An error has occoured and therefore the component will not be replicated, the exception will be logged. If you find an error, please open an issue

How this tool works

This tool works by retrieving the data of the components of the selected solution from the source environment. This data is then used to search for the same component in the target environment. If found, the component will be added to the target solution.

About

This tool allows to replicate a solution from a Dynamics 365 environment to another

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages