Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Shopping Cart section control contains templates for its Label, Hint and Help.

Image RemovedImage Added

Code Block
languagejava
titleHelp Text
You have {T} items in your cart.<br/> 
{Q1=0} Apples<br/> 
{Q2=0} Oranges<br/> 
{Q3=0} Pears 

Before the user starts entering values into this form they will see:

Image RemovedImage Added

As a user begins entering values into the form fields, the templates will immediately begin appearing, and the user will see:

Image RemovedImage Added

Templatized String Parameters

...

When a template refers to a selection control such as a dropdown, radio or checkbox, the selected option label will show in the form/workflow's run-time UI. So, a selection control template used in a message control or the label of another control will display the selected option label. However, when the template is used in form/workflow settings, such as a Form Action, Pending Message, or Doc Action Email, the template will display the option value. In this example we have a dropdown control named "dd" with options a=apples, b=bananas, c=carrots. Another control's label has the template {dd} and the message control also uses the template {dd}.

Image RemovedImage Added

At run time, the template displays the selected option label in the UI. Notice that the user sees "apples" in both the text control's label and in the message. If Save Value is checked on the message, the value passed will be "You selected apples", retaining the dropdown template's label in the message control's value.

Image RemovedImage Added

We've also used the template {dd} to name the Form Settings to display a Form Action Message, set the PDF Name, and in the Email subject line.

...

Each of these uses will return the selection option value for the template. Notice instead of "apples" the template displays "a".

Form Action:

Image RemovedImage Added

PDF Name:

Image RemovedImage Added

Email Subject:

Image RemovedImage Added

Tip

If you need to use the selected option's label in such cases, consider using a business rule like this example to get the option label and set it in a hidden control. Then use the hidden control's template in the form/workflow settings.

...

Template Validation

Template references used in  will in frevvo will be automatically validated when:

...

The Guided Designer editing mode icons will have a red '!' indicating a validation error. Workflow steps with validation error appear with a pink/salmon background.

Image RemovedImage Added

Any control that has a templatized property error will show an error message below it (red text on gold background).  

Image RemovedImage Added

If there are form/workflow/workflow step templatized property validation errors present, then when the designer opens the corresponding properties dialog, all properties on all tabs are immediately validated. Any tab containing an error will be displayed in red text.  
Image RemovedImage Added

Note
  • Any templatized property that references a value to be supplied by _data (either the uploaded _data file or the _data url parameter) that is not also a control name will result in a non-fatal validation error. In this situation, the designer can either ignore the error or, if the validation is for a form/workflow or workflow step property that prevents saving the properties, add a hidden control of the same name so that validation passes.
  • When templates are used in places that have a length limit, such as Email Subject lines, server side validation truncates the template's value by removing extra data which is more than 255 characters.
  • Control names with a ":" after the first word are ignored in Template Validation. This prevents the validator from erroneously flagging internal css styles as invalid templates.

...