Advanced Extended Texts (beginning/ending/line texts) for sales, purchase and service documents.
Current Version: 21.2.1.0as of Business Central 21. AppSource Name: NCDT Document Text
Manual
Creation date: 2024/11/22 The current version of this manual can be found at:
☰ Contents
General
NCDT Document Text Welcome to NCDT Document Text - your solution for efficient management of additional texts in Microsoft Dynamics 365 Business Central! With NCDT Document Text, you can easily store and utilize supplementary texts for sales, purchase, and service documents in various areas...
Setup
Document Text Setup Before you can fully leverage the full range of capabilities of NCDT Document Text, it is crucial to set up the basic functionality...
Beginning and Ending Texts With NCDT Document Text, recurring texts can be configured and formatted in various areas of Microsoft Business Central to help you customize correspondence with your customers...
Line Texts Line texts are used in all areas of Business Central. For example, when you create an item, you can use it to provide more details about that item. When you create a line with this item in a document, the texts are then inserted as line texts...
Miscellaneous Texts Miscellaneous Texts are texts that are assigned to methods or terms, such as payment terms texts or delivery terms texts...
Extended Texts You can extend the description for items, inventory data, G/L accounts, and resources by adding additional lines as extended text. You can also set conditions for the use of the additional lines...
Report Layout Selection In the Report Layout Selection you can specify which layout should be used when printing a document...
Export/Import of Standard Text Codes The following page explains how to export/import previously configured standard text codes. The function is designed to help you move the settings you have already made from an old Business Central, to the system you are currently running...
Tasks
Working with Document Texts Basically, the NCDT Document Text extension is available on all pages where documents are sent to your customer or partner...
Working with Beginning and Ending Texts The NCDT Document Text extension can be used to configure and format recurring texts in various areas of Microsoft Business Central, helping you customize your correspondence with your customers...
Working with Line Texts The NCDT Document Text extension can be used to configure and format recurring texts in various areas of Microsoft Business Central, helping you customize your correspondence with your customers...
Working with Miscellaneous Texts Miscellaneous Texts are described as all texts except beginning and endinig texts and line texts. These texts can be found in terms and conditions, including payment terms, shipment methods, reminder terms, finance charge terms, service order types and service contract types...
Working with the Text Editor In NCDT Document Text the texts are captured and edited via an editor. This helps you to create texts directly with the correct paragraph formatting...
Working with Placeholder In the extension NCDT Document Text, placeholders enable dynamic and personalized design of your documents...
Appendix
NAVAX License Management The NAVAX License Management page (in older versions NAVAX License Overview or NCEX License Overview) displays the current license status of the NAVAX extensions...
Information for Developers NCDT Document Texts provides a set of standard documents that contain the Document Texts and can be used without customization. If this is not sufficient for your company or your documents need to be customized, you can also use NCDT Document Texts on your own documents...
Installation Notes
Release Notes
Docs / NCDT Document Text / General General
Welcome to NCDT Document Text - your solution for efficient management of additional texts in Microsoft Dynamics 365 Business Central! With NCDT Document Text, you can easily store and utilize supplementary texts for sales, purchase, and service documents in various areas.
By providing the ability to store texts in master data, we offer you a consistent wording and layout. NCDT Document Text includes pre- and post-texts (general or personalized for customers/vendors), payment term texts, delivery term texts, as well as texts for service order and service contract types. Additionally, you can add text blocks per item, resource, and general ledger account.
For all texts, advanced formatting features such as font color, font style, font size, and paragraph alignment are available to provide you with more flexibility in creating documents.
This extension also includes a set of advanced standard documents for Dynamics 365 Business Central, which includes the document texts. If these predefined documents do not meet your requirements, you can easily configure your own documents using Microsoft Word.
With NCDT Document Text, you can design your documents professionally and individually - streamline your workflows and increase your efficiency!
Navigation
NCDT Document Text is integrated into the existing sales, purchasing and service processes.
Sales, purchasing and service documents are therefore created, posted and printed as before.
Fields, actions, pages, and reports originating from the NCDT Document Text extension are identified by the abbreviation NCDT. This additional labeling makes them clearly distinguishable from other extensions (which may use similar names and designations).
NCDT stands for NAVAX Consulting Document Text.
The search terms "ncdt", "nvxdt" and "navax" are recognized by "Tell me what you want to do".
This allows very fast access to the individual sections of NCDT Document Text.
Permission Sets
The following permission sets are available for NCDT Document Text
Name
Description
NVXDT
NCDT Document Text
You need these permissions to use the NCDT Document Text.
For more information, see Tasks, Working with Document Texts.
NVXDT, SETUP
NCDT Document Text Setup
You need these permissions to set up the NCDT Document Text.
For more information, see Setup, Document Text Setup.
Docs / NCDT Document Text / Setup Document Text Setup
Before you can fully leverage the full range of capabilities of NCDT Document Text, it is crucial to set up the basic functionality.
The NCDT Document Text Setup page provides you with the opportunity to define the general settings and preferences to ensure that the application is tailored to your needs.
By precisely configuring the settings, NCDT Document Text enables you to efficiently manage and customize additional texts for sales, purchase, and service documents in Microsoft Dynamics 365 Business Central. This not only enhances flexibility and individuality but also improves productivity and professionalism in your business processes.
General, Fields
Document Texts Activated
Specifies whether the NCDT Document Text extension is activated and should automatically insert the configured document texts when a document is created. If this field is activated, the NCDT Document Text extension will handle the insertion of document texts. If it is deactivated, the standard feature for extended text in Business Central will be used instead.
Copy Document with Texts
Das Feld Belege mit Texten kopieren ermöglicht es Ihnen, Belege zusammen mit den zugehörigen Texten zu kopieren. Wenn diese Option aktiviert ist, werden alle Texte, die mit dem Originalbeleg verknüpft sind, ebenfalls in den kopierten Beleg übernommen. Dies ist besonders nützlich, wenn Sie komplexe oder umfangreiche Belege erstellen und sicherstellen möchten, dass alle relevanten Informationen und Anmerkungen auf den neuen Beleg übertragen werden. Durch diese Funktion sparen Sie Zeit und minimieren das Risiko von Informationsverlusten, während Sie gleichzeitig die Konsistenz und Genauigkeit Ihrer Dokumente sicherstellen.
Copy Documents with Texts
The Copy Documents with Texts field allows you to copy documents along with their associated texts. When this option is enabled, all texts linked to the original document will also be copied to the new document. This is particularly useful when creating complex or extensive documents and you want to ensure that all relevant information and annotations are transferred to the new document. This feature saves time and minimizes the risk of information loss while ensuring the consistency and accuracy of your documents.
Print Item Attribute
The field Print Item Attribute specifies whether existing item attribute texts should also be printed on documents. Item attributes allow the definition of various characteristics or properties for items, with the possibility of setting different translations for these attributes. If this option is enabled, the corresponding item attribute texts will be printed on the documents in the selected language. This allows you to present the detailed properties of an item in different languages directly on the documents, facilitating communication with customers, suppliers, or internal users and enhancing usability.
For more information, see Work with item attributes
Default Text Formatting, Fields
Textzeilen mit Vorgaben erstellen
Specifies whether to create text lines with the values from the Last Line or with the default values from the NCDT Document Text Setup, in the Default Text Formatting area.
Following options are available:
From Last Line - if the option is enabled, new text lines are created with the formatting of the previous line.
From Setup - new text lines are created with the formatting that has been defined in the NCDT Document Text Setup in the Default Text Formatting section.
Default Font Family
Specifies which Font Family to use as the default. Newly created lines will have this value configured automatically.
Default Font Size
Specifies which Font Size to use as the default. Newly created lines will have this value configured automatically.
Default Font Color
Specifies which Font Color to use as the default. Newly created lines will have this value configured automatically.
Default Paragraph
Specifies which Paragraph to use as the default. Newly created lines will have this value configured automatically.
Bold by default
Specifies whether newly created lines should get bold as default value.
Italic by default
Specifies whether newly created lines should get Italic as default value.
For more information on formatting options and default formatting, see: Setup, Extended Text in the section Formatting Texts.
Actions
Standard Text Codes
The action opens the Standard Text Codes page where you can define and set up general texts that can be used in different areas.
Payment Terms
Sets up the extended texts for payment terms that will be inserted on the payment terms for your customers.
Shipment Methods
Sets up the extended texts for shipment methods to be inserted on delivery bills for your customers.
Reminder Terms
Set up extended texts for reminder terms to be inserted on reminders.
Fin. Charge Terms
Set up extended texts for finance charge terms to be inserted on the documents in case of late payment by the customer."
Service Order Types
The extended texts for service order types are set up here, that can be inserted on service orders, service contracts or contract quotations.
Service Contract Group
The extended texts for service contract groups are set up here, that can be inserted on service orders, service contracts or contract quotations.
Standard Service Codes
The extended texts for standard service codes are set up here, that can be inserted on service orders, service contracts or contract quotations.
System, Actions
NAVAX License Management
Opens the NAVAX License Management which displays the current license status of the NAVAX extensions.
For more information, see Appendix, NAVAX License Management.
Docs / NCDT Document Text / Setup Beginning and Ending Texts
With NCDT Document Text, recurring texts can be configured and formatted in various areas of Microsoft Business Central to help you customize correspondence with your customers.
Standard texts can be defined as general beginning and ending texts. These texts will be used on all documents you have selected.
On the customer and vendor card, you can assign personalized beginning and ending texts.
Note
When a document is created and a text is set up for a customer/vendor, it is inserted after the general beginning and ending texts.
Tip
If you want to create e.g. salutations for a customer/vendor, it is recommended to use the field Sorting order to control the order on the document, the order is chronological from the lowest to the highest number. So if you give the general texts a higher sort order than the texts on the customer/vendor, the personalized texts will be placed before.
Standard Text Codes Fields
Doc. Beginning Text
Specifies that the text is an automatic beginning text.
Doc. Ending Text
Specifies that the text is an automatic ending text.
Extended Text Exists
Specifies that a extended text exists and has been configured.
Standard Text Codes Actions
Import
The import function allows you to import the standard text codes and their extended texts as well as all settings. This can be helpful if you have previously created texts in your sandbox or in another database and want to transfer them to the productive database.
Export
The export function allows you to export the standard text codes and their extended texts as well as all settings. This can be helpful if you want to transfer existing texts from your database to your sandbox or another database.
Customer/Vendor Fields
Beginning Text
Specifies the Standard Text Code of the extended text to be used as automatic Beginning Text for customers/vendors on documents.
Ending Text
Specifies the Standard Text Code of the extended text to be used as automatic Ending Text for customers/vendors on documents.
Important
If you create beginning- or ending texts for customers or vendors, you must not activate the Beginning Text and Ending Text fields on the Standard Text Codes page, otherwise they will be recognized as general beginning- or ending texts and thus inserted for all documents, regardless of the selected customer/vendor.
Reminder Terms Fields
Beginning Text
Specifies the Standard Text Code of the extended text to be used as the automatic beginning text of the Reminder Terms on documents.
Ending Text
Specifies the Standard Text Code of the extended text to be used as the automatic ending text of the Reminder Terms on documents.
Note
If you disable the NCDT Document Text extension by unchecking the Document Texts Activated field in the Document Text Setup, the Beginning and Ending Texts fields are no longer shown on the page. The default Microsoft 365 Business Central logic will then be taken and Beginning Text and Ending Text actions will be shown.
From that moment, texts from the Reminder Text table will be inserted in reminders.
Line texts are used in all areas of Business Central. For example, when you create an item, you can use it to provide more details about that item. When you create a line with this item in a document, the texts are then inserted as line texts.
Line Texts can be defined for the following tables:
G/L Account
Item
Item Attribute
Ressource
Service Item
Standard Service Code
Fields
The following NCDT Document Text fields have been added to the tables:
Textbaustein vorhanden
Shows whether an extended text exist.
Important
In order for the text to be automatically added when inserting document lines for the element, the Automatic Ext. Texts must be activated.
Fields
Print
Specifies that the attribute should be printed on documents.
Docs / NCDT Document Text / Setup Miscellaneous Texts
Miscellaneous Texts are texts that are assigned to methods or terms, such as payment terms texts or delivery terms texts.
These can be used, in order to make more detailed information available, for these terms for customers/suppliers.
With the NCDT Document Text extension, the Miscellaneous Texts can be configured and formatted to help you customize the correspondence with your customers.
Standard text codes can be stored in the following areas and pages:
Payment Terms
Shipment Methods
Finance Charge Terms
Service Order Types
Service Contract Groups
Fields
The following NCDT Document Text field has been added to these pages:
Standard Text Code
Specifies the standard text code to be used for the text suggestion on documents.
You can extend the description for items, inventory data, G/L accounts, and resources by adding additional lines as extended text. You can also set conditions for the use of the additional lines.
The following section explains the steps required to set up extended text.
Steps for creating extended texts
Open the page Standard Text Codes, you will find the page via Tell me what you want to do?
Click on New
In the Code field, enter a code for the standard text, e.g.: PAY
In the Description field, enter a meaningful description to identify the standard text, e.g.: Text for payment terms.
The Beginning Text or Ending Text fields define the position of the Extended Texts.
In the next step, the Ext. Text Exists field takes you to the overview of the Extended Text List, where the text lines are configured.
Click on New to create a new extended text or select an existing extended text. The Extended Text page opens.
The Language Code field can be used to control the language of the documents for which the extended text is to be applied.
Tip
If you leave this field empty, the extended text is applied to all languages, the All Language Codes field is activated.
In the field Description specify again a meaningful description.
The field Sorting Sequence No. is used to sort the extended text if there is more than one, here you can enter the sequence number.
The Starting Date and Ending Date fields are used to restrict the period in which the extended text is to be inserted on documents. In this way, texts can be set up on documents that are only to be inserted during the Christmas period or in offer periods, for example.
In the FastTab Lines the extended text lines can be entered and formatted.
For more information on formatting options, see the Formatting texts section below.
Fields
The Extended Text table has been extended with the following NCDT Document Text fields.
Table Name
Shows the referenced table name for which the extended text was created.
No.
Displays the text code you have previously assigned to the standard text.
Text No.
Shows the text number that has been automatically assigned by the system.
Sorting Sequence No.
Specifies the sort order for the extended text.
Sales Pro Forma Invoice
Specifies whether the extended text will be available on sales pro forma invoices.
Sales Draft Invoice
Specifies whether the extended text will be available on sales draft invoices.
Sales Shipment
Specifies whether the extended text will be available on purchase receipts.
Sales Return Receipt
Specifies whether the extended text will be available on sales return receipts.
Purchase Receipt
Specifies whether the extended text will be available on purchase receipts.
Purchase Return Shipment
Specifies whether the extended text will be available on purchase return shipments.
Service Contract
Specifies whether the extended text will be available on service contracts.
Service Contract Quote
Specifies whether the extended text will be available on service contract quotes.
Service Shipment
Specifies whether the extended text will be available on service shipments.
Job Quote
Specifies whether the extended text will be available on job quotes.
Tip
If you select or deselect multiple documents, you will be asked whether you want to select or deselect all documents. This is to help you to configure the desired documents faster.
Actions
Copy Extended Text
With this action you can copy the lines of an already existing extended text into the current text module.
Disable Sequel Fields
With this action you can disable all sequel fields.
Enable Sequel Fields
With this action you can enable all sequel fields.
Fields, Lines
Text
Specifies the text. The text can contain up to 2048 characters. Line breaks in the text are also possible. Click the field to edit the text.
Note
To enter the text lines, an editor is provided. This can take up a maximum of 2048 characters. You can use the editor to insert already predefined texts into the editor by copying them from an external program into the Text Editor.
For more information, see Tasks, Working with the Text Editor.
Bold
Specifies whether this line should be printed or viewed in bold.
Italic
Specifies whether this line should be printed or viewed in italics.
Color
Specifies in which color this line should be printed or viewed.
Paragraph
Specifies whether this line should be printed in justified.
Font Family
Specifies the font family for the text line.
Font Size
Specifies the font size in pt for the text line.
Formatting texts
The following formatting options are available for document text lines:
Format
Effect
Bold
Specifies whether this line should be printed or shown in bold.
The default value is No.
Italic
Specifies whether this line should be printed or shown in italics.
The default value is No.
Color
Specifies which color this line should be printed.
NCDT Document Text supports the following colors:
BlackRedBlueGreen
The default value is Black.
Paragraph
Specifies whether this line should be printed aligned.
The default value is Left.
Font Family
Specifies the font for the text line.
You can choose from the following fonts:
Segoe UIArialConsolasCourier NewLucida ConsoleTimes New RomanSegoe ScriptSegoe UI LightSegoe UI SemilightKunstler Script
The default value is Segoe UI.
Warning
The fonts depend on the fonts installed on the system, the available fonts are the standard Windows fonts!
Font Size
The lines are printed in the selected font size. Sizes from 5-24 pixel are available.
The default value is 9.
Padding Top/Bottom
Specifies whether the line should be expanded at the top or bottom; the value is specified in pt (points).
You can use these values to expand the lines upwards or downwards to create spacing between the lines.
The default value is 2.
Indentation
Specifies whether indentation should occur at the beginning of the line. The value is specified in pt (points).
The default value is 0.
Tip
You have the opportunity to configure default values for formatting in the NCDT Document Text Setup. If the From Setup option of the Create Text Lines with Defaults field is specified, the settings from the NCDT Document Text Setup will be used when creating new text lines.
By default, if the From last Line option is selected, the values from the last line will be used. If there is no line the values from setup are used.
Docs / NCDT Document Text / Setup Report Layout Selection
In the Report Layout Selection you can specify which layout should be used when printing a document.
In order for the NCDT document text data to be printed on the A4 documents, the appropriate NCDT-Berichtslayouts report layouts must be set up.
Currently RDLC und Word report layouts are supported.
Available NCDT Report Layouts
NCDT report layouts are available for the following documents.
Report ID
Report Name
Built-in NCDT Report Layout
117
Reminder
./NVXDTReminder.rdlc
118
Finance Charge Memo
./NVXDTFinanceChargeMemo.rdlc
210
Blanket Sales Order
./NVXDTBlanketSalesOrder
404
Purchase - Quote
./NVXDTPurchaseQuote.rdlc
405
Order
./NVXDTPurchaseOrder.rdlc
406
Purchase - Invoice
./NVXDTPurchaseInvoice.rdlc
407
Purchase - Credit Memo
./NVXDTPurchaseCreditMemo.rdlc
408
Purchase - Receipt
./NVXDTPurchaseReceipt.rdlc
410
Blanket Purchase Order
./NVXDTBlanketPurchaseOrder.rdlc
1302
Pro Forma Invoice
./NVXDTSalesProFormaInv.rdlc
1303
Draft Invoice
./NVXDTSalesDraftInvoice.rdlc
1304
Sales - Quote
./NVXDTSalesQuote.rdlc
1305
Sales - Confirmation
./NVXDTSalesOrderConfirmation.rdlc
1306
Sales - Invoice
./NVXDTSalesInvoice.rdlc
1307
Sales - Credit Memo
./NVXDTSalesCreditMemo.rdlc
1308
Sales - Shipment
./NVXDTSalesShipment.rdlc
1309
Return Receipt
./NVXDTSalesReturnRcpt.rdlc
5900
Service Order
./NVXDTServiceOrder.rdlc
5902
Service Quote
./NVXDTServiceQuote.rdlc
5911
Service - Invoice
./NVXDTServiceInvoice.rdlc
5912
Service - Credit Memo
./NVXDTServiceCrMemo.rdlc
5913
Service - Shipment
./NVXDTServiceShipment.rdlc
5936
Service Item Worksheet
./NVXDTServiceItemWorksheet.rdlc
5970
Service Contract
./NVXDTServiceContract.rdlc
5971
Service Contract - Detail
./NVXDTServContractDetail.rdlc
5972
Service Contract Quote
./NVXDTServContractQuote.rdlc
5973
Service Contract Quote-Detail
./NVXDTServContQuoteDetail.rdlc
6631
Return Order Confirmation
./NVXDTSalesReturnOrderConfirmation.rdlc
6636
Purchase - Return Shipment
./NVXDTPurchaseReturnShipment.rdlc
6641
Return Order
./NVXDTReturnOrder.rdlc
Tip
Use the search term 117|118|210|404|405|406|407|408|410|1302|1303|1304|1305|1306|1307|1308|1309|5900|5902|5911|5912|5913|5936|5970|5971|5972|5973|6631|6636|6641 to filter all documents supported by the NCDT document text.
Docs / NCDT Document Text / Setup Export/Import of Standard Text Codes
The following page explains how to export/import previously configured standard text codes. The function is designed to help you move the settings you have already made from an old Business Central, to the system you are currently running.
Steps to Export Existing Standard Text Codes
.
Open the Standard Text Codes page, you can use the Tell me what you want to do? function for this.
In the page that will open you can find the overview of the existing standard text codes, click on Actions > Export.
Next, Export collects all Standard Text Codes and their Extended Texts and creates an XML file that will be downloaded to your system.
.
After that, open your Download folder to find the file.
Steps to Import Previously Exported Standard Text Codes
.
Open the Standard Text Codes page, you can use the Tell me what you want to do? to do this.
In the page that opens you will find the overview of the existing standard text codes, click on Actions > Import.
Next, select the file you want to import and click click here to browse to browse.
Note
Alternatively, you can drag and drop the file into the window. To do this, just drag the file into the blue frame.
.
The file will be imported.
Next, a window appears where you can decide how to proceed with the imported records.
The following options are available:
Create only new records.
This option creates only new records.
Create new records & overwrite existing records
Overwrites or updates the existing records.
Create new records & update existing records (keep settings).
If this option is selected, the settings (e.g. pre-text, post-text, language, line formatting, etc.) for the individual records will not be lost by the update.
When you confirm with OK the import will start with the selected options.
Important
When importing, the delivery reminder field is not taken into account. Text modules that are to be inserted in delivery reminders and were previously activated must be activated manually.
Docs / NCDT Document Text / Tasks Working with Document Texts
Basically, the NCDT Document Text extension is available on all pages where documents are sent to your customer or partner.
After the extension setup is completed, Document Texts created and the extension reports are set up, you can start working with Document Texts.
If you have not set up any texts yet, you can find the guide on the Setup, Document Texts page.
Use automatic Document Texts
With NCDT Document Text you can define texts that are automatically added to selected documents. In the following you will find a step by step guide, based on a sales order, about the procedure to use these automatic Document Text.
After completing the setups and having already created Texts, you can now work with the Document Texts.
For more information, see Setup, Document Text Setup.
Open the Sales Orders page, you will get to the page via Tell me what you want to do? or directly from the Business Central start page if you have assigned the Sales Order Processing role.
Click New to create a new sales order. The Sales Order page opens.
Click in the field Customer Name, the AssistEdit feature list all your customers.
In the list of customers, select the customer for which you want to create the sales order.
If you enter the Customer name and move to another field, the Beginning- and Ending Text fields will be updated. Both fields now show the value Yes, this means that the configured Document Text has been taken and added to the document.
With the AssistEdit feature, you can open the NCDT Document Text Lines page where the text lines are listed, if you want to customize the texts, you can do that in this page.
Create Document Text manually or change them
If you do not want to use the automatic text feature or if you want to change the automatic text, you can do it from the Document Text Lines page. In the following you will find a step by step guide how it works.
Let's suppose that there is a sales order in which no automatic texts have been added, but you want to add a ending text:
Open the Sales Orders page, you can get to the page via How do you want to proceed? or directly from the Business Central home page if you have assigned the Sales Order Processing role.
Click New to create a new sales order. The Sales Order page opens.
Click in the field Customer Name, the AssistEdit feature list all your customers.
In the list of customers, select the customer for which you want to create the sales order.
Via the drill down of the field Ending Text or via the action Ending Text you will get to the page NCDT Document Text Lines.
Now you can start to enter the lines and format them. Click in the field Text in the FastTab Lines the Text Editor will open.
For more information, see Setup, Extended Texts - Formatting texts.
Tip
With the action Insert Placeholder you have the possibility to insert a document field with its value, in the page that is opened, e.g. a direct salutation can be set by entering "Dear Mr. ##Bill-to Contact##," in the document text line. When you print the document, "Dear Mr. Izaak Schröder," will appear.
With the fields Sales Quote, Sales Order, Sales Shipment, Sales Invoice, Sales Proforma Invoice and Sales Draft Invoice you control on which documents the entered text should be added. For example, if you have selected the Sales Invoice field and posted the document using the Post action, you will find the configured text on the Posted Invoice.
When you copy documents, depending on the setup, a window is shown in which you are asked whether and which texts should be copied with the document.
Depending on the setup, the texts are copied automatically, on request or not in the newly created documents. For more information, see Setup, Document Text Setup.
To copy a sales document, proceed as follows:
Open the Sales Orders page, you can get to the page via How do you want to proceed? or directly from the Business Central home page if you have assigned the Sales Order Processing role.
Click New to create a new sales order. The Sales Order page opens.
Click in the field Customer Name, the AssistEdit feature list all your customers.
In the list of customers, select the customer for which you want to create the sales order.
Click on the Copy Document action in the Prepare menu. The Copy Sales Document page opens.
Select the Document Type and the Document No. to be copied. The grayed out fields are filled with the information of the document to be copied and are used for verification.
With the fields Including Header and Recalculate Lines you determine which information should be copied into the new document. Click OK.
If you have set the value On Request in the Copy Documents with Texts field in NCDT Document Text Setup, the prompt Do you want to paste the Document Texts into the copied document? appears. In this window, select the texts to be copied, you can either copy only the beginning or ending texts, only the line texts or both into the new document.
The window closes, you see again the Sales Document with the information of the selected document including the Document Texts.
Docs / NCDT Document Text / Tasks Working with Beginning and Ending Texts
The NCDT Document Text extension can be used to configure and format recurring texts in various areas of Microsoft Business Central, helping you customize your correspondence with your customers.
Beginning and Ending Texts help you to improve the correspondence with your customers or partners, making the documents more personal and professional than the Microsoft Business Central standard provides.
If you have not set up any texts yet, you can find the guide on the Setup, Beginning- and Ending Texts page.
Using the Beginning and Ending Texts, adding on documents
The beginning- and ending texts that have been set up can now be used, depending on which documents you have selected in the FastTabs Sales, Purchase or Service, the texts are automatically inserted when creating the documents. The following section explains the necessary steps, using a sales order as an example, to create documents with the texts.
Open the Sales Order page
Fill in the fields in the sales order header as required
As soon as you leave the field Customer Name, the predefined texts (beginning- and ending texts, payment terms texts, shipping method texts and so on...) will be inserted on the document.
Change or manually add Beginning and Ending Texts
The NCDT Document Text Lines page shows the text lines of the respective document.
You can edit the lines on this page, add new ones or delete lines that are not required.
Via the action Insert text modules you can insert already existing text modules.
Some formatting options for the document text lines are also available.
For more information, see Setup, Extended Texts - Formatting texts.
Text Determination and Sequence
Text Determination
Configured texts are found and inserted on the documents based on the following criterias: first, available texts are searched for based on the document type and the text type (Beginning-/Ending-Text). If any are found, the text lines are constrained based on the language code.
Example:
The text "Dear Customer, thank you for your Order." with the option All languages = yes is created as a Beginning Text, thus ensuring that documents without a stored language code, get this Beginning Text added.
In addition, the text "Dear customer, thank you for your order." with the language code DEA is created, this is automatically added to documents with this language code.
For example, if they create a document for a french customer or a customer without a language code, the beginning text will be added with the option All languages = yes. The texts are now in English.
If you create a document for a customer from Austria the beginning text will be added with the language code DEA.
Text Sorting
It is possible to store texts for debtors. If this is the case and texts are defined as Beginning Texts, these "personal" texts will be added by the customer, after the Beginning Texts, if the sorting sequence no. is not used. With the sorting sequence no. this behaviour can be changed, assign a lower sorting sequence to the texts which are to be put in front.
Example:
Customer 10000 Adatum Corporation has the beginning text "Dear ##Bill-to Name##," (a placeholder is used here For more information, see Tasks, Working with Placeholders.), with the sorting sequence no. 1, stored.
In addition, a beginning text has been created for all sales orders with the text "Thank you for your confidence, we confirm the placed order as follows." with the sorting sequence no. 10.
When a document is now created, the document header will display:
Dear Adatum Corporation,
Thank you for your confidence, we confirm the placed order as follows.
Docs / NCDT Document Text / Tasks Working with Line Texts
The NCDT Document Text extension can be used to configure and format recurring texts in various areas of Microsoft Business Central, helping you customize your correspondence with your customers.
This help page explains the necessary steps for setting up texts for an item using an example.
In case you haven't set up any texts yet, you can find the corresponding instructions at
Setup, Line Texts help page.
Steps for using line texts using the example of a Sales Order
Open the Sales Orderpage.
Fill in the fields in the Sales Header as required.
Create a line with an item on which you have placed an Extended Text.
Note
The field Automatic Ext. Texts indicates that a text module is stored and automatically inserted into the selected documents.
Once you leave the No. field, the line texts are inserted on the document.
Change or manually adding line texts
The NCDT Document Text Lines page shows the text lines of the respective document.
You can access this page by clicking on the Line Texts action or by using the DrillDown function of the Line Texts field.
You can edit the lines on this page, add new ones or delete lines that are not required. Via the action Line Texts you can insert already existing extended texts. Some formatting options for the document text lines are also available.
For more information, see Setup, Extended Texts - Formatting texts.
Actions
Insert Extended Text
This action can be used to select standard texts and insert them into the lines.
Docs / NCDT Document Text / Tasks Working with Miscellaneous Texts
Miscellaneous Texts are described as all texts except beginning and endinig texts and line texts. These texts can be found in terms and conditions, including payment terms, shipment methods, reminder terms, finance charge terms, service order types and service contract types.
If you have not set up any texts yet, you can find the guide on the Setup, Miscellaneous Texts page.
Use of Miscellaneous Texts, adding to Documents
The set up Miscellaneous Texts can now be used, depending on which documents you have selected in the FastTabs Sales, Purchase or Service, the texts are automatically inserted when creating the documents. The following section explains the necessary steps, taking a sales order as an example, to create documents with texts.
Open the Sales Order page
Fill in the fields in the sales order header as required
As soon as you leave the field, the defined texts (beginning- and ending texts, payment terms texts, shipping method texts) will be inserted on the document.
Change or manually add Miscellaneous Texts
The NCDT Document Text Lines page shows the text lines of the respective document. You can edit the lines on this page, add new ones or delete lines that are not required. Via the action Insert text modules you can insert already existing text modules. Some formatting options for the document text lines are also available.
For more information, see Setup, Extended Texts - Formatting texts.
Docs / NCDT Document Text / Tasks Working with the Text Editor
In NCDT Document Text the texts are captured and edited via an editor. This helps you to create texts directly with the correct paragraph formatting.
It is also possible to insert already predefined texts, e.g. created in Microsoft Word, into the Text Editor.
Note
If the page from which the Text Editor is called is not editable or in edit mode, the text in the editor is also not editable.
Using Placeholders
Placeholders must be used so you can use fields from the respective document when creating the texts. These can be inserted by using the action Insert Placeholder. This opens an overview of the available fields of the document. By clicking on the field, a placeholder is inserted in the Text Editor:
If the Text Editor is opened from the extended text setup, a selection window will first appear where you can select the desired document type:
For more information, see Tasks, Working with Placeholders.
Docs / NCDT Document Text / Tasks Working with placeholder
In the extension NCDT Document Text, placeholders enable dynamic and personalized design of your documents.
These placeholders act as variable text that is automatically replaced with specific information from your business data. For example, you can use placeholders to insert the customer's name, date, invoice number, or other relevant data. This allows you to create customized documents that are tailored to your requirements and the needs of your customers. With this flexible feature, you save time and minimize potential errors while maximizing the professionalism of your business correspondence.
Using the placeholders
.
The following section explains the steps, using a sales order as an example, to create documents with beginning texts and a personal salutation.
Open a sales order for the customer 10000 - Adatum Corporation.
Click in the Beginning Text - current/following document field and open the list of text lines configured for the document.
If you do not find any texts in the document yet, read the topic Tasks, Working with Beginning and Ending Texts.
In the overview of text lines (this applies to all text types), first klick in a new line (the Text Editor opens) and write the text "Dear ".
Click on the action Insert Placeholder.
The list of Available fields of the document opens.
Select the desired field whose value you want to use in the text line from the list - for example: Bill-to Name. The text line will then display ##Bill-to Name##.
Add a comma to the line.
Close the page with OK.
After that, when you print a document and preview it, the pre-text "Dear Adatum Corporation," appears.
Tip
If you do not see the Beginning Text on the document, it is possible that the wrong report is set up in the Report Selection - Sales. However, if this is the case the wrong layout is probably set, instructions on how to fix this can be found at Setup, Report Layout Selection.
Docs / NCDT Document Text / Appendix NAVAX License Management
The NAVAX License Management page (in older versions "NAVAX License Overview" or "NCEX License Overview") displays the current license status of the NAVAX extensions.
Fields
Name
Specifies the name of the Extension.
License Status
Specifies the current license status of the Extension.
Serial No.
Specifies the serial number of the Extension.
Version
Specifies the currently installed version of the Extension.
Trial Version
A NAVAX extension can be tested or used free of charge for 30 days after installation. After that, the extension can only be used with a valid license.
Request License
The license can be requested or checked via the Current Status action. This opens a window.
The following example shows the NAVAX extension Excel Report Builder.
Fill in the fields in the window and then click Send License Request.
Please note that the licensing process may take some time.
In the next few days you will receive an email with further information.
Note
For licensing, calling the online help and performing some actions, access to https://www.navax.app must be granted.
Public IP from www.navax.app for setting firewall access: 94.136.22.236, Port: TCP/443
Checking the connection to https://www.navax.app using PS: Test-NetConnection navax.app -port 443 (PS must be performed with the M-Tier service user)
CRL Servers In addition, the following CRL Servers must also be accessible for the certificate check: https://certificates.godaddy.com/* http://crl.godaddy.com/* or their IP: 192.124.249.36
Activate/Update License
As soon as the licensing has been completed, you will receive an email and the license can be activated via the Update License action.
The license is company independent. So it does not matter in which company the action is called.
Note
The licence must be updated once a year via the Update License action.
The update is only possible or necessary within the last 30 days before the license expires, or afterwards. Within the last 30 days before the license expires, notes are displayed.
If the Automatic License Renewal is enabled, the Update License action is called automatically before the license expires. Note that the setting is only active after the license has been activated via the action.
This action can be used to open the Microsoft AppSource ratings page for the extension.
We would be very happy if you submit your rating and let us know about your experience with the Extension.
Docs / NCDT Document Text / Appendix Information for Developers
NCDT Document Texts provides a set of standard documents that contain the Document Texts and can be used without customization. If this is not sufficient for your company or your documents need to be customized, you can also use NCDT Document Texts on your own documents.
In the following section you will find the required modifications to add the NCDT Document Text to your documents.
Customize individual reports to use NCDT Document Text
NVXDT Report Management
To customize your documents to use the NCDT Document Text the codeunit NVXDT Report Management is important. With the function GetReportText the texts can be HTML formatted or integrated as normal text. This allows you to create the documents either in Word format or as RDLC Report.
GetReportText
procedure GetReportText(RecordVariant: Variant; NVXDTTextType: Enum "NVXDT Text Type"; AsHTML: Boolean): Text
Parameters
RecordVariant
Here the record for which the texts are to be inserted is passed as a Variant.
This can be e.g.: a Sales Header, Purchase Header or also Sales Line or Purchase Line.
Important
It is important to make sure that the correct filters are set on the RecordVariant.
NVXDTTextType
The parameter specifies what kind of text lines should be inserted.
Ex: Beginning Text, Ending Text, Line Text, Payment Terms Text etc....
AsHTML
Specifies whether a text should be returned html formatted, this is used in RDL(C) reports, or as normal text, this is used e.g. in Word reports.
Important
If the text has to be implemented as HTML text in your report, a placeholder with the option HTML - interpret HTML tags as styles must be activated in the RDL(C) layout.
Implementation
To use Document Texts on a report, columns must be added to the report dataset with the return value of the GetReportText function.
Here is an example using the report Order as it is integrated in NCDT Document Text:
The following Granules are required for an On-Premises installation:
70714775 NCDT Document Text by NAVAX
1010860 Extension Base by NAVAX
External Addresses
https://www.navax.app
For licensing, calling the online help and performing some actions, access to https://www.navax.app must be granted.
Public IP from www.navax.app for setting firewall access: 94.136.22.236, Port: TCP/443
Checking the connection to https://www.navax.app using PS: Test-NetConnection navax.app -port 443 (PS must be performed with the M-Tier service user)
CRL Servers In addition, the following CRL Servers must also be accessible for the certificate check: https://certificates.godaddy.com/* http://crl.godaddy.com/* or their IP: 192.124.249.36
Docs / NCDT Document Text / Appendix Release Notes
Would you like to know what has changed in the extension? Below you'll find an overview of the new features and changes made in the updates.
Version 21.2.1.0
as of Business Central 21 2024/08/30
Improvements
New feature padding top/bottom added.
With these new formatting options, you can expand the lines upwards or downwards to create spacing between the lines.
Setup, Extended Texts
New feature indentation added.
This new formatting option can be used to implement an indent at the beginning of the line.
Setup, Extended Texts
Modifications
The summaries in the report layouts have been set.
Renamed Job to Project according new Business Central name convention.
Corrections
Correction of the event subscribers triggering the appending of document lines to prevent errors when adding new document lines.
When creating a sales order or a sales invoice, texts that were intended for the proforma invoice or the invoice draft (sales invoice) were not appended. This made it impossible to print these documents with the corresponding text lines.
Version 21.2.0.3
as of Business Central 21 2024/08/01
Improvements
The Shipment Method Text has been added on the Service Order page.
New functions Disable sequel fields and Enable sequel fields to simultaneously enable/disable the document sequel fields in the Extended Texts.
Modifications
The logo of the extension has been changed.
Corrections
When posting a warehouse shipment with option delivery or delivery and invoicing out of a service order, the error message 'Service Shipment Line' does not exist. Identifying fields and values: Document no.='xxxxxx',Line no.='xxxxxx'
As a result of an error message, it was not possible to create a service order or a service invoice directly from the customer card or customer list.
The document sequel fields for the line texts of the service item lines were not shown or filled correctly.
The payment terms text was not automatically pulled in service documents.
Version 21.2.0.2
as of Business Central 21 2024/07/05
Corrections
Error when posting a service order when using the Ship or Invoice options.
In the Service Contract Quotes and Service Contracts, the field Service Contract Group Text was not included, so it could not be used when creating custom layouts.
Changes for developers resp. the extensibility of the app.
Corrections
When a proforma invoice was printed from a sales order, the texts that were set up for printing on a proforma invoice did not appear.
When creating a project planning line (job planning lines) by directly clicking into the No. field, an error message occurred because the line number had not yet been assigned.
The functionality added in Business Central 24 to retrieve project planning lines (job planning lines) in the lines of a sales invoice caused an error and project planning lines could not be retrieved.
In service contracts or service contract quotes, it was not possible to use service contract group texts.
Report layout for the Pro Forma Invoice corrected. The line texts were positioned incorrectly.
The document sequel fields were not set correctly when a sales order was created from a sales quote.
Version 21.2.0.0
as of Business Central 21 2024/04/11
Note
This version is also available as a downgrade version for Business Central 20.
Improvements
New feature added to job planning lines that allows users to create and edit texts at the line level. With this feature, users can now add specific information and instructions directly to individual lines in the job planning lines to improve task organization and management. Additionally, automatic texts can be pulled from items, resources, and general ledger accounts to provide additional contextualization.
Corrections
When printing a Service Invoice, no texts were printed in the layout.
When printing the Service Delivery Note, a rendering error occurred.
When printing document lines with items, some attributes were displayed multiple times if an article had multiple attributes but not all were enabled for printing.
Version 21.1.7.0
as of Business Central 21 2024/02/28
Improvements
The Line Text field has been added to the Service Quote Lines page. Previously, texts were added but were not customizable, or no texts could be added manually.
The events for inserting the Extended Texts on the service side have been improved, previously these events were executed several times which could lead to errors. This also had an impact on performance.
The IsHandled pattern has been implemented in some functions in the NVXDT Document Text Mgt. codeunit for developers of customers or partners.
All Extended Text List have now been added to the text module overview. These are hidden by default, but can be added as required via Personalize.
The action Copy from Extended Text on the Extended Text page caused an error if the data record has not yet been initialized. The action is now greyed out as long as the data record has not yet been initialized and all required fields have a value.
Modifications
On the Service Lines and Service Quote Lines pages, the Line Texts action has been moved to the Related > Line menu.
On the Extended Text page, the tooltip of the Sales Shipment document option field has been corrected.
Incorrect tooltips on the Job Card page corrected.
When creating a service line in the service order page, the following error message appeared: 'Line no.' must contain a value in 'Service line': 'Document type=Order, document no.=X, line no.=0'. It cannot be zero or empty.
In the help, the hyperlink has been corrected so that you can now access the corresponding help page in the individual documents (from Business Central).
When changing the document options on the Extended Text page, the Service Quote option was ignored when changing multiple options.
Version 21.1.6.1
as of Business Central 21 2023/10/30
Modifications
The action Copy from Extended Text on the Extended Text page has been improved.
Corrections
Extended texts set up with the combination All languages and Language code = "empty" were not inserted correctly in the documents.
When creating Extended Texts, the prompt whether all documents in the group should be changed appeared incorrectly several times when selecting the documents.
When manually created Document Texts were added to a document, in certain constellations there was a prompt several times asking whether the existing Document Texts should be kept or newly created.
Version 21.1.6.0
as of Business Central 21 2023/09/21
Important
For On-Premises an update of the License or the following granules is required:
70714775 NCDT Document Text by NAVAX
Improvements
New import/export function added. It is now possible to export/import the already configured standard text codes and text modules using XML.
For more information, see Export/Import of Standard Text Codes.
The Placeholder selection no longer displays obsolete table fields. Previously, these fields were displayed and caused an error when selected.
On the NCDT Field List page, the link to the online help was incorrect, this has been corrected.
For Sales Orders, the sequel fields were calculated incorrectly, the Sales Shipment value was not considered.
With Business Central version 22 the direct call of the page Extended Texts has been enabled. If you have created an Extended Text via this page, it was inserted incorrectly in some constellations.
If a Start & End Date was assigned to a document text, it happened that this was not drawn correctly.
Version 21.1.5.0
as of Business Central 21 2023/03/17
Improvements
New feature, Default Formattings for newly created text lines. New fields have been added to NCDT Document Text Setup, these fields are used to configure default formatting for newly created text lines.
For more information, see Setup, Document Text Setup.
The document text lines for reminders added with version 21.1.3.0 have been redesigned. The texts in the Reminder Levels did not make sense and have now been moved to the Reminder Terms. Reminder Text lines were reset again as they were no longer configurable.
Note
The settings for Beginning and Ending Texts in the Reminder Level table are deleted during the update. An assignment to the reminder terms is not possible because there are several reminder levels per reminder terms and therefore not clearly assignable.
Errors in the layouts of the reports: NCDT Reminder, NCDT Sales Invoice, NCDT Draft Invoice, NCDT Proforma Invoice and NCDT Sales Credit Memo have been fixed.
Version 21.1.4.0
as of Business Central 21 2023/01/25
Improvements
Events have been added on top level to override the functionality of NCDT Document Text to implement custom filters and settings. The following events have been added to all relevant documents.
The frequency of the license check for NCDT Document Texts has been optimized. Previously, this was performed excessively often and this impacted performance.
When creating an extended text on the Standard Text Codes page, the value of the Extended Text Exists field was not updated after leaving the Extended Text List page.
In the codeunits NVXDT Document Text Mgt. and NVXDT Copy Document Management the access level was changed from Internal to Public. The reason for this change is that the events in the code unit were not visible when these events are to be implemented in customer projects.
In the document text line archive the document sequel fields where not set correctly. The error has been fixed.
In the purchase quote document, the shipment term was not shown correctly. As a result, the shipment term text was placed in the middle of the document without any reference to the shipment term.
The functions Make Order and Make Invoice in a Sales Quote have not applied the formatting of the document text lines.
Version 21.1.3.1
as of Business Central 21 2022/12/23
Corrections
When using the Copy Document function the document sequel fields where not set correctly. The error has been fixed.
When Canceling, Correcting Posted Sales Invoices, the error: 'Sales header' does not exist. Identified fields and values: Document type = 'Quote', No. = '**' occurred. The reason for the error was a faulty event subscriber.
In archived documents, the document sequel fields were not set correctly.
Version 21.1.3.0
as of Business Central 21 2022/12/20
Business Central Update
Improvements
Actions has been improved. The action groups newly introduced with Business Central, Document Texts have been integrated in the current version of NCDT and the actions has been improved.
The language control in NCDT did not work correctly. Texts set up for All Languages were only used if the language code was empty. Texts set up for All Languages are now also used regardless of the language code.
Modifications
Projects have been extended so that Beginning and Ending Texts can also be assigned per project.
NCDT Document Texts are now available for reminders. Beginning and Ending Texts can be set up for each reminder level.
Corrections
When deleting a purchase document, the following error occurred: 'Purchase Header' does not exist. Identifying fields and values: Document type='_1',No.='xxxx'. Error has been corrected.
Version 20.1.2.2
as of Business Central 20 2022/07/20
Corrections
When deleting a purchase document, the following error occurred: 'Purchase header' does not exist. Identifying fields and values: Document Type='_1',No.='xxxx'. Error has been fixed.
The action Copy Document and Get Posted Document Lines to reverse did not copy all document text lines when creating a credit memo for a posted invoice.
A menu with Category8 was shown in the Purchase Order Archives, this has been removed.
The action Beginning Text and Ending Text on Customer and Vendor Cards respectively brought the error "Table * not defined.", the error has been fixed.
The printout of Pro-Forma Invoices and the Draft Invoice did not print the correct Document Text, the error has been fixed now.
Version 20.1.2.1
as of Business Central 20 2022/06/21
Corrections
An error in the Extended Text Lines has been fixed. If text was entered via the new text editor, then the text (max. 100 characters) was not transferred to the standard text field, thus the field was invalidated and could no longer be used.
The insertion of a placeholder did not work properly when lines were created from defined tables. For example, if the extended text page was opened on the item page and you then wanted to create a placeholder, a prompt to select the document type appeared before the field was selected.
Unnecessary action "Insert Placeholder" has been removed from the Extended Text Lines page. The action has been moved to the Text Editor page.
If there was no value for a placeholder when creating a document, then the placeholder was deleted. This caused that this value was not printed as expected when printing the document.
Version 20.1.2.0
as of Business Central 20 2022/06/07
Business Central Update
Improvements
To make it easier to create/edit text lines, a Text Editor has been implemented. It is now possible to paste (copy) already predefined texts into the Text Editor.
The character length of text lines has been increased to 2048.
Events provided to extend functionality.
Corrections
Fixed an error when manually creating text lines in Posted Purchase Receipts.
An error when manually creating text lines in Posted Return Shipments has been fixed.
Version 19.1.1.2
as of Business Central 19 2022/03/24
Improvements
Reports enhancement - function improved and layouts redesigned.
Placeholders are already converted when the document text lines are created. Therefore, the values are visible on the documents instead of the placeholders.
Modifications
Orders from Dynamics 365 CRM are now provided with Document Text, analogous to the process of creating them in Dynamics 365 Business Central.
Corrections
Errors getting Document Texts in some documents fixed.
Improved calculation of the "Current/Following Documents" indicator.
Version 19.1.1.0
as of Business Central 19 2022/02/04
Corrections
Error in sales return orders when loading lines via the " Get Posted Document Lines to Reverse" function has been fixed. The error message for this was: "The record already exists in the Line Buffer table. Identified fields and values: Old Line No.='0'".
Filtering for sales invoice drafts has been corrected. In the document text lines overview, texts were shown and also printed that were not actually configured for an invoice draft.
Error in the Sales Shipment report has been fixed.
Improvements
Tooltips have been optimized for better understanding.
The indication of the Beginning and Ending Texts in the documents was improved so that it is now easier to see whether there are texts for the selected document and/or for subsequent documents.