{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"3"},"outline":{"value":"false"},"_parentId":{"value":"579829764"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"54b9c216-95ca-46aa-bf0d-1c34322ce4fb"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"baa275e6-d5ee-4746-834f-b4f996766adf"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"OVERVIEW","type":"text"}]},{"type":"paragraph","content":[{"text":"Is each individual object that composes a ","type":"text"},{"type":"inlineCard","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"FORM TEMPLATE OBJECT","versionAtSave":"134"},"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4260257"}},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Can be used to create:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Titles (static text) to be displayed in a questionnaire","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A interactive question to request data to a professional or patient. Supports many types of data (text, numbers, visual analog scale, list of options, check boxes, binary selections…)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Insert automatic calculations or execution of complex functions using the internal ","type":"text"},{"type":"inlineCard","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"FORM FORMULAS","versionAtSave":"13"},"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4817018"}},{"text":" language","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Display multimedia content (images, videos, reproduce audios)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Capture GPS geolocation data","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"etc.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The reference (unique ID) that identifies an ITEM TEMPLATE is a combination of two values:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":996.0,"localId":"36ee07ac-9bcf-47e1-83eb-2dfd030fc309"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[266.0]},"content":[{"type":"paragraph","content":[{"text":"Property","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[729.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[266.0]},"content":[{"type":"paragraph","content":[{"text":"FORM_TEMPLATE_REFERENCE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[729.0]},"content":[{"type":"paragraph","content":[{"text":"Reference of the FORM TEMPLATE where an ITEM TEMPLATE is embedded","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[266.0]},"content":[{"type":"paragraph","content":[{"text":"ITEM_TEMPLATE_REFERENCE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[729.0]},"content":[{"type":"paragraph","content":[{"text":"Reference of the ITEM TEMPLATE. this value is unique only inside a FORM TEMPLATE (can be repeated in other FORM TEMPLATES).","type":"text"}]},{"type":"paragraph","content":[{"text":"This value can be used in a FORMULA by prepending a '$' character (for example $14)","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"ITEM TEMPLATE PROPERTIES","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Properties table","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"a321da87-cfee-4fff-bbdf-71b5b4590d82"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"Property","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"ITEM_CODE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"A customized reference to the ITEM that can be used instead of the REFERENCE generated automatically by the system. The ITEM_CODE property must meet the following restrictions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It must be composed by a preceding letter followed by any alphanumeric character of '_' (underscore)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ITEM_CODE values are always converted to an uppercase string","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"An ITEM_CODE cannot be repeated within the same ","type":"text"},{"text":"FORM TEMPLATE OBJECT","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"FORM TEMPLATE OBJECT","versionAtSave":"134"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4260257"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Introduced in API version 2.7.18","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"ORDER","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"The order of the question in the ITEM[]. The list of ITEMS[] is sorted automatically","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"DATA_CODE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Is a code identifying the particular purpose of an ITEM value. The description of the different available DATA_CODE can be found in the CODES library under the DATA_CODE codification. For example: ","type":"text"},{"text":"code_search (session, \"DATA_CODE\", \"HR\")","type":"text","marks":[{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/524507"}}]},{"text":" will return the multilingual description of an ITEM with DATA_CODE = HR (Heart Rate) in the active language of the session. There are two special DATA_CODE uses beyond this general definition:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"System DATA_CODE:","type":"text","marks":[{"type":"strong"}]},{"text":" Some DATA_CODE are reserved for system use. System DATA_CODE are identified by a hash before the code.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Local DATA_CODE:","type":"text","marks":[{"type":"strong"}]},{"text":" DATA_CODE can also be used to refer to a particular ITEM for local ( form limited scope ) to be referred by a FORMULA. Example: SUM($item1, $item2) will add the value of the items referred with DATA_CODE $item1 and $item2. Local DATA_CODE are not part of the CODES library.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Restrictions: ","type":"text"},{"text":"Only accepted numbers, letters, underscores, dots and dollars. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#a94442"}}]}]},{"type":"paragraph","content":[{"text":"Validation is applied using next regular expression /^[a-zA-Z0-9_$.]*$/","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"TYPE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Is the type of the question. (*) See ","type":"text"},{"text":"ITEM TYPE","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"ITEM TYPE","versionAtSave":"32"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/579600414"}}]},{"text":" for more information.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"SECTION_TITLE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Used in STATIC TEXT ITEMS. Indicates that the TITLE of this ITEM is a \"Section\" title. This is normally used in the UI to display a caption when presenting an ITEM to know that it belongs to a particular section. All ITEMS following an ITEM marked as \"Section title\" are considered to belong to that section (until a new ITEM marked as \"Section title\" appears, which would start a new section)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"DESCRIPTION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Is the text that must be shown when displaying this ITEM such as a header (if the ITEM is a STATIC_TEXT) a question if the ITEM is any of most kind of ITEMs etc. The literal is always returned in the active session language unless it's instructed otherwise. Some Web Services allow to retrieve the value in all the available languages.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the literal has the system value #DATA_CODE the text returned will be the one associated to the DATA_CODE field.","type":"text"}]},{"type":"paragraph","content":[{"text":"The literal may also include{{","type":"text"},{"text":"OBJECT CODE","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"OBJECT CODES","versionAtSave":"141"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/32669832"}}]},{"text":"}}, that will be replaced by by the value of an ITEM with this DATA_CODE when calling ","type":"text"},{"text":"form_get_summary","type":"text","marks":[{"type":"textColor","attrs":{"color":"#800000"}},{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/524423"}}]},{"text":" () , ","type":"text"},{"text":"mobile_form_get_summary","type":"text","marks":[{"type":"textColor","attrs":{"color":"#800000"}},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"•\tmobile_form_get_summary ( session, form, language)"},"href":"https://linkcare.atlassian.net/wiki/pages/createpage.action?spaceKey=WS&title=%E2%80%A2%09mobile_form_get_summary%20%28%20session%2C%20form%2C%20language%29&linkCreation=true&fromPageId=579829764"}}]},{"text":" () and ","type":"text"},{"text":"form_get_question","type":"text","marks":[{"type":"textColor","attrs":{"color":"#800000"}},{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/524422"}}]},{"text":" ()","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"{% for key,value in ADMISSION.DATA.SPIRO.PBD.FEV1 %}{% endfor %}

	FVC	FEV1	FEV1/FVC	PEF	FEF25-75
{{loop.index}}	{{ ADMISSION.DATA.SPIRO.PBD.FVC[loop.index0] }}	{{ ADMISSION.DATA.SPIRO.PBD.FEV1[loop.index0] }}	{{ ADMISSION.DATA.SPIRO.PBD.FEV1-FVC[loop.index0] }}	{{ ADMISSION.DATA.SPIRO.PBD.PEF[loop.index0] }}	{{ ADMISSION.DATA.SPIRO.PBD.FEF2575[loop.index0] }}

","type":"text"}]},{"type":"paragraph","content":[{"text":"This will show something like:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":27216,"__fileMimeType":"image/png","width":762,"id":"acc2d834-4b63-45d1-b5b0-e811c36bd8e9","collection":"contentId-579829764","type":"file","__fileName":"Screen Shot 2016-05-18 at 14.37.51.png","height":115}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"DESCRIPTION_ONEDIT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"The same than DESCRIPTION, but represents the text to show when the FORM is being edited. If empty, the value of DESCRIPTION will be used.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is useful to show different texts when editing a FORM to fill the answers or when just seeing the contents of the FORM. For example, a question could have the following literals:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DESCRIPTION: \"Blood pressure of the patient is:\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DESCRIPTION_ONEDIT: \"What is your blood pressure?\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This way, when a patient is answering the FORM, the texts appears as a question, but when the FORM is not being edited, the text appears as a statement (not a question)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"LITERAL_FORMAT","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"LITERAL_FORMAT"},"legacyAnchorId":{"value":"ITEMTEMPLATEOBJECT-LITERAL_FORMAT"},"_parentId":{"value":"579829764"}},"macroMetadata":{"macroId":{"value":"ce0994aa-b0dd-49a2-a868-d684c9ebc9a9"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"49683605-5f3d-438e-8f3a-218f52c2804e"}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Determines how the text of the description should be presented. Is responsibility of the client to apply the indicated format.","type":"text"}]},{"type":"paragraph","content":[{"text":"The format is expressed using a JSON string with the following properties:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"text_format","type":"text","marks":[{"type":"em"}]},{"text":": there are two possibilities:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"plain (default): The literal is plain text that can be formatted with the values indicated in \"style\" property","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"html: The literal is an HTML string, and it is not necessary to indicate the \"style\" property (if indicated, it should be ignored)","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"style","type":"text","marks":[{"type":"em"}]},{"text":": contains a list of properties that determine the appearance of the text. The properties for the style have equivalent names to those in CSS specification.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"code_format","type":"text","marks":[{"type":"em"}]},{"text":": for a CODE ITEM determines which properties of the code to display","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"text_format\" : \"plain | html\",\n \"code_format\"\t: \"value|description|all\"\n \"font-family\" : \"Times new roman\",\n \"font-size\" : \"18\",\n \"font-style\" : \"normal | italic\",\n \"font-weight\" : \"normal | bold\",\n \"text-align\" : \"center | left | right\"\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"VALUE_FORMAT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Same than ","type":"text"},{"text":"ITEM TEMPLATE OBJECT#LITERAL_FORMAT","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=579829764#ITEMTEMPLATEOBJECT-LITERAL_FORMAT"}}]},{"text":" but applied to the value (answer) of the questions in the FORM","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"IMAGES","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"IMAGES_PROPERTY"},"legacyAnchorId":{"value":"ITEMTEMPLATEOBJECT-IMAGES_PROPERTY"},"_parentId":{"value":"579829764"}},"macroMetadata":{"macroId":{"value":"a29ea430-25bb-403f-967f-a8cd5e59624f"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"f9dbf006-cb84-42bc-a83c-1d256c028a75"}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"List of images associated to this ITEM. The property ","type":"text"},{"text":"ARRANGEMENT PROPERTY","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":" defines how the images will be displayed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"ARRANGEMENT","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ARRANGEMENT_FORMAT"},"legacyAnchorId":{"value":"ITEMTEMPLATEOBJECT-ARRANGEMENT_FORMAT"},"_parentId":{"value":"579829764"}},"macroMetadata":{"macroId":{"value":"5708ab1b-824e-46b3-8d3a-cf4e60a4c9c0"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"7a01bac5-58cd-49ff-a018-88a0913213b8"}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Determines the arrangement of the answer in the interface. Is responsibility of the client to apply the indicated format.","type":"text"}]},{"type":"paragraph","content":[{"text":"The format is expressed using a JSON string (see ","type":"text"},{"text":"ARRANGEMENT PROPERTY","type":"text","marks":[{"type":"link","attrs":{"href":"#ARRANGEMENT"}}]},{"text":") ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"CONSTRAINTS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Allows to define constraints for the value admitted for this ITEM (See ","type":"text"},{"text":"CONSTRAINT PROPERTY","type":"text","marks":[{"type":"link","attrs":{"href":"#CONSTRAINT"}}]},{"text":")","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"MIN_LEN","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Minimum Length of the field (ITEM)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"MAX_LEN","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Maximum Length of the field (ITEM)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"DEF_VAL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Default Value that will be assigned to an ITEM based in this ITEM TEMPLATE when no value has been specifically assigned. See ","type":"text"},{"text":"ITEM OBJECT","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"ITEM OBJECT","versionAtSave":"14"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/321191985"}}]},{"text":" for more information about how the default value is applied","type":"text"}]},{"type":"paragraph","content":[{"text":"It can contain ","type":"text"},{"text":"FORMULAS","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"INTRODUCTION TO FORMULAS","versionAtSave":"18"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/9765144"}}]},{"text":" which are executed if are preceded by '='.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"MIN_VAL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Minimum value of the field (ITEM)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"MAX_VAL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Maximum value of the field (ITEM)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"NUM_DEC","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Number of decimals for numeric ITEMs","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"MIN_ROWS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Minimum number of rows required in an ITEM of type ARRAY. Supports a number or a FORMULA","type":"text"}]},{"type":"paragraph","content":[{"text":"Introduced in API version 2.8.1","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"MAX_ROWS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Maximum number of rows permitted in an ITEM of type ARRAY. Supports a number or a FORMULA","type":"text"}]},{"type":"paragraph","content":[{"text":"Introduced in API version 2.8.1","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"REQUIRED","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Indicates if it is required (mandatory) to provide a value for in ITEMS generated from this ITEM TEMPLATE","type":"text"}]},{"type":"paragraph","content":[{"text":"Values accepted:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NULL, false, 0: Value is not required (not mandatory)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"true, 1: Non null value is required (mandatory)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FORMULA: Use a ","type":"text"},{"text":"FORM FORMULAS","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"FORM FORMULAS","versionAtSave":"13"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4817018"}}]},{"text":" to set the required property. ","type":"text"},{"text":"Introduce in API Version 2.7.20","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"FORMULA","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"FORM FORMULAs to calculate complex values depending on referenced ITEMs (questions) or constant values. See more information in ","type":"text"},{"text":"FORM FORMULAS","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"FORM FORMULAS","versionAtSave":"13"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4817018"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"HIDDEN","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"If the ITEM (question) must be hidden in the browse format to the user. Possible values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0: Always visible (not hidden)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: Always hidden","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"2: Hidden only when FORM is closed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3: Hidden only if FORM is open","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"CONDITIONED","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"An ITEM with a condition different null will only \"exist\" if the formula in the condition property returns 1 (Y).","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"text":": Be aware that condition is different from hidden. While a hidden ITEM exists but cannot be displayed, so it can be part of a follow-up report or be referenced by a formula; A conditioned field doesn't exists at all if the condition property is not true and neither has an associated value nor can be referenced by a formula.","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE2 (Array Conditions)","type":"text","marks":[{"type":"strong"}]},{"text":": If the condition is on an Array block, when the Array add a new file and if the condition references to another question ID (of the same Array), the condition is recalculated","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE3 (Code Conditions)","type":"text","marks":[{"type":"strong"}]},{"text":": When conditioning to a previous question that is CODE item type, condition expression should contain the whole JSON structure: e.g. $2,{\"option_id\":\"0\"} (the first manual answer included in the CODE item type, starts with option_id = 0).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"VISIBILITY_CONDITION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"This property allows to decide whether an ","type":"text"},{"text":"ITEM OBJECT","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"ITEM OBJECT","versionAtSave":"14"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/321191985"}}]},{"text":" generated from this ITEM TEMPLATE will be visible for the active SESSION USER. The VISIBILITY CONDITION is generally expressed as a FORMULA. The ","type":"text"},{"text":"ITEM OBJECT","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"ITEM OBJECT","versionAtSave":"14"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/321191985"}}]},{"text":" is considered to be visible when this field evaluates to a value different than 0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"NUM_ASOCIADAS (ARRAY)","type":"text","marks":[{"type":"strike"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Removed in API Version 2.7.24","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Is a numeric field indicating if the field may have more than one instance. When a field has the \"ARRAY\" value of 1, once the field is filled a new blank field is shown. If the field is left empty the next field will be shown.","type":"text","marks":[{"type":"strike"}]}]},{"type":"paragraph","content":[{"text":"If the ARRAY value is higher that 1 means that the next N ITEMs will be sequentially shown until the first field in the group is left blank","type":"text","marks":[{"type":"strike"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"ARRAY_REF","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Used to indicate that an ITEM TEMPLATE is part of an array. The value can be:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NULL: The ITEM TEMPLATE is not part of an array","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Number: Should be the ID of an ITEM TEMPLATE of type \"ARRAY\". All ITEM TEMPLATES that belong to the same array will have the same ARRAY_REF","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Introduced in API Version 2.7.24","type":"text","marks":[{"type":"strong"}]},{"text":" as a replacement of the deprecated property NUM_ASOCIADAS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"ARRAY_COL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"When an ITEM TEMPLATE is part of an array, this property indicates the position (column) of the ITEM in the array. Otherwise it is null.","type":"text"}]},{"type":"paragraph","content":[{"text":"This value is read-only because it is automatically assigned by the system. The position of an ITEM TEMPLATE and can be modified using the API function ","type":"text"},{"text":"library_form_question_move ()","type":"text","marks":[{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/3019636758"}}]}]},{"type":"paragraph","content":[{"text":"Introduced in API Version 2.7.24","type":"text","marks":[{"type":"strong"}]},{"text":" as a replacement of the deprecated property NUM_ASOCIADAS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"OPTIONS FORMULA","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"This field allows to generate a dynamic list of options for the following types of ITEMS","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HORIZONTAL_CHECK","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VERTICAL_CHECK","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VERTICAL_RADIO","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HORIZONTAL_RADIO","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CODE","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The value of this field must be a FORMULA that generates a list of options. See ","type":"text"},{"text":"OPTION FORMULAS","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=579829764#ITEMTEMPLATEOBJECT-OPTION_FORMULAS"}}]},{"text":" for more details","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"MONITORED","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"(true/false) Indicates if the values stored in ITEMS created from this TEMPLATE should be monitored. This value is used for statistics, extractions and evolution graphs","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"MONITORED_CATEGORY","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"The name of a DATA_CODE that can be used to categorize a monitored value. This property only produces some effect if MONITORED=true.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"EXCLUSION","type":"text","marks":[{"type":"strike"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Removed in API Version 2.7.29","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If EXCLUSION is set:","type":"text","marks":[{"type":"strike"}]}]},{"type":"paragraph","content":[{"text":"If the ","type":"text","marks":[{"type":"strike"}]},{"text":"CONDITIONED","type":"text","marks":[{"type":"strike"},{"type":"strong"}]},{"text":" field is ","type":"text","marks":[{"type":"strike"}]},{"text":"null","type":"text","marks":[{"type":"strike"},{"type":"strong"}]},{"text":" admission will be rejected if answered current question with No,","type":"text","marks":[{"type":"strike"}]}]},{"type":"paragraph","content":[{"text":"otherwise if ","type":"text","marks":[{"type":"strike"}]},{"text":"CONDITIONED","type":"text","marks":[{"type":"strike"},{"type":"strong"}]},{"text":" = '","type":"text","marks":[{"type":"strike"}]},{"text":"S","type":"text","marks":[{"type":"strike"},{"type":"strong"}]},{"text":"' admission will be rejected answering current question with Yes.","type":"text","marks":[{"type":"strike"}]}]},{"type":"paragraph","content":[{"text":"Note: To activate option EXCLUSION question should be BOOLEAN type.","type":"text","marks":[{"type":"strike"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"DEVICE_TYPE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Only for ITEMs of type \"DEVICE\": identifies the type of device. Possible values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SPIROMETER","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PEDOMETER","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PULSEOXYMETER","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ACTIVITY_MONITOR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SPHYGMOMANOMETER","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GPS","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"BARCODE_SCAN"},"legacyAnchorId":{"value":"ITEMTEMPLATEOBJECT-BARCODE_SCAN"},"_parentId":{"value":"579829764"}},"macroMetadata":{"macroId":{"value":"80e43f8a-716a-48eb-9bc2-be1928dee28b"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"f9fe80ff-043d-498a-82ed-8216c4dd055e"}}]},{"type":"paragraph","content":[{"text":"BARCODE_SCAN","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"This property is used to indicate that it may be possible for the user to enter the value of the ITEM by scanning a barcode. This is only a suggestion for the client APP because the API has no control on the way the items are presented to the user. Accepted values for this property are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NULL / 0: Do not allow barcode scan","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: Allow barcode scan and manual input","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"2: Allow only barcode scan","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Introduced in API version 2.7.15","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"DESCRIPTION_AUX_1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Auxiliar text used by some type of ITEMS. For example, an ITEM of type FILE uses this description to allow to configure the text that should appear in the \"Upload\" button","type":"text"}]},{"type":"paragraph","content":[{"text":"The literal is always returned in the active session language unless it's instructed otherwise. Some Web Services allow to retrieve the value in all the available languages.","type":"text"}]},{"type":"paragraph","content":[{"text":"Introduced in API version 2.7.16","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"DESCRIPTION_AUX_2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Auxiliar text used by some type of ITEMS. For example, an ITEM of type FILE uses this description to allow to configure the text that should appear in the \"Skip\" button","type":"text"}]},{"type":"paragraph","content":[{"text":"The literal is always returned in the active session language unless it's instructed otherwise. Some Web Services allow to retrieve the value in all the available languages.","type":"text"}]},{"type":"paragraph","content":[{"text":"Introduced in API version 2.7.16","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"NAVIGATION_MODE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"This property is used to indicate how the ITEM should be presented to the user when editing its value. Note that this is only a recommendation of the designer to the client application about how to present the ITEM, but It is responsibility of the client application to implement the suggested behavior.","type":"text"}]},{"type":"paragraph","content":[{"text":"Possible values are","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0: List (default value). When editing the ITEM value, it should be presented in a list along with the rest of ITEMs of the FORM.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: Step by Step. When editing the ITEM value, it should be presented individually (preferably in a popup modal dialog)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Introduced in API version 2.7.19","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Examples","type":"text","marks":[{"type":"underline"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"Suggestion to present an ITEM with NAVIGATION_MODE=0 (list):","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":702,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":322275,"__fileMimeType":"image/png","width":1910,"id":"586a5782-b8f7-471e-ab40-8e682515e23f","collection":"contentId-579829764","type":"file","__fileName":"Captura de pantalla 2021-04-13 a las 10.28.17.png","height":1124}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[314.0]},"content":[{"type":"paragraph","content":[{"text":"DOCUMENTATION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1485.0]},"content":[{"type":"paragraph","content":[{"text":"Developer notes about the ITEM TEMPLATE","type":"text"}]},{"type":"paragraph","content":[{"text":"Introduced in API version 2.8.1","type":"text","marks":[{"type":"strong"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Special properties","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"OPTION_FORMULAS"},"legacyAnchorId":{"value":"ITEMTEMPLATEOBJECT-OPTION_FORMULAS"},"_parentId":{"value":"579829764"}},"macroMetadata":{"macroId":{"value":"892090be-fd87-4325-9e2e-e6b9c7abee48"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"0fc6bef2-ea1a-499d-ad83-5e17b84cdc44"}},{"text":"Property “OPTIONS FORMULAS”","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"OPTION FORMULAS in CODE ITEMS","type":"text"}]},{"type":"paragraph","content":[{"text":"To generate a list of options for an ITEM of type CODE it is possible to use one of the following expressions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a DATA_CODE value (e.g. \"ICD9\"). This will cause to return a list of ","type":"text"},{"text":"CODE OBJECTS","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"CODE OBJECTS","versionAtSave":"53"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/20054339"}}]},{"text":" where ","type":"text"},{"text":"ID_STANDARD_CODE is the indicated value","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a DATA_CODE TREE expression","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"OPTION FORMULAS in RADIO or CHECKBOX ITEMS","type":"text"}]},{"type":"paragraph","content":[{"text":"to generate a list of options for this types of ITEM you can use any ","type":"text"},{"text":"FORM FORMULAS","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"FORM FORMULAS","versionAtSave":"13"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4817018"}}]},{"text":" that returns a value with a valid format","type":"text"}]},{"type":"paragraph","content":[{"text":"The result of the formula should be an array with the list of options. Ideally each option consists of three values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Description (string) This is the literal that will be returned as the description of the option","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value assigned to the option (string)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ID of the option (integer)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"But it is not mandatory to provide all values. The value returned by the FORMULA can have the following formats:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A scalar value (e.g. \"Option 1\"): it will be interpreted as only one option where the Description and Value and ID will be equal to that scalar, and the ID will be 1.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"An array of values. An option will be generated for each item in the array, where each item can be:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A scalar value (e.g. \"Option 1\"): the Description, Value and ID will be equal to that scalar, and the ID will be a sequential number starting at 1.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"An array with 1 up to 3 subitems (additional subitems will be ignored)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The first subitem will be used as the Description of the option","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The second subitem will be used as the Value of the option. If it does not exist then the Value will equal to the description","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The third subitem will be used as the ID of the option only if it exists and is a positive integer. Otherwise a sequential number will be assigned","type":"text"}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The following FORMULAS have been specifically designed to generate lists of options:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"30fc75c1-1483-4af6-9a6a-849679621076"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"NAME","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET_LIST (SCOPE, PROPERTY{, PARAMETER, OPTIONS})","type":"text","marks":[{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/16580953"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET_LIST_MEMBERS()","type":"text","marks":[{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/810811394"}}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"OPTION_DEFAULT"},"legacyAnchorId":{"value":"ITEMTEMPLATEOBJECT-OPTION_DEFAULT"},"_parentId":{"value":"579829764"}},"macroMetadata":{"macroId":{"value":"7aec1da3-3a93-48a0-9c5e-d641b5d2a5de"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"0ee22b04-d5d2-44af-ac28-8d9ab6cde440"}},{"text":"OPTION's DEFAULT VALUE FORMULAS","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"5590267e-c7d9-4ccc-890d-cfe9ab9e342f"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[346.0]},"content":[{"type":"paragraph","content":[{"text":"NAME","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1453.0]},"content":[{"type":"paragraph","content":[{"text":"DESCRIPTION","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[346.0]},"content":[{"type":"paragraph","content":[{"text":"OPTION_SELECT","type":"text","marks":[{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/33915057"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1453.0]},"content":[{"type":"paragraph","content":[{"text":"OPTION_SELECT allows to set in the DEFAULT or FORMULA properties of an OPTION field a default or calculated selection. Valid only for H_CHECK and V_CHECK.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ARRANGEMENT"},"legacyAnchorId":{"value":"ITEMTEMPLATEOBJECT-ARRANGEMENT"},"_parentId":{"value":"579829764"}},"macroMetadata":{"macroId":{"value":"550af649-c757-4a0c-8b49-9f6325c4ead6"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"df90f745-cc8e-46b2-9b66-32d50e0871cd"}},{"text":"Property \"ARRANGEMENT\"","type":"text"}]},{"type":"paragraph","content":[{"text":"The ARRANGEMENT property is a JSON expression that contains instructions about the appearance of the question (how should it be displayed in the User Interface):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"answer_position","type":"text","marks":[{"type":"code"}]},{"text":": indicates if the answer should be presented beside or below the question text. This property should be applied when not editing the FORM","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"answer_position_onedit","type":"text","marks":[{"type":"code"}]},{"text":": the same than answer_position, but his property should be applied when editing the FORM","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"images","type":"text","marks":[{"type":"code"}]},{"text":": This property only makes sense if there is at least one image loaded in the question (see property ","type":"text"},{"text":"IMAGES","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=579829764#ITEMTEMPLATEOBJECT-IMAGES_PROPERTY"}}]},{"text":"). Defines how the images should be displayed:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"position","type":"text","marks":[{"type":"code"}]},{"text":": (\"","type":"text"},{"text":"above\"","type":"text","marks":[{"type":"em"}]},{"text":", \"","type":"text"},{"text":"below\"","type":"text","marks":[{"type":"em"}]},{"text":") to define where the image should be positioned relative to the title text","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"alignment","type":"text","marks":[{"type":"code"}]},{"text":": (\"","type":"text"},{"text":"left\"","type":"text","marks":[{"type":"em"}]},{"text":", \"","type":"text"},{"text":"center\"","type":"text","marks":[{"type":"em"}]},{"text":", \"","type":"text"},{"text":"right\"","type":"text","marks":[{"type":"em"}]},{"text":") alignment of the image","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"presentation","type":"text","marks":[{"type":"code"}]},{"text":": this property makes sense when there are more than one image loaded. The possible values are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"","type":"text"},{"text":"normal","type":"text","marks":[{"type":"em"}]},{"text":"\": is the default presentation mode. When there exist only one image, a single image will be displayed. If there exist more than one image, all of them will be visible and lying one beside each other","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"","type":"text"},{"text":"carrousel","type":"text","marks":[{"type":"em"}]},{"text":"\": Only one image will be visible at a time. The user can manually switch to the next/previous image","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"n","type":"text","marks":[{"type":"em"}]},{"text":": (where ","type":"text"},{"text":"n","type":"text","marks":[{"type":"em"}]},{"text":" is a positive number) permits to select only one image of the set. The value of ","type":"text"},{"text":"n","type":"text","marks":[{"type":"em"}]},{"text":" represent the ordinal position of the image in the set of images","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"multioption_layout","type":"text","marks":[{"type":"code"}]},{"text":": only valid for CHECK or RADIO question types. Determines if the list of options should be presented as a horizontal or vertical list (NOTE: currently there exist the H_CHECK, H_RADIO, V_CHECK and V_RADIO to define the arrangement, but in the future this will be substituted by only CHECK or RADIO, and the arrangement will be determined by this property)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"codes_layout","type":"text","marks":[{"type":"code"}]},{"text":": used in questions of type \"CODE\". Defines how the list of CODES will be displayed. Possible values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"default\"","type":"text","marks":[{"type":"em"}]},{"text":": an autocomplete field that permits to enter some characters and shows the CODES that match in a dropdown list","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"radio\"","type":"text","marks":[{"type":"em"}]},{"text":": show all the CODES in a list of RADIOS","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VAS","type":"text","marks":[{"type":"code"}]},{"text":" section (only for ITEMS of type VAS)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"show_progress","type":"text","marks":[{"type":"code"}]},{"text":": defines whether the visual slider should be filled up to the current value (similar to a progress bar). Possible values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"true","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"16eaa648-7123-4f95-9692-f76b89032d44","collection":"contentId-579829764","height":""}}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"false","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"7ea3b3aa-f958-47ef-81a3-0a5c46545643","collection":"contentId-579829764","height":""}}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"tooltip_text","type":"text","marks":[{"type":"code"}]},{"text":": format of the tooltip balloon that appears when selecting a value on the visual slider","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"none\"","type":"text","marks":[{"type":"em"}]},{"text":": do not display tooltip","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"description\"","type":"text","marks":[{"type":"em"}]},{"text":": the tooltip text will be the description instead of the value (see ","type":"text"},{"text":"#ELEMENT:CHOICE","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"spaceKey":"WS","isRenamedTitle":true,"linkType":"page","contentTitle":"#ELEMENT:CHOICE","versionAtSave":"18"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/94934877"}}]},{"text":" to find out how to set up descriptions)","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"40bfe2f8-b7fe-4695-ab47-89bad7b2b1e9","collection":"contentId-579829764","height":""}}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"value\"","type":"text","marks":[{"type":"em"}]},{"text":": the tooltip text will display the currently selected value (numeric)","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":104,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":4028,"__fileMimeType":"image/png","width":115,"id":"8ece4e3b-1cae-4e13-9809-7d630add93ef","collection":"contentId-579829764","type":"file","__fileName":"VAS value.png","height":65}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"mixed\"","type":"text","marks":[{"type":"em"}]},{"text":": the tooltip text will be a combination of the text and the value","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":107,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":3680,"__fileMimeType":"image/png","width":115,"id":"f81432d0-562d-4c5b-8f0e-b0b11dbfbd8d","collection":"contentId-579829764","type":"file","__fileName":"VAS mixed.png","height":65}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"title","type":"text","marks":[{"type":"code"}]},{"text":": format of the title shown above the VAS (","type":"text"},{"text":"introduced in API Version 2.7.22","type":"text","marks":[{"type":"strong"}]},{"text":"). Possible values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"none\"","type":"text","marks":[{"type":"em"}]},{"text":": do not display title","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"600","id":"f8f4b01b-3934-41ae-925b-c62c112c8334","collection":"contentId-579829764","height":""}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"description\"","type":"text","marks":[{"type":"em"}]},{"text":": the title will be the description instead of the value (see ","type":"text"},{"text":"#ELEMENT:CHOICE","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"spaceKey":"WS","isRenamedTitle":true,"linkType":"page","contentTitle":"#ELEMENT:CHOICE","versionAtSave":"18"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/94934877"}}]},{"text":" to find out how to set up descriptions)","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"600","id":"3b59941a-778f-4687-acf2-51b3b8258476","collection":"contentId-579829764","height":""}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"value\"","type":"text","marks":[{"type":"em"}]},{"text":": the title will display the currently selected value (numeric)","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":499,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":24075,"__fileMimeType":"image/png","width":1634,"id":"ade57e7a-5740-4517-82dd-07e2570497ab","collection":"contentId-579829764","type":"file","__fileName":"Value.png","height":178}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"mixed\"","type":"text","marks":[{"type":"em"}]},{"text":": the title will be a combination of the text and the value","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":499,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":26899,"__fileMimeType":"image/png","width":1634,"id":"714b0cbb-9446-45e4-b931-965c501dd9ec","collection":"contentId-579829764","type":"file","__fileName":"Mixed.png","height":178}}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"link_display","type":"text","marks":[{"type":"code"}]},{"text":": (only for ITEMs of type LINK) Indicates how to display a link in the client application. ","type":"text"},{"text":"Introduced in API Version 2.7.24","type":"text","marks":[{"type":"strong"}]},{"text":". Contains 2 properties:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"mode","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"default\": Show a in the client application so that it is followed when clicked.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"embedded\": Show the web page referred by the link in an embedded frame so that the contents can be viewed directly without the need of clicking to redirect to another page","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"size","type":"text","marks":[{"type":"code"}]},{"text":": Only necessary when mode = \"embedded\". Indicates the vertical size (in pixels) of the embedded frame where the contents of the link will be displayed.","type":"text"}]}]}]}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"answer_position\" : \"beside/below\",\n \"answer_position_onedit\" : \"beside/below\",\n \"images\" : {\n \"position\" : \"below\",\n \"alignment\" : \"center\",\n \"presentation\" : \"normal\",\n }\n \"multioption_layout\" : \"vertical/horizontal\",\n \"codes_layout\" : \"default/radio\",\n \"VAS\" : {\n \"show_progress\" : true,\n \"show_ticks\" : true,\n \"tooltip_text\": \"description\",\n \"title\": \"none\"\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"CONSTRAINT"},"legacyAnchorId":{"value":"ITEMTEMPLATEOBJECT-CONSTRAINT"},"_parentId":{"value":"579829764"}},"macroMetadata":{"macroId":{"value":"2c4fa652-0c62-4aee-85b8-b1b361feec47"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"a3a63394-a0fd-4c98-a985-50d540a66ae4"}},{"text":"Property \"CONSTRAINTS\"","type":"text"}]},{"type":"paragraph","content":[{"text":"The CONSTRAINT property allows to define restrictions and/or validations to verify that the value assigned to an ITEM is valid.","type":"text"}]},{"type":"paragraph","content":[{"text":"This property is expressed as a JSON string, and the contents depends on the ITEM type as explained below:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"ALL ITEM TYPES","type":"text"}]},{"type":"paragraph","content":[{"text":"All ITEM TYPES accept the following properties for the constraints:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"error_message","type":"text","marks":[{"type":"strong"}]},{"text":": (optional) A custom error message that will be returned if the constraint is not accomplished. If no message is provided, a generic error message will be returned. The error message can be a ","type":"text"},{"text":"FORM FORMULAS","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"FORM FORMULAS","versionAtSave":"13"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4817018"}}]},{"text":". If there are additional validations (see next point) that do not provide a specific message, then this error message will be used as default. ","type":"text"},{"text":"Introduced in API Version 2.7.16","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"validations","type":"text","marks":[{"type":"strong"}]},{"text":": array of FORMULAS that can be used to verify that the value entered is valid. Each validation consists of 2 fields (","type":"text"},{"text":"Introduced in API Version 2.7.16)","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"formula","type":"text","marks":[{"type":"strong"}]},{"text":": Admits any valid FORMULA. See ","type":"text"},{"text":"FORM FORMULAS","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"FORM FORMULAS","versionAtSave":"13"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4817018"}}]},{"text":" for more details. If the evaluation of the FORMULA returns \"false\", then the value will be considered invalid (validation failed).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"error_message","type":"text","marks":[{"type":"strong"}]},{"text":": (optional) A custom error message that will be returned if the validation fails. If no message is provided, a generic error message will be returned. The error message can be a ","type":"text"},{"text":"FORM FORMULAS","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"FORM FORMULAS","versionAtSave":"13"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4817018"}}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The $0 variable","type":"text","marks":[{"type":"strong"}]},{"text":": When writing a FORMULA expression, the term $0 will refer to the value that we are evaluating. Remember that a term with the form $n represents an ","type":"text"},{"text":"ITEM Reference","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"INTRODUCTION TO FORMULAS","anchorName":"ITEM_REFERENCE","versionAtSave":"18"},"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/9765144#INTRODUCTIONTOFORMULAS-ITEM_REFERENCE"}}]},{"text":", where n is an ITEM ID, which are always greater than 0. We use $0 to represent the value being validated. ","type":"text"},{"text":"Introduced in API Version 2.7.16","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, the value entered must be different than \"XXX\" and \"YYY\". If one of them is entered, we'll get one of the following error messages:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the value is \"XXX\" the error message ","type":"text"},{"text":"\"XXX is not admitted\"","type":"text","marks":[{"type":"em"}]},{"text":" will be returned because it was specifically defined for that validation","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the value is \"YYY\" the error message ","type":"text"},{"text":"\"The value entered is not accepted\"","type":"text","marks":[{"type":"em"}]},{"text":" will be returned because there is no specific message defined for that validation, an therefore the general error message is used","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Validate value using a FORMULA","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"error_message\": \"The value entered is not accepted\",\n \"validations\": [\n {\"formula\" : \"$0 != \\\"XXX\\\"\", \"error_message\": \"XXX is not admitted\"},\n {\"formula\" : \"$0 != \\\"YYY\\\"\"}\n ]\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"TEXT ITEMS Specific constraints","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"regex","type":"text","marks":[{"type":"code"}]},{"text":": (default = null) a regular expression to define the format allowed for the value.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example 1","type":"text"}]},{"type":"paragraph","content":[{"text":"The value entered must match the pattern defined by the regular expression \"","type":"text"},{"text":"^A\\d*N$\" to only accept strings composed by a letter \"A\", 1 or more digits and an ending letter \"N\" like \"A875N\"","type":"text","marks":[{"type":"code"}]},{"text":". If the value provided is invalid, a standard error message will be returned (no custom error message has been defined in this example)","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Validate value with a regular expression","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"regex\" : \"^A\\\\d*N$\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example 2","type":"text"}]},{"type":"paragraph","content":[{"text":"the value entered must match the pattern defined by a regular expression and also be different than \"A666N\" and \"A999N\". In this example there are 2 validation formulas to display different message depending on the wrong value entered.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Validate value using a FORMULA","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"regex\": \"^A\\\\d*N$\",\n \"error_message\": \"The value must have format AnnnN\",\n \"validations\": [\n {\"formula\" : \"$0 != \\\"A666N\\\"\", \"error_message\": \"A666N is not admitted\"},\n {\"formula\" : \"$0 != \\\"A999N\\\"\", \"error_message\": \"A999N is not admitted\"}\n ]\n}","type":"text"}]},{"type":"heading","attrs":{"level":6},"content":[{"text":"NOTE","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"In the LIBRARY of linkcareapp the regex and formulas expressions must not be placed \"escaped\". The following screenshot is the same of the \"Example 2\" but introduced from the Library:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":660,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":119509,"__fileMimeType":"image/png","width":1844,"id":"97fac220-f96f-45da-be6b-b4058caf1df6","collection":"contentId-579829764","type":"file","__fileName":"Captura de pantalla 2020-11-20 a las 13.50.30.png","height":832}}]},{"type":"paragraph","content":[{"text":"\"Regular expression\" only shows one \"\\\" and \"formula\" is showing \" instead of \\\"","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"FILE ITEMS Specific constraints","type":"text"}]},{"type":"paragraph","content":[{"text":"Available from API version 2.7.16","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"file_type","type":"text","marks":[{"type":"code"}]},{"text":": (default = null) a comma-separated list of permitted file types. Each file type can be expressed as:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a specific file extension (e.g. \"pdf\", \"doc\"...)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a general group of file extension. The possible values are: image/*, audio/* and video/*","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"max_size","type":"text","marks":[{"type":"strong"}]},{"text":": (default = null). Maximum allowed size (in bytes). The value null or 0 means 'any size'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"max_width","type":"text","marks":[{"type":"strong"}]},{"text":": (default = 1024) Maximum width in pixels that the client should allow before uploading the image. This is only an indication to avoid uploading large files from the client application. The API does not check the size in pixels of the files received.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"max_height","type":"text","marks":[{"type":"strong"}]},{"text":": (default = 1024) Maximum height in pixels that the client should allow before uploading the image. This is only an indication to avoid uploading large files from the client application. The API does not check the size in pixels of the files received.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"The uploaded file must be a PDF, DOCX (Word document) or any type of image file with a maximum size of 100KB","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Validate value with a regular expression","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"file_type\" : \".pdf, .docx, image/*\",\n \"max_sixe\" : 100000,\n \"max_width\" : 1024,\n \"max_height\" : 1024\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"DATE ITEMS Specific constraints","type":"text"}]},{"type":"paragraph","content":[{"text":"The following properties allow to define which parts of a date value are required, optional or not necessary. The possible values are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"year","type":"text","marks":[{"type":"code"}]},{"text":" : Define if the \"year\" part of the date should be asked. The possible values are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"required\": the year part of the date is mandatory","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"optional\": (this is the default value) the year part of the date is optional (it can be left empty)","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"month","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"required\": the year part of the date is mandatory. It makes no sense specifying \"required\" in this property if ","type":"text"},{"text":"year","type":"text","marks":[{"type":"code"}]},{"text":" = \"no\" or \"optional\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"optional\": (this is the default value) the year part of the date is optional (it can be left empty)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"no\": the month part of the date should not be asked. If a date with month and/or day parts is provided, they will be ignored and only the year will be used","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"day","type":"text","marks":[{"type":"code"}]},{"text":": ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"required\": the year part of the date is mandatory. It makes no sense specifying \"required\" in this property if ","type":"text"},{"text":"month","type":"text","marks":[{"type":"code"}]},{"text":" = \"no\" or \"optional\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"optional\": (this is the default value) the year part of the date is optional (it can be left empty). It makes no sense specifying \"optional\" in this property if ","type":"text"},{"text":"month","type":"text","marks":[{"type":"code"}]},{"text":" = \"no\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"no\": the day part of the date should not be asked. If a date with day parts is provided, it will be ignored and only the year and month will be used.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example of constraints for a DATE ITEM","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"year\" : \"required\",\n \"month\" : \"optional\",\n \"day\" : \"optional\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"WEB SERVICES","type":"text"}]},{"type":"paragraph","content":[{"text":"List of web services to manage form template:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"8ac392c3-9bc3-4f2e-975e-b2cc33f4909d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"WS","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"DESCRIPTION","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"library_form_get_question ()","type":"text","marks":[{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/31654047"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"This function get a XML with information of specific question in a template.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"library_form_question_move ()","type":"text","marks":[{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/pages/viewpage.action?pageId=13631522"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Sets new order for questions of a FORM TEMPLATE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"library_form_set_answer ()","type":"text","marks":[{"type":"link","attrs":{"href":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/31654051"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Sets a value of specific field in a template. This specific field is determined in datacode of question in template.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported