Migrating teams using TfsTeamSettingsProcessor #1245

michael-buchner · 2022-08-23T13:03:09Z

michael-buchner
Aug 23, 2022

I need to specify SourceName and TargetName of the endpoints but how do I create endpoints? Is there any example? Why do I need it for teams but not for work items?
https://nkdagility.github.io/azure-devops-migration-tools/Reference/Processors/TfsTeamSettingsProcessor.html

Answered by MrHinsh

Oct 10, 2022

The non-work item processors use the new API that is more flexible.

View full answer

michael-buchner · 2022-09-09T10:42:24Z

michael-buchner
Sep 9, 2022
Author

I need further help on this. How do I migrate teams using the processor?

5 replies

michael-buchner Oct 10, 2022
Author

@MrHinsh I need your help :)

MrHinsh Oct 10, 2022
Maintainer

What do you need?

The Teams processor migrates the Team entity and meta data, it does not migrate users.

michael-buchner Oct 21, 2022
Author

What do you need?

The Teams processor migrates the Team entity and meta data, it does not migrate users.

Sorry for late answer. Is there any example or description how to use the TfsTeamSettingsProcessor? The documentation is incomplete, SourceName and TargetName settings are not documented ("missng XML code comments"). I need to migrate teams, can add users later, no problem.

michael-buchner Nov 17, 2022
Author

What do you need?
The Teams processor migrates the Team entity and meta data, it does not migrate users.

Sorry for late answer. Is there any example or description how to use the TfsTeamSettingsProcessor? The documentation is incomplete, SourceName and TargetName settings are not documented ("missng XML code comments"). I need to migrate teams, can add users later, no problem.

@MrHinsh Can you assist here?

Nessman101 Jan 10, 2024

Does the TfsTeamSettingsProcessor work with Azure Dev Ops? If so, I tried to configure end points as such and it didn't work as expected.

MrHinsh · 2022-10-10T13:04:45Z

MrHinsh
Oct 10, 2022
Maintainer

The non-work item processors use the new API that is more flexible.

4 replies

Nessman101 Jan 11, 2024

Would love to see an example of how to use the "New API" endpoints. I have tried everything and I keep getting an error saying it can't find an endpoint named "Source" Here is the config I am using to migrate Team settings to Target. BTW, I've tried a number of the different Endpoint types ... none of them worked.

I'd be glad to help add to your documentation if I can get this working. I cannot find any examples that show a complete config file with the new end point APIs with a Processor.

Please help.

{
"Version": "14.3",
"workaroundForQuerySOAPBugEnabled": false,
"ChangeSetMappingFile": null,
"LogLevel": "Verbose",
"FieldMaps": [],
"GitRepoMapping": null,
"CommonEnrichersConfig": null,

"Endpoints": {
"TfsTeamSettingsEndpoint": [
{
"Name": "Source",
"Direction": "Source",
"AccessToken": "token",
"Query": {
"Query": "SELECT [System.Id], [System.Tags] FROM WorkItems WHERE [System.TeamProject] = @teamproject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') ORDER BY [System.ChangedDate] desc"
},
"Organisation": "https://dev.azure.com/UQF-ES",
"Project": "EnterpriseApplications",
"ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
"AuthenticationMode": "Prompt",
"AllowCrossProjectLinking": false,
"LanguageMaps": {
"AreaPath": "Area",
"IterationPath": "Iteration"
}

  },
  {
    "Name": "Target",
	"AccessToken": "token",
    "Query": {
      "Query": "SELECT [System.Id], [System.Tags] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') ORDER BY [System.ChangedDate] desc"
    },
    "Organisation": "https://dev.azure.com/lmorton",
    "Project": "Test2-EnterpriseApplications",
    "ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
    "AuthenticationMode": "Prompt",
    "AllowCrossProjectLinking": false,
    "LanguageMaps": {
      "AreaPath": "Area",
      "IterationPath": "Iteration"
    }		
  }
]

},

"Processors": [

{
  "$type": "TfsTeamSettingsProcessorOptions",
  "Enabled": true,
  "MigrateTeamSettings": true,
  "UpdateTeamSettings": true,
  "PrefixProjectToNodes": false,
  "MigrateTeamCapacities": false,
  "Teams": null,
  "ProcessorEnrichers": null,
  "SourceName": "Source",
  "TargetName": "Target"
}

],

"WorkItemTypeDefinition": {
"sourceWorkItemTypeName": "targetWorkItemTypeName"
},
}

MrHinsh Jan 11, 2024
Maintainer

There are samples under https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v2/

But here is the complete sample from the "Samples" folder of the tool:

{
  "Version": "0.0",
  "LogLevel": "Verbose",
  "MappingTools": [
    {
      "$type": "WorkItemTypeMappingTool",
      "Enabled": true,
      "WorkItemTypeDefinition": {
        "sourceWorkItemTypeName": "targetWorkItemTypeName"
      }
    },
    {
      "$type": "WorkItemFieldMappingTool",
      "Enabled": true,
      "WorkItemFieldMaps": []
    },
    {
      "$type": "WorkItemGitRepoMappingTool",
      "Enabled": true,
      "WorkItemGitRepos": {
        "sourceRepoName": "targetRepoName"
      }
    }
  ],
  "Endpoints": {
    "TfsWorkItemEndpoints": [
      {
        "Name": "Source",
        "AccessToken": "qosss7crwz3vie4fupzpaafjndoy6g6ulgkzhoxtmjgicv2lqjyq",
        "Query": {
          "Query": "SELECT [System.Id], [System.Tags] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') ORDER BY [System.ChangedDate] desc"
          "Parameters": {
            "TeamProject": "MigrationSource1"
          }
        },
        "Organisation": "https://dev.azure.com/nkdagility-preview/",
        "Project": "migrationSource1",
        "ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
        "AuthenticationMode": "Prompt",
        "AllowCrossProjectLinking": false,
        "PersonalAccessToken": "qosss7crwz3vie4fupzpaafjndoy6g6ulgkzhoxtmjgicv2lqjyq",
        "LanguageMaps": {
          "AreaPath": "Area",
          "IterationPath": "Iteration"
        }
      },
      {
        "Name": "Target",
        "AccessToken": "qosss7crwz3vie4fupzpaafjndoy6g6ulgkzhoxtmjgicv2lqjyq",
        "Query": {
          "Query": "SELECT [System.Id], [System.Tags] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') ORDER BY [System.ChangedDate] desc"
        },
        "Organisation": "https://dev.azure.com/nkdagility-preview/",
        "Project": "migrationTarget1",
        "ReflectedWorkItemIdField": "nkdScrum.ReflectedWorkItemId",
        "AuthenticationMode": "Prompt",
        "AllowCrossProjectLinking": false,
        "LanguageMaps": {
          "AreaPath": "Area",
          "IterationPath": "Iteration"
        }
      }
    ]
  },
  "Source": {},
  "Target": {},
  "Processors": [
    {
      "$type": "WorkItemTrackingProcessorOptions",
      "Enabled": false,
      "ReplayRevisions": true,
      "PrefixProjectToNodes": false,
      "CollapseRevisions": false,
      "WorkItemCreateRetryLimit": 5,
      "Enrichers": [
        {
          "$type": "PauseAfterEachItemOptions",
          "Enabled": true
        },
        {
          "$type": "FilterWorkItemsThatAlreadyExistInTargetOptions",
          "Enabled": true,
          "Query": {
            "WhereBit": "AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')",
            "OrderBit": "[System.ChangedDate] desc"
          }
        },
        {
          "$type": "AppendMigrationToolSignatureFooterOptions",
          "Enabled": false
        },
        {
          "$type": "SkipToFinalRevisedWorkItemTypeOptions",
          "Enabled": false
        }
      ],
      "SourceName": "Source",
      "TargetName": "Target",
      "Endpoints": [
        {
          "$type": "FileSystemWorkItemEndpointOptions",
          "Direction": "Source",
          "FileStore": ".\\Store\\Source\\",
          "Query": {
            "WhereBit": "AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')",
            "OrderBit": "[System.ChangedDate] desc"
          },
          "Enrichers": [
            {
              "$type": "FileSystemWorkItemAttachmentEnricherOptions",
              "Enabled": true,
              "AttachmentWorkingPath": "c:\\temp\\WorkItemAttachmentWorkingFolder\\",
              "AttachmentMaxSize": 480000000
            }
          ]
        },
        {
          "$type": "TfsWorkItemEndPointOptions",
          "Direction": "Target",
          "AccessToken": "qosss7crwz3vie4fupzpaafjndoy6g6ulgkzhoxtmjgicv2lqjyq",
          "Query": {
            "Query": "SELECT [System.Id], [System.Tags] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') ORDER BY [System.ChangedDate] desc"
          },
          "Enrichers": [
            {
              "$type": "TfsWorkItemAttachmentEnricherOptions",
              "Enabled": true,
              "AttachmentWorkingPath": "c:\\temp\\WorkItemAttachmentWorkingFolder\\",
              "AttachmentMaxSize": 480000000
            },
            {
              "$type": "TfsWorkItemEmbedEnricherOptions",
              "Enabled": true,
              "AttachmentWorkingPath": "c:\\temp\\WorkItemAttachmentWorkingFolder\\"
            },
            {
              "$type": "TfsWorkItemLinkEnricherOptions",
              "Enabled": true,
              "LinkMigrationSaveEachAsAdded": false
            },
            {
              "$type": "TfsWorkItemCreatedEnricherOptions",
              "Enabled": true,
              "UpdateCreatedDate": true,
              "UpdateCreatedBy": true
            },
            {
              "$type": "TfsWorkItemFieldTableEnricherOptions",
              "Enabled": true
            }
          ]
        }
      ]
    }
  ]
}

systobe Apr 17, 2024

@Nessman101 Did you manage to get it working? I'm stuck at the same point.
In the Processor configuration, specify the SourceName, for example "SourceName" : "mySourceName" and make sure there's an EndPoint with that name
Endpoints are configured based on the example, but probably not correctly. It's not really clear to me, why there's an endpoint on the top level and inside processors. My goal is to use TfsSharedQueryProcessor.

systobe Apr 17, 2024

Nevermind, got the correct structure from this discussion #2012.
The endpoint type is the crucial part.

 "Endpoints": {
    "TfsEndpoints": [
      {
         "$type": "TfsTeamProjectConfig"
         ....

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Migrating teams using TfsTeamSettingsProcessor #1245

{{title}}

{{editor}}'s edit

{{editor}}'s edit

Replies: 2 comments 9 replies

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{title}}

{{title}}

{{title}}

{{title}}

{{title}}

{{title}}

{{title}}

{{title}}

{{title}}

Select a reply

Migrating teams using TfsTeamSettingsProcessor #1245

michael-buchner Aug 23, 2022

Replies: 2 comments · 9 replies

michael-buchner Sep 9, 2022 Author

michael-buchner Oct 10, 2022 Author

MrHinsh Oct 10, 2022 Maintainer

michael-buchner Oct 21, 2022 Author

michael-buchner Nov 17, 2022 Author

Nessman101 Jan 10, 2024

MrHinsh Oct 10, 2022 Maintainer

Nessman101 Jan 11, 2024

MrHinsh Jan 11, 2024 Maintainer

systobe Apr 17, 2024

systobe Apr 17, 2024

michael-buchner
Aug 23, 2022

Replies: 2 comments 9 replies

michael-buchner
Sep 9, 2022
Author

michael-buchner Oct 10, 2022
Author

MrHinsh Oct 10, 2022
Maintainer

michael-buchner Oct 21, 2022
Author

michael-buchner Nov 17, 2022
Author

MrHinsh
Oct 10, 2022
Maintainer

MrHinsh Jan 11, 2024
Maintainer