You can automatically generate documents such as quotes or proposals right from within servis.ai using Document Templates. You can personalize the format and style of these templates to fit your brand.  

User Permissions: Only Administrators and App Admins can create new Document Templates. 

FAQs

What is a Document Template?

A document template is a preformatted document used to generate various types of documents in servis.ai such as quotes and orders. 

What is an App field?

An App field is a specific piece of information or data that is collected, stored, and managed in a servis.ai App record.

What is a Line?

A line contains the details of individual products or services, including specific attributes related to those items such as price and quantity.

Can I use information from a line in a Document Template?

Yes. See Pulling Information from a Line.

Can I use dot.walking in a Document Template?

Yes, but the format is slightly different.

Instead of writing it as Account.Contact, you should write it as:

AccountContact

Docmosis Documentation

If you haven’t used Docmosis before, we would recommend reviewing the Docmosis Cloud Template Guide. Cloud (DWS3) – Template Guide and here.

Creating a DOCX Template

The first step in creating a Document Template for servis.ai is creating a DOCX version in Microsoft Word or LibreOffice Writer. This version should include all the style and brand elements you want in the Document Template as well as all the information you want the document to contain.

DOCX Template Example: Sales Quote- Header

Let’s take a look at an example. We will make a Sales Quote DOCX template, starting with the Header. 

As you can see, we have added our logo and address to the top left corner of the template Header. We have also chosen our preferred fonts and colors. 

On the right-hand side, we have named the template (Sales Quote) and designated a place to display the Sales Quote ID# and Issued Date.

Next, we need to identify our placeholder elements.

Placeholder Elements

While some of the information in a Document Template will remain consistent from document to document, most of the information will need to be updated based on the specific details of each individual document.

For example, in our Sales Quote template Header, the Koda Company logo, address elements, and the document name will all remain the same from quote to quote. 

The Sales Quote ID# and the Issued Date elements, however, will need to be updated each time a new Sales Quote is created. Elements that need to be updated like this are called placeholder elements. 

Here we have outlined the placeholder elements in green.

Next, we need to replace those placeholder elements with Tags.

Tags

Tags designate an existing field within a servis.ai App. Information from the designated field will be used to populate the placeholder element that contains the Tag. 

Copy in CamelCase

The Copy in CamelCase feature lets you easily copy a field name in the correct format to your clipboard. This ensures it’s ready to be used in document tags without any manual formatting.

Tags are formatted as follows: <<fieldname>>. For example, a Tag for the Account field in the Quotes App would look like this: <<account>>. 

For fields that have multiple words, the first word is spelled out in lowercase letters, and the next word begins with a capital. There are no spaces between the words. For example, a Tag for the Contact Name field in the Quotes App would look like this: <<contactName>>.

Here’s what our Sales Quote template example looks like with the Tags entered. You can see we replaced the placeholder elements we identified with Tags that correspond to the fields in our servis.ai Quotes App that contain the information we want to populate those placeholder elements with.

Note: The name of available fields will vary based on your servis.ai configuration.

Adding your Logo 

DOCX Template Example: Sales Quote- Body

Let’s move on to the body of our Sales Quote template. First, when designing the body of a Document Template, it is best to create separate tables that contain similar types of information.

For example, all of the account-specific information for our Sales Quote template could be contained in a single table that includes the account name, address, primary contact, and the primary contact’s phone number and email. 

In this example we have included a “Prepared By” section as well. Deciding what information you want in a template, as well as how to organize it, is not a science and will require you to play around a little bit to find the right fit for you and your brand. 

Next, we identify our placeholder items and then replace them with Tags.

Pulling Information from a Line

If you need a Document Template to pull information from a Line, rather than a field, you can do so. 

First, we recommend that each Line have its own table. This allows you to create rows in the table with commands that tell servis.ai to pull the information from a Line in the App and not a field in the App. Those commands are:

1. <<rr_appLines>> This command tells servis.ai that the information that comes after this row is to be pulled from a Line in an App, not a field. 
2. <<er_appLines>> This command tells servis.ai to stop pulling information from that Line.

These rows act as a closed loop that allows you to select several elements from a Line to be displayed together. 

Copy in CamelCase

The Copy in CamelCase feature lets you easily copy a Line name in the correct format to your clipboard. This ensures it’s ready to be used in the corresponding table without any manual formatting.

Note: Replace “app” in the command with the name of the App you are using for your Document Template. 

Let’s take a look at an example from our Sales Quote template.

As you can see, we have created a new table in our DOCX document for the Line. We started by creating a header row that indicates what information from the Line each column will hold (product info, List Price, Discount, etc.). 

Next, we created a row for our first command and replaced the word “app” with “quote” because we want to pull information from a Line in the Quotes App. The command now looks like this: <<rr_quoteLines>>.

After that, we created a row for the placeholder elements in each column that we will replace with Tags and outlined those placeholder elements in green.

Lastly, we created a row for our second command (<<er_quoteLines>>). 

Now we can replace our placeholder elements with Tags.

Upload a DOCX Template to servis.ai

From the Navigation Menu, go to Settings > Advanced > Document Templates and click the Add Document Template button.

This will pull up the Add Document Template window. From here, you can name the template, select what App to associate the template with, and upload the DOCX template file.

Special Formats

Dates/Time/Numbers

You can specify a different format in the bold section to print your preferred date and time.

Referencing Different Field Types

Some Field types in servis.ai require different tags to produce results in your template.

Configure Custom Code for Document Generation

Servis.ai supports document generation in the following formats: PDF, DOC, HTML, RTF, TXT, and ODT.  These formats are controlled by API parameters and will require some simple coding to set up generation within your App Action.  

To learn more about API, click here.  For more information on setting up App Actions, click here.  The following is a sample of the custom code required to configure your document generation preferences.  

(async function(record, context){
try{
const entity = await context.clientAPI.getEntityIdFromName({entity_name:'leads'}); 
const response = await context.clientAPI.getPdfByTemplate({
fa_entity_id: entity.data.getEntityIdFromName.fa_entity_id, 
instance_id: record.id, 
template_id: 'DOC100001',
output_format: 'pdf',
show_activity: true,
output_file_name: 'Output File Name'
})
if (response.error) {
await context.clientAPI.showErrorMessage(response.error);
} else {
const url = response.data.getPdfByTemplate.attachment_url; 
window.open(url, '_blank');
await context.clientAPI.showSuccessMessage("Generate Document Successfully!"); 
}
} catch(e){
await context.clientAPI.showErrorMessage(e);
}
}(record, context));

Refer to the table below to customize the code to your desired result.  There are five parameters you will need to configure manually.

Using Related Lists

What Are Related Lists?

• Print a table of all line items on a quote or invoice
• List every issue or task associated with a project
• Include all notes, emails, or activities tied to a contact
• Display product details from a connected inventory App

How to Set Up a Related List in Your Template

Step 1 – Open Your Document Template

1. Go to Settings > Advanced > Document Templates.
2. Click on the template you want ot edit, or click “Add New” to create one.
3. In the template form, you’ll see fields for Name, App (the App this template is associated with), Template File (your .docx file), and a field called IncludeRelated List.

Step 2 – Select the Related List

Step 3 – Design Your Word Template

<<fieldName>>

Quotation #: <<id>>

Step 4 – Build the Repeating Table

1. Create a table in Word with a header row and one data row.
2. In the first cell of the data row, place the <<rr_listName>> tag.
3. In the last cell of the data row (or in a final row below), place the <<er_listName>> tag,

Example – A Quote with Line Items:

Step 5 – Upload and Test

1. Save your .docx file and upload it to the Document Template record in servis.ai.
2. Make sure the “App” field and the “Related List” field are correctly set.
3. Open a record in the associated App and use the template to generate a document (typically through an App Action button).
4. Check the generated PDF or Word file to confirm that the related records appear correctly.

How to Find the Correct Placeholder Names

1. Open the related App (for example, “Quote Lines”) and look at the field labels visible in the record form or list view.
2. Convert each label to camelCase. This means:
   • Capitalize the first letter of each word except the first word.
   • Remove all spaces and special characters.
   • Example: “Unit Price” → “unitPrice”, “Net Amount” → “netAmount”.

Example: Project Report with Issues

Template Configuration

• App: Projects
• Related List: Issues (selected from the dropdown)
• Template File: your .docx file

Parent Record Fields (Projects)

Related Record Fields (Issues) – used inside the repeating section:

Your Word Template Table

Filtering Records with Conditional Tags

Conditional Start Tag

<<cr_{condition}>> 

Conditional End Tag

<<er_>> 

Examples of Conditions

Related Lists Naming Convention

The Rule

<<rr_issues_Related>>  ...  <<er_issues_Related>> 

<<rr_quoteLines_Related>>  ...  <<er_quoteLines_Related>> 

Tag Reference for Related Lists

Supported Fonts

Available Fonts on Docmosis Cloud (DWS3)

Sans-Serif Fonts

Serif Fonts

Monospace Fonts

Script & Handwriting Fonts

Decorative & Dispplay Fonts

CJK Fonts

Other Fonts

Troubleshooting

If you have followed this tutorial, but nothing happens when you click on the PDF icon to download, then most likely there is something missing in your template. Some of the most common mistakes are:

1. The file is missing some characters; it could be an initial < or a closing > or other characters like apostrophes (‘ or ‘) or curly brackets ({ or }).
2. There is a tag <<field>> that either doesn’t exist in your App or in the lines of your App or is not following the naming convention fieldName.

If you have reviewed your template but are still having issues downloading your PDF, email the template to support@servis.ai or share it through the Support Portal!