Formatting Properties pages
Making a control program in EIKON for WebCTRL automatically creates a Properties page for WebCTRL. The initial properties displayed on a Properties page are defined in microblock dialog boxes. Defining properties in EIKON for WebCTRL will save you time when you are ready to transfer the control program to the control module.
You can preview Properties pages by running the system without connecting to control modules.

You can change the way the text appears on the Properties page by using the Text microblock or by inserting special characters in the Property Page Text field in a microblock dialog box.
 
To use the Text microblock to format text
The Text microblock allows you to format text, add horizontal lines, and arrange items on the Properties page.

- Place a Text microblock in the workspace.
TIP Because Text microblocks are hidden on Logic pages in WebCTRL, place them to the right of the microblock logic.
- Click and hold the mouse down on the Text Type field, then select an option. See table below.
- Select types of text, line separators, or controls for expanding and collapsing sections. You may also use the microblock to hide sections of the Properties page.
Text Type
|
Notes
|
Plain
|
For creating plain text.
|
Separator
|
To create a horizontal line on the Properties page, often used to offset or group information, choose Separator as the Text Type. If you would like text to appear on the separator line, enter the text in the Property Page Text field.
|
Bold
|
For creating bold text.
|
Expand Begin Closed (or Opened) Expand End
|
To format a section using expanded formatting, first insert a Text microblock with the Text Type set as Expanded Begin Closed or Expanded Begin Opened, depending on how you want the area to display when first viewed. If you would like text to appear on your expandable line, enter the text in the Property Page Text field.

You must also insert a Text microblock with the Text Type set as Expand End at the end of the section you wish to group together.
|
TableBegin TableEnd
|
To align data in a table, insert a Text microblock with the Text Type set as Table Begin. To complete the table, insert a Text microblock with the Text Type set as Table End after the last item you want to include in the table.

NOTE When working with a table within an expanded section, make sure the table begins after the Expand Begin and ends before the Expand End.
|
Conditional Hide Begin Conditional Hide End
|
You can hide part of the Properties page based on a value from a specific microblock. For example, you can specify that the Properties page text from an Analog Input microblock will only appear on the Properties page if the value is above 85. The expression is evaluated relative to the entire equipment, not at that particular microblock.
Place a Text microblock with the Text Type set as Conditional Hide Begin before the microblock to be evaluated and another set to Conditional Hide End after it. Enter a Javascript expression in the Properties Page Text field of the Text microblock. Microblock properties may be referenced between the dollar signs ($), and the expression must be Boolean. For example, to show the microblock Properties page text only when the present value of the point named Zone Temp is greater than 85, the expression would be "$Zone_Temp/present_value$ >85".
NOTES
When referring to the name of a point, use the RefName rather than the point name.
Technical Support does not provide assistance with writing and editing Javascript. Please see Javascript textbooks, available in most bookstores, for help with Javascript.
TIP If you are adding the Conditional Hide formatting after the control program has been designed or would prefer to group all of the Text microblocks within the control program, use the Reorder menu to correctly place the Text microblocks.
|
Using special characters to format text
To display microblock properties
|
To display or edit a microblock property, enclose an expression within a pair of dollar signs. For example, The value is $Present_Value$ will display the contents of the present value field of the current microblock in place of $Present_Value$ in the string. You can make the expressions more detailed by adding a ":" after the expression, then adding additional properties such as
Duty cycle is $Present_Value:control=="minsec"$ or Description: $description:size="24" editable="false"$:
|
To align items in columns
|
Use the pipe character (|) to form a column aligned table. For example:
{[|History Recorder: |Current cycle = |$Current/Latched_Value$| on |$Current/Latched_Time$|$Current/Latched_Date$|since |$Current/Reset_Time$|$Current/Reset_Date$]
[||Previous cycle = |$Previous/Latched_Value$| on |$Previous/Latched_Time$|$Previous/Latched_Date$|since |$Previous/Reset_Time$|$Previous/Reset_Date$]}^$

NOTE See the Microblock reference for property reference names used in individual microblocks.
|
To hide information
|
If you do not want text for a particular microblock to appear on the Properties page, type ^## in the field or fields or leave the Property Page Text field blank.
|
To display two or more microblock properties on the same line
|
To display two or more microblock properties on the same line, type ^$ at the end of the text for the first microblock.


|
To begin a new line of text
|
To begin a new line of text on the Properties page, type ^\. One blank line will appear for each caret that is typed.
For example, type: Time of day for daily trend report:^\ _____ hh:mm 24 hr
to display the following on the Properties page:
Time of day for daily trend report: 02:00 hh:mm 24 hr
|
Special characters and formatting codes
Use the following special characters and formatting codes to customize Properties page text.
|
|
For this effect...
|
Type...
|
Field edit/display
|
$Present_Value$
|
w/optional list of properties (below)
|
$Present_Value:control="number"size="3"$
|
Optional properties
|
|
Bold Text Begin
|
!{
|
Bold Text End
|
!}
|
begin/end
|
{ }
|
Row begin/end
|
[ ]
|
Tab/Cell (column align)
|
| (pipe)
|
Insert carriage return
|
^\
|
Suppress carriage return at end
|
^$ (only at end of string)
|
Begin/End nobreak
|
^( ^)
|
Escape to HTML
|
^!
|
Supply alternate template include
|
^#name# (only at start of string)
|
Insert literal
|
\x (where x is any character)
|
The following special characters are reserved and must be inserted using the Insert Literal syntax:
^ \ $ { } [ ] | !
|
|