Data Label Control

1. Create a View
2. Drag the Data Label control onto the canvas. The control can be found in the Input section of the Controls found in the View Designer, see the Properties section below
3. Configure a validation pattern if required under Validation of the Properties section
4. Configure the rest of the properties as required
5. Run the View

• The Data Label control is also available in the Form Designer
• A Data Label control has all the functionality of a Label control with the added functionality of dynamic value population through the use of expressions and rules

The Data Label control is available in the Input section of the Controls found in the View Designer and Form Designer.

Properties	Description	Can be set in runtime using Rules
Name	A unique identifier for the selected control. This property is required	No
Text	The text to be displayed in the control	No
Field	A read-only property displaying the field that is bound to the selected control	No
Data Type	A drop-down list containing the types of values that the selected control can accept. The following types are available: Number DateTime AutoNumber Text Guid AutoGuid memo Yes/No Xml Decimal	No
Tooltip	The value to be displayed when the cursor is hovered over the control during runtime	Yes, see Control Properties Actions for more information
Width	Adjust the width of the control (any whole percentage up to 100%, number or pixel value up to 32767px). Note: The Width should be set when using the Wrap Text property.	Yes, see Control Properties Actions for more information
Visible	A Boolean value used to establish whether the control is visible during runtime	Yes, see Control Properties Actions for more information
Enabled	A Boolean value used to establish whether the control is enabled during runtime	Yes, see Control Properties Actions for more information
Wrap Text	Allows the user to set the Width of the control and if the Text of the Label is longer than the label, the Wrap Text property can be selected to allow the overflow to flow to new lines, growing the Label height. If the Width is set and the Text content runs longer than the Label width, the overflow is hidden and an ellipsis is shown. In runtime, if the Tooltip is set and the content is hidden, the Tooltip shows the full text	Yes, see Control Properties Actions for more information
Literal	A Boolean value used to establish whether the text should be read as literal or plain text. In the following example: <div style=”color:blue”>HTML Element</div> If Literal = True, the result will be: HTML Element If Literal = False, the result will be: <div style=”color:blue”>HTML Element</div> The setting is disabled by default. If Literal is not selected, the control does not add any HTML elements to the text. This is useful when you want to render text and controls directly into a page without any additional markup	Yes, see Control Properties Actions for more information
Expression	Opens the Expression Builder to configure expressions to populate the control with dynamically calculated values	Yes, see Control Properties Actions for more information
Styles	Opens the Style Builder enabling the user to specify style features like Format, Font, Borders, Padding and Margins. See the Style Builder topic for more information on styling options	No
Conditional Styles	Opens the Conditional Formatting Designer used to design styles that will apply only when certain conditions are met. See the Conditional Styles section for more information	No
Pattern	Set up a validation pattern that can be used to evaluate the value of the selected control	No
Message	Specify the message to be displayed if the content of the control does not adhere to the specified Validation Pattern	No

Pattern

Patterns are regular expressions used to enforce validation on a certain control when data is captured. For a Data Label control there are several validation types as shown below. Additional validation patterns can be configured and the validation error message can be customized. Creating a Pattern for “percentage” for example, would enforce validation on the selected control, which will fail if the user did not enter the value as “[Value][%]”.
When clicking on the ellipsis next to Pattern, the Validation Patterns screen opens:

Actions	Description	How to use it
Add Pattern	Adds a new Validation Pattern	Click on Add Pattern
Edit Pattern	Edits an existing Validation Pattern	Click on Edit Pattern
Remove Pattern	Removes a Validation Pattern	Click on Remove Pattern

Click Add Pattern to add a new pattern. The Add New Validation Pattern screen opens

Fields	Description	How to use it
Name	The name of the Validation Pattern	Type a name
Example	An example of the Validation Pattern such as abc for a Characters Only Validation Pattern	Type an example
Pattern	The regular expression for the Validation Pattern	Type the regular expression
Message	The message to be displayed if the input data does not match the regular expression	Type the message

The Display Time Zone property can be configured by using the set control properties actions allowing the designer to force a particular time zone to be used when displaying the control's value. This property can be used with the Calendar, Data Label, Text Box and Text Area controls and is configured in the Set Control properties rule actions. This property is useful if the datetime should display the same regardless of the end user location/time zone. Examples of where this feature would be beneficial are:

• A good example is birthdays or;
• When you have a time zone setting somewhere else you have to match for example the manner which SharePoint has time zones set per site collection and per user.
• Another example is when referring to a time in a particular time zone. When the user interface would state the time zone and the date time. A good example would be a world clock showing times in New York, London etc.
• Final example is when scheduling a meeting you can select a date/time based on your browser time zone but also show another control indicating the time in another region for the participants.