This applies to:
Available with the following QorusDocs Editions:
Please note that before you can create and manage Smart Fields, you’ll need to belong to the QorusDocs Designer or Admin user role.
You can create and manage Smart Fields in your QorusDocs Add-Ins for Word and PowerPoint, as well as on Hub Central.
In this article, we’ll cover:
- Text Smart Fields
- Date Time Smart Fields
- Number Smart Fields
- Single Select Smart Fields
- Multi Select Smart Fields
- Yes/No Smart Fields
- Image Smart Fields
- Dynamic Smart Fields
- Static Smart Fields
- The end-user experience in the Smart Fields Form
1. Text Smart Fields
Text fields allow users to type in anything they'd like in the text box provided.
They can cater for both single line of text (for example: a company name) as well as allow users to enter multiple lines of text (for example: a street address).
2. Date Time Smart Fields
Date/Time fields allow users to pick a date from a date picker control. In the ‘format’ drop down menu, you can select how you’d like the date to be displayed in the created document.
3. Number Smart Fields
Number fields allow users to enter a numerical value. Similar to Date/Time fields, it’s also possible here to select the format the number should be displayed as from a drop-down menu.
4. Single Select Smart Fields
Single select fields allow users to choose one option from a list of values. In the ‘List Values’ box, enter each option on a separate line:
5. Multi-Select Smart Fields
Multi select fields allow users to choose one or more options from a list of values. In the ‘List Values’ box, enter each option on a separate line:
6. Yes/No Smart Fields
Yes/No fields allow users to choose either 'Yes' or 'No' from a drop-down menu.
7. Image Smart Fields
Image fields allow users to browse their computer and upload an image they would like QorusDocs to merge into their created document.
In ‘Choose a fit’, you can specify how the image should look when a user uploads an image that is not the same size as the image placeholder in the template.
Regardless of the size of the image uploaded, the two options ‘fit and stretch’ and ‘fit and maintain aspect ratio’ will ensure that the image stays within the bounds of the image placeholder, unlike the ‘use image size’ option which will cause the image to overflow if it is bigger than the placeholder.
‘Fit and stretch’ will ensure that the full image completely fills the image placeholder – even if it means the image uploaded becomes distorted. ‘Fit and maintain aspect ratio’ will ensure that the full image is displayed without any distortions and without overflowing beyond the bounds of the image placeholder.
8. Dynamic Content Smart Fields
Dynamic content fields allow users to search for and select Word or PowerPoint content (Word documents for Word templates, and PowerPoint presentations for PowerPoint templates) they’d like to include, and merge that content into the template they are using to create a new document or slide deck.
When you create a Dynamic content field, you’ll need to specify which content source the content should come from, and optionally enter a search term and/or select one or more search filters.
A window will pop up where you can select the search filters:
You can also specify whether users can override the Dynamic content search settings you’ve provided here and choose their own search filters instead with the ‘Allow user to manually refine’ option.
9. Static Content Smart Fields
Static content fields, like Dynamic content fields, are used to merge content from other documents and presentations into the template to create a new document or slide deck.
The difference though is that users don’t get to search for and choose that content. It is pre-defined in the template by the template designer.
It is also the only type of Smart Field that does not show up in the Smart Field form – since the user does not have a say in whether it is included or not.
Unlike other types of Smart Fields, Static content fields are inserted into templates directly from the search pane. To find this option, click on the ‘more’ button and then on ‘Insert as content Field’ :
In the pop-up window that appears next, give it a name, specify whether QorusDocs should “Respect document section breaks” found in the static content when merged, and then on “Insert”.
It will look a bit like this in the template:
10. Hidden and Read-only
You will notice that when creating a Smart Field you have the following 2 options to select: Hidden, and Read-only. Let's break down what each of these means and how it might help you.
If you set a Smart Field to “Hidden”, it simply won't show up in the Pursuit Edit/Create form, the Smart Field tab in the Pursuit workspace, or on document creation. (Just a quick note, it will still appear on the Pursuit Type Create/Edit and the Design tab in the Add-In for Admins and Designers). Plus, this setting will be dutifully logged in Odata for your convenience. This can be set upon creation, or after creation by editing a Smart Field
Here's how to access this feature: Simply go to Manage > Smart Fields, and then click on an existing Smart Field in your hub or create a new one. Here we've clicked on an existing Smart Field:
Next, you'll find a new “Hidden” checkbox. Initially, it will be unchecked, but feel free to make use of it as it suits your needs:
You will also notice that in the Smart Field grid there will be a “Hidden” column, where the value will either be set to “Yes” or “No”, so you can see at a glance if this option has been checked or not:
However, we've got a couple of points to note:
- This Smart Field setting can't be overridden on the Pursuit Type level. For instance, if you want a Smart Field to be hidden on one Pursuit Type and not another, you'll need to use different Smart Fields for each of those Pursuit Types, hiding the one you don't want to show.
- This setting is versatile and can be used for all Smart Field Types, with the exception of Dynamic Content and Pursuit Standard Fields.
The Read-only selection option allows the user to grey out a Smart Field edit block when completing a Pursuit Create Form. You might question, why is this useful? Consider instances where reviewing the data is necessary but you do not want to risk inconsistencies in the data you are pulling through from other systems. This is precisely where the new Read-Only function comes into play.
So, how does one utilize this new feature? Simply go to Manage > Smart Fields.
When you're establishing or adjusting Smart Fields, you'll find a new “Read-only” checkbox option. It's unchecked by default, but it's there for your convenience as needed.
You will also notice that in the Smart Field grid there will be a “Read-Only” column, where the value will either be set to “Yes” or “No”. This is so that you can see at a glance if a Smart Field has been set to read-only:
Upon ticking the "Read-Only" box, the field and its contents will remain visible on the Document Create/Insert forms (including Auto Answer insert) and Pursuit Create/Edit forms. However, instead of the usual appearance, the field will be grayed-out, signifying its inactive state.
Confused about why a field can't be altered? Just hover over the field and a useful tooltip will display, clarifying why the field can't be edited.
Please take note of the following additional information:
- Pursuit Type Level: The Smart Field setting can't be overridden at the Pursuit Type level. In other words, if you'd like a Smart Field to be read-only on one Pursuit Type but not on another, you'll need to create separate Smart Fields for each of these Pursuit Types.
- Usage: This setting can be applied to all Smart Field Types, except for Dynamic Content and Pursuit Standard Fields.
- Exception: There is however one exception - if a field is marked as both Required and Read-only but doesn't contain any data yet, it will remain editable.
11. The end-user experience
Below is a screenshot of what the different field types look like in the Smart Fields form: