With cx:write, the most used element in CxScript, you write the value of a constant or variable into the document at the current position, like:
<cx:write value="$activity.toEmployee.lastName"/>
The value attribute is obligatory and used to determine what actually is to be written. Determine the way the value is written by the use of one or more other attributes.
Attributes
The following table contains the attributes available with the cx:write element. Obligatory attributes are bold.
Content
The attribute content determines how the content (the part enclosed by the opening and closings tags) should be written.
The following options are available:
prepend (the default behaviour): the content is written before the value of the value attribute; however, if the value attribute is empty (nil) than the content is suppressed and nothin is written;
append: the content is written after the value of the value attribute; however, if the value attribute is empty (nil) than the content is suppressed and nothin is written;
default: the content is only written when the value of the value attribute is empty (nil).
Examples:
<cx:write value="$activity.toEmployee.phone" content="default">Unknown</cx:write>
phone=nil -> "Unknown"
phone="123" -> "123"
<cx:write value="$activity.toEmployee.phone" content="append"> is the number</cx:write>
phone=nil -> ""
phone="123" -> "123 is the number"
<cx:write value="$activity.toEmployee.phone" content="prepend">Tel. </cx:write>
phone=nil -> ""
phone="123" -> "Tel. 123"
Data
Use this attribute to, for instance, insert a photo into the document. For this you would first create a template like "photo.bin" with only the following content:
<cx:write data="$form.eid.@fetchByID.CREmployee.@first.photo"/>
Use such a template within another template as follows:
<img src="<cx:hyperlink action='view' string='1' template='photo.bin'>
<cx:parameter name='eid' value='$employee.employeeID'/>
</cx:hyperlink>">
With the data attribute you could also create a link to, for instance, a MS-Word document with the resume of a candidate.
Again, first create a template that will contain the actual resume, like:
<cx:let name="document" value="$form.aid.@fetchByID.CRAttachment.@first">
<cx:if condition="document.content.md5Hash.description = form.chk.@first.description">
<cx:write data="$document.content"/>
</cx:if>
</cx:let>
Link the resume from another template like ($employee references a candidate):
<cx:foreach list="$employee.attachments" filter="toTypeNode.value like 'cv'" count="1">
<cx:hyperlink action="view" target="_blank" template="cv.bin">
<cx:parameter name="aid" value="$item.attachmentID"/>
<cx:parameter name="chk" value="$item.content.md5Hash"/>
Bekijk CV
</cx:hyperlink>
</cx:foreach>
Note that the resume construction contains a checksum key 'chk' (a so called MD5Hash checksum) for security reasons. It also adds a key 'aid' to the link (cx:hyperlink). This key tells the system that the user has the right to obtain the checksum.
dateformat
Format a date value with the attribute dateFormat through the following symbols:
The following example shows how parts of a date are being specified in a dateFormat:
<cx:write value="$utilities.currentDate" dateformat="Today it is %a, %e %B %Y." language="English"/>
This results in the following date: Today it is Monday, 14 february 2005.
html
The HTML layout stays preserved when you use the attribute html in HTML templates as follows: html="$YES". The use of the attribute html is to indicate that the value is an HTML fragment. If this attribute is not used the HTML codes are not interpreted but printed literally.
language
The result of the dateformat and numberformat attributes can be language dependent, like the names of days and months. Therefor always use the language attribute in combination with the use of any of these 2 attributes. For the Dutch language the correct value for the language attribute is: "Dutch". Other valid values are: "English" and "German".
numberformat
Format a number value with the numberFormat attribute through the following symbols:
Thus, suppose a variable n contains the number 4217,5, you could present this number like:
<cx:write value="$s" numberformat="00000"/>
<cx:write value="$s" numberformat="#,##0.00" language="Dutch"/>
This results respectively in the following output: "04217" and "4.217,50". Notice that specifying the Dutch language translates the the decimal point into a decimal comma.
width
To specify the number of to be written characters use the width attribute; if nescessary spaces are added to the right of the text. This way a fixed column width is obtained when using a fixed width font like Courier.
invoke
See cx:let for an explanation of this attribute.
____
Keywords: UD-2568