https://github.com/kentico/xperience-by-kentico-universal-migration-tool
Underlying technology to enable content and data imports from any data source into Xperience by Kentico.
https://github.com/kentico/xperience-by-kentico-universal-migration-tool
xperience-by-kentico xperience-by-kentico-integrations xperience-by-kentico-migrations
Last synced: 7 months ago
JSON representation
Underlying technology to enable content and data imports from any data source into Xperience by Kentico.
- Host: GitHub
- URL: https://github.com/kentico/xperience-by-kentico-universal-migration-tool
- Owner: Kentico
- License: mit
- Created: 2023-07-26T18:29:37.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-07T06:39:25.000Z (7 months ago)
- Last Synced: 2025-04-12T19:09:18.484Z (7 months ago)
- Topics: xperience-by-kentico, xperience-by-kentico-integrations, xperience-by-kentico-migrations
- Language: C#
- Homepage:
- Size: 5.54 MB
- Stars: 2
- Watchers: 8
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/Contributing-Setup.md
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Xperience by Kentico: Universal Migration Tool
[](https://github.com/Kentico/.github/blob/main/SUPPORT.md#full-support)
[](https://github.com/Kentico/xperience-by-kentico-universal-migration-toolkit/actions/workflows/ci.yml)
[](https://www.nuget.org/packages/Kentico.Xperience.UMT)
## Description
This repository is part of the [Xperience by Kentico Migration Toolkit](https://github.com/Kentico/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](https://www.nuget.org/packages/Kentico.Xperience.UMT) to facilitate and automate data import from external data sources into Xperience by Kentico.
[](/images/xperience-by-kentico-migration-toolkit-universal-migration-tool-embedded.jpg)
## Library Version Matrix
| Xperience Version | Library Version |
| ----------------- | --------------- |
| 30.3.1 | >= 3.5.0 |
| >= 30.2.0 | >= 3.4.0 |
| >= 30.1.0 | >= 3.1.0 |
| >= 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](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
- [Xperience by Kentico](https://docs.kentico.com/changelog)
## Package Installation
Add the package to your application using the .NET CLI
```powershell
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.
5. When importing asset files, the working dir of the application must be set to the root folder of the XbyK project (i.e. the folder, which contains XbyK project's .csproj file)
## Full Instructions
View the [Docs](./docs/README.md) 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`](https://github.com/Kentico/.github/blob/main/CONTRIBUTING.md) for more information and follow the [Kentico's `CODE_OF_CONDUCT`](https://github.com/Kentico/.github/blob/main/CODE_OF_CONDUCT.md).
Instructions and technical details for contributing to **this** project can be found in [Contributing Setup](./docs/Contributing-Setup.md).
## License
Distributed under the MIT License. See [`LICENSE.md`](./LICENSE.md) for more information.
## Support
[](https://github.com/Kentico/.github/blob/main/SUPPORT.md#full-support)
This contribution has **Full support by 7-day bug-fix policy**.
See [`SUPPORT.md`](https://github.com/Kentico/.github/blob/main/SUPPORT.md#full-support) for more information.
## Security
For any security issues see [Kentico's `SECURITY.md`](https://github.com/Kentico/.github/blob/main/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