{"title":"DataTransfer.AddJoin(Integer, Integer) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/datatransfer/datatransfer-addjoin-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/datatransfer/datatransfer-addjoin-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/datatransfer/datatransfer-addjoin-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Adds a field pair to be used to create a join condition which determines which rows to transfer, optional for same table transfers.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"DataTransfer.AddJoin(Integer, Integer) Method","slug":"datatransferaddjoininteger-integer-method","at":0,"chars":1807},{"level":2,"title":"Syntax","slug":"syntax","at":241,"chars":91},{"level":2,"title":"Parameters","slug":"parameters","at":332,"chars":261},{"level":2,"title":"Remarks","slug":"remarks","at":593,"chars":375},{"level":2,"title":"Example","slug":"example","at":968,"chars":695},{"level":2,"title":"Related information","slug":"related-information","at":1663,"chars":144}],"text":"# DataTransfer.AddJoin(Integer, Integer) Method\n> Version: _Available or changed with runtime version 10.0._\nAdds a field pair to be used to create a join condition which determines which rows to transfer, optional for same table transfers.\n## Syntax\n```al\n DataTransfer.AddJoin(SourceField: Integer, DestinationField: Integer)\n```\n## Parameters\nDataTransfer\nType: datatransfer-data-type\nAn instance of the datatransfer-data-type data type.\nSourceField\nType: ../integer/integer-data-type\nThe source table field.\nDestinationField\nType: ../integer/integer-data-type\nThe destination table field.\n## Remarks\nThe DataTransfer object can only be used in upgrade code and it will throw an runtime error if used outside of upgrade codeunits.\nUse this method to create a join condition between tables when copying fields from one table to the other. See Transferring Data Bewteen Tables<../../devenv-data-transfer>.\nThis method isn't needed when copying within the same table.\n## Example\nIn this example, you have two tables, Source and Destination. You're planning on obsoleting field S3 in the Source table. But before you do, you want to copy some values of S3 into the field D3 of the Destination table. Specifically, you only want to copy field S3 in rows where field S2 is equal to A.\n```al\nlocal procedure CopyFields()\nvar\n    dt: DataTransfer;\n    dest: Record Destination;\n    src: Record Source;\nbegin\n    dt.SetTables(Database::Source, Database::Destination);\n    dt.AddFieldValue(src.FieldNo(\"S3\"), dest.FieldNo(\"D3\"));\n    dt.AddSourceFilter(src.FieldNo(\"S2\"), '=%1', 'A');\n    dt.AddJoin(src.FieldNo(\"PK\"), dest.FieldNo(\"PK\"));\n    dt.CopyFields();\nend;\n```\n## Related information\ndatatransfer-data-type\nGetting Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}