{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph","content":[{"text":"Each control setting property is explained below. Keep in mind that all controls do not have the same setting properties.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":125617,"__fileMimeType":"application/octet-stream","width":746,"id":"667e486a-758c-4010-8e7c-f9a4587e3bb8","collection":"contentId-1507398706","type":"file","__fileName":"v91%20text%20control%20properties.PNG?version=1&modificationDate=1686239127501&cacheVersion=1&api=v2&effects=drop-shadow&width=251&height=400","height":1150}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Label","type":"text"}]},{"type":"paragraph","content":[{"text":"A control’s label is displayed on your form above the control. When you first drag in a control it is assigned an arbitrary and unique label, for example, \"Checkbox 43.\" You will want to edit for more meaningful labels for your users. Change a control’s label either on the form itself (by clicking the control and selecting the label) or by replacing the arbitrary text in the Properties Label field. Message controls are used for static text and do not need a label, so they are the only controls without labels. ","type":"text"}]},{"type":"paragraph","content":[{"text":"There are restrictions on what you can do in the label markup due to the incorporation of a whitelist approach to filter out XSS attacks. The whitelist allows a full range of text and structural body HTML: a, b, blockquote, br, caption, cite, code, col, colgroup, dd, dl, dt, em, h1, h2, h3, h4, h5, h6, i, img, li, ol, p, pre, q, small, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, u, ul. This means that you can only use these tags in a label's markup. You can find information about XHTML tags ","type":"text"},{"text":"at this w3schools.com website","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.w3schools.com/TAGS/default.asp"}}]},{"text":". These restrictions also apply to the Help property.","type":"text"}]},{"type":"paragraph","content":[{"text":"Let's say you want to underline (6 characters) in the label of a password field.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":21226,"__fileMimeType":"application/octet-stream","width":648,"id":"08a01d25-cfe9-49bb-aa94-2818d2c723fc","collection":"contentId-1507398706","type":"file","__fileName":"v91%20control%20label%20example.PNG?version=1&modificationDate=1686239127570&cacheVersion=1&api=v2&effects=drop-shadow&width=583&height=131","height":196}}]},{"type":"paragraph","content":[{"text":"In the Label field, type this HTML: Password: 6 characters .","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":104913,"__fileMimeType":"application/octet-stream","width":1420,"id":"e99e2db6-27bf-4df6-aece-ed47b2f9b7db","collection":"contentId-1507398706","type":"file","__fileName":"v91%20control%20label%20with%20html.PNG?version=1&modificationDate=1686239125126&cacheVersion=1&api=v2&effects=drop-shadow&width=790&height=250","height":494}}]},{"type":"paragraph","content":[{"text":"When typing labels you are free to use any special characters with the exception of the less-than sign (<). If you need a less-than sign in your label, substitute the characters ","type":"text"},{"text":"<","type":"text","marks":[{"type":"strong"}]},{"text":" (with no spaces between) for the less-than symbol.","type":"text"}]},{"type":"paragraph","content":[{"text":"Labels can also contain templates that will be replaced by values entered into your form as the form is used. See ","type":"text"},{"text":"Templatized Strings","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"spaceKey":"frevvo111","isRenamedTitle":true,"linkType":"page","contentTitle":"Templatized Strings","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/frevvo111/pages/1161962482"}}]},{"text":" for details.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that a control's name defaults to its label minus any spaces and special characters. Spaces and special characters are removed in order to make the name valid for use in rules and, for XML users, valid as an xsd schema element name. If the name begins with a numeral (for example,","type":"text"},{"text":"123Name","type":"text","marks":[{"type":"strong"}]},{"text":"), DocuPhase Forms prepends an underscore to it (for example, _123Name) to make it a valid XSD element name. Control names will be truncated to 32 characters for all the controls except triggers and panels.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also note that if you have two controls with the same label, the control's name will automatically be made unique. If you try to edit the name such that it would no longer be unique, DocuPhase Forms will prevent the edit.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"The < sign is not allowed in a label for Input controls. ","type":"text"},{"text":"Searchable Fields","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"spaceKey":"frevvo111","isRenamedTitle":true,"linkType":"page","contentTitle":"Edit Settings","anchorName":"SetupSearchableFields","versionAtSave":"2"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/frevvo111/pages/1161958855#EditSettings-SetupSearchableFields"}}]},{"text":" with values that contain the < sign will not display completely in the ","type":"text"},{"text":"Submissions Table","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"spaceKey":"frevvo111","isRenamedTitle":true,"linkType":"page","contentTitle":"Submissions Stored Inside of frevvo","anchorName":"SubmissionsTable","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/frevvo111/pages/1161964254#SubmissionsStoredInsideoffrevvo-SubmissionsTable"}}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Control Type","type":"text"}]},{"type":"paragraph","content":[{"text":"This applies to selection controls (dropdowns, radios, and checkboxes) and most input controls (text, text area, email, phone, quantity, number, table, and repeat) and is populated automatically when you first drag in a control. You can change this property if you want to switch a control in your form to a different type of control. This saves you from having to remove the original control and drag in a new one. The Control Type property is also used to change a date control to a time or date/time control. See ","type":"text"},{"text":"Date, Time, Date/Time","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"Date,Time,Date/Time","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-Date,Time,Date/Time"}}]},{"text":" for more information.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":43,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":33995,"__fileMimeType":"image/png","width":680,"id":"36114516-84c5-4a02-bafb-8e1a08ca0bff","collection":"contentId-816782515","type":"file","__fileName":"v91 Control Type Dropdown.PNG","height":576}}]},{"type":"paragraph","content":[{"text":"There are some limitations: you cannot change a selection control to an input control or vice versa. This means you easily can switch a checkbox to a dropdown list, but you cannot use this property to change a checkbox to a text control. ","type":"text"}]},{"type":"paragraph","content":[{"text":"This property is also useful for verifying what kind of controls are in your form. Since you assign new labels to your controls after you drag them in, you occasionally might forget whether you are looking at a text control or phone control, for example. This property lets you know what kind of controls are in your form no matter what the labels say. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If your control was generated from a schema element, it will have a ","type":"text"},{"text":"DisplayAs","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#Display-As"}}]},{"text":" property instead of a Control Type property. ","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"On this page","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"_parentId":{"value":"1507398706"},"style":{"value":"default"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"84a14f65-4a5a-4ec7-9097-6d87bb424c53"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"fa7d0ff1-3a24-423a-8028-5ad3799e5612"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Convert Repeat to Table or Table to Repeat","type":"text"}]},{"type":"paragraph","content":[{"text":"A repeat control can be changed to a table control and vice versa by selecting the appropriate option in the Control Type dropdown. These controls can be changed whether you drag and drop the table or repeat from the palette or populate the form with these controls from schema.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"__fileSize":29095,"__fileMimeType":"image/png","width":680,"id":"92852c66-6534-44b7-ac11-5e5d584dd9ca","collection":"contentId-816782515","type":"file","__fileName":"v91 Repeat Type Dropdown.PNG","height":477}}]},{"type":"paragraph","content":[{"text":"For example, an Address Book form that contains a section with controls for First and Last Name, Home and Cell Phones, Street, City, State, and Zip code is dropped into a repeat control by the forms designer. The min and max values for the repeat are set to 1 and 10 respectively. The designer then decides to change the Control Type of the Repeat Control to a Table by selecting this option from the dropdown.","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":566,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":256256,"__fileMimeType":"image/png","width":1661,"alt":"image-20240605-181646.png","id":"8b410c76-3c94-449f-9339-c7ff355e87f3","collection":"contentId-1507398706","type":"file","__fileName":"image-20240605-181646.png","height":1136}},{"type":"caption","content":[{"text":"Address Book controls in a Section in a Repeat (Design Mode)","type":"text"}]}]},{"type":"paragraph"}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":566,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":194262,"__fileMimeType":"image/png","width":1663,"alt":"image-20240605-181726.png","id":"99f826ae-e037-4897-9a8b-71285586e734","collection":"contentId-1507398706","type":"file","__fileName":"image-20240605-181726.png","height":632}},{"type":"caption","content":[{"text":"Address Book Repeat changed to Table (Design Mode)","type":"text"}]}]},{"type":"paragraph"}]}]},{"type":"paragraph","content":[{"text":"Notice each control in the Repeating section becomes a column in the table. The min/max values for the table are the same as the repeating section. ","type":"text"}]},{"type":"paragraph","content":[{"text":"A from-schema repeat that does not contain a section cannot be converted to a table. Schemas with a sectionless repeat with just a single control cannot be converted to a table. You will see the message \"Cannot change type on a sectionless, from-schema Repeat\" if you attempt the conversion in either of these situations. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":437,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":13974,"__fileMimeType":"image/png","width":400,"id":"4e3bfbfe-4f90-44f2-a2c7-fff780d66bde","collection":"contentId-816782515","type":"file","__fileName":"RepeattoTableError.png","height":121}}]},{"type":"paragraph","content":[{"text":"Attempting to convert an empty repeat or a repeat that contains an empty section to a table, will display the error \"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Cannot change type on an empty Repeat\". ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":616,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":23199,"__fileMimeType":"image/png","width":1839,"id":"f4933103-6c9c-49f0-96b5-136098892324","collection":"contentId-816782515","type":"file","__fileName":"v92 Cannot Change Type on Empty Repeat message.PNG","height":252}}]},{"type":"paragraph","content":[{"text":"Repeats with nested panels and sections can be converted to a table. The input controls inside the panels and sections are added to the table as columns. Here is an example of a repeat control with a section with panels that contain Contact Name, Email and Phone input controls.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":538,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":47659,"__fileMimeType":"image/png","width":1280,"id":"426a3bca-4bb7-45b8-9764-3a64f7efd03f","collection":"contentId-1507398706","type":"file","__fileName":"v10 Section with Panels inside Repeat.png","height":632}}]},{"type":"paragraph","content":[{"text":"Here is what the Repeat control looks like after it has been converted to a table in the designer. Notice the three input controls become columns in the table.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":786,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":162935,"__fileMimeType":"image/png","width":1670,"alt":"image-20240605-182535.png","id":"eb64eefa-402f-4d88-91ae-552a80b13667","collection":"contentId-1507398706","type":"file","__fileName":"image-20240605-182535.png","height":596}}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"The Printable, Hide Label, and Background Color properties transfer according to the statements below when converting a table to a repeat and vice versa:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When converting a table to a repeat, the table's printable property is transferred to each section in the new repeat. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When converting a table to a repeat, the column's hide label property is transferred to the corresponding control. When converting a repeat to a table, the control's hide label property is not transferred to the column. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When converting a table to a repeat, you can set the background color on both the column and individual cells. Only the background color on the cells is transferred to the corresponding repeat control. When converting a table to a repeat to a table, the control background color is transferred to the table cell background color.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"When you change a table to a repeat or vice versa and there are referencing rules, it is recommended that you verify that your rules still work. See ","type":"text"},{"text":"Rule Examples","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Rule Examples","versionAtSave":"10"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400609"}}]},{"text":" for more information.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Name","type":"text"}]},{"type":"paragraph","content":[{"text":"Every control has a name. The name is automatically generated and defaults to the control's label minus any spaces and special characters. Spaces and special characters are removed in order to make the name valid for use in rules and, for XML users, this makes the name valid as a xsd schema element name. Control names will be truncated to 32 characters for all the controls except triggers and panels. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have two controls with the same label and at the same level, the control's name will automatically be made unique. If you try to edit the name such that it would no longer be unique, DocuPhase Forms will prevent the edit. In order to use a control in a rule the name must be unique in your form. When a control is dropped inside a section control, it is at a different nesting level than a control dropped outside a section. Also two controls, one inside a section called Car and another in a section called Boat are also at different nesting levels. In both cases, the form designer will allow you to name the controls the same. For example, both Car and Boat can contain a control named VIN. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Important Tips for Control Names","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do not name your controls ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"action ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"or ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"method","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":". These are reserved names. If you use these names your form will not properly submit or cancel and may cause an HTTP 404 error when the users try to submit or cancel. Also, avoid using JavaScript Reserved Keywords as control identifier names as these words have a special function in the JavaScript language. Click ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"here","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"http://www.quackit.com/javascript/javascript_reserved_words.cfm"}}]},{"text":" for a partial list.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do not name your controls ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"form.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" This is a reserved word and may cause rules to fail and other unexpected issues.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use English alphabet characters only when naming controls. For example, controls named with ó as in Póliza may cause issues when the control is used in a business rule and with submission data.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Control Names cannot start with a number. If you attempt to name a control starting with a number, such as \"1Name\" it will automatically be corrected to \"_1Name.\" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DocuPhase Forms recommends unique names even if controls are in different nesting levels","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" to improve clarity when using wizards and connectors. Controls with the same name, even at different nesting levels, will cause problems with","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rules based on or affecting the controls.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Templatized strings referencing the controls in Form Actions, Doc Actions, Properties, etc.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PDF Mapping of those controls.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The Name property is instrumental in several usages within DocuPhase Forms: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name is how you refer to your control in ","type":"text"},{"text":"Rules","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Working with Rules","anchorName":"ControlName","versionAtSave":"2"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400097#WorkingwithRules-ControlName"}}]},{"text":". ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name is also used when initializing form fields via the DocuPhase Forms ","type":"text"},{"text":"_data URL parameter","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Initializing Forms with Data","anchorName":"UrlParameters","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507404101#InitializingFormswithData-UrlParameters"}}]},{"text":" for controls added from the palette. ","type":"text"},{"type":"hardBreak"},{"text":"Note: For controls added from XSD schema, you must use the underlying element name to initialize the control via _data. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name is how you refer to form fields from ","type":"text"},{"text":"Document URIs","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Form and Doc Actions","anchorName":"DocURIWizards","versionAtSave":"23"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399767#FormandDocActions-DocURIWizards"}}]},{"text":". ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name is used in Form Action ","type":"text"},{"text":"Display Message and Go to URL Templates","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Form and Doc Actions","anchorName":"UsingTemplatesinForm/Doc/ErrorActions","versionAtSave":"23"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399767#FormandDocActions-UsingTemplatesinForm/Doc/ErrorActions"}}]},{"text":". ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name is used in Doc Action ","type":"text"},{"text":"Email Address Templates","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Email Integration","versionAtSave":"8"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507412258"}}]},{"text":". ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This is the name given to the XML element corresponding to the control you drag into your form from the palette.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"You can change the Name of controls from schema, although schema controls maintain their underlying XSD element name. For example, suppose you are using controls from two schemas in a form and both contain a control named ''FName''. You could change the name of one of these controls to ''FirstName'' to make them unique within the form. This is helpful if you're adding rules to the form, or if you want to use the form as a template.","type":"text"}]},{"type":"paragraph","content":[{"text":"Except for _data, controls from XSD use the same rules (as above) as controls from the palette. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"HRef","type":"text"}]},{"type":"paragraph","content":[{"text":"This property applies only to the Link control. Enter the URL that you want to add to your form. Checking the New Window checkbox will open the URL in a new browser window. The use of ","type":"text"},{"text":"Templates","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Templatized Strings","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507403162"}}]},{"text":" is supported in this property.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":60.0},"content":[{"type":"media","attrs":{"__fileSize":68424,"__fileMimeType":"image/png","width":1280,"id":"93011b31-b31a-4a2a-97bb-c0b6b19ae7b5","collection":"contentId-1507398706","type":"file","__fileName":"v10 Link Control Properties.PNG","height":731}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Pattern","type":"text"}]},{"type":"paragraph","content":[{"text":"Most controls automatically ensure that users provide the correct data type, but patterns give you the flexibility to impose additional restrictions on what users enter in a particular control.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the Pattern field in the Properties area, type your pattern using ","type":"text"},{"text":"XML schema regular expressions","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.w3.org/TR/xmlschema-2/#regexs"}}]},{"text":". Check this ","type":"text"},{"text":"site","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.regular-expressions.info/xml.html"}}]},{"text":" for more information. A simple example is a pattern that restricts a text control to only allow strings formatted as a US zip code: \\d{5}|\\d{5}-\\d{4}. If you type this expression in the Patterns property, your form will permit values entered into this field only if they are five digits or five digits followed by the '-' character, followed by 4 digits. ","type":"text"}]},{"type":"paragraph","content":[{"text":"When you define patterns you don’t have to restrict what the control handles automatically. It is not necessary to enter a pattern [a-z] for a Number control, since users can’t type letters in a number field anyway. Since essentially you would be attempting to expand the allowed data types in the control, DocuPhase Forms would ignore this pattern if you entered it.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"You have to first save the form before the pattern takes effect. Thus patterns cannot be tested in the form designer, only in use mode.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"Patterns and Validation","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Valid Forms","anchorName":"Patterns","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507404198#ValidForms-Patterns"}}]},{"text":" for more information and example patterns.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Hint","type":"text"}]},{"type":"paragraph","content":[{"text":"This property lets you create a tooltip that will display in your form when the user mouses over the control. Simply type the text for your tooltip in the Hint field. The Hint property does not support HTML markup.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Help","type":"text"}]},{"type":"paragraph","content":[{"text":"This property lets you provide your users with more detailed help about a specific control. If you enter text here, an ","type":"text"},{"type":"mediaInline","attrs":{"width":17,"alt":"v11.3 Help Info icon.PNG","id":"9a78e25d-2c5d-4b0a-a9a2-b3aee3b4aa4a","collection":"contentId-1507398706","type":"image","height":15}},{"text":" icon will appear next to the control on your form. When the user clicks ","type":"text"},{"type":"mediaInline","attrs":{"width":17,"alt":"v11.3 Help Info icon.PNG","id":"9a78e25d-2c5d-4b0a-a9a2-b3aee3b4aa4a","collection":"contentId-1507398706","type":"image","height":15}},{"text":", the help text you supplied in the Help property will be displayed in a floating box.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":13751,"__fileMimeType":"image/png","width":614,"id":"b80b90cc-bb6c-4750-ba2e-91281d715ca8","collection":"contentId-816782515","type":"file","__fileName":"v91 Help Text Example.PNG","height":236}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Decorator","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The designer can provide helpful hints for users using the Decorator property. This is a great way to visually enhance the look and feel of your forms/workflows.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":701,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":155797,"__fileMimeType":"image/png","width":998,"alt":"image-20240605-182748.png","id":"59c834f3-0e59-4018-beb1-b95618c58d57","collection":"contentId-1507398706","type":"file","__fileName":"image-20240605-182748.png","height":653}}]},{"type":"paragraph","content":[{"text":"Decorators are on by default. You can control this via a decorator checkbox on the ","type":"text"},{"text":"Form Setting Properties","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Edit Settings","anchorName":"Decorated","versionAtSave":"6"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399427#EditSettings-Decorated"}}]},{"text":". If decorators are turned on, when you drag an input control from the palette, it shows a default decorator. The default depends on the type of control being dragged in. You can change the decorator for individual controls by selecting one from the dropdown list. An icon appears on the left side of input controls. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Decorators do not appear in snapshots (PDFs). Decorators will disappear when a decorated control is dropped into a table. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Date, Time & Date/Time controls have a decorator checkbox instead of a dropdown. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":266,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":42451,"__fileMimeType":"image/png","width":606,"id":"7507e4a6-9fc2-4389-8fd8-d9e9d6c2120d","collection":"contentId-816782515","type":"file","__fileName":"v91 Date Control Properties.PNG","height":814}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Placeholder","type":"text"}]},{"type":"paragraph","content":[{"text":"Enter text in this field and it will appear in your input control until the user enters some data. When data is entered, the placeholder disappears. If data is removed, it reappears. Placeholders do not appear in snapshots (PDFs). You may have noticed the placeholder in the username field on the DocuPhase Forms login screen.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":311,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":13887,"__fileMimeType":"image/png","width":236,"alt":"6a0e6d02-db02-4bf8-85cd-0896892fc206.png","id":"da84bca4-92ae-48c4-add4-e6b6dc9f2627","collection":"contentId-1507398706","type":"file","__fileName":"6a0e6d02-db02-4bf8-85cd-0896892fc206.png","height":84}}]},{"type":"paragraph","content":[{"text":" Placeholders for Date and Time controls are not supported in iOS.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Error Message","type":"text"}]},{"type":"paragraph","content":[{"text":"This lets you display a specific error message if the user does not supply a valid value in the control. If you leave this property blank users will get generic feedback (an “invalid value” message, for example) if they supply a bad value—but if you use this property, you can make the error message more helpful. The Error Message property does not support HTML markup.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, if you are using a pattern that requires the user to enter an area code of 203 in a phone control, you can use the Error Message property to let users know this explicitly if they try to enter a different area code.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":342,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":3323,"__fileMimeType":"image/png","width":398,"id":"fef31499-31c8-42b6-8d27-c56404204d2d","collection":"contentId-816782515","type":"file","__fileName":"SettingPropertiesPhoneErrorMessage.png","height":79}}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The error message only displays when an invalid value has been entered. Required empty fields are always displayed with a yellow or orange background. If the ","type":"text"},{"text":"Accessible ","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Edit Settings","anchorName":"Accessible","versionAtSave":"6"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399427#EditSettings-Accessible"}}]},{"text":"property is checked, the error message \"You can't leave this empty\" - not the error message text configured by the designer - will display. ","type":"text"},{"text":"The 'You can't leave this empty:' string can is included in the downloaded file used for form/workflow ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"internationalization","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Multi Language Support","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507407348"}}]},{"text":". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"paragraph","content":[{"text":"Refer to the ","type":"text"},{"text":"Table","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"Table","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-Table"}}]},{"text":" control for information on error messages and columns in a table.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Display As","type":"text"}]},{"type":"paragraph","content":[{"text":"This property applies only to controls generated from XSD schema elements. (If the control was dragged in from the palette, it has a ","type":"text"},{"text":"Control Type","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#Control-Type"}}]},{"text":" property). ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":231,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":22836,"__fileMimeType":"image/png","width":362,"id":"6f4a1919-726e-4958-b0ee-33382ad677cb","collection":"contentId-816782515","type":"file","__fileName":"v91 Display As property.PNG","height":606}}]},{"type":"paragraph","content":[{"text":"Use the Display As property to change the way your control looks on your form (for example, to change a text control to a dropdown, select dropdown from the list of allowable controls). This will change the control's appearance ","type":"text"},{"text":"but will not affect how the control validates data","type":"text","marks":[{"type":"strong"}]},{"text":". If you need to modify the control's validation behavior, you must ","type":"text"},{"text":"update the schema","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Data Sources","anchorName":"UpdatingaSchema","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507403283#DataSources-UpdatingaSchema"}}]},{"text":". See ","type":"text"},{"text":"Data Sources","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Data Sources","anchorName":"DisplayAs","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507403283#DataSources-DisplayAs"}}]},{"text":" for further information. The Display As property is not available for the following schema controls: Message, Date, Time, Date/Time and T/F. Repeat controls can only be changed to tables and vice versa.","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"When you change a table to a repeat or vice versa and there are referencing rules, it is recommended that you verify that your rules still work. See ","type":"text"},{"text":"Rule Examples","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Rule Examples","versionAtSave":"10"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400609"}}]},{"text":" for more information.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"DocuPhase Forms Type","type":"text"}]},{"type":"paragraph","content":[{"text":"This property applies only to controls generated from XSD schema elements that contain information.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":251,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":58860,"__fileMimeType":"image/png","width":609,"id":"3b15491f-ad15-4a8d-9140-0b2cb921edb3","collection":"contentId-816782515","type":"file","__fileName":"v91 Frevvo Type example.PNG","height":983}}]},{"type":"paragraph","content":[{"text":" Refer to the ","type":"text"},{"text":"Data Sources","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Data Sources","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507403283"}}]},{"text":" topic for information about frevvo XSD annotations. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Date, Time, Date/Time Formats","type":"text"}]},{"type":"paragraph","content":[{"text":"Designers can select formats for Date, Time, and Date/Time controls from a variety of options. The Date Format only controls what the user sees in the form and not ","type":"text"},{"text":"what is stored in the submission xml","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"DateTimeandDateTimeSubmissionValues","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-DateTimeandDateTimeSubmissionValues"}}]},{"text":". ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Date Format","type":"text"}]},{"type":"paragraph","content":[{"text":"The Date Format property applies to Date controls and the Date portion of the Date/Time control. The default, recommended format is \"Automatic\", which is a locale-specific date format. The designer has the option to set a particular date format independent of the locale by using the format field, but this is not recommended. ","type":"text"},{"text":"Read ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"this documentation","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Multi Language Support","anchorName":"DateandTimeControls","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507407348#MultiLanguageSupport-DateandTimeControls"}}]},{"text":" for more information about date controls and internationalization. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"paragraph","content":[{"text":"Available Date Formats consist of three different separators (dash '-', slash '/', or period '.') and four date display formats (DD/MM/YYYY, MM/DD/YYYY, YYYY/MM/DD, or Mmm/DD/YYYY). European date formatting is supported. ","type":"text"}]},{"type":"paragraph","content":[{"text":"When the Date Format property is set to a specific format, dates entered into the form are translated according to the selected format and will be reformatted to match the selected format.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A date typed into a form field will be reformatted to match the selected Date Format ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A date entered into a form field will be translated according to the selected format. For example, if you choose a European format of DD-MM-YYYY and the user enters 10-05-2009, the date value will be translated as May 10, 2009. If you choose a US format of MM-DD-YYY the date value will be translated as October 5, 2009. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Any of the three separators will be valid for date entry but will be translated to the selected separator. For example, if you choose a format of MM/DD/YYY and the user enters 10-05-2009, the date will display 10/05/2009.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dates entered like Feb 3, 2001 will be translated into the specified format.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":317,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":21542,"__fileMimeType":"image/png","width":656,"id":"76307479-778a-47e1-a9de-f1aa8cd1292d","collection":"contentId-816782515","type":"file","__fileName":"v91 Date Format Examples.PNG","height":411}}]},{"type":"paragraph","content":[{"text":"frevvo adjusts dates expressed with a two-digit year to be within 80 years before or 20 years after. For example, using a pattern of \"MM/DD/YY\" and the current date/time of Jan 1, 1997, the string \"01/11/12\" would be interpreted as Jan 11, 2012 while the string \"05/04/64\" would be interpreted as May 4, 1964. During parsing, only year strings consisting of exactly two digits will be parsed into the default century. Any other numeric string, such as a one-digit string, a three- or more digit string, or a two-digit string that isn't all digits, is interpreted literally. So \"01/02/3\" or \"01/02/003\" are parsed, using the same pattern, as Jan 2, 3 AD. Likewise, \"01/02/-3\" is parsed as Jan 2, 4 BC. DocuPhase Forms will always format as 4-digit years. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The date will be converted to the standard xsd:date format of yyyy-mm-dd in the submissions XML document. Here is an example: ","type":"text"},{"text":"2012-03-06","type":"text","marks":[{"type":"strong"}]},{"text":". Refer to ","type":"text"},{"text":"Viewing XML Documents","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/pages/createpage.action?spaceKey=frevvo102&title=Submissions%20Stored%20Inside%20of%20frevvo%20-%20Legacy%20View"}}]},{"text":" for more details.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Rules","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Working with Rules","anchorName":"DatesandTimes","versionAtSave":"2"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400097#WorkingwithRules-DatesandTimes"}}]},{"text":" can be applied to the Date control in all variations.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Time Format","type":"text"}]},{"type":"paragraph","content":[{"text":"The Time Format property applies to the Time control type. The default recommended format is \"Automatic\", which is a locale-specific time format. The designer has the option to set a particular time format independent of the locale by using the format field, but this is not recommended. Read ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"this documentation","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Multi Language Support","anchorName":"DateandTimeControls","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507407348#MultiLanguageSupport-DateandTimeControls"}}]},{"text":" for more information about time controls and internationalization. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"paragraph","content":[{"text":"If you keep the default \"Automatic\" format, you can enter data into a Time control using any of the formats shown in the table. The Time control will accept and display the values as shown: ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":940,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":42132,"__fileMimeType":"image/png","width":1536,"id":"be0747c0-4087-4a69-a990-d96baa69868d","collection":"contentId-816782515","type":"file","__fileName":"Time Control Values Chart.PNG","height":278}}]},{"type":"paragraph","content":[{"text":"The Time Format dropdown provides variations of military and standard time conventions, with either colon or period separators.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":317,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":16531,"__fileMimeType":"image/png","width":365,"id":"77abe2d9-d50d-44f8-9e37-ee89a314ab0e","collection":"contentId-816782515","type":"file","__fileName":"v91 Time Format List.PNG","height":485}}]},{"type":"paragraph","content":[{"text":"When the Time Format property is set to a specific format, time entries entered into the form are reformatted to match the selected format. For example, if you choose a military time format of hh:mm:ss and enter 2:00 PM the time value will display in the form as 14:00:00.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":583,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":24180,"__fileMimeType":"image/gif","width":948,"id":"1c423c32-4f8b-44e3-b048-84a621af17e1","collection":"contentId-816782515","type":"file","__fileName":"v91 Time Format Movie.gif","height":150}}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The time will be converted to the standard xsd:time format of hh","type":"text"},{"text":":mm:ss","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":" in the submissions XML document. Here is an example: ","type":"text"},{"text":"14:00:00","type":"text","marks":[{"type":"strong"}]},{"text":". Refer to ","type":"text"},{"text":"Viewing XML Documents","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/pages/createpage.action?spaceKey=frevvo102&title=Submissions%20Stored%20Inside%20of%20frevvo%20-%20Legacy%20View"}}]},{"text":" for more details.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Rules","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Working with Rules","anchorName":"DatesandTimes","versionAtSave":"2"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400097#WorkingwithRules-DatesandTimes"}}]},{"text":" can be applied to the Time control in all variations.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Date/Time Format","type":"text"}]},{"type":"paragraph","content":[{"text":"Date/Time controls display both the Date Format and Time Format dropdown menus in the properties panel. ","type":"text"},{"text":"Rules","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Working with Rules","anchorName":"DatesandTimes","versionAtSave":"2"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400097#WorkingwithRules-DatesandTimes"}}]},{"text":" can be applied to the Date control in all variations. There are ","type":"text"},{"text":"some additional considerations for the Date/Time control:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"W","type":"text"},{"text":"hen you enter a date in the date portion of the date/time control (or select the date with the date picker), it will automatically fill the time portion of the control with a value for 12:00 AM. The value displayed depends on the time format selected: For example: ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

Time Format	Default Time Display
hh:mm	00:00
hh:mm PM	12:00 AM
hh:mm:ss	00:00:00
hh:mm:ss PM	12:00:00 AM

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"table","attrs":{"__autoSize":true},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Time Format","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Default Time Display","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"hh:mm","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"00:00","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"hh:mm PM","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"12:00 AM","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"hh:mm:ss","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"00:00:00","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"hh:mm:ss","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" PM","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"12:00:00 AM","type":"text","marks":[{"type":"strong"}]}]}]}]}]}],"version":1},"reason":"A table in list item can't be created or edited in the new editor."}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The date picker is included in the date portion of the date/time control. You can hide/disable it by unchecking the ","type":"text"},{"text":"Date Picker","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Style Properties","anchorName":"DatePicker","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399031#StyleProperties-DatePicker"}}]},{"text":" checkbox on the Style tab.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You cannot enter a time value without a date value. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The time input field cannot be labeled. It is recommended that the label for the date portion be descriptive enough to include the time portion. If the date and time labels over the appropriate input fields are required, two separate controls can be used or the label for the date portion can be extended over the time input field, as shown in the image below:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":354,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":3367,"__fileMimeType":"image/png","width":400,"id":"31c2fe33-9e34-4154-8eff-6d2097e01e9c","collection":"contentId-816782515","type":"file","__fileName":"v91 Order Date Time Label.PNG","height":95}}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The local time will be converted to and saved in UTC format and the date will be converted to the standard xsd:datetime format of ","type":"text"},{"text":"yyyy-mm-dd","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"T","type":"text","marks":[{"type":"strong"}]},{"text":"hh:mm:ss","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"Z","type":"text","marks":[{"type":"strong"}]},{"text":" in the submission XML document. Here is an example: ","type":"text"},{"text":"2013-08-12T19:13:00Z","type":"text","marks":[{"type":"strong"}]},{"text":". Refer to ","type":"text"},{"text":"Viewing XML Documents","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/pages/createpage.action?spaceKey=frevvo102&title=Submissions%20Stored%20Inside%20of%20frevvo%20-%20Legacy%20View"}}]},{"text":" for more details. ","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Date and Time Format on Mobile Devices","type":"text"}]},{"type":"paragraph","content":[{"text":"Mobile devices support limited date, time, and date/time formats. For example, if you have a date control in your form formatted mm/dd/yyyy and you use that control name as a template in the ","type":"text"},{"text":"Form Action Message","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Form and Doc Actions","anchorName":"DisplayMessagewhenUserSubmitsForm","versionAtSave":"23"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399767#FormandDocActions-DisplayMessagewhenUserSubmitsForm"}}]},{"text":", you will notice that the message displayed after submitting is in the correct format on desktop view, but changes to yyyy-mm-dd on the mobile view. This is expected and may vary by device and OS. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Similarly, if you have a date field with a default date in your form it ","type":"text"},{"text":"must","type":"text","marks":[{"type":"strong"}]},{"text":" be formatted as YYYY-MM-DD in order for it to display correctly on mobile devices.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":561,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":123917,"__fileMimeType":"image/png","width":1280,"id":"15cffb3b-f7e2-4b96-bddd-b0929afef767","collection":"contentId-1507398706","type":"file","__fileName":"default date format.PNG","height":803}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"DocuPhase Forms recommends enabling the ","type":"text"},{"text":"date picker","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Style Properties","anchorName":"DatePicker","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399031#StyleProperties-DatePicker"}}]},{"text":" for forms that will be used on mobile devices to ensure the date is selected accurately.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Number Format","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"Number controls can display the decimal separator differently for different currencies and locales. By default, the format will respect the Form/Workflow Number Formatting and Currency setting. Specifically, this relates to the decimal separator which is a period in some locales and a comma in others. ","type":"text"}]},{"type":"paragraph","content":[{"text":"There are three options for the Number control format (specifically, the decimal separator).","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default (the default setting) will turn locale-based (automatic) formatting on or off based on the Number Formatting and Currency form/workflow property","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If Number Formatting and Currency is set, the Number control will use Automatic (locale-based) format. This will be true even if the property is set to a template that resolves to null or invalid.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If Number Formatting and Currency is ","type":"text"},{"text":"not ","type":"text","marks":[{"type":"strong"}]},{"text":"set, the Number control will use the original formatting of a period for the decimal separator regardless of locale.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Automatic respects the locale of the form user.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"None uses the original formatting of a period for the decimal separator regardless of locale.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":230,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":43845,"__fileMimeType":"image/png","width":230,"alt":"v11.3 Number Format property.PNG","id":"01fe20f7-fb04-4069-9e71-3df412b7a890","collection":"contentId-1507398706","type":"file","__fileName":"v11.3 Number Format property.PNG","height":241}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Currency","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"Forms can display money values for any currency formatted in the current user’s locale including symbol, thousands and decimal separators, and number of decimal places. The Currency property is set to Default on new controls, meaning that it picks up the Form/Workflow level Number Formatting and Currency setting. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The form designer can change it to any value in the dropdown list for each Money control, overriding the Form/Workflow setting for that control.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":274,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":69557,"__fileMimeType":"image/png","width":274,"alt":"v11.3 Money Control Currency Property.PNG","id":"d6e5524f-543d-42da-a4b7-4f592e7c9d24","collection":"contentId-1507398706","type":"file","__fileName":"v11.3 Money Control Currency Property.PNG","height":278}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The currency (at Form/Workflow level) can be dynamic, so for example the same form can be used in different offices situated in different countries, and each will display the currency correctly for that country. (Note that there is no currency conversion; the value of the control is as originally entered in the end user’s locale.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The currency symbol is locale-specific. For example, if you have a Money control set to Brazilian Real, but you view the form in the US locale, you would see the value with the “R$” currency indicator and the US money format: R$150.32. If you run the same form in the Brazil locale, you will see it formatted as 150,32 BRL.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Currency formatting applies to the form control, any snapshot generated from it and when that control is mapped to a pdf field. Formatting does not apply to other submission related views like dashboards, searchable, summary and export fields.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Max Length","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"This property is available for text controls and other input controls and limits how many characters users can supply in the control. Simply type a number (positive integer) in the Max Length field. Text area controls do not support this property due to an HTML limitation. However, it is very easy to add this functionality to the ","type":"text"},{"text":"text area control using a business rule","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Rule Examples","anchorName":"TextareaMaxLength","versionAtSave":"10"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400609#RuleExamples-TextareaMaxLength"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"# of Rows","type":"text"}]},{"type":"paragraph","content":[{"text":"This property applies only to text area controls and selection controls using the ","type":"text"},{"text":"Comment Property","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#Comment-Property"}}]},{"text":". This property lets you define the initial size of the text area. Scroll bars will appear automatically when the user reaches the # of rows you specify. The default value is 3 for the textarea controls and 1 for selection controls.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Required","type":"text"}]},{"type":"paragraph","content":[{"text":"Make a control required when you want to force users to enter a valid value in the control before they submit your form. To do this, check the Required checkbox in the Properties area. If the data is optional, leave the checkbox unchecked. ","type":"text"}]},{"type":"paragraph","content":[{"text":"As soon as you mark a control required, the empty control displays a yellowish background gradient. Until users populate all required controls with valid data, they will not be able to submit the form. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":2176,"__fileMimeType":"image/png","width":383,"id":"01d9845e-c59f-4610-8e12-d3b55b70924c","collection":"contentId-816782515","type":"file","__fileName":"v91 Required Control.PNG","height":72}}]},{"type":"paragraph","content":[{"text":"You can change the color displayed by Required fields by modifying a ","type":"text"},{"text":"Style","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Layouts and Styles","anchorName":"Example-ChangingthebackgroundcolorforRequiredFields","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507402758#LayoutsandStyles-Example-ChangingthebackgroundcolorforRequiredFields"}}]},{"text":" and then applying it to your form/workflow. If you prefer an asterisk to designate required fields, enable the ","type":"text"},{"text":"Accessibility","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Accessibility and frevvo","anchorName":"Designingformsflows","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507407305#Accessibilityandfrevvo-Designingformsflows"}}]},{"text":" feature by checking the Accessible property on the form/workflow Properties pane. This feature was built to allow visually impaired users to access forms. Enabling this property adds an asterisk (*) for all required fields. If users move ahead from that field without filling it, they will receive the error, \"You can't leave this empty .\"","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":721,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":209496,"__fileMimeType":"image/png","width":1280,"id":"da6b5277-e5e8-483c-a470-b4cd94e630cb","collection":"contentId-1507398706","type":"file","__fileName":"v10 Form Settings Accessible highlighted.PNG","height":852}}]},{"type":"paragraph","content":[{"text":"If you click on the Submit button in a form that contains invalid data or required fields that are empty, invalid controls will be highlighted with an orange border. The designer can use a message control to notify the user that fields need to be filled or data needs to be corrected before the form can be submitted. This can be very helpful to users when trying to determine why a form does not submit. Refer to this ","type":"text"},{"text":"Valid Forms topic","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Valid Forms","anchorName":"InvalidFormNotificationforUsers","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507404198#ValidForms-InvalidFormNotificationforUsers"}}]},{"text":" for the details.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":660,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":29177,"__fileMimeType":"image/png","width":942,"id":"582f7793-665a-47bc-b89b-e0c47f45a79a","collection":"contentId-816782515","type":"file","__fileName":"v91 Form with Required Error Message Control.PNG","height":668}}]},{"type":"paragraph","content":[{"text":"You cannot mark grouping controls (tabs, panels, and repeats) required. A section is one grouping control that does have a Required Property. If a Section has the required property checked, required controls within it show a yellow background in design and Use mode. If the Section has required unchecked, required controls within it DO NOT show the yellow background color in design and Use mode. The yellow background color appears only when one of the required controls in the section is filled making it mandatory to fill other required controls within the section. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Input controls that are direct children (directly inside) of repeat controls also cannot be marked required, nor do they need to be, since the min# and max# properties take care of this already. You may, however, make controls required when they are inside sections, tabs, and panels.","type":"text"}]},{"type":"paragraph","content":[{"text":"You cannot edit the required property for controls that have been generated from an uploaded schema, since the schema already specifies this via the minOccurs attribute. If a control from schema appears as required and you don't want it to be required, edit the XSD and set minOccurs=0. Re-upload the XSD. Then the control will no longer appear required.","type":"text"}]},{"type":"paragraph","content":[{"text":"This property is very useful when using rules to hide/show sections depending on something else in the form. If you hide the section you may have to set the required property to false. See these ","type":"text"},{"text":"examples","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"spaceKey":"frevvo101","isRenamedTitle":true,"linkType":"page","contentTitle":"Rules Examples (old)","anchorName":"ShoworHideControlsandWorkflowSteps","versionAtSave":"2"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/frevvo101/pages/1063223338#RulesExamples(old)-ShoworHideControlsandWorkflowSteps"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Options","type":"text"}]},{"type":"paragraph","content":[{"text":"Options for the Dropdown, Radio, and Checkbox controls can be populated using 2 methods:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Method 1 - Set Up Static Options for Dropdown, Radio or Checkbox controls in the form/workflow designers","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#Setting-Up-Static-Options"}}]},{"text":" - Designers enter the options at design time by typing them in the Options property for the chosen selection control. Options entered in this way are static - they will not change at runtime.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Method 2 - Set Up Dynamic Options for Dropdown, Radio or Checkbox controls with Control Properties","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#Setting-Up-Dynamic-Options-No-Coding-Needed"}}]},{"text":" - Dynamically populate options at runtime from an external RESTful web service source. The Dynamic Options feature uses Control properties to retrieve data from a web service and populate the selection control options. No coding is needed as required when using a business rule.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setting Up Static Options","type":"text"}]},{"type":"paragraph","content":[{"text":"This property allows you to populate the choices the user sees in dropdown, radio, and checkbox controls. Make sure the ","type":"text"},{"text":"Options Src","type":"text","marks":[{"type":"strong"}]},{"text":" property is set to the default value - ","type":"text"},{"text":"Design Time","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":280,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":17219,"__fileMimeType":"image/png","width":362,"id":"557d88ba-52f6-4b7e-b78e-bf0faac71a16","collection":"contentId-816782515","type":"file","__fileName":"v91 Selection Control Options Src.PNG","height":606}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Options Values and Labels","type":"text"}]},{"type":"paragraph","content":[{"text":"You may have option ","type":"text"},{"text":"values","type":"text","marks":[{"type":"strong"}]},{"text":" different from option ","type":"text"},{"text":"labels","type":"text","marks":[{"type":"strong"}]},{"text":". The syntax for the options is =. The is what is saved as the selected value when the user submits the form and the is what will be displayed on your form and ","type":"text"}]},{"type":"paragraph","content":[{"text":"When you first drag a selection control into your form it has generic values: Option 1, Option 2 and Option 3. To supply your own values, simply overlay the values in the Options property with the values you want and add more (or delete) as necessary.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not enter both and using the = syntax, then the value will default to the label. As soon as you tab off the options property, options without values will automatically be converted to the syntax.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Here the options are entered without values. In this case, DocuPhase Forms will default the value to the label. As soon as you tab out of the Options property the options will be automatically converted to the = syntax.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":28049,"__fileMimeType":"image/png","width":766,"id":"284279b7-e396-4c28-8f02-7e0c4d469148","collection":"contentId-816782515","type":"file","__fileName":"v91 Radio Options Same Value.PNG","height":216}}]},{"type":"paragraph","content":[{"text":"If you would like the submitted values to differ from the visible label then edit the options as follows. In this case the values are A, B, C, while the visible labels remain morning, afternoon, evening.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":20197,"__fileMimeType":"image/png","width":514,"id":"f6a9db04-8383-4d58-a36b-15a036b76e19","collection":"contentId-816782515","type":"file","__fileName":"v91 Radio Options Different Values.PNG","height":214}}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Design mode allows options with the same value and different labels. If you set the options of a Selection control as shown below then click the ","type":"text"},{"type":"emoji","attrs":{"id":"835db413-3e63-4556-9217-e22df9fcfe71","text":":Save_and_Test_icon:","shortName":":Save_and_Test_icon:"}},{"text":" save and test icon, you will only be able to select one option of the Selection Control in Test mode.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a=b","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a=c","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This can be an issue when working with ","type":"text"},{"text":"dynamic options","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#Setting-Up-Dynamic-Options-No-Coding-Needed"}}]},{"text":" controls. Designers must be careful that the web services they are using do not return data with duplicate values.","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Options Order","type":"text"}]},{"type":"paragraph","content":[{"text":"The order of choices in your control will match the order in the Properties area. If you have choices that need a logical order (you’d want a dropdown of US states to be sorted alphabetically, presumably), make sure the order is correct in the Properties area. (You can’t sort the text you enter in the Options property field but you can cut and paste.) See ","type":"text"},{"text":"this business rule example","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Rule Examples","anchorName":"RandomizeOptions","versionAtSave":"10"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400609#RuleExamples-RandomizeOptions"}}]},{"text":" for creating a randomized order, such as for a quiz question.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Dropdown Blank Option","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition to the generic Option 1, 2, and 3 choices, a dropdown control also includes a blank option that by default will appear first in the list. This blank option will appear no matter what text you supply in the Options property. You cannot remove the blank option but you can make one of the other options the default. See ","type":"text"},{"text":"Setting Defaults","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Default Values","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398663"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Special Characters in Options","type":"text"}]},{"type":"paragraph","content":[{"text":"What if you want a '=' character to appear in your options? Since the 1st equal sign is the delimiter between the value and the label, you can put an equal in the label as follows. For example, suppose you want your label to be \"good = gold.\" If you enter this as the option, what you'll see in your dropdown is the label \"gold.\" To solve this, use this options string: \"a=good = gold\". Now the label will be as you wish. Currently, if there is an equal sign in the label, it is not possible to also have an equal in the value. This will be supported in a future release.","type":"text"}]},{"type":"paragraph","content":[{"text":"The < sign is not allowed in an option label for Selection controls. ","type":"text"},{"text":"Searchable Fields","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Edit Settings","anchorName":"SetupSearchableFields","versionAtSave":"6"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399427#EditSettings-SetupSearchableFields"}}]},{"text":" with values that contain the < sign will not display completely in the ","type":"text"},{"text":"Submissions Table","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Submissions Stored Inside of frevvo","anchorName":"SubmissionsTable","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507404977#SubmissionsStoredInsideoffrevvo-SubmissionsTable"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"HTML Formatting for Option Labels","type":"text"}]},{"type":"paragraph","content":[{"text":"Options label may include HTML formatting. If you find that the HTML used does not display on the PDF Snapshot, change the ","type":"text"},{"text":"Print Font","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Form and Workflow Style Properties","anchorName":"PrintFont","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399989#FormandWorkflowStyleProperties-PrintFont"}}]},{"text":" to a font that supports the character/markup you are using. For example, if you use a checkmark as an options label (","type":"text"},{"text":"✓","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":"), use the DejaVu Sans print font which supports this character.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Options from Schema","type":"text"}]},{"type":"paragraph","content":[{"text":"The choices cannot be changed if they have been generated from an uploaded schema, since the schema specifies the choices. On controls generated from schema, you won’t see the Options property in the Properties area. However, you can change the option labels. See ","type":"text"},{"text":"the option labels documentation.","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=1507398706#SettingProperties-Labels"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Checkbox Values","type":"text"}]},{"type":"paragraph","content":[{"text":"Checkbox option values cannot contain spaces. For example, if you set your checkbox option to \"Black Cat=Black Cat\", it will automatically be converted to \"Black_Cat=Black Cat\" as soon as you tab out of the options property. This is because checkboxes are multi-select. When the form is submitted, space is used as the separator character for the checkbox control's value. Thus a space character cannot be in the value itself as it would be interpreted as a separator.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Comment Property","type":"text"}]},{"type":"paragraph","content":[{"text":"The Comment property is the easiest way to to provide a text box for the user to type in based on the selection of the last option in your selection control. Check the comment property and specify the number of text lines in the # Rows field. For example, a Product Category dropdown control has choices for Computers, Cell Phones, DVDs, TVs, and Other. If Other is selected, you can collect additional information by displaying a comment box. To accomplish this, the designer would list Other as the 5th option, check the comment box and specify the # of rows if more than the default value of 1 is required. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":437,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":59303,"__fileMimeType":"image/png","width":524,"id":"fc267d6c-40db-416f-8330-dc8d95c95aa9","collection":"contentId-816782515","type":"file","__fileName":"v91 Comment Property.PNG","height":411}}]},{"type":"paragraph","content":[{"text":"When Other is selected in Use mode for the Product category dropdown shown above, a 3-line text box displays where comments can be entered. If the ","type":"text"},{"text":"Required","type":"text","marks":[{"type":"link","attrs":{"href":"#Required"}}]},{"text":" property is checked for the dropdown control, then the comment box that opens on selecting the last option is also required. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":410,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":8058,"__fileMimeType":"image/png","width":401,"id":"538c7514-ec82-4095-88db-b5929bde3b8d","collection":"contentId-816782515","type":"file","__fileName":"v91 Comment Box.PNG","height":262}}]},{"type":"paragraph","content":[{"text":"The Comment property does not apply to the T/F control even though it is included in the selection control group. You can retrieve or set the value in the Comment property with a ","type":"text"},{"text":"business rule","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"spaceKey":"frevvo101","isRenamedTitle":true,"linkType":"page","contentTitle":"Rules Examples (old)","anchorName":"RetrievingorSettingtheCommentPropertyforSelectionControls","versionAtSave":"2"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/frevvo101/pages/1063223338#RulesExamples(old)-RetrievingorSettingtheCommentPropertyforSelectionControls"}}]},{"text":". If you want to templatize the Comment property, use the special syntax discussed in the ","type":"text"},{"text":"Template Syntax for the Comment Field of Selection Controls","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Templatized Strings","anchorName":"TemplateSyntaxfortheCommentFieldofSelectionControls","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507403162#TemplatizedStrings-TemplateSyntaxfortheCommentFieldofSelectionControls"}}]},{"text":" topic.","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"_parentId":{"value":"1507398706"},"atlassian-macro-output-type":{"value":"INLINE"}},"macroMetadata":{"macroId":{"value":"b5b4c92e-12c0-4e6d-941c-eab7d924d2af"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"c81ebab3-ccad-4acf-8882-f8385fc6d460"},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Setting Up Dynamic Options No Coding Needed ","type":"text"}]},{"type":"paragraph","content":[{"text":"Checkbox, Dropdown, and Radio controls support the ability to dynamically retrieve options at runtime from a RESTful web service. The Dynamic Options feature will ","type":"text"},{"text":"NOT","type":"text","marks":[{"type":"strong"}]},{"text":" work with SOAP web services. Using this feature with the ","type":"text"},{"text":"ComboBox control","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#Dynamic-Options-for-the-ComboBox-Control"}}]},{"text":" is described below.","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"frevvo supports data returned from RESTful web services formatted in either XML or JSON. The ","type":"text"},{"text":"DocuPhase Forms Database Connector","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Database Connector","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507409588"}}]},{"text":" is an example of a RESTful web service.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Dynamic Options feature requires: ","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The URL to the web service - include parameters and mappings that the service requires in the URL","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value and Label binding properties - Path(s) to retrieve the option data from the web service results data. Designers determine the values for these properties by examining the results returned by the web service in the Debug Console. This method is described below and in the ","type":"text"},{"text":"Dynamic Options Example","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#Dynamic-Options-Example"}}]},{"text":".","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"Watch ","type":"text"},{"text":"this 5-minute video","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.youtube.com/watch?v=KGFJbBNp8e0"}}]},{"text":" example of setting Dynamic Options using the DocuPhase Forms Database Connector.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"widget","parameters":{"macroParams":{"overlay":{"value":"youtube"},"_parentId":{"value":"1507398706"},"_template":{"value":"com/atlassian/confluence/extra/widgetconnector/templates/youtube.vm"},"width":{"value":"400px"},"url":{"value":"https://www.youtube.com/watch?v=KGFJbBNp8e0"},"height":{"value":"300px"}},"macroMetadata":{"macroId":{"value":"124c8933-c70c-4401-ba44-f10f8a254487"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://confluence-prod-eu-5-3.prod.atl-paas.net/wiki/plugins/servlet/widgetconnector/placeholder?thumb=https://img.youtube.com/vi/KGFJbBNp8e0/mqdefault.jpg&overlay=youtube&width=400&height=300"}}],"title":"Widget Connector"}},"localId":"365aab37-3abe-4b42-bc89-0750f176df4e"}},{"type":"paragraph","content":[{"text":"Follow these steps:","type":"text"},{"type":"hardBreak"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the selection control (Checkbox, Dropdown, Radio)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select Web Service from the ","type":"text"},{"text":"Option Src","type":"text","marks":[{"type":"strong"}]},{"text":" dropdown","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"f49f448e-9bd0-48c6-b0e7-a0dcb335e076","collection":"contentId-1507398706","height":"400"}}},{"type":"hardBreak"},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the URL of the RESTful web service that you are going to retrieve the option data from. Data is retrieved using HTTP GET. The URL can contain ","type":"text"},{"text":"templates","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Templatized Strings","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507403162"}}]},{"text":" and the options will be automatically updated whenever the value changes of any control referenced by a template in the URL. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Ex: /http(s)://10.0.0.27/:8081/database/BIRT/allCustomers?_mediaType=json - This URL returns a list of all customers from a database The _mediaType parameter specifies that JSON results are returned. In this example, the Database Connector integrates with the database to execute the query. The Database Connector is a Restful service that returns results in XML or JSON","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After entering the ","type":"text"},{"text":"Options URL","type":"text","marks":[{"type":"strong"}]},{"text":" for your web service, click the ","type":"text"},{"type":"emoji","attrs":{"id":"835db413-3e63-4556-9217-e22df9fcfe71","text":":Save_and_Test_icon:","shortName":":Save_and_Test_icon:"}},{"text":" ","type":"text"},{"text":"save and test ","type":"text","marks":[{"type":"strong"}]},{"text":"icon. Examine the results in the debug console to determine the ","type":"text"},{"text":"Value and Label Bindings","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The syntax for selection control options is =. The is what is saved as the selected value when the user submits the form or completes the workflow and the is what will be displayed on your form/workflow.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the ","type":"text"},{"text":"Value Binding","type":"text","marks":[{"type":"strong"}]},{"text":" - this is bind path of the option VALUES within the XML or JSON returned by the RESTful web service. Binding paths are specified with the ","type":"text"},{"text":"'/'","type":"text","marks":[{"type":"strong"}]},{"text":" character used as a delimiter i.e.","type":"text"},{"text":" /resultSet/CountryID","type":"text","marks":[{"type":"strong"}]},{"text":". The path locates the values to be extracted and set into the selection control options. If the data pointed to by the path is repeating, then the data extracted will be a collection of items. This is the value that will be stored in the XML submissions document when the form/workflow is submitted/completed.","type":"text"},{"type":"hardBreak"},{"text":"The Value Binding can be determined by examining the resultSet in the DocuPhase Forms debug console.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the ","type":"text"},{"text":"Label Binding","type":"text","marks":[{"type":"strong"}]},{"text":" - this is the bind path of the option display LABELS within the XML or JSON returned by the RESTful web service. This label is displayed in the selection control options in Use mode. The Label Binding can be determined from the debug console by examining the resultSet in the debug console. ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type the URL to your WebService in the ","type":"text"},{"text":"Options Source ","type":"text","marks":[{"type":"strong"}]},{"text":"property then click the ","type":"text"},{"type":"emoji","attrs":{"id":"835db413-3e63-4556-9217-e22df9fcfe71","text":":Save_and_Test_icon:","shortName":":Save_and_Test_icon:"}},{"text":" ","type":"text"},{"text":"save and test ","type":"text","marks":[{"type":"strong"}]},{"text":"icon. Examine the resultSet in the debug console to determine the Value binding. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1: Results returned in JSON format","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"If this is the JSON Data returned: \"totalResultsAvailable\":2,\n\"resultSet\":[{\"CountryName\":\"Argentina\",\"CountryID\":\"1\"},{\"CountryName\":\"Aruba\",\"CountryID\":\"12\"},{\"CountryName\":\"Bahamas\",\"CountryID\":\"13\"}]}\n\nIf the Value Binding property is set to /resultSet/CountryID - the country id of the selected country will be stored in the DocuPhase Forms submission\n\nIf the Label Binding is set to /resultSet/CountryName - the country names are what the user sees as the selection control options - Argentina, Aruba, Bahamas","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Example 2: Results returned in XML format","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"If the results are returned in XML: Notice that the XML uses namespaces and that they must be part of the bind path.\n\n\n\n \n 1\n Argentina\n \n \n 12\n Aruba\n \n \n 13\n Bahamas\n \n/BIRT/allCustomers?_mediaType=json. The Value Bindings is set to /resultSet/customerNumber and the Label Binding is set to /resultSet/customerName. This returns a list of customers from the database showing the Customer Name (Label) in the Dropdown options.","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"87216767-a447-4677-b3c0-661d8dfecd13","collection":"contentId-1507398706","height":"250"}}},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The Options URL for the second Dropdown uses the templatized value of the first Dropdown - {sc} - https:///database/BIRT/ordersByCustomer?cnum=","type":"text"},{"text":"{sc}","type":"text","marks":[{"type":"strong"}]},{"text":"&_mediaType=json. The Value Binding for this Dropdown is set to /resultSet/orderNumber and the Label Binding is set to /resultSet/orderDate. This was intended to return a list of orders using the value (Customer Number) of the customer selected in the first Dropdown. Note the use of the Select Customer template - {sc} in the Options URL.","type":"text"},{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If your options will have spaces, ","type":"text"},{"text":"append the URL","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.frevvo.com/d/display/frevvo91/Templatized+Strings#TemplatizedStrings-TemplatizedStringParameters"}}]},{"text":" with ","type":"text"},{"text":"!encode=true","type":"text","marks":[{"type":"strong"}]},{"text":" to accurately list options. An example of the the syntax is ","type":"text"},{"text":"{sc.value!encode=true}.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#1d1c1d"}}]}]}]},{"type":"mediaSingle","attrs":{"layout":"wide","width":100,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":133076,"__fileMimeType":"image/png","width":1280,"id":"f3050010-afde-46f2-9c5e-e38707fb1a76","collection":"contentId-1507398706","type":"file","__fileName":"v90DynamicOptions2.PNG","height":386}}]},{"type":"paragraph","content":[{"text":"When you test the form, the Customer dropdown is successfully populated but when a customer is selected, the Select Order Dropdown does not populate.","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"350","id":"e83a478f-ef37-4fd7-a328-46f3a82763b9","collection":"contentId-1507398706","height":""}}},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The Debug console shows this error:","type":"text"}]},{"type":"codeBlock","content":[{"text":"ERROR \tWEB_SERVICE \tso \tError calling web server end point: https://app.frevvo.com/database/BIRT/ordersByCustomer?cnum=Alpha Cognac&_mediaType=json\nInvalid uri 'https://app.frevvo.com/database/BIRT/ordersByCustomer?cnum=Alpha Cognac&_mediaType=json': Invalid query","type":"text"}]},{"type":"paragraph","content":[{"text":"This happens because the second dropdown is using the label of the first dropdown (instead of the value) while executing the web service call.","type":"text"}]},{"type":"paragraph","content":[{"text":"Changing the Select Order template - {sc} to {sc.value} in the Options URL for the Select Order Dropdown forces DocuPhase Forms to evaluate the template to the option value instead of the label and the query will return the expected results. Note the Select Customer template is {sc.value}.","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Options URL for the Select Orders Dropdwon","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"https:///database/BIRT/ordersByCustomer?cnum={sc.value}&_mediaType=json","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":770,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":175695,"__fileMimeType":"application/octet-stream","width":1321,"id":"b23b8d1c-be3a-41f1-a3bd-93df01854d7a","collection":"contentId-1507398706","type":"file","__fileName":"v90DynamicOptions3.PNG?version=1&modificationDate=1661277842419&cacheVersion=1&api=v2&&height=250","height":469}},{"type":"caption","content":[{"text":"Option URL for the Select Order Dropdown with {controlName.value}","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":510,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":68535,"__fileMimeType":"application/octet-stream","width":699,"id":"e90a28b2-4bcc-495a-be4d-129bc44ce7a0","collection":"contentId-1507398706","type":"file","__fileName":"80DynamicOptionsscreenwithscvalue.PNG?version=1&modificationDate=1661277841200&cacheVersion=1&api=v2&&height=400","height":493}},{"type":"caption","content":[{"text":"Runtime","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Dynamic Option Runtime Support in the Debug Console","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"When developing a form/workflow with selection controls with dynamic options, the designer needs to see returned results from an entry point in order to determine bind paths, troubleshoot end point urls, etc. Logging available in the \"Debug Console\" in test mode includes Web Service events such as:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The web service call being made with fully the resolved end point URL shown (Options URL)","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":8070,"__fileMimeType":"image/png","width":900,"id":"cc60e239-0fd7-472f-a9e2-5b2cbc9c2182","collection":"contentId-1507398706","type":"file","__fileName":"URLinDebug.PNG","height":102}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The web service data retrieved (JSON/XML)","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":197632,"__fileMimeType":"image/png","width":1280,"id":"fe8d9684-faf4-480d-a117-0ded66e6afe5","collection":"contentId-1507398706","type":"file","__fileName":"ResultsinDebugCombined.png","height":369}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Any errors received upon calling the web service.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":51017,"__fileMimeType":"image/png","width":800,"id":"46ec7329-8963-4df9-bf00-9168cd2660e1","collection":"contentId-1507398706","type":"file","__fileName":"DebugConsoleEnhancementsforDO.PNG","height":259}}]}]}]},{"type":"paragraph","content":[{"text":"If there is a runtime problem invoking a configured web service entry point, DocuPhase Forms will log a warning statement with a reason to the \\tomcat\\logs\\frevvo_YYYY-MM-DD logfile. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"08:03:55.177 |-WARN [http-nio-8080-exec-3] [amicPropertyHolderAdapter] - Error calling web service end point: https://api.edmunds.com/api/vehicle/v2/?state=new&year=2017&view=basic&fmt=json&api_key=p9v6s4uv6998k464u33m8jx3 Error: Service call failed with code: 404 (Not Found)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Timeouts for Non-responsive Web Services","type":"text"}]},{"type":"paragraph","content":[{"text":"A non-responsive web service call for dynamic options can hold-up a form/workflow indefinitely. Two timeouts have been added to DocuPhase Forms for socket read timeout and connection timeout. Both timeouts default to 30 seconds. ","type":"text"}]},{"type":"paragraph","content":[{"text":"They can be overridden by adding these parameters to the URL: ","type":"text"},{"text":"http.connection.timeout","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"http.socket.timeout","type":"text","marks":[{"type":"strong"}]},{"text":". Both are specified in milliseconds. These timeouts apply to web service calls from rules as well as doc actions, etc.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Secure Web Services","type":"text"}]},{"type":"paragraph","content":[{"text":"DocuPhase Forms supports Secure Web Service entry points that use HTTP basic authentication. The authentication credentials are entered in the ","type":"text"},{"text":"HTTP Authorization Credentials","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Manage Tenants","anchorName":"ConfigureHTTPAuthorizationCredentials","versionAtSave":"2"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507413710#ManageTenants-ConfigureHTTPAuthorizationCredentials"}}]},{"text":" section of the ","type":"text"},{"text":"Edit Tenant","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Manage Tenants","anchorName":"EditTenant","versionAtSave":"2"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507413710#ManageTenants-EditTenant"}}]},{"text":" screen by the tenant administrator. These HTTP credentials are used by the web service integration. Other authentication schemes in use by 3rd-party services are not supported.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Dynamic Options for the ComboBox Control","type":"text"}]},{"type":"paragraph","content":[{"text":"The ComboBox control supports three types of data retrieval: DocuPhase Forms Users, frevvo Roles and Web Service. Select the data source using the dropdown in the ","type":"text"},{"text":"Options Src ","type":"text","marks":[{"type":"strong"}]},{"text":"property. Selecting Web Service makes it possible to use the ComboBox to retrieve values from a database and enable a list of possible partial matches. There is also a blank option. Pick this one if you are going to ","type":"text"},{"text":"populate your ComboBox options using a business rule","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#ComboBox-Control-Properties-for-Business-Rules"}}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"frevvo Users","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" and","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":" frevvo Roles ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":"require security/authentication. When selecting ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"frevvo Users","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" and ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"frevvo Roles","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" as the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Option Src","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":", your form or workflow must be set to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Authenticated Users (login required)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Access Control and Shared Items","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507405643"}}]},{"text":". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Dynamic Options feature using the ComboBox will ","type":"text"},{"text":"NOT","type":"text","marks":[{"type":"strong"}]},{"text":" work with SOAP web services.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Here's how it works:","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the ComboBox to return a list of users/roles in the tenant where your form/workflow is located (current tenant). You cannot pull users/roles from a tenant other than the current one due to security restrictions.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Drag the ComboBox control into your form/workflow","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Options Src","type":"text","marks":[{"type":"strong"}]},{"text":" to one of two choices: ","type":"text"},{"text":"frevvo Users","type":"text","marks":[{"type":"strong"}]},{"text":" or ","type":"text"},{"text":"frevvo Roles","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Selecting ","type":"text"},{"text":"frevvo Users","type":"text","marks":[{"type":"strong"}]},{"text":" - returns a list of ","type":"text"},{"text":"ALL","type":"text","marks":[{"type":"strong"}]},{"text":" users in the current tenant.frevvo constructs a ","type":"text"},{"text":"URL:/frevvo/web/tn/{form.tenant.id}/users?match=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" then replaces the form.tenant.id template with the name of the current tenant.","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Selecting ","type":"text"},{"text":"frevvo Roles","type":"text","marks":[{"type":"strong"}]},{"text":" returns the list of ","type":"text"},{"text":"ALL","type":"text","marks":[{"type":"strong"}]},{"text":" roles in the current tenant. frevvo","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"constructs a ","type":"text"},{"text":"URL:/frevvo/web/tn/{form.tenant.id}/roles?match=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" then replaces the form.tenant.id template with the name of the current tenant.","type":"text"}]}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":75,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":73761,"__fileMimeType":"image/png","width":1016,"id":"7e99ba5f-b657-4a2a-8384-45fe4993ef24","collection":"contentId-1507398706","type":"file","__fileName":"v9.0ComboBoxProperties.PNG","height":792}}]},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ComboBox supports the ability to specify single or multiple values. Check the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Single Value","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" checkbox if you want to limit the choice to one value.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":5185,"__fileMimeType":"image/png","width":397,"id":"630ded20-2a16-45f1-85e9-16fad5592eb6","collection":"contentId-1507398706","type":"file","__fileName":"combobox5.PNG","height":116}}]},{"type":"paragraph","content":[{"text":"Users can typeahead to narrow the choices based on the letters entered. User ids and roles are case sensitive so remember to use the correct case when typing. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":7772,"__fileMimeType":"image/png","width":409,"id":"79fc044c-830a-4b30-9a1f-edd0ea5787d3","collection":"contentId-1507398706","type":"file","__fileName":"combobox3combined.png","height":200}}]},{"type":"orderedList","attrs":{"order":4},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Options Value Only","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" checkbox to restrict the ComboBox value to available options. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Options Value Only","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" is only available when ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Options Src","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" is set to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"frevvo Users","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" or ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"frevvo Roles.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"You cannot test the ComboBox Options in the form/workflow designers. Click the ","type":"text"},{"type":"emoji","attrs":{"id":"835db413-3e63-4556-9217-e22df9fcfe71","text":":Save_and_Test_icon:","shortName":":Save_and_Test_icon:"}},{"text":" save and test icon for the quickest way to verify that the ComboBox is working as expected.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Populate Dynamic Pick Lists from a Database with the ComboBox","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The ComboBox control can be used to retrieve values from a web service and enable a list of possible partial matches. This is helpful when you have database queries that return a large number of options. You can filter the number of options returned from a query based on the text typed into the ComboBox. Users typeahead and are only presented with the matching options as choices.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Your web service must be able to filter results and accept parameters that drive filtering","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" A dynamic ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Options URL","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" that contains the {.matchText} parameter. As the user types text into the CombBox, the text will be substituted into the URL. The web service returns only the options matching the typed in text as choices. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ComboBox control shows up to 100 matching options. If the web service finds more that 100 possible matching options, only the first 100 are to be shown. Informing users that there are additional matches that are not shown is not supported. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Set the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Options Source","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" property of the ComboBox to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Web Service","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" then provide the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Options URL","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" and ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Bind Path","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" properties:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Options URL","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" - The URL of the RESTful web service that will retrieve matching options. Be sure that the URL contains the {.matchText} template parameter. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Bind Path","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" - The bind path of the matching options within the XML or JSON returned by the RESTful web service. The Bind Path property determines the selected value that is included in the submission and what the user sees.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"type":"hardBreak"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"It is very common to pull options for a typeahead control such as the ComboBox from a database. If you are using the DocuPhase Forms ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Database Connector","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Database Connector","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507409588"}}]},{"text":" to integrate with your SQL database you already have a Restful service that returns data as resultSets. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"paragraph","content":[{"text":"Let's say you have a classicmodels MySQL database with a Products table that contains 121 records. You have a form with a ComboBox control named NameofProduct and you want to populate the options from the query results. However, you do not expect your users to scroll through 121 choices until they find the one that they are looking for. Ideally, you would like to filter the results coming back from the query based on the characters inserted into ComboBox. Users can then typeahead and select a value from the filtered choices.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"paragraph","content":[{"text":"For this example, the DocuPhase Forms Database Connector is installed on the same machine as DocuPhase Forms and configured in Standalone mode running on port 8081.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"type":"hardBreak"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You will need a query to run against the database. This query, which is included in the BIRT queryset in the configuration.xml file, uses the MySQL Like and % wild cards, to return all the products that match the value in the template (pname}.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"codeBlock","content":[{"text":"\n\n \n SELECT * FROM Products where productName LIKE '%{pName}%' order by productName \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ComboBox control to display the Properties panel. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Select Web Service","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" as the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Options Src.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide the URL to the datasource - in this case the URL to the database query in the BIRT queryset- productsByName. Add the {.matchText} parameter to specify the value of the variable - pname - in the query as the matching text typed into the Name of Product control.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"http://:/database/BIRT/productsByName?pName={NameofProduct.matchText}","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

If your options will have spaces, append the URL with !encode=true to accurately filter options. Using the example above the syntax is {NameofProduct.matchtext!encode=true}.

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If your options will have spaces, ","type":"text"},{"text":"append the URL","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.frevvo.com/d/display/frevvo91/Templatized+Strings#TemplatizedStrings-TemplatizedStringParameters"}}]},{"text":" with ","type":"text"},{"text":"!encode=true","type":"text","marks":[{"type":"strong"}]},{"text":" to accurately filter options. Using the example above the syntax is ","type":"text"},{"text":"{NameofProduct.matchtext!encode=true}.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#1d1c1d"}}]}]}]}],"version":1},"reason":"An info macro in a list item can't be created or edited in the new editor."}}}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"type":"emoji","attrs":{"id":"835db413-3e63-4556-9217-e22df9fcfe71","text":":Save_and_Test_icon:","shortName":":Save_and_Test_icon:"}},{"text":" ","type":"text"},{"text":"save and test","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" icon. Enter a value into the ComboBox. Determine the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Binding Path","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" from the resultSet. In the image, the number 1 was entered into the ComboBox.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"700","id":"2e8a4095-946e-46db-8128-ca248d9c2170","collection":"contentId-1507398706","height":""}}},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Binding Path Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"/p0:productsByName/row/productName","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ComboBox Properties panel should look like this. If you want to limit the user selection to one value, check the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"SIngle Value","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"strong"}]},{"text":" checkbox.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"9e643cd9-8dc6-4414-9efa-c0dd350f0d4b","collection":"contentId-1507398706","height":"400"}}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"Users will see all the returned options that match the number 1 when it is entered in the ComboBox. Adding 8t into the ComboBox will further filter the options and display the choices that match 18t . Each time a character is entered it is added to the URL and the Web Service is invoked. Only the matching results is displayed to the user.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":89389,"__fileMimeType":"image/png","width":900,"id":"932fbe2c-de65-4ee7-912e-69deadfa4405","collection":"contentId-1507398706","type":"file","__fileName":"ComboBoxDBcombined.png","height":315}}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ComboBox Control Properties for Business Rules","type":"text"}]},{"type":"paragraph","content":[{"text":"The following ComboBox properties can be used in rules.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"c014c478-5cf1-4bbd-8962-2a52c20ea01f"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Property","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Purpose","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"optionsUrl","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allow designers to specify more complex dynamically determined end point urls that cannot be built using control templates within the URL.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"matchText","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Read-only. As the user types in the combobox, any rule referencing the matchText property will fire and determine/set options that match.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"matchingOptions","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Write-only. Array of strings. The rule can set the options that match and should be presented to the user as choices. Typically used in conjunction with matchText.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Labels","type":"text"}]},{"type":"paragraph","content":[{"text":"This property applies only to controls generated from schema elements. (If you drag a control in from the palette, it has a Options property; if the control was generated from a schema element, it has a Labels property instead.)","type":"text"}]},{"type":"paragraph","content":[{"text":"You can change the controls labels, although the XSD values for the control in the the schema do not change. In other words, you can change what a user sees in the form, but not the underlying values (i.e., you cannot use the [value=label] syntax you use for palette controls to change the element values).","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, the schema below specifies choices for an event registration as: ''A'', ''B'', ''C''. However, the form would be easier to understand if the labels for A, B and C were ''morning'', ''afternoon'', and ''evening''. You can edit the labels, and the form will show morning, afternoon and evening. However, when this form is submitted, the submission will still correctly contain the required values A, B or C. If you want to change these values, you must edit and re-upload the schema.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Changing Labels for Controls Generated from Schema Elements","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"\n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Note also that you cannot add more labels to the control than the number of XSD values defined for the control in the schema. Using the example above, you cannot add a fourth label to the control because the schema specifies only three possible values (A, B, C) for the control.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Labels property is also very useful when used in conjunction with the ","type":"text"},{"text":"DisplayAs","type":"text","marks":[{"type":"link","attrs":{"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398706/Setting+Properties#Display-As"}}]},{"text":" property. For example, imagine your XSD schema contains an element named \"product\" which is of the type xsd:string. But you know for a fact that there are a limited set of product types that are allowed by the back-end system (a database, for example). An xsd:string element will create a text control on your form by default. But you can easily change the form to restrict the types by using the Display As property to change the control from text to dropdown. Then use the labels property to enter the list of product choices. The submission values will now be restricted to that set of options rather then any text string.","type":"text"}]},{"type":"paragraph","content":[{"text":"Though you can still edit the underlying schema to add an enumeration or set the options in a business rule, using the labels property makes this common task easier.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Enabled","type":"text"}]},{"type":"paragraph","content":[{"text":"This property determines whether the control is enabled or disabled when users first access your form. If unchecked, users may not enter a value in the control effectively making the control readonly. Data cannot be entered until the control is enabled. (You can enable the control using a Rule.)","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, say you are creating a wedding invitation form and want to know if the people completing your form are bringing a guest. Your form might include a text control for the guest’s name that becomes enabled only after users indicate (in another control) that they are in fact coming to the wedding. ","type":"text"}]},{"type":"paragraph","content":[{"text":"You are not permitted to disable grouping controls such as panels or repeats. However, there is an Enabled property for Sections, each of the columns in a Table and each tab in a Tab control. ","type":"text"},{"text":"If \"enabled\" is set on Tab or Section, controls inside of these group controls would be enabled. Conversely, if the property is unchecked, controls inside of a section or tab would be disabled. This property will make it easier to write ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Business Rules","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Business Rules","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400052"}}]},{"text":". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"You can enable/disable the selection controls via rules thereby enabling/disabling all the selection control options. It is not possible to enable/disable individual options.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"paragraph","content":[{"text":"Disabled tabs are still selectable and disabled sections can still be expanded and collapsed. This is as designed. If you are trying to show/hide the contents of a tab/section, use the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Visible","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"#Visible"}}]},{"text":" property. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Visible","type":"text"}]},{"type":"paragraph","content":[{"text":"This property determines whether the control is visible or hidden when users first access your form. It is almost identical in concept to the Enabled property, but instead of disabling the control you hide it and write a Rule that makes it visible based on what users enter in another control. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Hide Label","type":"text"}]},{"type":"paragraph","content":[{"text":"This property determines whether the control’s label will be displayed on your form. Check the checkbox to hide the label on your form; leave it unchecked to show the control’s label. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Message","type":"text"}]},{"type":"paragraph","content":[{"text":"This property applies only to message controls and is where you enter the static text that will appear on your form. In addition to regular text, you may include in this property field arbitrary XHTML markup that will be formatted and displayed by the browser.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Message Type","type":"text"}]},{"type":"paragraph","content":[{"text":"This property only applies to the message control. You can choose a message type to display your control with different background colors, decorators or a border. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Select a type from the Message Type dropdown.","type":"text"}]},{"type":"paragraph","content":[{"text":"Available message types are","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default - The background color for Default depends on the color scheme and is currently a grayish gradient in all color schemes. This is the message type for new controls","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"None - has no border, decorator or color. Controls in migrated forms will have this type post migration","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Bordered - a border but no decorator or color.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Info - default decorator and blue background color.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Success - default decorator and green background color.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Warning - default decorator and yellow background color","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Error - default decorator and a red background color. ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"You can center the message text by selecting the center property on the Style tab. Click ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Style Properties","anchorName":"Center","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399031#StyleProperties-Center"}}]},{"text":" for the details.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":626,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":154760,"__fileMimeType":"image/png","width":1280,"id":"b6e6be02-d6d2-46f8-92c1-ffd72c2f0e8f","collection":"contentId-1507398706","type":"file","__fileName":"v10 Message Control types.PNG","height":629}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Min# and Max#","type":"text"}]},{"type":"paragraph","content":[{"text":"These properties appear as part of a Table Control, when your form has an input control inside a repeat control or an Upload control. Simply type a number (positive integer) into each property field. If you specify a min # of 1 and max # of 10, users must enter values in at least one input control or they will be unable to submit the form, but they may enter as many as 10. See ","type":"text"},{"text":"Repeat Controls","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"Repeats","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-Repeats"}}]},{"text":" for more details. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If you set the min# to 0, users initially will see one email control but won’t be required to supply an Email address to submit the form. ","type":"text"}]},{"type":"paragraph","content":[{"text":"MIn/Max properties for the Table Control allow the user to add/delete table rows in a form as needed. See ","type":"text"},{"text":"Tables","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"Table","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-Table"}}]},{"text":" for more details. You can specify the min/max number of attachments that can be uploaded to an ","type":"text"},{"text":"Upload","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"UploadControl","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-UploadControl"}}]},{"text":" control. ","type":"text"},{"text":"Business Rules","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Business Rules","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400052"}}]},{"text":" can be used to adjust the min/max properties during runtime. For example, if you have a section with an upload control where the min# and max# are set to 1 in the designer. The user must upload at least one attachment to be able to submit the form. ","type":"text"},{"text":"It is possible to set set minOccurs down to 0 even if the design time setting > 0, but not greater than max# ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":", therefore making the field not required using a ","type":"text"},{"text":"business rule","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Business Rules","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400052"}}]},{"text":". The max# can","type":"text"},{"text":" exceed the design time setting as well, but not go below min# value. This is only applicable to controls that are dropped into your form from the palette.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"Min/Max properties are not editable for controls generated from an uploaded schema, since the schema already specifies this via the minOccurs and maxOccurs attributes.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Password","type":"text"}]},{"type":"paragraph","content":[{"text":"This property applies only to text controls and other input controls. If you check the Password checkbox, the text the user enters will appear on the form as asterisks (it will be submitted as normal text, however).","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Entering data into Numeric Controls (Number, Phone, Quantity, Email, Money) that have the Password property checked, brings up the text keyboard when the form is running on a mobile device. Users will have to select the numeric keyboard button from the alpha keyboard when entering data. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"7cdbd6c3-54b7-41d5-860e-f8dc652b267b","collection":"contentId-816782515","height":"400"}}},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Save Value ","type":"text"}]},{"type":"paragraph","content":[{"text":"The Save Value property applies to Message, Link, Image and Form Viewer controls. This property controls whether the control's value appears in the","type":"text"},{"text":" form/workflow submission document","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Submissions Stored Inside of frevvo","anchorName":"SubmissionsDetail","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507404977#SubmissionsStoredInsideoffrevvo-SubmissionsDetail"}}]},{"text":" and the translation file used for ","type":"text"},{"text":"multi language support","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"spaceKey":"frevvo90","isRenamedTitle":true,"linkType":"page","contentTitle":"Multi Language Support","versionAtSave":"11"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/frevvo90/pages/1063683609"}}]},{"text":". The property will be unchecked (default) for new Message, Link, Image or Form Viewer controls added to your form/workflow. An example of the Properties pane for the Message control is shown in the image.","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"6f960bee-3b02-438c-a666-8ccb6588f238","collection":"contentId-816782515","height":"250"}}}]},{"type":"paragraph","content":[{"text":"The Save Value property will be checked for Message, Link, Image and Form Viewer controls upgraded from a previous release. Re-instantiating a submission that has a Message, Link, Image or Form Viewer control will restore the value/text of the control only if ","type":"text"},{"text":"Save Value","type":"text","marks":[{"type":"strong"}]},{"text":" was checked for it and it was in the submission doc.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":818,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":732779,"__fileMimeType":"image/png","width":2426,"alt":"image-20240605-183307.png","id":"5e2ecb68-f335-4f9e-821e-592853c61b87","collection":"contentId-1507398706","type":"file","__fileName":"image-20240605-183307.png","height":1257}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Message and Link controls still support the \"value\" property. Existing rules will work unchanged. The Save Value must be ","type":"text"},{"text":"checked","type":"text","marks":[{"type":"strong"}]},{"text":" for there to be a value that is accessible in a business rule.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Save Value","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" property if you are using the Image control in a template i.e. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Print Headers/Footers in the form/workflow PDF","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Form and Workflow Style Properties","anchorName":"PrintHeaders/Footers","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399989#FormandWorkflowStyleProperties-PrintHeaders/Footers"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Include Message Controls in ","type":"text"},{"text":"Optional Sections","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Valid Forms","anchorName":"OptionalSections","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507404198#ValidForms-OptionalSections"}}]},{"text":" but make sure the Save Value property is","type":"text"},{"text":" unchecked","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When mapping Message controls with templates to the SharePoint Connector, the Save Value property should be checked.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"CSS Class","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the control’s class name that changes the look of HTML output in your form/workflow when added to the CSS Class property of a control. The CSS classes that are available in DocuPhase Forms are listed in the table.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"c71a6811-6b4d-4f5d-b3a8-fc5c4e8ccfc7"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"CSS Class Name (see detail in paragraphs below)","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":"f-page-break","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Adds a page break to the forms PDF","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"f-break-children-avoid","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"When applied to a group control, avoids page break inside child controls","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"f-break-inside-avoid","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Avoid a page break inside a specific control","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"f-page-break-inside-avoid*","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"*","type":"text"},{"text":"Deprecated, but will continue to work. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}}]},{"text":"Prevents a PDF page break from occurring in the middle of a group control. v10.1+ use f-break-inside avoid or f-break-children avoid.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"showhelp","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Enables Help icon at the top of each column when using the Tight layout","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"f-font css classes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Sets the font size for Message and Table controls","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"f-submit-error","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Used to display a message to the user if the form is invalid when they click submit","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"f-action-error","type":"text"}]},{"type":"paragraph","content":[{"text":"(workflows)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Used to display a message to the user if an Activity Document Action in a workflow fails","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CSS Class to Add a Page Break","type":"text"}]},{"type":"paragraph","content":[{"text":"One built-in CSS Class name is '","type":"text"},{"text":"f-page-break","type":"text","marks":[{"type":"strong"}]},{"text":"'. If you want to add a page break to the printed view of the form's pdf, tiff, add f-page-break to the control that you want to start at the top of a new page. See ","type":"text"},{"text":"Printing Forms","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Printing Forms","anchorName":"PageBreaks","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399250#PrintingForms-PageBreaks"}}]},{"text":" for the details.","type":"text"}]},{"type":"paragraph","content":[{"text":"Controls can be prevented from having a ","type":"text"},{"text":"page break","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.frevvo.com/d/display/frevvo91/Printing+Forms#PrintingForms-PageBreaks"}}]},{"text":" in the middle of the control. For example, you may not want a checkbox control split with some options printed on one page and the rest of the options on the next page. In this case, apply the CSS Class property ","type":"text"},{"text":"f-break-inside-avoid","type":"text","marks":[{"type":"strong"}]},{"text":". This will avoid a page break in the middle of a control. This would also prevent a page break inside a group control such as a Section.","type":"text"}]},{"type":"paragraph","content":[{"text":"You may want to prevent a page break inside any control inside a group control, such as a Section. Instead of applying CSS to each control in the section, you can use ","type":"text"},{"text":"f-break-children-avoid","type":"text","marks":[{"type":"strong"}]},{"text":" on the Section to prevent a break inside any of the child controls in that section.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"CSS Class property ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"f-page-break-inside-avoid ","type":"text","marks":[{"type":"strong"}]},{"text":"was previously used to prevent breaks inside a group control. This class is deprecated, but will continue to work if in use. We recommend replacing this with f-break-inside-avoid or f-break-child-avoid.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CSS Class to Reduce White Space","type":"text"}]},{"type":"paragraph","content":[{"text":"Another is the showhelp CSS Class that is built into the ","type":"text"},{"text":"Tight","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Layouts and Styles","anchorName":"CSSClasses","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507402758#LayoutsandStyles-CSSClasses"}}]},{"text":" layout. For example, y","type":"text"},{"text":"ou can reduce white space even further with the Tight layout so that you have virtually no space between controls by selecting the hide label property on each control. This can be a way to implement a grid type layout as shown in this sample form below. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"paragraph","content":[{"text":"When controls are this tight together there is no room to display the help icon for controls with help text. Notice that the first row of controls does display the help icon. This is done by putting the string showhelp into the css class property for each control in the first row. This is a useful way to have help at the top of each column.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":711,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":20845,"__fileMimeType":"image/png","width":600,"id":"7aeeb4ee-7434-4c44-ae16-b8a8ee5c49e4","collection":"contentId-816782515","type":"file","__fileName":"TightLayoutwithshowhelpccclasstoshowhelponfirstrow.png","height":275}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CSS Class to Set Font Size for the Table and Message Controls","type":"text"}]},{"type":"paragraph","content":[{"text":"There are seven CSS classes that set font size that can be used with a ","type":"text"},{"text":"Setting Properties#MessageControl","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=1069257446#SettingProperties-MessageControl"}}]},{"text":" or ","type":"text"},{"text":"Setting Properties#Tables","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=1069257446#SettingProperties-Tables"}}]},{"text":" controls. Add these into the CSS Class property for these controls only. Other use cases are not supported.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is the list:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"f-font-xx-small","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"f-font-x-small","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"f-font-small","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"f-font-medium","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"f-font-large","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"f-font-x-large","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"f-font-xx-large ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Display and submission PDF results are shown in the image:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":442,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":40271,"__fileMimeType":"image/png","width":356,"id":"b8897e62-297d-4b7e-825a-25657d4f1b15","collection":"contentId-816782515","type":"file","__fileName":"v535CSSClassesforFontSizeExamples.PNG","height":500}}]},{"type":"paragraph","content":[{"text":"Let's say you want the user to read an agreement section and then check a box on the form if they agree. You can put the Agreement text inside a Message Control. Since there is a large amount of text in the Agreement, you may want to make the font smaller so that it does not appear overwhelming. Simply add the desired CSS class to the Message Control CSS Class property.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":78864,"__fileMimeType":"image/png","width":700,"id":"17549f5b-6d14-4f72-88c1-08f95eab0474","collection":"contentId-816782515","type":"file","__fileName":"v53CSSClassFontExample.png","height":247}}]},{"type":"paragraph","content":[{"text":"Selecting a choice from the ","type":"text"},{"text":"Label Size","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Style Properties","anchorName":"LabelColorandLabelSize","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399031#StyleProperties-LabelColorandLabelSize"}}]},{"text":" dropdown on the Style tab of some controls, such as the Message control, will override the CSS class. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CSS Class to Display Invalid Form Message on Submit","type":"text"}]},{"type":"paragraph","content":[{"text":"You can use the CSS Class ","type":"text"},{"text":"f-submit-error","type":"text","marks":[{"type":"strong"}]},{"text":" to display a message control that notifies the users that the form cannot be submitted because there are required controls that are empty or controls that contain invalid data. Refer to this ","type":"text"},{"text":"topic","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Valid Forms","anchorName":"InvalidFormNotificationforUsers","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507404198#ValidForms-InvalidFormNotificationforUsers"}}]},{"text":" for the details.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":623,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":29177,"__fileMimeType":"image/png","width":942,"id":"582f7793-665a-47bc-b89b-e0c47f45a79a","collection":"contentId-816782515","type":"file","__fileName":"v91 Form with Required Error Message Control.PNG","height":668}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CSS Class to Display a Message if an Activity Document Action post returns a 422 status","type":"text"}]},{"type":"paragraph","content":[{"text":"The f-action-error CSS Class displays text defined in a Message control if an Activity Document Action post returns an HTTP 422 status for a workflow step. Refer to ","type":"text"},{"text":"Activity Document Action Behavior for Failed Post","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Activity Doc Actions","anchorName":"ActivityDocumentActionBehaviorforFailedPost","versionAtSave":"8"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507396785#ActivityDocActions-ActivityDocumentActionBehaviorforFailedPost"}}]},{"text":" for the details.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"If you are using DocuPhase Forms On Premise, Cascading Style Sheet code that was used in themes applied to forms/workflows in previous DocuPhase Forms releases, can be added to a newly created style.css file in the frevvo.war file. The context parameter, ","type":"text"},{"text":"frevvo.css.url","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Installation Customizations","anchorName":"CSSforFormsFlows","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507409306#InstallationCustomizations-CSSforFormsFlows"}}]},{"text":", in the web.xml file ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":"must be changed to point to it.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prompt and Prompt Message","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the Prompt and Prompt Msg properties to display a warning message when an attempt is made to delete a Table row or Repeating item. See the ","type":"text"},{"text":"Tables","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"Table","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-Table"}}]},{"text":" and ","type":"text"},{"text":"Repeat","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"Repeats","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-Repeats"}}]},{"text":" control topics for the details.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Button Color","type":"text"}]},{"type":"paragraph","content":[{"text":"You can change the color of the trigger button by selecting a choice from the Button Color dropdown.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":606,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":61267,"__fileMimeType":"image/png","width":1280,"id":"f473d4de-8b5c-4105-9570-ddb14437a6e1","collection":"contentId-1507398706","type":"file","__fileName":"v90TriggerButtonColor.PNG","height":313}}]},{"type":"paragraph","content":[{"text":"Available button colors are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default - The background color for Default depends on the ","type":"text"},{"text":"Style","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Layouts and Styles","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507402758"}}]},{"text":" applied to your form.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"None - has no border, decorator or color","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Green - default decorator and green background color","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Blue - default decorator and blue background color","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Yellow - default decorator and yellow background color","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Red - default decorator and red background color","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Light Blue - default decorator and light blue background color","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":9428,"__fileMimeType":"image/png","width":802,"id":"56b5fc2a-34aa-4ca3-a44e-280db4445741","collection":"contentId-816782515","type":"file","__fileName":"TriggerButtonColors.png","height":114}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Printable","type":"text"}]},{"type":"paragraph","content":[{"text":"This property determines whether or not this form field will appear in the ","type":"text"},{"text":"PDF document view","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Printing Forms","anchorName":"SubmissionPDF","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399250#PrintingForms-SubmissionPDF"}}]},{"text":" of the form. If unchecked, the field will not appear in the PDF. You can set the property on a section control and it will automatically apply to all controls inside the section control. This is often used in business rules. See ","type":"text"},{"text":"Show/Hide/Print","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Rule Examples","anchorName":"Show/HideRules","versionAtSave":"10"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507400609#RuleExamples-Show/HideRules"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Enable if Valid","type":"text"}]},{"type":"paragraph","content":[{"text":"This property applies only to Submit controls. By default, DocuPhase Forms disables the form's submit button until all required fields are filled and contain valid data. See ","type":"text"},{"text":"Valid Forms","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Valid Forms","anchorName":"InvalidFormNotificationforUsers","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507404198#ValidForms-InvalidFormNotificationforUsers"}}]},{"text":" for details of this feature. However, sometimes you may wish to override DocuPhase Forms' default behavior and allow the user to submit a form even if it is invalid. To do this, uncheck this property.","type":"text"}]},{"type":"paragraph","content":[{"text":"When \"Enable if Valid\" is checked and you click on the Submit button in a form that contains invalid data or required fields that are empty, the form will not submit and the invalid fields will be highlighted with an orange background color. The designer can also display a message instructing the user what to do.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"paragraph","content":[{"text":"This approach is very helpful to users when trying to determine why a form does not submit. Refer to this ","type":"text"},{"text":"Invalid Form Notification","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Valid Forms","anchorName":"InvalidFormNotificationforUsers","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507404198#ValidForms-InvalidFormNotificationforUsers"}}]},{"text":" for the details.","type":"text"}]},{"type":"paragraph","content":[{"text":"If \"Enable if Valid\" property is unchecked, you can control the Submit button behavior in a business rule using the Submit.enabled = [true,false] property.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prefix Property","type":"text"}]},{"type":"paragraph","content":[{"text":"Custom groups with rules included when dropped back onto the same or another form, will contain a special \"Prefix\" property. The property will automatically be given a unique value if you drop the group onto the same form 2 or more times. This ensures that the group controls have unique element name. You can view the impact the prefix has on the element names by viewing the form's schema or the control's property panel. ","type":"text"},{"text":"Using the prefix property, you can write a separate rule to manipulate the 2nd or greater instance of the custom control. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Refer to this ","type":"text"},{"text":"documentation","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Control Templates","anchorName":"PrefixProperty","versionAtSave":"1"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507399197#ControlTemplates-PrefixProperty"}}]},{"text":" for the details.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Max Size","type":"text"}]},{"type":"paragraph","content":[{"text":"The Max Size property is used to set the upper limit for each attachment uploaded using the ","type":"text"},{"text":"Upload Control","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"UploadControl","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-UploadControl"}}]},{"text":" in your forms/workflow. It is set to 25 MB in the frevvo Cloud. On Premise customers should refer to the ","type":"text"},{"text":"Max Size property","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"MaxSize","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-MaxSize"}}]},{"text":" for information about configuring this property for an On Premise installation.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"File Name","type":"text"}]},{"type":"paragraph","content":[{"text":"The File Name property is used to rename attachments uploaded to DocuPhase Forms via the ","type":"text"},{"text":"Upload Control","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"UploadControl","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-UploadControl"}}]},{"text":". Refer to the ","type":"text"},{"text":"Changing the filename of an uploaded attachment in the form/workflow submission ","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Palette Controls","anchorName":"Changingthefilenameofanuploadedattachmentintheform/flowsubmission","versionAtSave":"3"},"href":"https://frevvo-docs.atlassian.net/wiki/spaces/docuphaseforms113/pages/1507398257#PaletteControls-Changingthefilenameofanuploadedattachmentintheform/flowsubmission"}}]},{"text":"topic for the details.","type":"text"}]},{"type":"paragraph","content":[{"text":"The bind path of the option display LABELS within the XML or JSON returned by the RESTful web service.","type":"text"}]}],"version":1}

Browser not supported