Skip to main content

Supported layouts

The output (print) of content created via DYCE Happy Texts can be done either via WORD layout or via RDL layout. Therefore, the app comes with two additional layouts for each of the following reports. These can be identified by the extension name DYCE Happy Texts.

  • Sales - Quote (1304)
  • Sales - Confirmation (1305)
  • Sales - Invoice (1306)
  • Sales - Credit Memo (1307)

For more information on handling layouts, see this part of the Microsoft documentation.

Notes about layouts​

The additional layouts are based on the standard layouts for the respective reports and are only extended to handle content created via DYCE Happy Texts. Although it is possible to use them out-of-the-box, it is usually the case that users use customized layouts. This is the real purpose of the additional layouts. It is very easy to identify the enhancements compared to the standard layouts and to transfer them to the customized layouts. For more details on this, please refer to the next section and also the Microsoft documentation.

Notes for developers​

This section targets developers who want to transfer the extensions of the standard layouts, which were created using DYCE Happy Texts as an example, to customized layouts.

Example: create new sales quote layout​

A report extension for the standard sales quote in the DYCE Happy Texts app has been extended with fields used to display HTML content, thus preparing the dataset for the integration of HTML content in a customized layout. This example describes how to use the standard RDL and Word layout for Sales Quotes and extend it with header texts, footer texts and extended description for the Sales Quote line.

RDL Layout​

  • The standard RDL layout named "StandardSalesQuote.rdlc" can be copied from the base app and used as a basis for an extension or an already customized layout can be used.
  • Optional: The file extension can be changed to *.rdl in order to support editing with Microsoft Report Builder.
  • The integrated layout from the app DYCE Happy Texts should be downloaded as a model for changes to be made in newly created layout.
    • To do this, open the Report Layouts page in Business Central.
    • Find the report with ID 1304.
    • Locate the report layout for report 1304 named "./RDLCLayouts/DYCEHTSalesQuote.rdl".
    • The layout can be exported using the respective action.
  • Both the newly created layout and the layout integrated in the app DYCE Happy Texts should be opened using Microsoft Report Builder or Visual Studio.
  • Copy the tablix control named "DYCEHtmlForRdlHeader_Table" from the layout used in the app DYCE Happy Texts and paste it in the newly created layout before the tablix for displaying the lines.
  • Copy the tablix control named "DYCEHtmlForRdlFooter_Table" from the layout used in the app DYCE Happy Texts and paste it in the newly created layout at the end of the document.
  • Locate the the last two lines from the tablix named "LinesTable" in the layout used in the app DYCE Happy Texts and replicate the changes made for those two lines in newly created layout.
  • The newly created layout can either be integrated into the application that contains the customizations or imported from the Customer Report Layouts page within Business Central.

WORD Layout​

  • The standard Word layout named "StandardSalesQuote.docx" can be copied from the base app and used as a basis for an extension or an already customized layout can be used.
  • The integrated layout from the app DYCE Happy Texts should be downloaded as a model for changes to be made in newly created layout.
    • To do this, open the Report Layouts page in Business Central.
    • Find the report with ID 1304.
    • Locate the report layout for report 1304 named "./WordLayouts/DYCEHTSalesQuote.docx".
    • The layout can be exported using the action.
  • Both the newly created layout and the layout integrated in the app DYCE Happy Texts should be opened using Microsoft Word.
  • In the newly created layout add a new content control named "DYCEHtmlForWord_Header_Placeholder" before the Table used for displaying the lines analog to the the layout used in the app DYCE Happy Texts.
  • In the newly created layout add a new content control named "DYCEHtmlForWord_Header_Placeholder" at the end of the document analog to the the layout used in the app DYCE Happy Texts.
  • Locate the the nested repeater content control named "DYCEHtmlForWord_Line_Placeholder" in the layout used in the app DYCE Happy Texts and replicate the changes made for this line in newly created layout.
  • The newly created layout can either be integrated into the application that contains the customizations or imported from the Customer Report Layouts page within Business Central.