XML expressions

In contexts where XML is expected, the USoft Blend framework processes literal XML and expressions evaluating to literal XML. This XML must be valid according to the XML 1.0 specification by W3C.

USoft uses XML to describe data that must be exported, imported, compared, delivered, configured outside a USoft repository. This type of XML follows the USoft XML format detailed in the USoft Definer Help. The first examples in the table below are in this format.

USoft Blend uses XML to facilitate composite input and output of directives. This is referred to as embedded XML.

Data type	Explanation	Examples
xml-fragment	An XML structure consisting of one or more XML nodes.	<T_AUTH_USER USERNAME="admin"/> <T_AUTH_USER USERNAME="admin2"/> <Users> <T_AUTH_USER USERNAME="admin"/> <T_AUTH_USER USERNAME="admin2"/> </Users>
xml-fragment	An expression evaluating to such a structure.	<msg>Logging in: <pc:value-of select="$logfile"/>... <pc:newline/> </msg>
xml-document	An XML fragment that is a valid XML document, ie., that has a single top-level node (document node). An expression evaluating to such a structure. Subsets xml-fragment.	<Users> <T_AUTH_USER USERNAME="admin"/> <T_AUTH_USER USERNAME="admin2"/> </Users> <msg> Logging in: <pc:value-of select="$logfile"/>... <pc:newline/> </msg>
xml-text	An XML fragment that is a valid XML text node. An expression evaluating to a valid XML text node. Subsets xml-fragment.	admin2 Logging in: <pc:value-of select="$logfile"/>... <pc:newline/>
embedded-xml	An XML fragment (usually, an XML document) that is allowed to be a child node of a USoft Blend directive, or is returned by a USoft Blend directive, or both.	<pc:Dialog> <Form w="250"> <Title>USoft Blend dialog</Title> <Label dx="5" dy="10" w="40" > This is a USoft Blend dialog. </Label> <Button dy="20" newline="true"> <Result>OK</Result>OK </Button> </Form> </pc:Dialog>