XML expressions

Previous Next

USoft Blend  >  Expressions  >  XML

 

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>

 

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>

 

 

See also

Guide to expressions and data types

         Literal expressions

                 Dates

                 string literals

         Path expressions

         XML expressions

                  Embedded XML

          XPath expressions

                 Node set expressions

                 Booleans

                 Strings

                 Numbers

                 Function calls

                 Variable references

                 Implicit XPath data type conversion

                 Evaluated expressions vs. literals

          SQL expressions