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

Docs update related to XbK API upgrade 26.0.1 and member migration

Closed this issue · 1 comments

tkrch commented
  • new command "MigrateMembers"
  • new setting "MemberIncludeUserSystemFields"

Prerequisites & Compatibility

  • target instance requirements raised to XbK API version 26.0.1

New supported command for members migration

command moniker --members,
full example with other commands migrate --siteId 1 --contact-management --media-libraries --custom-modules --settings-keys --page-types --pages --forms --attachments --culture en-US --sites --users --members

in order to run members migration with custom fields and legacy system fields command custom-modules must be run before.

  • apart from users, migration toolkit now supports migration of new entity Member
  • member is migrated from users without access to administration (CMS_User with UserPrivilegeLevelEnum.None)
  • migration to member supports:
    • corresponding users fields in member entity
    • creation and migration of no longer present fields optionally (configured with setting Settings.MemberIncludeUserSystemFields) from User and UserSettings
    • migration of custom fields from entities User and UserSettings
  • migration to member NOT supports:
    • migration of passwords

New setting

  • appsettings.json, path Settings.MemberIncludeUserSystemFields for complete system fields migration (remove field You don't want to migrate): FirstName|MiddleName|LastName|FullName|PreferredCultureCode|PreferredUICultureCode|UserPrivilegeLevel|UserIsExternal|UserPasswordFormat|LastLogon|UserStartingAliasPath|UserLastModified|UserLastLogonInfo|UserIsHidden|UserIsDomain|UserHasAllowedCultures|UserMFRequired|UserMFSecret|UserMFTimestep|UserNickName|UserSignature|UserURLReferrer|UserCampaign|UserCustomData|UserRegistrationInfo|UserActivationDate|UserActivatedByUserID|UserTimeZoneID|UserAvatarID|UserGender|UserDateOfBirth|UserSettingsUserGUID|UserSettingsUserID|UserWaitingForApproval|UserDialogsConfiguration|UserDescription|UserAuthenticationGUID|UserSkype|UserIM|UserPhone|UserPosition|UserLogActivities|UserPasswordRequestHash|UserInvalidLogOnAttempts|UserInvalidLogOnAttemptsHash|UserPasswordLastChanged|UserAccountLockReason|UserShowIntroductionTile|UserDashboardApplications|UserDismissedSmartTips`
skurekjakub commented

PR with changes #133