Xperience by Kentico: Universal Migration Tool

Description

This repository is part of the Xperience by Kentico Migration Toolkit.

The Xperience by Kentico: Universal Migration Tool (UMT) is an open-source set of software libraries, documentation, and samples distributed via NuGet packages to facilitate and automate data import from external data sources into Xperience by Kentico.

Library Version Matrix

Xperience Version	Library Version
>= 30.0.0	>= 3.0.0
>= 29.7.0	>= 1.10.0
>= 29.6.0	>= 1.9.0
>= 29.5.0	>= 1.7.0
>= 29.4.0	>= 1.6.0
>= 29.3.0	>= 1.4.0
>= 29.1.0	>= 1.1.0

Dependencies

• .NET 8+ SDK
• Xperience by Kentico

Package Installation

Add the package to your application using the .NET CLI

dotnet add package Kentico.Xperience.UMT

Quick Start

1. Open file with dependency injection container configuration. (Program.cs / Startup.cs / ...)
2. Import namespace Kentico.Xperience.UMT.
3. Register Umt to service collection IServiceCollection using AddUniversalMigrationToolkit().
4. Inject IImportService where you want use this tool.

Full Instructions

View the Docs for more detailed instructions.

Projects

Project	Description
src/Kentico.Xperience.UMT	Core migration tool
utils/Kentico.Xperience.UMT.DocUtils	Used to generate documentation in the repository
examples/Kentico.Xperience.UMT.Example.AdminApp	simplified administration sample
examples/Kentico.Xperience.UMT.Example.Console	main example of how to use UMT
examples/Kentico.Xperience.UMT.Example.Examples	centralized sample source

Contributing

To see the guidelines for Contributing to Kentico open source software, please see Kentico's CONTRIBUTING.md for more information and follow the Kentico's CODE_OF_CONDUCT.

Instructions and technical details for contributing to this project can be found in Contributing Setup.

License

Distributed under the MIT License. See LICENSE.md for more information.

Support

This contribution has Full support by 7-day bug-fix policy.

See SUPPORT.md for more information.

Security

For any security issues see Kentico's SECURITY.md.

Testing

1. Migrate to blank template Kentico XbK project by Kentico.Xperience.UMT.Example.Console
2. Configure $SolutionDir\test.runsettings per the project's settings
3. Ensure test.runsettings file is used in Visual Studio: Top menu -> Test -> Configure Run Settings -> Select Solution Wide runsettings File
4. Run tests from Test explorer