Skip to main content

Setup of DYCE Happy Texts

DYCE Happy Texts does not necessarily require any special setup. However, a default template (Cascading Style Sheet - CSS) for paragraph and character formats is part of the delivery. This provides the possibility to define the selectable formattings.
To change the contents of the default, it can be exported via the DYCE Happy Texts Setup page and imported again after the desired changes.

Automatic pre- and post-texts​

Pre- and post-texts can be inserted automatically in Sales documents. In the Sales & Receivables Setup, in the Text Templates fast tab, the fields Default Header Text Quote and Default Footer Text Quote or Default Header Text Order and Default Footer Text Order, specify the defaults for texts to be used. This facility is optional.
The text templates are transferred to the document as soon as the Contact or Document No. is filled in and the language code for the document is known. The contents of the text templates are determined on the basis of the language code and the validity date.

Allow HttpClient Requests​

The full functionality of DYCE Happy Texts is only ensured if HttpClient requests are permitted (see also here). The layout to be printed is transferred to a web service, which takes over the rendering and then returns it to Business Central. In the Extension Management, the Extension Settings of the app can be opened by clicking on the name of the app. Here Allow HttpClient Requests must be set to YES.

Error message when printing

The following error indicates that Allow HttpClient Requests for DYCE Happy Texts is not activated:
The request was blocked by the runtime to prevent accidental use of production services.

Handling layouts and hints to developers​

DYCE Happy Texts includes additional layouts (WORD and RDL) for the relevant standard reports from Business Central. These layouts are based on the standard layouts for the relevant reports. They can either be used out-of-the-box or are used to apply the relevant changes to the deployed (custom) layouts. For more information on layouts and notes for developers, please refer to this part of the DYCE documentation.

Rendering the report output

Rendering the output of the report layouts including content created via DYCE Happy Texts is done using an external function call.

Permissions​

Two permission sets are included with the app:

  • DYCEHAPPYTEXTSALL (DYCE Happy Texts All)
    This permission set can be assigned to all users. It contains read-only permissions to use the stylesheets (CSS).
  • DYCEHAPPYTEXTSADMIN (DYCE Happy Texts Admin)
    This permission set is designed for administrators and power users who should additionally be able to import and export stylesheets (CSS).

For more information on permission sets, see this part of the Microsoft documentation.