Skip to content

Underlying technology to enable content and data imports from any data source into Xperience by Kentico.

License

Notifications You must be signed in to change notification settings

Kentico/xperience-by-kentico-universal-migration-tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Xperience by Kentico: Universal Migration Tool

7-day bug-fix policy

CI: Build and Test

NuGet Package

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.

Universal Migration Tool use-cases

Library Version Matrix

Xperience Version Library Version
>= 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

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

7-day bug-fix policy

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