beta12 - Week 9 (3rd March) Release

Migrations has (or is attempting to have) a fast cadence, we will release weekly if there are changes to release.

3rd March 2023 - Beta 12

• #75 - Childnode permissions being lost on import (doctype structure) @snappercrumpleddog

24th Feb 2023 - Beta 11

• #72 - Pre-release code cleanup

beta010 - 🎪

This is another beta of uSync.Migrations, getting closer to being useful, with being finished.

dotnet add package uSync.Migrations --version 4.0.0-beta010 

What's Changed

Migrations or Conversions?

The big changes in this version are splitting Migrations and Converting.

• Migrations are moving from old to new (e.g. v7 to v8+)
• Conversions are chaning things your site already have (e.g. Nested Content to Block List)

Grid -> BlockGrid

Support for Grid to Block Grid ! HT @soreng (as a conversion) - so if your site have grid, one (or maybe two now) clicks of a button will turn it all into blockgrid (*you will have to update your own razor templates to get things to render).

Breaking Changes 🛠

• Move the context (breaking) by @KevinJump in #71

Other Changes

• Making the code version aware. by @KevinJump in #56
• Community migrator: Stacked Content to Block List by @soreng in #57
• v8 and Shared migration code. by @KevinJump in #58
• Add logging to the handlers. by @KevinJump in #62
• NestedContent: Property value can be null, resulting in an error by @soreng in #65
• Update the UI - So we group profiles by migrations and conversions by @KevinJump in #69
• Feature : v8 grid to block grid by @KevinJump in #70

New Contributors

• @soreng made their first contribution in #57

Full Changelog: 4.0.0-beta007...4.0.0-beta010

4.0.0-beta 007 🔫🎯

This is another beta of usync.Migrations, getting less rought but still quite not ready -

** N.B you need to use uSync 10.3.1 beta (or uSync v11 for this to work.) **

Fixes

• Quite a lot, tweaks around the houses to make properties come in better
  • Nested / BlockList any Content Typers used are now made as element types)
  • Language - the default language of the current install is kept
  • Checkbox List - the result is now JSON not CSV
  • Grid - slightly better (but Grid to BlockGrid is on the roadmap)

What's Changed

• The SyncPropertyMigrators are now loaded in the context based on options (so you can in theory choose them - UI to come)
• ID look ups in the context so int to guid on really only (pre v7.6 things) can have a go at working
• Support for mapping things to the new media types in Umbraco 10
• Nested Content to BlockList (but you need to enable this in code [see sample profile for how])(https://github.com/Jumoo/uSyncMigrations/blob/main/MyMigrations/MyMigrationProfile.cs#L48-L52)
• the Handlers are now version aware, meaning we might also have v8 handlers for other types of migration 🤫

New Mappers

• uEditorNotes migrators (both to uEditorNotes and Contentment) added to community migrators
• Multi-URL picker editor support

What's Changed

Other Changes

• Tiny spelling mistake by @CarlSargunar in #26
• Fix/prep order fix by @KevinJump in #27
• Order the profiles correctly. by @KevinJump in #28
• error box on the migrations dashboard by @KevinJump in #29
• profiles - keep them lazy loaded but in order by @KevinJump in #30
• Corrected typos by @leekelleher in #31
• Removed unused namespaces by @leekelleher in #32
• Whitespace formatting by @leekelleher in #33
• Various code formatting by @leekelleher in #34
• Marks internal ISyncPropertyMigrator classes as public by @leekelleher in #35
• Corrected typo in EditorAliasInfo.OriginalEditorAlias by @leekelleher in #36
• Adds migrator for Multi-URL Picker editor by @leekelleher in #37
• Add support for the popular uEditorNotes property editor by @marcemarc in #39
• Adds ID/Key lookup to SyncMigrationContext by @leekelleher in #42
• Adds support for newer Media Types by @leekelleher in #43
• fix typo by @LottePitcher in #46
• Move migrators to the context, so they can be configured. by @KevinJump in #38
• Typos by @craigs100 in #47
• Change attributes on editornotes, so they both load by @KevinJump in #48
• Make sure we use Path.DirectorySeparatorChar as needed. by @KevinJump in #50
• Make context disposable. by @KevinJump in #49
• spell it with two r's pre-fer-red - by @KevinJump in #51
• Nested to BlockList Migrator. by @KevinJump in #52
• fix case of Textbox to TextBox when migrating from v7 by @KevinJump in #53
• Tidy up handlers, allow for source versioning. by @KevinJump in #54
• Fix/checkboxlist by @KevinJump in #55

New Contributors

• @CarlSargunar made their first contribution in #26
• @marcemarc made their first contribution in #39
• @LottePitcher made their first contribution in #46
• @craigs100 made their first contribution in #47

Full Changelog: 4.0.0-beta1...4.0.0-beta4

4.0.0 beta ~001/2/3. 🙂

This is the first 🎉 release of the new and shiny 🌟 uSync.Migrations tool, - something to help you get from Umbraco 7 to Umbraco 8/9/10 and 11.

No 1. Its FREE

uSync.Migrations is a free tool, - at its basic level it will get you going on a migration - there are no doubt things you will need to do to finish a migration and there are loads of customisation points This is your starting point.

No 2. Its Beta

This is the beta release - so things may or may not work, things might change before release, but as a beta we will try to minimise breaking changes in interfaces etc.

Not 3. It runs on Umbraco 10

This release runs on Umbraco 10 - but the files it produces will work on other versions - uSync files are compatible from v8 through to v11.

Updates

Release early - release often ! - so we are at beta 003!

• 002 - fixed the order of the prep so we actually did datatypes before doctypes 🤦
• 003 - fixed data type issues on media pickers, and colour pickers without a label.

Gettting Started

Install uSync and uSync.Migrations.

You need the latest uSync beta

dotnet add package uSync --version 10.3.1-beta001

And the pre-release of uSync.Migrations.

dotnet add package uSync.Migrations --prerelease

Copy your v7 usync/data folder into your new v10 uSync folder

uSync.Migrations will let you pick a folder to import but only from the uSync folder so you have to copy things into there.

Go to the uSync Migrations dashboard

Work out what you want to migrate (defaults are settings, content and everything!)

configure your migration

Pick the source and target folders, if the source doesn't look right, uSync.Migrations will tell you, It will also warn you of things it thinks it cant't migrate.

Migrate.

Import

Enjoy .

Report any issues in the issues log but remember. 1. this is a beta, 2. this is the starting point for migrations not the destination!