{"title":"Report.WordLayout(Integer, InStream) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/report/report-wordlayout-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/report/report-wordlayout-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/report/report-wordlayout-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":"Gets the Word report layout that is used on a report and returns it as a data stream.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"Report.WordLayout(Integer, InStream) Method","slug":"reportwordlayoutinteger-instream-method","at":0,"chars":2758},{"level":2,"title":"Syntax","slug":"syntax","at":411,"chars":85},{"level":2,"title":"Parameters","slug":"parameters","at":496,"chars":236},{"level":2,"title":"Return Value","slug":"return-value","at":732,"chars":238},{"level":2,"title":"Remarks","slug":"remarks","at":970,"chars":359},{"level":2,"title":"Example","slug":"example","at":1329,"chars":1295},{"level":2,"title":"Related information","slug":"related-information","at":2624,"chars":134}],"text":"# Report.WordLayout(Integer, InStream) Method\n> Version: _Available or changed with runtime version 1.0 until version 14.0 where it was deprecated for the following reason: \"Replace with layout selection and 'Report Layout List' lookup. See https://go.microsoft.com/fwlink/?linkid=2284102&clcid=0x409 for more information.\"_\nGets the Word report layout that is used on a report and returns it as a data stream.\n## Syntax\n```al\n[Ok := ]  Report.WordLayout(Number: Integer, InStream: InStream)\n```\n## Parameters\nNumber\nType: ../integer/integer-data-type\nThe ID of the report object for which you want to get the Word report layout.\nInStream\nType: ../instream/instream-data-type\nThe variable in which to return the Word report layout.\n## Return Value\n*[Optional] Ok*\nType: ../boolean/boolean-data-type\ntrue if the operation was successful; otherwise false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.\n## Remarks\nUsing the return value is optional. When you use the return value, if the Word report layout can't be retrieved at runtime, then the system returns false and no error is recorded. When you omit the return value, if the Word report layout can't be retrieved at runtime, then an error occurs, which states that the Word report couldn't be retrieved.\n## Example\nThe Report.WordLayout method will throw a runtime error if the operation fails, either if no object exists with that object ID or if no Word layout exists for that report. This code example shows how to write robust AL code to handle possible failures.\n```al\nvar\n    layoutAsStream: InStream;\n    result: Boolean;\nbegin\n    result := Report.WordLayout(ObjectId, layoutAsStream);\n    if result then\n        // use the layout that now is available in the stream\n    else\n        // handle that no object exists with that id or that no Excel layout exists for that report\n    ;\nend;\n```\nIf the report is known when you write the code, the safest way to avoid runtime errors is to use the scope (::) operator to reference the report object. This way you'll get a compile time error if the report doesn't exist. The example illustrates how to call WordLayout on the report MyReport using this technique:\n```al\nvar\n    layoutAsStream: InStream;\n    result: Boolean;\nbegin\n    // if MyReport does not exist, then Report::MyReport will fail at compile time\n    result := Report.WordLayout(Report::MyReport, layoutAsStream);\n\n    if result then\n        // use the layout that now is available in the stream\n    else\n        // handle that no Excel layout exists for that report\n    ;\nend;\n```\n## Related information\nreport-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}