Element: ATTR

The data structure which is built when recognizing an instance of an element can extractinformation from the formula as well as from attributes.

Attributes

Name Type Optional
NAME STRING No Name of the attribute as it will be found inthe XML input to parse.
TARGET STRING Yes

If specified, the value of this attribute mustrefer to a field defined within the same element,and which will receive the valueparsed by the XMLBOOSTER-generatedparser. The way this fetch operation willoccur in practice will depend mostly on thetarget field type specication.

If no target attribute is specified, the parsergenerated by XMLBOOSTER will skipthe attribute without fetching the attachedvalue.
DEFAULT STRING Yes
OPTIONAL BOOLEAN Yes Indicates whether the attribute is optionalor not. Default is FALSE.
ENTITIESINATTR BOOLEAN Yes This attribute indicates whether entities (starting with the "&" character) must be recognized in this attribute. While this is the standard behaviour of XML, allowing for a simpler parsing method when dealing with messages in which one knows that entities will not be required can deliver a significant performance advantage. The value indicated in this attribute overriddes the value given in the meta-definition header.
FIXED BOOLEAN Yes If FIXED is set to TRUE, a number of conditions must be met:
  • The attribute must have a default value attached
  • The attribute cannot have a target field attached
It indicates that the attribute has a fixed value. When parsing, if the attribute is present, its value must match the attached default value for the input to be considered valid. It can be missing if the attribute was marked as optional.
When unparsing, this attribute will always be generated with its default value.

Content

Sequence of
META

Appears in

ATTRIBUTES

Example

<SYSTEM NAME="Agenda">
  <CCONFIG MAXLEN="100"
           ARRAYSIZE="5"
           FLATMODE="TRUE"/>
  <COBOLCONFIG NUMBERLINES="6"
               USECLASSPREFIX="TRUE"
               MAXLEN="40"
               ARRAYSIZE="40"
               DATAPREFIX=""
               LABELPREFIX="XMLB-"/>
  <DELPHICONFIG COLLECTIONSTART="ONE"/>
  <JAVACONFIG PACKAGE="com.raincode.xmlbooster.agenda"
              COLLECTIONCLASS="ArrayList"
              COLLECTIONSTART="ZERO">
    <IMPORT>
/////////////////////////////////////
// Automatically inserted import list
/////////////////////////////////////
import java.util.*;
    </IMPORT>
  </JAVACONFIG>
  <CPPCONFIG STRINGCLASS="std::string"
             COLLECTIONCLASS="std::vector">
    <INCLUDES>
#include <vector.h>
#include <stl_string.h>
</INCLUDES>
  </CPPCONFIG>
  <ELEMENT NAME="AGENDA"
           MAIN="TRUE">
    <FIELDS>
      <FIELD NAME="Entries"
             REFTYPE="ENTRY"
             MODE="LIST"/>
    </FIELDS>
    <FORMULA>
      <REPEAT TARGET="ENTRIES"
              ATLEASTONE="TRUE">
        <ELEMENTREF NAME="ENTRY"/>
      </REPEAT>
    </FORMULA>
  </ELEMENT>
  <ELEMENT NAME="ENTRY">
    <FIELDS>
      <FIELD NAME="Day"
             TYPE="INTEGER"/>
      <FIELD NAME="Month"
             TYPE="INTEGER"/>
      <FIELD NAME="Year"
             TYPE="INTEGER"/>
      <FIELD NAME="Who"
             TYPE="PCHAR">
        <META NAME="JUST"/>
      </FIELD>
      <FIELD NAME="Status"
             ENUMTYPE="ENTRYSTATUS"/>
    </FIELDS>
    <ATTRIBUTES>
      <ATTR NAME="DAY"
            TARGET="Day"/>
      <ATTR NAME="MONTH"
            TARGET="Month"/>
      <ATTR NAME="YEAR"
            TARGET="Year"/>
      <ATTR NAME="WHO"
            TARGET="Who"/>
      <ATTR NAME="STATUS"
            TARGET="Status"
            OPTIONAL="TRUE"/>
    </ATTRIBUTES>
  </ELEMENT>
  <ENUM NAME="ENTRYSTATUS"
        PREFIX=""
        POSTFIX="">
    <ENUMVALUE NAME="Proposed"/>
    <ENUMVALUE NAME="Cancelled"/>
    <ENUMVALUE NAME="Confirmed"/>
  </ENUM>
</SYSTEM>

DTD declaration

<!ELEMENT ATTR
(META)*
>

<!ATTLIST ATTR
     NAME CDATA  #REQUIRED
     TARGET CDATA  #IMPLIED
     DEFAULT CDATA  #IMPLIED
     OPTIONAL (TRUE|YES|yes|Y|y|ON|On|on|true|True|1|FALSE|NO|no|N|n|OFF|Off|off|false|False|0)  #IMPLIED
     ENTITIESINATTR (TRUE|YES|yes|Y|y|ON|On|on|true|True|1|FALSE|NO|no|N|n|OFF|Off|off|false|False|0)  #IMPLIED
     FIXED (TRUE|YES|yes|Y|y|ON|On|on|true|True|1|FALSE|NO|no|N|n|OFF|Off|off|false|False|0)  #IMPLIED
>