{"title":"XMLport object","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-xmlport-object/","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/devenv-xmlport-object, 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/devenv-xmlport-object","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":"XMLport objects are used to export and import data between an external source and Business Central.","date":"2024-11-13","meta":{"topic":"article"},"outline":[{"level":2,"title":"XMLport example","slug":"xmlport-example","at":708,"chars":4377},{"level":2,"title":"Related information","slug":"related-information","at":5085,"chars":248}],"text":"XMLports are used to export and import data between an external source and Dynamics 365 Business Central. Sharing data between different computer systems is seamless when it's shared in an XML format. Working with XML files can be tedious so the details of how the XML file is handled are encapsulated in XMLports.\nTo use an XMLport to import or export data, you first create an XMLport object. Once created, you can run the XMLport from a page or codeunit object.\nYou can design XMLports to include a request page, which is a dialog box that enables the user to set a filter on the data, sort the data, or choose whether to export or import the data. Learn more about request pages in devenv-request-pages.\n## XMLport example\nThe following example shows a page extension of the Permission Sets page that adds an action to the specified page calling the XMLport ExportPermissionSet. The XMLport exports the permission set data to an XML file.\n```al\npageextension 50111 PermissionSetExporter extends \"Permission Sets\"\n{\n    actions\n    {\n        addafter(Permissions)\n        {\n            action(ExportPermissionSet)\n            {\n                Promoted = true;\n                PromotedCategory = New;\n                trigger OnAction();\n                begin\n                    Xmlport.Run(50112, false, false);\n                end;\n            }\n        }\n    }\n}\n\nxmlport 50112 ExportPermissionSet\n{\n    Format = xml;\n\n    schema\n    {\n        textelement(PermissionSets)\n        {\n            tableElement(PSet; \"Aggregate Permission Set\")\n            {\n                SourceTableView = WHERE (\"App Name\" = FILTER (<> ''));\n                XmlName = 'PermissionSet';\n                fieldattribute(RoleID; pset.\"Role ID\") { }\n                fieldattribute(RoleName; pset.Name) { }\n                tableelement(P; \"Tenant Permission\")\n                {\n                    XmlName = 'Permission';\n                    LinkTable = pset;\n                    LinkFields = \"Role ID\" = FIELD (\"Role ID\");\n\n                    textelement(ObjectType)\n                    {\n                        trigger onbeforePassvariable();\n                        var\n                            int: Integer;\n                        begin\n                            int := p.\"Object Type\";\n                            ObjectType := format(int);\n                        end;\n                    }\n                    textelement(ObjectID)\n                    {\n                        trigger onbeforePassvariable();\n                        var\n                            int: Integer;\n                        begin\n                            int := p.\"Object ID\";\n                            ObjectID := format(int);\n                        end;\n                    }\n                    textelement(ReadPermission)\n                    {\n                        trigger onbeforePassvariable();\n                        var\n                            int: Integer;\n                        begin\n                            int := p.\"Read Permission\";\n                            ReadPermission := format(int);\n                        end;\n                    }\n                    textelement(InsertPermission)\n                    {\n                        trigger onbeforePassvariable();\n                        var\n                            int: Integer;\n                        begin\n                            int := p.\"Insert Permission\";\n                            InsertPermission := format(int);\n                        end;\n                    }\n                    textelement(ModifyPermission)\n                    {\n                        trigger onbeforePassvariable();\n                        var\n                            int: Integer;\n                        begin\n                            int := p.\"Modify Permission\";\n                            ModifyPermission := format(int);\n                        end;\n                    }\n                    textelement(DeletePermission)\n                    {\n                        trigger onbeforePassvariable();\n                        var\n                            int: Integer;\n                        begin\n                            int := p.\"Delete Permission\";\n                            DeletePermission := format(int);\n                        end;\n                    }\n                    textelement(ExecutePermission)\n                    {\n                        trigger onbeforePassvariable();\n                        var\n                            int: Integer;\n                        begin\n                            int := p.\"Execute Permission\";\n                            ExecutePermission := format(int);\n                        end;\n                    }\n                    textelement(SecurityFilter)\n                    {\n                        trigger onbeforePassvariable();\n                        begin\n                            SecurityFilter := format(p.\"Security Filter\");\n                        end;\n                    }\n                }\n            }\n        }\n    }\n}\n```\n## Related information\nDeveloping extensions<devenv-dev-overview>\nAL development environment<devenv-reference-overview>\ndevenv-xmlport-overview\ndevenv-using-namespaces-with-xmlports\nPage extension object<devenv-page-ext-object>\ndevenv-report-object"}