Templates

The entities related to templates are used for any kind of communication with a user, via e-mail, SMS or letter. nevisIDM selects the correct template based on the user's preferred language, the actual event that requires the communication and the associated template collection.

The following main characteristics summarize the template mechanism:

• A template can contain one or more text templates in the different allowed user languages.
• nevisIDM resolves the placeholders in a text template within the context of a specific user and credential. The user is the one that will receive the e-mail, SMS or letter.
• A template is defined per template collection and per communication event.

In case there is no matching template text available for a particular preferred user language, nevisIDM uses the corresponding template text in the nevisIDM default language as a fall-back. If there is no template text in the nevisIDM default language either, the communication with the user will fail with an error. For an in-depth description of the template mechanism (which is only available in the web GUI), see the chapter: Template store.

Database table TIDMA_TEMPLATE_COLLECTION

DB attribute	Java data type (max. size), defaults	Description
client_id	Long, not NULL	Foreign key that links to information in the table TIDMA_CLIENT
default_collection	Boolean, not NULL	Defines whether the collection is the default one for the underlying client (defined with client_id).
description	String(200), nullable
name	String(100), not NULL	Collection name
template_collection_id	Long, not NULL	Primary key (uniquely identifies each individual DB entry)

Database table TIDMA_TEMPLATE

DB attribute	Java data type (max. size), defaults	Description
comm_event_type	Long, not NULL	The communication event for which the template is used. Possible values are: 3 (Ticket) 4 (Reset Code, i.e., password reset) 5 (Temporary strong password) 6 (Initial password) 10 (User deactivation warning) 11 (Ticket expiration warning) 12 (Certificate expiration warning) 20 (OTP initial) 21 (OTP renew) 22 (OTP reset) 23 (OTP expiration warning) 24 (OTP low on challenge warning) 30 (PUK initial) 31 (PUK reset) 40 (URL ticket notification) 50 (Selfadmin ticket notification) 51 (Selfadmin mobile notification) 61-69 (User notification) 70 (Vasco Digipass token assignment) 80-90 (User notification)
doc_type	Long, not NULL	The document type of the template. Possible values are: 1 (SMS template); 2 (e-mail template); 3 (OpenOffice template); 4 (HTML e-mail template)
extid	String(50), not NULL	External identifier
precedence	Integer, not NULL	Precedence number of the template. The lowest precedence denotes the default template.
template_collection_id	Long, nullable	The collection the template belongs to. Foreign key that links to information in the table TIDMA_TEMPLATE_COLLECTION.
template_id	Long, not NULL	Primary key (uniquely identifies each individual DB entry)

Database table TIDMA_TEMPLATE_TEXT

DB attribute	Java data type (max. size), defaults	Description
file_name	String(1000), nullable
html_content	BLOB, nullable	Only used for HTML e-mail templates. Contains the binary data of an HTML document.
language_id	Long, not NULL	The language identification number.
mand_placeholders	String(4000), nullable	A comma-separated list of mandatory placeholders.
oo_file	BLOB, nullable	Only used for OpenOffice templates. Contains the whole OpenOffice document.
opt_placeholders	String(4000), nullable	A comma-separated list of optional placeholders.
pdf_file_name	String(100), nullable	Name for the generated PDF.
receiver	String(50), nullable	Used for e-mail and SMS templates. The e-mail address or phone number of the receiver (placeholders may be used).
receiver_bcc	String(50), nullable	Only used for e-mail templates. The e-mail address of the BCC receiver (placeholders may be used).
receiver_cc	String(50), nullable	Only used for e-mail templates. The e-mail address of the CC receiver (placeholders may be used).
sender	String(50), nullable	Only used for e-mail templates. The e-mail address of the sender (placeholders may be used).
subject	String(200), nullable	Only used for e-mail templates. The e-mail's subject (placeholders may be used).
table_names	String(4000), nullable	Only used for OpenOffice templates. A comma-separated list of the tables contained in the template.
template_id	Long, not NULL	Foreign key that links to information in the table TIDMA_TEMPLATE.
template_text_id	Long, not NULL	Primary key (uniquely identifies each individual DB entry)
text	String(4000), nullable	Used for e-mail and SMS templates. The e-mail's or SMS's text (placeholders may be used).