Business central - Customizing/changing a word-layout

(5) Share

Report

Posted on by Joey Portier

113

Hi all,

Hope you can assist me in the following topic. So we have a word-layout for a label that we want to print from warehouse receipts/posted warehouse receipts. I would like to customize this label (Change fonts/ move words or codes). Everytime I want to import,update or validate a layout I get the error message below. I attached our item number and our xml file.

If requesting support, please provide the following details to help troubleshooting:

Error message:
Errors were detected in the Word layout:

/NavWordReportXmlPart/Warehouse_Receipt_Header/WarehouseReceiptLine/QRCode specifies a path that is not valid. Required elements or sections of the XML schema may be missing.

/NavWordReportXmlPart/Item_Label_Data/receiptDate specifies a path that is not valid. Required elements or sections of the XML schema may be missing.

Internal session ID:
5ad6276a-a8a7-4688-8b48-5db84dfec534

Application Insights session ID:
3d857feb-7b32-436b-8086-3fe3419ab543

Client activity id:
365f863d-b659-4c8e-bd63-db9b44ed8812

Time stamp on error:
2025-07-02T11:59:09.2018625Z

User telemetry id:
acd429df-72ec-4aaa-b25e-d02a7a3fe033

AL call stack:
"Report Layouts Impl."(CodeUnit 9660).EditReportLayout line 61 - Base Application by Microsoft version 26.1.33404.35312
"Report Layouts"(Page 9660)."EditLayout - OnAction"(Trigger) line 6 - Base Application by Microsoft version 26.1.33404.35312

Default (4).xml

SLEItemLabel (4)....

Categories:

Dynamics 365 Business Central

Microsoft Dynamics NAV

I have the same question (0)

All responses (5)

Answers (1)

Suggested answer

Montassar Krichi 231 on at

Like (2)

Report
Copy link

Link copied!
Hi,

The error messages point to invalid XPath expressions in your Word layout:
/NavWordReportXmlPart/Warehouse_Receipt_Header/WarehouseReceiptLine/QRCode
/NavWordReportXmlPart/Item_Label_Data/receiptDate

This typically happens when:

The XML part used by the layout does not include those nodes (QRCode, receiptDate, etc.).

The report definition (RDLC/AL code) does not expose the expected fields or dataset structure.

The Word layout is referencing sections that do not exist in the current XML being generated by the report.

First , Preview the Report Dataset (XML)
To confirm what’s actually available:

Go to the Report Layout Selection page in Business Central.

Find the report ID used for your label (e.g., Warehouse Receipt).

Use "Print to PDF" or "Download XML" option to inspect the dataset.

Open the XML in a viewer or VS Code to confirm the paths:
Look for:

/Warehouse_Receipt_Header/WarehouseReceiptLine
/Item_Label_Data
Check if:

<QRCode> exists under WarehouseReceiptLine

<receiptDate> exists under Item_Label_Data

If either is missing, the Word layout will break when trying to bind them.

Second, Fix the Word Layout

Open your current .docx layout in Word.

Go to Developer > XML Mapping Pane

Use the correct XML part (NavWordReportXmlPart) on the right.

Expand nodes to find your intended fields.

If you don’t see QRCode or receiptDate, then:

Don’t bind to them, or

Add them in the AL report definition (next step).

Third, Update the Report Dataset (AL code, if needed)
If you're customizing this report via AL:

Edit the dataset definition in AL to include:

column(QRCode; YourQRCodeField) { }
column(receiptDate; YourReceiptDateField) { }

Rebuild and publish the extension.

Then re-export the dataset XML to confirm the fields now appear.

Finaly, Validate Layout Again

Once the layout matches the actual dataset:

Re-import it into BC via Report Layouts page.

Click Validate Layout – error should be gone.

You can now adjust fonts, positions, etc.

If you find this helpful, please mark it as verified :)

Was this reply helpful? Yes No
Suggested answer

Kamal Khakhkhar 2,915 on at

Like (2)

Report
Copy link

Link copied!

Hii There as per requirement if you were updating in Base report You need to Update the layout again every time you applied any changes , as it will need to get updated changes containing layout only else it will give error,

If You found answer mark It answered.

Thank You,

Kamal Khakhkhar

Was this reply helpful? Yes No
Verified answer

Jeffrey Bulanadi 9,112 Super User 2026 Season 1 on at

Like (2)

Report
Copy link

Link copied!
Hi Joey

The error you're seeing usually means the Word layout is referencing XML paths that don’t exist in the dataset generated by the report. In this case, it’s looking for QRCode under WarehouseReceiptLine and receiptDate under Item_Label_Data but those elements might not be part of the actual XML output

Here’s what you can do to troubleshoot

Run the report and export the dataset as XML

Open the XML in a viewer or editor and check if those paths exist

If they’re missing, you’ll need to either update the report’s AL code to include those fields or remove the references from the Word layout

Also, make sure the layout is based on the correct report object. If the layout was built for a different version or modified report, the dataset structure might not match

This guide walks through how to preview and validate the dataset https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-reports-troubleshooting

If this helped, feel free to mark it as the suggested or verified answer

Cheers
Jeffrey

Was this reply helpful? Yes No
Suggested answer

YUN ZHU 99,084 Super User 2026 Season 1 on at

Like (2)

Report
Copy link

Link copied!

Hi, hope the following can give you some hints.

Dynamics 365 Business Central: Why are custom columns/fields added via Report Extension not found in standard layouts exported from Report Layouts page?

https://yzhums.com/58299/

Thanks.

ZHU

Was this reply helpful? Yes No
Gerardo Rentería Ga... 25,555 Most Valuable Professional on at

Like (3)

Report
Copy link

Link copied!

Hi, good day

The error appears to be related to a reference error in fields that do not exist in the report dataset, so you should review the XML Mapping.

How to Add Fields to a Word Report Layout - Business Central | Microsoft Learn

Business Central 2025 wave 1 (BC26): Validate report layouts for errors as an admin (Check report layout without running) | Dynamics 365 Lab

Best Regards
Gerardo

Was this reply helpful? Yes No