Reports

The four standard rental reports (Quote, Order, Shipment, Invoice), their layouts (RDLC and Word), email body templates, and the Report Selections page that ties each report to its rental document type.


How it fits in

Essential Rental ships with four standard rental reports, each producing a printable customer-facing document for one stage of the document flow. The Print and Email actions on rental documents (Print Quote / Print Order / Print Shipment Manifest, Email Order Confirmation, etc.) all run against these reports.

Which report runs for which rental document type is configured on the Report Selections - Rental page (accessible from the Rental Setup ribbon). You can assign more than one report per usage if you want a sequence to run, swap in a customised report you've built, and choose which report drives the email body separately from which report becomes the email attachment.

The four standard reports

All four ship with both an RDLC layout (the BC-native report layout format) and a Word DOCX layout (a Word-based alternative). Each also has a corresponding email body template (a DOCX layout designed for the message body when emailing the document, distinct from the attachment).

Standard Reports
Standard Rental Quote
The customer-facing quote document. Run from the Print or Email actions on a Rental Quote, or via Report Selections when the Quote usage is invoked.
Standard Rental Order
The Order Confirmation document. Run from the Order Confirmation / Email Order Confirmation actions on a Rental Order, or via Report Selections when the Order usage is invoked.
Standard Rental Shipment
The Shipment Manifest. Run from Print Shipment Manifest on a Posted Shipment Order, from Post and Print on an open Shipment Order, or via Report Selections when the Shipment usage is invoked.
Standard Rental Invoice
The Sales Invoice with rental-specific fields surfaced. Run via the standard BC Sales Invoice print/email actions; the rental fields (Rental From / To, Rental Quantity, Price Term Code, Rental Periods) appear on each line so the customer can see the period breakdown.
There is no out-of-box Standard Rental Return report shipped, although the Report Selections usage enum includes a Rental Return value for a custom return document. The Print Return Confirmation action on a Posted Return Order runs whatever report you've assigned to the Rental Return usage on Report Selections; assign your own custom report there, or leave it unassigned if you don't need a printed return document.

Line pricing schedule on the Quote and Order

Where a rental line carries duration tiers, multi-rate date windows, or a minimum billing period, the Standard Rental Quote and Standard Rental Order print a small per-line pricing schedule under the line, so the customer can see why the line's price varies over the hire. Lines without any of these print exactly as before.

The schedule shows up to three blocks, each only when the line has it:

The pricing schedule is laid out on the Word (DOCX) layouts of the Quote and Order only. The RDLC layouts carry the same data but do not render the schedule, so it does not appear when you print the RDLC layout. Set the Quote and Order to their Word layout (see below) to show it.

Layout formats: RDLC vs DOCX

Each report ships with two layout files in the Report Documents folder:

RDLC (Report Definition Language Client-side): the native BC report layout format. Edit in SQL Server Report Builder or Visual Studio's RDL designer. Produces precise pixel-level control over the printed output. The default layout for most installations.

DOCX (Word): a Word document used as a templated layout. Edit in Microsoft Word using the BC report layout add-in. Easier for non-developer customisation; layout changes happen in familiar Word controls (paragraph styles, tables, images, branding) without RDL knowledge.

Switch between layouts per report on the Report Layouts page (BC standard) or by setting the layout on each Report Selections row.

Email body templates

When a rental document is emailed (Email Order Confirmation, Email Quote, etc.), the email message itself is composed from a template. The four shipped templates are DOCX files in Report Documents:

StandardRentalQuoteEmailBody.docx, StandardRentalOrderEmailBody.docx, StandardRentalShipmentEmailBody.docx, StandardRentalInvoiceEmailBody.docx.

These are the message bodies; the attached document (the report itself) is what the customer downloads. Set on Report Selections per usage via the Email Body Layout fields.

The Report Selections - Rental page

Open from Rental Setup via the Report Selection - Rental action. The page is a worksheet keyed by the rental usage (Quote / Order / Shipment / Return / Invoice); selecting a usage at the top filters the lines below to show the assigned report sequence for that usage.

Report Selections - Rental
Usage
The rental document type the lines below apply to. One of: Rental Quote, Rental Order, Rental Shipment, Rental Return, Rental Invoice. Switching the Usage at the top filters the lines.
Sequence
Order in which reports run when more than one is assigned to a single usage. Lower numbers first.
Report ID
The BC Report object ID. Pick from the standard rental reports or any custom report built for this usage. The report's caption shows alongside.
Report Caption
Auto-populated display name of the report selected by Report ID.
Use for Email Body
When ticked, this report's layout drives the email message body text when the document is emailed.
Use for Email Attachment
When ticked, this report's output is attached to the email as a PDF (or other format per layout).
Email Body Layout Code, Email Body Layout Description, Email Body Layout Name, Email Body Layout Publisher
Identifiers for the chosen email-body layout (the DOCX template that becomes the message body). Picked from the BC Report Layouts list filtered to the report.
Report Layout Name, Report Layout Caption, Report Layout Publisher
Identifiers for the chosen report-output layout (RDLC or DOCX). Picked from the Report Layouts list filtered to the report.

Walkthrough: swapping the standard report for a customised one

A common operational need: replace the shipped Standard Rental Order report with a customised version branded for your operation.

1
Build (or import) the custom report

Develop the custom AL Report object in your customisation extension, or import an existing one from a partner. Compile and publish so the report appears in the BC Report list with its own Report ID.

2
Open Report Selections - Rental

From Rental Setup, run the Report Selection - Rental action. At the top of the page, set Usage to Rental Order to filter the lines below to that usage's assignments.

3
Replace the Report ID

On the existing Sequence 1 line, change Report ID from the standard H2B Rental Order to your custom report's ID. Report Caption updates to match. If you want both reports to run (e.g. yours first, then the standard as a backup), add a new line at Sequence 2 instead of replacing.

4
Configure email body and attachment if needed

If the custom report should also drive the email body or attachment when emailing Order Confirmations, tick Use for Email Body and Use for Email Attachment on its line. Set the Email Body Layout fields if you have a separate DOCX template for the message body.

5
Test from a Rental Order

Open any Rental Order and run the Order Confirmation print or email action. The custom report runs in place of the standard one. Repeat for Email Order Confirmation if you adjusted the email-body assignments.

Related pages