Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: about 12 hours 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 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-31T12:46:01.000Z (5 days ago)
- Last Synced: 2025-02-02T13:26:45.387Z (3 days ago)
- Topics: xperience-by-kentico, xperience-by-kentico-integrations, xperience-by-kentico-migrations
- Language: C#
- Homepage:
- Size: 1.85 MB
- Stars: 2
- Watchers: 8
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: docs/Contributing-Setup.md
- License: LICENSE.md
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.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` / ...)
1. Import namespace `Kentico.Xperience.UMT`.
1. Register Umt to service collection `IServiceCollection` using `AddUniversalMigrationToolkit()`.
1. Inject `IImportService` where you want use this tool.
## 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