Reference: Template Elements
A reference of template elements is provided here. Required or Optional indicates whether the element is required to create a template.
Template Elements
| Parameter | Optional/Mandatory | Data Type | Description |
|---|---|---|---|
| id | Optional | Long | ID of the template. |
| uuid | Optional | String | Unique ID of the template. |
| name | Optional | String | Name of the template. |
| description | Optional | String | Description of the template. |
| category | Mandatory | String | Category of the template. |
| familyId | Mandatory | String | Family identifier of the template. |
| revision | Optional | Long | Version of the template. |
| isLibrary | Optional | Boolean | True if the template is created from a library template. |
| questionCnt | Required | Long | Count of questions in a template. |
| state | Optional | String | State of the template (Published, Draft) |
| elements | Mandatory | List | List of Template element (sections, questions, ...) |
| elements.sections | Mandatory | List | List of Template section, a section can contains other sections and questions. |
| elements.questions | Mandatory | List | List of the template questions. |
| elements.scorings | Mandatory | List | List of the template scorings. |
| Scoring.label | Optional | String | Scoring value. |
| Scoring.value | Optional | String | Scoring value. |
| Section.name | Mandatory | String | Name of the section. |
| Section.description | String | Description of the section. | |
| Question.label | Optional | String | Label assigned to the question. |
| Question.text | Optional | String | Description of the question. |
| Question.type | Optional | String | The question type (booleanQuestion, numericQuestion, textQuestion, ...) |
| Question.mode | Mandatory | String | The question mode (Button, Radio, Combo) |
| Question.criticality | Mandatory | String | The question criticality (INFO, CRITICAL, ...) |
| Question.requireAttachment | Mandatory | Boolean | True if the Attachment required flag is set to yes. |
| Question.requireComment | Mandatory | Boolean | True if the Comment required flag is set to yes. |
| Question.requireAsset | Mandatory | Boolean | True if the Asset required flag is set to yes. |
| Question.yesScoringLabel | Mandatory | Boolean | The question yes scoring label, used for Boolean question only. |
| Question.noScoringLabel | Mandatory | String | The question no scoring label, used for Boolean question only. |
| Question.minCommentLength | Mandatory | Integer | The question min comment length, the value of this field is stored if the requireComment field is set to true. |
| Question.maxCommentLength | Mandatory | Integer | The question max comment length, the value of this field is stored if the requireComment field is set to true. |
| Question.dateRange | Mandatory | Date | The question date range, used for a date question only. |
| Question.minAnswerLength | Mandatory | Integer | The question minimum question length, used for a text question only. |
| Question.maxAnswerLength | Mandatory | Integer | he question max comment length, the value of this field is stored if the requireComment field is set to true. |
| Answer.title | Mandatory | String | Title of the answer. |
| Answer.value | Mandatory | String | Value of the answer. |
| Answer.requireAttachment | Mandatory | Boolean | True if the Attachment required flag is set to yes. |
| Answer.requireComment | Mandatory | Boolean | True if the Comment required flag is set to yes. |
| Answer.requireAsset | Mandatory | Boolean | True if the Asset required flag is set to yes. |
| Answer.scoringLabel | Mandatory | Required | The answer scoring label (only for the dropdown, multiselect, single select) |
| Answer.minCommentLength | Mandatory | Integer | The Answer min comment length, the value of this field is stored if the requireComment field is set to true. |
| Answer.maxCommentLength | Mandatory | Integer | The Answer max comment length, the value of this field is stored if the requireComment field is set to true. |
Refer to the following table to view details of elements.
|
Element |
Description |
|---|---|
|
id (Long) |
(Optional) ID of the template. |
|
uuid (String) |
(Optional) Unique ID of the template. |
|
name (String) |
(Optional) Name of the template. |
|
description (String) |
(Optional) Description of the template. |
|
category (String) |
(Required) Category of the template. |
|
familyId (String) |
(Required) Family identifier of the template. |
|
revision (Long) |
(Optional) Version of the template. |
|
isLibrary (Boolean) |
(Optional) True if the template is created from a library template. |
|
questionCnt (Long) |
(Required) Count of questions in a template. |
|
state (String) |
(Optional) State of the template (Published, Draft) |
|
elements (List) |
(Required) List of Template element (sections, questions, ...) |
|
elements.sections (List) |
(Required) List of Template section, a section can contains other sections and questions. |
|
elements.questions (List) |
(Required) List of the template questions. |
|
elements.scorings (List) |
(Required) List of the template scorings. |
|
Scoring.label (String) |
(Optional) Scoring label. |
|
Scoring.value (Integer) |
(Optional) Scoring value. |
|
Section.name (String) |
(Required) Name of the section. |
|
Section.description (String) |
Description of the section. |
|
Question.label (String) |
(Optional) Label assigned to the question. |
|
Question.text (String) |
(Optional) Description of the question. |
|
Question.type (String) |
(Optional) The question type (booleanQuestion, numericQuestion, textQuestion, ...) |
|
Question.mode (String) |
(Required) The question mode (Button, Radio, Combo) |
|
Question.criticality (String) |
(Required) The question criticality (INFO, CRITICAL, ...) |
|
Question.requireAttachment (Boolean) |
(Required) True if the Attachment required flag is set to yes. |
|
Question.requireComment (Boolean) |
(Required) True if the Comment required flag is set to yes. |
|
Question.requireAsset (Boolean) |
(Required) True if the Asset required flag is set to yes. |
|
Question.yesScoringLabel (String) |
(Required) The question yes scoring label, used for Boolean question only. |
|
Question.noScoringLabel (String) |
(Required for Boolean question) The question no scoring label, used for Boolean question only. |
|
Question.minCommentLength (Integer) |
(Required) The question min comment length, the value of this field is stored if the requireComment field is set to true. |
|
Question.maxCommentLength (Integer) |
(Required) The question max comment length, the value of this field is stored if the requireComment field is set to true. |
|
Question.dateRange (Date) |
(Required for date question) The question date range, used for a date question only. |
|
Question.minAnswerLength (Integer) |
(Required for text question) The question minimum question length, used for a text question only. |
|
Question.maxAnswerLength (Integer) |
(Required for text question) The question minimum question length, used for a text question only. |
|
Answer.title (String) |
(Required) Title of the answer. |
|
Answer.value (String) |
(Required) Value of the answer. |
|
Answer.requireAttachment (Boolean) |
(Required) True if the Attachment required flag is set to yes. |
|
Answer.requireComment (Boolean) |
(Required) True if the Comment required flag is set to yes. |
|
Answer.requireAsset (Boolean) |
(Required) True if the Asset required flag is set to yes. |
|
Answer.scoringLabel (String) |
(Required) The answer scoring label (only for the dropdown, multiselect, single select) |
|
Answer.minCommentLength (Integer) |
(Required) The Answer min comment length, the value of this field is stored if the requireComment field is set to true. |
|
Answer.maxCommentLength (Integer) |
(Required) The Answer max comment length, the value of this field is stored if the requireComment field is set to true. |