Toursys DocuBuilder Manual V.9.0.1

This documentation will explain step by step how to use the Toursys Documentation Generator. After this documentation, you will be able to create your own reports to print or send to your clients and suppliers. 

Requirements 

1. Access to a document editor such as Word or Google Documents

2. Access to the Toursys Document Generator module, located on the main Dashboard 

Generate the document template 

What are Toursys Custom Labels and how to use them?

1. • • Toursys Custom Labels will help you gather your information from the Toursys platform to be able to use in reports. Think of it as a placeholder, where it will change with when the report is being created. 

     • The Toursys Custom Labels are available for you to search and use in the Toursys Document Generator module, on a page called: Toursys Custom Data Fields

The following section will explain all the different ways a label can be used. 

Label Categories: 

• Text Label

Format: {text}

Description: This label is used to insert plain text into the document.

Example: 

{quotation_name}

2. List and Conditional Label

• Format: {#lists} ... {/lists}

• Description: This label can be used to create iterations or conditional sections within the document.

  • List: Repeats the content within the labels for each item in the specified collection.

  • Conditional: If the label in the JSON is empty, the section between the labels is not added to the document.

Example: 

{#service_list}

{supplier_code}   

 {service_name}   

 {quotation_line_date}

 {quotation_line_end_date}

{/service_list}

This will generate as many rows as there are items in the service list of the itinerary, each service will print with the information requested. In this example, it would print a list of all the services of the itinerary, each with a supplier code, service name, start date and end date.

3. Mathematical Operations Label

• Format: {$ a + b}

• Description: Performs the specified mathematical operation (+, -, *, /) on the given attributes.

• Formatting Decimals: you can specify the formar of the decimals and separators 

  • Format: {$ attribute1 + attribute2 | format:numberOfDecimals:thousandsSeparator:decimalSeparator}

Example:  

{$ attribute1 + attribute2 | format:2:,:.}

If attribute1 is 10.2 and attribute2 is 5000, the result would be: 5,010.20

4. Image Label

• Format: {%image}

• Description: Embeds an image into the document.

• Extra options:

  • Specifying size (width and height in pixels)

  • Specifying maximum size (max width and max height)

  • If no size is specified, it will get the image original size. 

Example: 

Basic embedding:

{%image1}

Specifying size (width and height):

{%image2 | size:250:100}

Specifying maximum size (max width and max height):

{%image3 | maxSize:300:500}

You can see and download the following Toursys Document Template we have as an example: