Creating custom questions in the Document Editor – Xemplo Help

When required, you can add custom questions to the Document Editor. Creating a new custom question in the Document Editor allows a Company Administrator to add values to letters, documents and contracts that must be completed by a user when creating a document that includes this field.

Custom questions can be added for Contracts, Documents or Letters. When a custom question is added to the Document Editor from any of these locations, it will be available to all other locations - e.g., when a custom merge field is added via the Contract Editor, it will be available to use when creating Letter templates, and vice versa.

To use a custom question, you must add it to a document template. When a custom question is added to a document template, any user creating a document from this template will be prompted to provide an answer to the custom question which will be populated to the document.

To create and use a custom question, you must:

Create a custom question in the library
Add the custom question merge field to a document template.

Creating a custom question

To create a custom question, select the Show merge field questions option on the left-hand side of the Document Editor screen:
The custom questions library will display. You can add a new question to the library using the
+ Add custom question option at the bottom of the screen:
Add the details for your custom question - this will determine how your new custom question will be displayed in the Document Editor, and what a user will be asked when this merge field is added to a document:
1. Step Title - the title of the page upon which this custom question will appear when a user creates a document from a template containing this question.
2. Step instructions - when populated, this is the description that will display to a user when they are asked to populate this field when creating a new document from a template containing this question.
3. Question/s - multiple question fields can be added to a single custom question using the 'Add item' button at the bottom of each question section. For each question:
  1. Question Text - the name of the custom question as displayed in the questions library, and in the list of merge field in the Document Editor.
  2. Instructions - guidance text for the user completing the merge field to understand the required information.
  3. Merge Field Name - the name of the merge field displayed in the Document Editor library, and on the screen when the user completes the merge field in a document.
  4. Condition (advanced) - see Conditional Syntax section.
  5. Type (text) - the type of input field presented to the user when they respond to the question. When dropdown is selected, you must provide the values that users can select from when answering this question.

Once you have completed question configuration, select Save to add your question to the library. Once added, the merge field related to this question will be displayed in the Document Editor in the Questions section.

Screenshot 2024-01-11 at 6.50.57 pm.png

Conditional Syntax for custom questions

Using the Condition (Advanced) field in a custom question, you can show or hide questions shown when creating a document based on responses to earlier custom questions in the document.

The Condition (Advanced) field supports the following Comparison (Relational) Operators:

Condition	Example
Equal to (`==`): Checks if two values are equal	In this example, we are creating an additional question that must be completed if the subject of a document was born overseas. We have created a custom question called 'WorkerBornOverseas'. Using the response to this question, we can optionally display an additional question by adding this conditional formula to the additional question: `Contract.WorkerBornOverseas == 'Yes'` This will show the field if the answer to the previous 'WorkerBornOverseas' question is 'Yes'. If the answer is anything other than 'Yes', the additional question on which this condition is placed will not show.
Not equal to (`!=` ) Checks if two values are not equal.	In this example, we are creating an additional question that must be completed if the subject of a document was not born overseas. We have created a custom question called 'WorkerBornOverseas'. Using the response to this question, we can optionally display an additional question by adding this conditional formula to the additional question: `Contract.WorkerBornOverseas != 'Yes'` This will show the field if the answer to the previous 'WorkerBornOverseas' question is any value other than 'Yes'. If the answer is 'Yes', the additional question on which this condition is placed will not show.
Greater than (`>`): Checks if the value on the left is greater than the value on the right.	In this example, we are creating an additional question that must be completed if the salary of a worker is over a specified threshold. We have created a custom question called 'NewSalaryAmount'. Using the response to this question, we can optionally display an additional question by adding this conditional formula to the additional question: `Contract.NewSalaryAmount > 150000` This will show the field if the answer to the previous 'NewSalaryAmount' question is 150,001 or higher. If the value is equal to or lower than the 150,000 threshold, the additional question on which this condition is placed will not show.
Less than (`<`): Checks if the value on the left is less than the value on the right.	In this example, we are creating an additional question that must be completed if the salary of a worker is under a specified threshold. We have created a custom question called 'NewSalaryAmount'. Using the response to this question, we can optionally display an additional question by adding this conditional formula to the additional question: `Contract.NewSalaryAmount < 45000` This will show the field if the answer to the previous 'NewSalaryAmount' question is 44,999 or lower. If the value is equal to or greater than the 45,000 threshold, the additional question on which this condition is placed will not show.
Greater than or equal to (`>=`): Checks if the value on the left is greater than or equal to the value on the right.	In this example, we are creating an additional question that must be completed if the salary of a worker is equal to or over a specified threshold. We have created a custom question called 'NewSalaryAmount'. Using the response to this question, we can optionally display an additional question by adding this conditional formula to the additional question: `Contract.NewSalaryAmount >= 150000` This will show the field if the answer to the previous 'NewSalaryAmount' question is equal to or greater than 150,000. If the value is lower than the 150,000 threshold, the additional question on which this condition is placed will not show.
Less than or equal to (`<=`): Checks if the value on the left is less than or equal to the value on the right.	In this example, we are creating an additional question that must be completed if the salary of a worker is under a specified threshold. We have created a custom question called 'NewSalaryAmount'. Using the response to this question, we can optionally display an additional question by adding this conditional formula to the additional question: `Contract.NewSalaryAmount <= 45000` This will show the field if the answer to the previous 'NewSalaryAmount' question is equal to or less than 45,000. If the value is 45,001 or greater, the additional question on which this condition is placed will not show.