Migrating future iterations

[colutti]

Hello

I have created several future iterations that have no work items associated to them, so they are "empty". When I run the migration with the WorkItemMigrationConfig, those iterations are not being migrated.

How can I migrate all iteration despite having no WI associated with them?

[MrHinsh]

You can use ReplicateAllExistingNodes which will run before the work items are loaded and create all of the existing nodes from the source. You can use NodeBasePaths to filter:

https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v2/ProcessorEnrichers/TfsNodeStructure/

The docs for NodeBasePaths are still in https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v1/Processors/WorkItemMigrationContext/ but have been moved in the Preview version to the TfsNodeStructure enricher.

[colutti]

Is it available on 14.4? I am getting an error:

 Your configuration file is malformed and cant be loaded!
[15:39:39 ERR] [v14.4.6] Type specified in JSON 'MigrationTools.Enrichers.TfsNodeStructureOptions, MigrationTools.Clients.AzureDevops.ObjectModel, Version=14.4.6.0, Culture=neutral, PublicKeyToken=null' is not compatible with 'MigrationTools._EngineV1.Configuration.IProcessorConfig, MigrationTools, Version=14.4.6.0, Culture=neutral, PublicKeyToken=null'. Path 'Processors[2].$type', line 84, position 46.
[15:39:39 ERR] [v14.4.6] How to Solve: Malformed Json is usually a result of editing errors. Validate that your .\configuration.json is valid Json!

config.json

{
    "ChangeSetMappingFile": null,
    "Source": {
        "$type": "TfsTeamProjectConfig",
        "Collection": "redacted",
        "Project": "redacted",
        "ReflectedWorkItemIDFieldName": "Custom.ReflectedWorkItemId",
        "AllowCrossProjectLinking": false,
        "AuthenticationMode": "AccessToken",
        "PersonalAccessToken": "redacted",
        "PersonalAccessTokenVariableName": "",
        "LanguageMaps": {
            "AreaPath": "Area",
            "IterationPath": "Iteration"
        }
    },
    "Target": {
        "$type": "TfsTeamProjectConfig",
        "Collection": "redacted",
        "Project": "redacted",
        "ReflectedWorkItemIDFieldName": "Custom.ReflectedWorkItemId",
        "AllowCrossProjectLinking": false,
        "AuthenticationMode": "AccessToken",
        "PersonalAccessToken": "redacted",
        "PersonalAccessTokenVariableName": "",
        "LanguageMaps": {
            "AreaPath": "Area",
            "IterationPath": "Iteration"
        }
    },
    "FieldMaps": [],
    "GitRepoMapping": null,
    "LogLevel": "Information",
    "CommonEnrichersConfig": null,
    "Processors": [
        {
            "$type": "WorkItemMigrationConfig",
            "Enabled": false,
            "ReplayRevisions": false,
            "PrefixProjectToNodes": false,
            "UpdateCreatedDate": true,
            "UpdateCreatedBy": true,
            "WIQLQueryBit": "AND [System.CreatedDate] >= '06/30/2021' AND [System.CreatedDate] <= '12/31/2021' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request', 'Code Review Request', 'Code Review Response', 'Feedback Response')",
            "WIQLOrderBit": "[System.ChangedDate] desc",
            "LinkMigration": true,
            "AttachmentMigration": true,
            "AttachmentWorkingPath": "c:\\temp\\WorkItemAttachmentWorkingFolder\\",
            "FixHtmlAttachmentLinks": true,
            "SkipToFinalRevisedWorkItemType": true,
            "WorkItemCreateRetryLimit": 5,
            "FilterWorkItemsThatAlreadyExistInTarget": true,
            "PauseAfterEachWorkItem": false,
            "AttachmentMaxSize": 480000000,
            "AttachRevisionHistory": false,
            "LinkMigrationSaveEachAsAdded": false,
            "GenerateMigrationComment": true,
            "WorkItemIDs": null,
            "MaxRevisions": 0,
            "UseCommonNodeStructureEnricherConfig": false,
            "StopMigrationOnMissingAreaIterationNodes": false,
            "NodeBasePaths": [],
            "AreaMaps": {},
            "IterationMaps": {},
            "MaxGracefulFailures": 0,
            "SkipRevisionWithInvalidIterationPath": true,
            "SkipRevisionWithInvalidAreaPath": true,
            "ShouldCreateMissingRevisionPaths": true
        },
        {
            "$type": "TfsNodeStructureOptions",
            "Enabled": true,
            "PrefixProjectToNodes": false,
            "NodeBasePaths": null,
            "AreaMaps": {},
            "IterationMaps": {},
            "ShouldCreateMissingRevisionPaths": true,
            "ReplicateAllExistingNodes": true
        }
    ],
    "Version": "14.4",
    "workaroundForQuerySOAPBugEnabled": false,
    "WorkItemTypeDefinition": {
        "sourceWorkItemTypeName": "targetWorkItemTypeName"
    }
}

[MrHinsh]

Remove the 'TfsNodeStructureOptions' from processors and move it instead to 'CommonEnrichersConfig'

[colutti]

Thank you. Do I have to actually run a WI migration for it to work? I have all the processors disabled and the app just finishes witout executiing anything/

[MrHinsh]

Its part of the WorkItemMigrationConfig

[colutti]

Ok, but the iterations have no work itens associated ... so I am kind of lost on what to migrate in order to get the iteration migrated. sorry ...

[MrHinsh]

Yup, its run as part of the WorkItemMigrationConfig rather than independently. If you want to run it with no work items you can create a query that finds no work items.

[colutti]

Something like that right?

    "CommonEnrichersConfig": [
        {
            "$type": "TfsNodeStructureOptions",
            "Enabled": true,
            "PrefixProjectToNodes": false,
            "NodeBasePaths": null,
            "AreaMaps": {
            },
            "IterationMaps": {},
            "ShouldCreateMissingRevisionPaths": true,
            "ReplicateAllExistingNodes": true
        }
    ],
    "Processors": [
        {
            "$type": "WorkItemMigrationConfig",
            "Enabled": true,
            "ReplayRevisions": false,
            "PrefixProjectToNodes": false,
            "UpdateCreatedDate": true,
            "UpdateCreatedBy": true,
            "WIQLQueryBit": "AND [System.CreatedDate] >= '06/30/2021' AND [System.CreatedDate] <= '12/31/2021' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request', 'Code Review Request', 'Code Review Response', 'Feedback Response')",
            "WIQLOrderBit": "[System.ChangedDate] desc",
            "LinkMigration": true,
            "AttachmentMigration": true,
            "AttachmentWorkingPath": "c:\\temp\\WorkItemAttachmentWorkingFolder\\",
            "FixHtmlAttachmentLinks": true,
            "SkipToFinalRevisedWorkItemType": true,
            "WorkItemCreateRetryLimit": 5,
            "FilterWorkItemsThatAlreadyExistInTarget": true,
            "PauseAfterEachWorkItem": false,
            "AttachmentMaxSize": 480000000,
            "AttachRevisionHistory": false,
            "LinkMigrationSaveEachAsAdded": false,
            "GenerateMigrationComment": true,
            "WorkItemIDs": null,
            "MaxRevisions": 0,
            "UseCommonNodeStructureEnricherConfig": false,
            "StopMigrationOnMissingAreaIterationNodes": false,
            "NodeBasePaths": [],
            "AreaMaps": {
            },
            "IterationMaps": {},
            "MaxGracefulFailures": 0,
            "SkipRevisionWithInvalidIterationPath": true,
            "SkipRevisionWithInvalidAreaPath": true,
            "ShouldCreateMissingRevisionPaths": true
        },

[MrHinsh]

you need to set "UseCommonNodeStructureEnricherConfig": true if you are using v14.x