Attributes to Customize XML Serialization

Topics

Mapping between simple 4GL and XML data types
Facet constraints between simple 4GL and XML data types
XML Serialization Customizing

Without value
With a mandatory value

Default Mapping between XML and simple 4GL data types
Mapping Example

Mapping between simple 4GL and XML data types

The following attributes cannot have values:

Attribute	Definition
XSDAnySimpleType	Map 4GL STRING or VARCHAR to XML Schema simpleType.
XSDAnyType	Map 4GL STRING or VARCHAR to XML Schema anyType.
XSDAnyURI	Map 4GL STRING or VARCHAR to XML Schema anyURI.
XSDBase64binary	Map 4GL BYTE to the XML Schema base64binary.
XSDBoolean	Map 4GL BOOLEAN, SMALLINT or INTEGER to XML Schema boolean.
XSDByte	Map 4GL TINYINT, SMALLINT or BIGINT to XML Schema byte.
XSDDate	Map 4GL DATE or DATETIME to XML Schema date.
XSDDateTime	Map 4GL DATETIME to XML Schema dateTime.
XSDDecimal	Map 4GL DECIMAL to XML Schema decimal.
XSDDouble	Map 4GL FLOAT to XML Schema double.
XSDDuration	Map 4GL INTERVAL to XML Schema duration.
XSDEntities	Map 4GL STRING or VARCHAR to XML Schema entities.
XSDEntity	Map 4GL STRING or VARCHAR to XML Schema entity.
XSDFloat	Map 4GL SMALLFLOAT to XML Schema float.
XSDGday	Map 4GL DATETIME to XML Schema gDay.
XSDGMonth	Map 4GL DATETIME to XML Schema gMonth.
XSDGMonthDay	Map 4GL DATETIME to XML Schema gMonthDay.
XSDGYear	Map 4GL DATETIME to XML Schema gYear.
XSDGYearMonth	Map 4GL DATETIME to XML Schema gYearMonth.
XSDHexBinary	Map 4GL BYTE to XML Schema hexBinary.
XSDID	Map 4GL STRING or VARCHAR to XML Schema id.
XSDIDREF	Map 4GL STRING or VARCHAR to XML Schema idRef.
XSDIDREFS	Map 4GL STRING or VARCHAR to XML Schema idRefs.
XSDInt	Map 4GL INTEGER or BIGINT to XML Schema int.
XSDInteger	Map 4GL DECIMAL to XML Schema integer.
XSDLanguage	Map 4GL STRING or VARCHAR to XML Schema language.
XSDLong	Map 4GL BIGINT or DECIMAL to XML Schema long.
XSDNCName	Map 4GL STRING or VARCHAR to XML Schema NCName.
XSDName	Map 4GL STRING or VARCHAR to XML Schema Name.
XSDNegativeInteger	Map 4GL DECIMAL to XML Schema negativeInteger.
XSDNMTOKEN	Map 4GL STRING or VARCHAR to XML Schema NMToken.
XSDNMTOKENS	Map 4GL STRING or VARCHAR to XML Schema NMTokens.
XSDNonNegativeInteger	Map 4GL DECIMAL to XML Schema nonNegativeInteger.
XSDNonPositiveInteger	Map 4GL DECIMAL to XML Schema nonPositiveInteger.
XSDNormalizedString	Map 4GL STRING or VARCHAR to XML Schema normalizedString.
XSDNotation	Not supported.
XSDPositiveInteger	Map 4GL DECIMAL to XML Schema positiveInteger.
XSDQName	Map 4GL STRING or VARCHAR to XML Schema QName.
XSDShort	Map 4GL SMALLINT or BIGINT to XML Schema short.
XSDString	Map 4GL STRING , Char, Text or VarChar to XML Schema string.
XSDTime	Map 4GL DATETIME to XML Schema time.
XSDToken	Map 4GL STRING or VARCHAR to XML Schema token.
XSDUnsignedByte	Map 4GL SMALLINT or BIGINT to XML Schema unsignedByte.
XSDUnsignedInt	Map 4GL BIGINT or DECIMAL to XML Schema unsignedInt.
XSDUnsignedLong	Map 4GL DECIMAL to XML Schema unsignedLong.
XSDUnsignedShort	Map 4GL INTEGER or BIGINT to XML Schema unsignedShort.

Back to the top

Facet constraints between simple 4GL and XML data types

The following attributes are facet constraints depending on the XSD data type used on a simple 4GL variable to restrict the allowed value-space.
(Notice that some attributes are allowed only on some XSD data types).
Several facet constraints can be set on the same data type, and a mandatory values is expected ( for example, XSDMinLength="8")

Attribute	Definition
XSDLength	Define the exact number of XML character or bytes.
XSDMinLength	Define the minimum number of XML character or bytes.
XSDMaxLength	Define the maximum number of XML character or bytes.
XSDEnumeration	Define a list of allowed values separated by the character \|.
XSDWhiteSpace	Perform a XML string manipulation before serialization or deserialization.
XSDPattern	Define the regular expression the value has to match.
XSDMinInclusive	Define the inclusive minimum value according to the data type where it is set.
XSDMaxInclusive	Define the inclusive maximum value according to the data type where it is set.
XSDMinExclusive	Define the exclusive minimum value according to the data type where it is set.
XSDMaxExclusive	Define the exclusive maximum value according to the data type where it is set.
XSDTotalDigits	Define the total number of digits.
XSDFractionDigits	Define the number of digits of the fraction part.

Back to the top

XML Serialization Customizing

The following attributes are used to change the default serialization of 4GL into XML, and vice-versa. Some of these attributes cannot have values; for the others a value is mandatory.

The following attributes cannot have values:

Attribute	Definition
XMLOptional	Define whether the variable can be missing.
XMLElement	Map a 4GL simple data type to an XML Element.
XMLAttribute	Map a 4GL simple data type to an XML Attribute.
XMLBase	Set the base type of an XML Schema simpleContent.
XMLAll	Map a 4GL Record to an XML Schema all structure.
XMLChoice	Map a 4GL Record to an XML Schema choice structure.
XMLSequence	Map a 4GL Record to an XML Schema sequence structure.
XMLSimpleContent	Map a 4GL Record to an XML Schema simpleContent structure.
XSComplexType	Map a 4GL Record type definition to an XML Schema complexType.
XMLList	Map a one-dimensional array to an XML Schema list.
XMLSelector	Define which member of an XMLChoice record is selected.
XMLAny	Map a Xml.DomDocument object to a wildcard XML element node.
XMLAnyAttribute	Map a 4GL one-dimensional dynamic array of a record with 3 strings to XML wildcard attributes.

Values are mandatory for the following attributes: (for example, XMLName="myname")

Attribute	Definition
XMLName	Define the XML Name of a variable in an XML document.
XMLNamespace	Define the XML Namespace of a variable in an XML document.
XMLType	Force the XML type name of a variable.
XMLTypenamespace	Force the XML type namespace of a variable.
XSTypename	Define the XML Type Name of a 4GL type definition.
XSTypenamespace	Define the XML Type Namespace of a 4GL type definition.
XMLElementNamespace	Define the default XML namespace of all children defined as XMLElement in a Record.
XMLAttributeNamespace	Define the default XML namespace of all children defined as XMLAttribute in a Record.

Back to the top

Default XML Mapping

By default, GWS maps BDL variables in the input or output messages of a Genero Web Services application to their corresponding XML data types, enabling values to be passed between applications and Web Services. The XML data types conform to the standard XML Schema Definition (XSD):

Data Type of BDL variable	Default XML Data Type
BYTE	xsd:base64binary
CHAR	xsd:string
DATE	xds.date
DATETIME YEAR TO FRACTION(1-5)	xsd:dateTime
DATETIME YEAR TO SECOND	xsd:dateTime
DATETIME YEAR TO HOUR	xsd:dateTime
DATETIME YEAR TO MINUTE	xsd:dateTime
DATETIME YEAR TO YEAR	xsd:gYear
DATETIME YEAR TO MONTH	xsd:gYearMonth
DATETIME YEAR TO DAY	xsd:date
DATETIME MONTH TO MONTH	xsd:gMonth
DATETIME MONTH TO DAY	xsd:gMonthDay
DATETIME DAY TO DAY	xsd:gDay
DATETIME HOUR TO HOUR	xsd:time
DATETIME HOUR TO MINUTE	xsd:time
DATETIME HOUR TO SECOND	xsd:time
DATETIME HOUR TO FRACTION(1-5)	xsd:time
DECIMAL	xsd:decimal
FLOAT	xsd:double
INTEGER	xsd:int
INTERVAL	xsd:duration
SMALLFLOAT	xsd:float
SMALLINT	xsd:short
STRING	xsd:string
TEXT	xsd:string
VARCHAR	xsd:string
TINYINT	xsd:byte
BIGINT	xsd:long
BOOLEAN	xsd:boolean

In addition, the Web Service Style that you use determines what default XMLName attributes are assigned to variables.

Back to the top

Mapping Example

Starting with Genero 2.0, you can add optional attributes to the definition of variables. These attributes can be used to map a BDL data type used in the input or output message of a Genero Web Service application to a specific XML data type, rather than using the default. For example, BDL does not have a BOOLEAN data type. If an XML Schema boolean data type is required for an application, you can use an attribute to map a BDL SMALLINT to a boolean.

The following example uses the XSDBoolean attribute to map a BDL SMALLINT variable to an XML Schema boolean type, and assigns an uppercase name as the XMLName attribute:

GLOBALS

  DEFINE invoice_out RECORD
      ok SMALLINT ATTRIBUTE(XSDBoolean,XMLName="OK")
    END RECORD

END GLOBALS

If you assign your own XMLName attributes, be sure to respect the conventions when using the RPC Service Style.

See the Tutorial: Writing a GWS Server application for additional information about input and output messages.

Back to the top

XSDAnySimpleType

Map 4GL STRING or VARCHAR to XML Schema anySimpleType.

Back to the top

XSDAnyType

Map 4GL STRING or VARCHAR to XML Schema anyType.

Back to the top

XSDAnyURI

Map 4GL STRING or VARCHAR to XML Schema anyURI.

Back to the top

XSDBase64binary

Map 4GL BYTE to XML Schema base64binary.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 BYTE(XSDBase64binary,XMLName="Val")
END RECORD

<Root>
  <Val>F0FFC8D27FF001547FC219E1FFF009F0FFC8D27FF001547D</Val>
</Root>

Back to the top

XSDBoolean

Map 4GL BOOLEAN, SMALLINT or INTEGER to XML Schema boolean.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 INTEGER ATTRIBUTE(XSDBoolean,XMLName="Val")
END RECORD

<Root>
  <Val>true</Val>
</Root>

Back to the top

XSDByte

Map 4GL TINYINT, SMALLINT or BIGINT to XML Schema byte.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 SMALLINT ATTRIBUTE(XSDByte,XMLName="Val")
END RECORD

<Root>
  <Val>-126</Val>
</Root>

Back to the top

XSDDate

Map 4GL DATE or DATETIME to XML Schema date.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DATE ATTRIBUTE(XSDDate,XMLName="Val")
END RECORD

<Root>
  <Val>2006-06-29+01:00</Val>
</Root>

Back to the top

XSDDateTime

Map 4GL DATETIME to XML Schema dateTime.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DATETIME ATTRIBUTE(XSDDateTime,XMLName="Val")
END RECORD

<Root>
  <Val>2006-06-29T09:35:26.13584+01:00</Val>
</Root>

Back to the top

XSDDecimal

Map 4GL DECIMAL to XML Schema decimal.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DECIMAL(5,3) ATTRIBUTE(XSDDecimal,XMLName="Val")
END RECORD

<Root>
  <Val>12.345</Val>
</Root>

Back to the top

XSDDouble

Map 4GL FLOAT to XML Schema double.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 FLOAT ATTRIBUTE(XSDDouble,XMLName="Val")
END RECORD

<Root>
  <Val>12.78e-2</Val>
</Root>

Back to the top

XSDDuration

Map 4GL INTERVAL to XML Schema duration.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 INTERVAL DAY TO SECOND ATTRIBUTE(XSDDuration,XMLName="Val")
END RECORD

<Root>
  <Val>P3DT10H30M45S</Val>
</Root>

Back to the top

XSDEntities

Map 4GL STRING or VARCHAR to XML Schema ENTITIES.

Back to the top

XSDEntity

Map 4GL STRING or VARCHAR to XML Schema ENTITY.

Back to the top

XSDFloat

Map 4GL SMALLFLOAT to XML Schema float.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 SMALLFLOAT ATTRIBUTE(XSDFloat,XMLName="Val")
END RECORD

<Root>
  <Val>126.435</Val>
</Root>

Back to the top

XSDGday

Map 4GL DATETIME to XML Schema gDay.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DATETIME DAY TO DAY ATTRIBUTE(XSDGday,XMLName="Val")
END RECORD

<Root>
  <Val>---25</Val>
</Root>

Back to the top

XSDGMonth

Map 4GL DATETIME to XML Schema gMonth.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DATETIME MONTH TO MONTH ATTRIBUTE(XSDGMonth,XMLName="Val")
END RECORD

<Root>
  <Val>--12</Val>
</Root>

Back to the top

XSDGMonthDay

Map 4GL DATETIME to XML Schema gMonthDay.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DATETIME MONTH TO DAY ATTRIBUTE(XSDGMonthDay,XMLName="Val")
END RECORD

<Root>
  <Val>--12-31</Val>
</Root>

Back to the top

XSDGYear

Map 4GL DATETIME to XML Schema gYear.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DATETIME YEAR TO YEAR ATTRIBUTE(XSDGYear,XMLName="Val")
END RECORD

<Root>
  <Val>2006</Val>
</Root>

Back to the top

XSDGYearMonth

Map 4GL DATETIME to XML Schema gYearMonth.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DATETIME YEAR TO MONTH ATTRIBUTE(XSDGYearMonth,XMLName="Val")
END RECORD

<Root>
  <Val>2006-06</Val>
</Root>

Back to the top

XSDHexBinary

Map 4GL BYTE to XML Schema hexBinary.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 BYTE ATTRIBUTE(XSDHexBinary,XMLName="Val")
END RECORD

<Root>
  <Val>0FB6</Val>
</Root>

Back to the top

XSDID

Map 4GL STRING or VARCHAR to XML Schema ID.

Back to the top

XSDIDREF

Map 4GL STRING or VARCHAR to XML Schema IDREF.

Back to the top

XSDIDREFS

Map 4GL STRING or VARCHAR to XML Schema IDREFS.

Back to the top

XSDInt

Map 4GL INTEGER or BIGINT to XML Schema int.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 INTEGER ATTRIBUTE(XSDInt,XMLName="Val")
END RECORD

<Root>
  <Val>-1258</Val>
</Root>

Back to the top

XSDInteger

Map 4GL DECIMAL to XML Schema integer.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DECIMAL(32,0) ATTRIBUTE(XSDInteger,XMLName="Val")
END RECORD

<Root>
  <Val>12678</Val>
</Root>

Back to the top

XSDLanguage

Map 4GL STRING or VARCHAR to XML Schema language.

Back to the top

XSDLong

Map 4GL BIGINT or DECIMAL to XML Schema long.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DECIMAL(19,0) ATTRIBUTE(XSDLong,XMLName="Val")
END RECORD

<Root>
  <Val>1267488</Val>
</Root>

Back to the top

XSDNCName

Map 4GL STRING or VARCHAR to XML Schema NCName.

Back to the top

XSDName

Map 4GL STRING or VARCHAR to XML Schema Name.

Back to the top

XSDNegativeInteger

Map 4GL DECIMAL to XML Schema negativeInteger.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DECIMAL(32,0) ATTRIBUTE(XSDNegativeInteger,XMLName="Val")
END RECORD

<Root>
  <Val>-4828</Val>
</Root>

Back to the top

XSDNMTOKEN

Map 4GL STRING or VARCHAR to XML Schema NMToken.

Back to the top

XSDNMTOKENS

Map 4GL STRING or VARCHAR to XML Schema NMTokens.

Back to the top

XSDNonNegativeInteger

Map 4GL DECIMAL to XML Schema nonNegativeInteger.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DECIMAL(32,0) ATTRIBUTE(XSDNonNegativeInteger,XMLName="Val")
END RECORD

<Root>
  <Val>1589</Val>
</Root>

Back to the top

XSDNonPositiveInteger

Map 4GL DECIMAL to XML Schema nonPositiveInteger.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DECIMAL(32,0) ATTRIBUTE(XSDNonPositiveInteger,XMLName="Val")
END RECORD

<Root>
  <Val>-8574</Val>
</Root>

Back to the top

XSDNormalizedString

Map 4GL STRING or VARCHAR to XML Schema normalizedString.

Back to the top

XSDnotation

Not supported.

Back to the top

XSDPositiveInteger

Map 4GL DECIMAL to XML Schema positiveInteger.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DECIMAL(32,0) ATTRIBUTE(XSDPositiveInteger,XMLName="Val")
END RECORD

<Root>
  <Val>+41893</Val>
</Root>

Back to the top

XSDQName

Map 4GL STRING or VARCHAR to XML Schema QName.

Back to the top

XSDShort

Map 4GL SMALLINT or BIGINT to XML Schema short.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 SMALLINT ATTRIBUTE(XSDShort,XMLName="Val")
END RECORD

<Root>
  <Val>12678</Val>
</Root>

Back to the top

XSDString

Map 4GL STRING, CHAR, TEXT or VARCHAR to XML Schema string.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 STRING ATTRIBUTE(XSDString,XMLName="Val")
END RECORD

<Root>
  <Val>Hello world, how are you ?</Val>
</Root>

Back to the top

XSDTime

Map 4GL DATETIME to XML Schema time.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DATETIME ATTRIBUTE(XSDTime,XMLName="Val")
END RECORD

<Root>
  <Val>23:16:03.589+01:00</Val>
</Root>

Back to the top

XSDToken

Map 4GL STRING or VARCHAR to XML Schema token.

Back to the top

XSDUnsignedByte

Map 4GL SMALLINT or BIGINT to XML Schema unsignedByte.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 SMALLINT ATTRIBUTE(XSDUnsignedByte,XMLName="Val")
END RECORD

<Root>
  <Val>254</Val>
</Root>

Back to the top

XSDUnsignedInt

Map 4GL BIGINT or DECIMAL to XML Schema unsignedInt.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DECIMAL(32,0) ATTRIBUTE(XSDUnsignedInt,XMLName="Val")
END RECORD

<Root>
  <Val>1267896754</Val>
</Root>

Back to the top

XSDUnsignedLong

Map 4GL DECIMAL to XML Schema unsignedLong.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 DECIMAL(32,0) ATTRIBUTE(XSDUnsignedLong,XMLName="Val")
END RECORD

<Root>
  <Val>12678967543233</Val>
</Root>

Back to the top

XSDUnsignedShort

Map 4GL INTEGER or BIGINT to XML Schema unsignedShort.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 INTEGER ATTRIBUTE(XSDUnsignedShort,XMLName="Val")
END RECORD

<Root>
  <Val>65535</Val>
</Root>

Back to the top

XMLOptional

Define whether the variable can be missing or not. It specifies how a 4GL NULL value is interpreted in XML.

Notes:

The attribute cannot be set on a type definition.
The attribute cannot be set if the main variable is not a RECORD.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 INTEGER ATTRIBUTE(XSDint,XMLName="ValOne")
  val2 FLOAT ATTRIBUTE(XSDdouble,XMLName="ValTwo",XMLOptional)
END RECORD

<Root>
  <ValOne>458</ValOne>
  <ValTwo>58.48</ValTwo>
</Root>

<Root>
  <ValOne>458</ValOne>
</Root>

Back to the top

XMLElement (Optional)

Map a 4GL simple data type to an XML Element.

Note: The attribute cannot be set on a type definition.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 INTEGER ATTRIBUTE(XMLElement,XSDunsignedShort,XMLName="Val1")
  rec  RECORD ATTRIBUTE(XMLName="Rec")
    val2 FLOAT 	ATTRIBUTE(XMLElement,XMLName="Val2"),
    val3 STRING	ATTRIBUTE(XMLElement,XMLName="Val3")
  END RECORD
END RECORD

<Root>
  <Val1>148</Val1>
  <Rec1>
    <Val2>25.8</Val2>
    <Val3>Hello world</Val3>
  </Rec1>
</Root>

Back to the top

XMLAttribute

Map a 4GL simple data type to an XML Attribute.

Notes:

The attribute cannot be set on on a type definition.
The attribute can only be set on a RECORD's member.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1 INTEGER ATTRIBUTE(XMLAttribute,XSDunsignedShort,XMLName="Val1")
  rec  RECORD ATTRIBUTE(XMLName="Rec")
    val2  FLOAT ATTRIBUTE(XMLAttribute,XMLName="Val2"),
    val3  STRING ATTRIBUTE(XMLElement,XMLName="Val3")
  END RECORD
END RECORD

<Root Val1="148">
  <Rec1 Val2="25.8">
    <Val3>Hello world</Val3>
  </Rec1>
</Root>

Back to the top

XMLBase

Define the simple 4GL variable used as the base type of an XML Schema simpleContent structure.

The attribute can be set on one and only one member of a RECORD defined with the XMLSimpleContent attribute

Back to the top

XMLAll

Map a 4GL Record to an XML Schema all structure.

The order in which the record members appear in the XML document is not significant.

Example

DEFINE myall RECORD ATTRIBUTE(XMLAll,XMLName="Root")
  val1  INTEGER ATTRIBUTE(XMLName="Val1"),
              val2  FLOAT   ATTRIBUTE(XMLAttribute,XMLName="Val2"),
              val3  STRING  ATTRIBUTE(XMLName="Val3")
END RECORD

<Root Val2="25.8">
  <Val3>Hello world</Val3>
  <Val1>148</Val1>
</Root>

<Root Val2="25.8">
  <Val1>148</Val1>
  <Val3>Hello world</Val3>
</Root>

Back to the top

XMLChoice

Map a 4GL Record to an XML Schema choice structure.
The choice of the record's member is performed at runtime, and changes dynamically according to a mandatory member. This specific member must be of type SMALLINT or INTEGER, and have an XMLSelector attribute set. The XMLChoice attribute also supports a "nested" value that removes the surrounding XML tag.

Notes:

Valid selector values are indexes referring to members considered as XML element nodes. All other values will raise XML runtime errors.
Nested choice records cannot be defined as main variables; there must always be a surrounding variable.

Example

DEFINE mychoice RECORD ATTRIBUTE(XMLChoice,XMLName="Root")
  val1  INTEGER   ATTRIBUTE(XMLName="Val1")
  val2  FLOAT     ATTRIBUTE(XMLAttribute,XMLName="Val2"),
  sel   SMALLINT  ATTRIBUTE(XMLSelector),
  val3  STRING    ATTRIBUTE(XMLName="Val3")
END RECORD

Case where "sel" value is 4 Case where "sel" value is 1

<Root Val2="25.8">
  <Val3>Hello world</Val3>
</Root>

<Root Val2="25.8">
  <Val1>148</Val1>
</Root>

Nested Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1  INTEGER   ATTRIBUTE(XMLName="Val1")
  val2  FLOAT     ATTRIBUTE(XMLAttribute,XMLName="Val2"),
  choice RECORD   ATTRIBUTE(XMLChoice="nested")
    choice1   INTEGER   ATTRIBUTE(XMLName="ChoiceOne"),
    choice2   FLOAT     ATTRIBUTE(XMLName="ChoiceTwo"),
    nestedSel SMALLINT  ATTRIBUTE(XMLSelector)
  END RECORD,
  val3  STRING    ATTRIBUTE(XMLName="Val3")
END RECORD

Case where "nestedSel" value is 1 Case where "nestedSel" value is 2

<Root Val2="25.8">
  <Val1>148</Val1>
  <ChoiceOne>6584</ChoiceOne>
  <Val3>Hello world</Val3>
</Root>

<Root Val2="25.8">
  <Val1>148</Val1>
  <ChoiceTwo>85.8</ChoiceTwo>
  <Val3>Hello world</Val3>
</Root>

Back to the top

XMLSequence (Optional)

Map a 4GL Record to an XML Schema sequence structure.
The order in which the record members appear in the XML document must match the order of the 4GL Record.
The XMLSequence attribute also supports a "nested" value that removes the surrounding XML tag.

Note: Nested sequence records cannot be defined as main variables; there must always be a surrounding variable.

Example

DEFINE mysequence RECORD ATTRIBUTE(XMLSequence,XMLName="Root")
  val1  INTEGER   ATTRIBUTE(XMLName="Val1")
  val2  FLOAT     ATTRIBUTE(XMLAttribute,XMLName="Val2"),
  val3  STRING    ATTRIBUTE(XMLName="Val3")
END RECORD

<Root Val2="25.8">
  <Val1>-859</Val1>
  <Val3>Hello world</Val3>
</Root>

Nested Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1  INTEGER   ATTRIBUTE(XMLName="Val1")
  val2  FLOAT     ATTRIBUTE(XMLAttribute,XMLName="Val2"),
  sequence RECORD   ATTRIBUTE(XMLSequence="nested")
    seq1   INTEGER   ATTRIBUTE(XMLName="SeqOne"),
    seq2   FLOAT     ATTRIBUTE(XMLName="SeqTwo"),
  END RECORD,
  val3  STRING    ATTRIBUTE(XMLName="Val3")
END RECORD

<Root Val2="25.8">
  <Val1>148</Val1>
  <SeqOne>6584</SeqOne>
  <SeqTwo>85.597</SeqTwo>
  <Val3>Hello world</Val3>
</Root>

Back to the top

XMLSimpleContent

Map a 4GL Record to an XML Schema simpleContent structure.

Note: One member must have the XMLBase attribute; all other members must have an XMLAttribute attribute. If not, the compiler complains.

Example

DEFINE mysimpletype RECORD ATTRIBUTE(XMLSimpleContent,XMLName="Root")
  base  STRING  ATTRIBUTE(XMLBase),
  val1  INTEGER ATTRIBUTE(XMLAttribute,XMLName="Val1"),
  val2  FLOAT   ATTRIBUTE(XMLAttribute,XMLName="Val2")
END RECORD

<Root Val1="148" Val2="25.8">
  Hello
</Root>

Back to the top

XSComplexType

Map a 4GL Record type definition to an XML Schema complexType.

Note: You can have one member as a nested sequence or choice, or as an XMLList array with a nested sequence or choice as the array's elements; all other members must have an XMLAttribute attribute. If not, the compiler complains.

Example

TYPE mycomplextype RECORD ATTRIBUTE(XSComplexType,XSTypeName="MyComplexType",XSTypeNamespace="http://tempuri.org")
  name DYNAMIC ARRAY ATTRIBUTE(XMLList) OF RECORD ATTRIBUTE(XMLSequence="nested")
    firstname STRING ATTRIBUTE(XMLName="FirstName"), 
    lastname  STRING ATTRIBUTE(XMLName="LastName")
                                                                                                                                    END RECORD,
  date DATE ATTRIBUTE(XMLAttribute,XMLName="Date")
END RECORD

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://tempuri.org" elementFormDefault="qualified" >
  <xsd:complexType name="MyComplexType">
    <xsd:sequence maxOccurs="unbounded">
      <xsd:element name="FirstName" type="xsd:string" />
      <xsd:element name="LastName"  type="xsd:string" />
    </xsd:sequence>
    <xsd:attribute name="Date" type="xsd:date" use="required"/>
  </xsd:complexType>
</xsd:schema>

Back to the top

XMLList

Map a one dimensional array to an XML Schema element that has more than one occurrence.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
    val1  INTEGER ATTRIBUTE(XMLName="Val1"),
                list  DYNAMIC ARRAY ATTRIBUTE(XMLList) OF STRING ATTRIBUTE(XMLName="Element"),
                val2  FLOAT   ATTRIBUTE(XMLName="Val2")
END RECORD

<Root>
  <Val1>148</Val1>
  <Element>hello</Element>
  <Element>how</Element>
  <Element>are</Element>
  <Element>you</Element>
  <Val2>0.58</Val2>
</Root>

Note: It is not possible to define an XMLList attribute on a main array.

Back to the top

XMLSelector

Define the index of the candidate among all members of an XMLChoice record that will be serialized or de-serialized at runtime.
The index starts at 1.
The selector data type must be a SMALLINT or a INTEGER.

Back to the top

XMLAny

Map a Xml.DomDocument object to a wildcard XML element.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root",XMLNamespace="http://tempuri.org")
    val1  INTEGER ATTRIBUTE(XMLName="Val1"),
    any   Xml.DomDocument ATTRIBUTE(XMLAny,XMLNamespace="##other"),
    val2  FLOAT   ATTRIBUTE(XMLName="Val2")
END RECORD

<pre:Root xmlns:pre="http://tempuri.org" >
  <pre:Val1>148</pre:Val1>
  <pre2:Doc xmlns:pre2="http://www.mycompany.com">
     <pre2:Element>how</pre2:Element>
     <pre2:Element>are</pre2:Element>
     <pre2:Element>you</pre2:Element>
  </pre2:Doc>
  <pre:Val2>0.58</pre:Val2>
</pre:Root>

Note: Associated with XMLAny, the XMLNamespace attribute requires either:

a list of space-separated URIs to accept each attribute belonging to one of this namespace URI as a wildcard attribute.
the value ##any to accept any attribute as a wildcard attribute.
the value ##other to accept any attribute not in the main schema namespace as a wildcard attribute.

For example:

If XMLNamespace="http://tmpuri.org http://www.mycompany.com", then only the XML documents belonging to one of those namespaces will be accepted and serialized (or de-serialized) into the Xml.DomDocument object.
If XMLNamespace="##any", then any XML document will be accepted and serialized (or de-serialized) into the Xml.DomDocument object.
If XMLNamespace="##other", then any XML document not belonging to the targetNamespace of the XML Schema where the any definition is used will be accepted and serialized (or de-serialized) into the Xml.DomDocument object.

Back to the top

XMLAnyAttribute

Map a one-dimensional dynamic array to wildcard XML attributes.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root",XMLNamespace="http://tempuri.org")
    val1  INTEGER ATTRIBUTE(XMLName="Val1"),
    val2  FLOAT   ATTRIBUTE(XMLName="Val2"),
    attr  STRING  ATTRIBUTE(XMLName="Attr",XMLAttribute),
    any   DYNAMIC ARRAY ATTRIBUTE(XMLAnyAttribute,XMLNamespace="##other") OF RECORD
        ns  STRING,
        name  STRING,
        value  STRING
      END RECORD
END RECORD

<pre:Root xmlns:pre="http://tempuri.org" pre:Attr="10" xmlns:pre2="http://www.mycompany.com" pre2:AnyAttr1="10" pre2:AnyAttr2="">
  <pre:Val1>148</pre:Val1>
  <pre:Val2>0.58</pre:Val2>
</pre:Root>

Notes

The attribute XMLAnyAttribute is only allowed on a one-dimensional dynamic array of a record with three members of type STRING. The first member is for the namespace of the wildcard attribute, the second member is for the name of the wildcard attribute, and the third member is for the value of the wildcard attribute. The name cannot be null.
Associated with the XMLAnyAttribute, the XMLNamespace attribute requires either:
- a list of space-separated URIs to accept each attribute belonging to one of the namespace URIs as a wildcard attribute.
- the value ##any to accept any attribute as a wildcard attribute.
- the value ##other to accept any attribute not in the main schema namespace as a wildcard attribute.
For example:
- If XMLNamespace="http://tmpuri.org http://www.mycompany.com", then only the attributes belonging to one of those namespaces will be accepted and serialized (or de-serialized) into the array.
- If XMLNamespace="##any", then any attribute will be accepted and serialized (or de-serialized) into the array.
- If XMLNamespace="##other", then any attributes not belonging to the targetNamespace of the XML Schema where the anyAttribute definition is used will be accepted and serialized (or de-serialized) into the array.

Back to the top

XMLName

Define the name of a variable in an XML document.

Note: The attribute cannot be set on a type definition.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root")
  val1  INTEGER ATTRIBUTE(XMLName="Val1"),
  val2  FLOAT,
  val3  INTEGER ATTRIBUTE(XMLName="Val3"),
END RECORD

<Root>
  <Val1>148</Val1>
  <val2>0.5</val2>
  <Val3>-18547</Val3>
</Root>

Back to the top

XMLNamespace

Define the namespace of a variable in an XML document.

Notes:

If the attribute is set on a Record, by default all members defined as XMLElement of that record are in the same namespace.
If the attribute is set on an Array, by default all elements defined as XMLElement of that array are in the same namespace.
The attribute cannot be set on a type definition.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root",XMLNamespace="http://tempuri.org")
  attr1 INTEGER ATTRIBUTE(XMLAttribute,XMLName="Attr1"),
  val1  FLOAT   ATTRIBUTE(XMLName="Val1",XMLNamespace="http://www.mycompany.com"),
  val2  INTEGER ATTRIBUTE(XMLName="Val2"),
  attr2 STRING  ATTRIBUTE(XMLAttribute,XMLName="Attr2",XMLNamespace="http://anyuri.org"),
END RECORD

<fjs1:Root xmlns:fjs1="http://tempuri.org" Attr1="158" xmlns:fjs3="http://anyuri.org" fjs3:Attr2="Hello">
  <fjs2:Val1 xmlns:fjs2="http://www.mycompany.com">0.5</fjs2:Val1>
  <fjs1:Val2>-18547</fjs1:Val2>
</fjs1:Root>

Back to the top

XMLType

Force the XML type name of a variable by adding xsi:type at serialization or by checking xsi:type at deserialization.

Note: The attribute must be used with the XMLTypenamespace attribute; otherwise, the compiler complains.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root",XMLNamespace="http://tempuri.org")
  val1  FLOAT   ATTRIBUTE(XMLName="Val1"),
  val2  INTEGER ATTRIBUTE(XMLName="Val2",XMLType="MyRecord",XMLTypenamespace="http://mynamespace.org")
END RECORD

<fjs1:Root xmlns:fjs1="http://tempuri.org">
  <fjs1:Val1>0.5</fjs1:Val1>
  <fjs1:Val2 xmlns:fjs2="http://mynamespace.org" xsi:type="fjs2:MyRecord">-18547</fjs1:Val2>
</fjs1:Root>

Back to the top

XMLTypenamespace

Force the XML type namespace of a variable by adding xsi:type at serialization or by checking xsi:type at de-serialization.

Note: the attribute must be used with the XMLType attribute; otherwise the compiler complains.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root",XMLNamespace="http://tempuri.org")
  val1  FLOAT   ATTRIBUTE(XMLName="Val1"),
  val2  INTEGER ATTRIBUTE(XMLName="Val2",XMLType="MyRecord",XMLTypenamespace="http://mynamespace.org")
END RECORD

<fjs1:Root xmlns:fjs1="http://tempuri.org">
  <fjs1:Val1>0.5</fjs1:Val1>
  <fjs1:Val2 xmlns:fjs2="http://mynamespace.org" xsi:type="fjs2:MyRecord">-18547</fjs1:Val2>
</fjs1:Root>

Back to the top

XSTypename

Define the XML Schema name of a 4GL type definition.

Notes:

The attribute must be used with the XSTypenamespace attribute; otherwise the compiler complains.
The attribute is only allowed on a type definition.

Example

TYPE myType RECORD ATTRIBUTE(XMLSequence,XSTypeName="MyFirstType",XSTypeNamespace="http://tempuri.org")
  val1  FLOAT   ATTRIBUTE(XMLElement,XMLName="Val1"),
  val2  INTEGER ATTRIBUTE(XMLElement,XMLName="Val2",XMLOptional),
  attr  STRING  ATTRIBUTE(XMLAttribute,XMLName="Attr")
END RECORD

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://tempuri.org" elementFormDefault="qualified" >
  <xsd:complexType name="MyFirstType">
    <xsd:sequence>
      <xsd:element name="Val1" type="xsd:double" />
      <xsd:element name="Val2" type="xsd:int" minOccurs="0" />
    </xsd:sequence>
    <xsd:attribute name="Attr" type="xsd:string" use="required" />
  </xsd:complexType>
</xsd:schema>

Back to the top

XSTypenamespace

Define the XML Schema namespace of a 4GL type definition.

Notes:

The attribute must be used with the XSType attribute; otherwise the compiler complains.
The attribute is only allowed on a type definition.

Example

TYPE myType RECORD ATTRIBUTE(XMLChoice,XSTypeName="MyFirstChoice",XSTypeNamespace="http://tempuri.org")
  val1  FLOAT   ATTRIBUTE(XMLElement,XMLName="Val1"),
  val2  INTEGER ATTRIBUTE(XMLElement,XMLName="Val2",XMLOptional),
  attr  STRING  ATTRIBUTE(XMLAttribute,XMLName="Attr",XMLOptional),
  set   INTEGER ATTRIBUTE(XMLSelector)
END RECORD

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://tempuri.org" elementFormDefault="qualified" >
  <xsd:complexType name="MyFirstChoice">
    <xsd:choice>
      <xsd:element name="Val1" type="xsd:double" />
      <xsd:element name="Val2" type="xsd:int" minOccurs="0" />
    </xsd:choice>
    <xsd:attribute name="Attr" type="xsd:string" />
  </xsd:complexType>
</xsd:schema>

Back to the top

XMLElementNamespace

Define the default namespace of all members of a record also defined as XML elements.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root",XMLNamespace="http://tempuri.org",XMLElementNamespace="http://www.mycompany.com")
  val1  FLOAT   ATTRIBUTE(XMLElement,XMLName="Val1"),
  val2  INTEGER ATTRIBUTE(XMLElement,XMLName="Val2"),
  attr  STRING  ATTRIBUTE(XMLAttribute,XMLName="Attr"),               
END RECORD

<fjs1:Root xmlns:fjs1="http://tempuri.org" Attr="Hello" xmlns:fjs2="http://www.mycompany.com">
  <fjs2:Val1>0.5</fjs2:Val1>
  <fjs2:Val2>-18547</fjs2:Val2>
</fjs1:Root>

Back to the top

XMLAttributeNamespace

Define the default namespace of all members of a record also defined as XML attributes.

Example

DEFINE myVar RECORD ATTRIBUTE(XMLName="Root",XMLNamespace="http://tempuri.org",XMLAttributeNamespace="http://www.mycompany.com")
  val1  FLOAT   ATTRIBUTE(XMLElement,XMLName="Val1"),
  val2  INTEGER ATTRIBUTE(XMLElement,XMLName="Val2"),
  attr1 STRING  ATTRIBUTE(XMLAttribute,XMLName="Attr1"),               
  attr2 DATE    ATTRIBUTE(XMLAttribute,XMLName="Attr2",XMLNamespace="http://anyuri.org"),               
END RECORD

<fjs1:Root xmlns:fjs1="http://tempuri.org" fjs2:Attr1="Hello" xmlns:fjs2="http://www.mycompany.com" xmlns:fjs3="http://anyuri.org" fjs3:Attr2="2006-06-24">
  <fjs1:Val1>0.5</fjs1:Val1>
  <fjs1:Val2>-18547</fjs1:Val2>
</fjs1:Root>

Back to the top

XSDLength

Restrict the length of the data to the exact number of XML characters allowed when set on a 4GL STRING, VARCHAR, CHAR or TEXT, or the number of bytes allowed when set on a 4GL BYTE.

Notes:

XSDMinLength and XSDMaxLength can be used together, but XSDMaxLength value must be greater then XSDMinLength
XSDMaxLength cannot be used with XSDLength

Examples

DEFINE myStr STRING ATTRIBUTE(XSDString,XSDLength="12",XMLName="MyString")

DEFINE myByte BYTE ATTRIBUTE(XSDBase64Binary,XSDLength="8000",XMLName="MyPicture")

Back to the top

XSDMinLength

Restrict the length of the data to the minimum number of XML characters allowed when set on a 4GL STRING, VARCHAR, CHAR or TEXT, or the number of bytes allowed when set on a 4GL BYTE.

Notes:

XSDMinLength and XSDMaxLength can be used together, but XSDMaxLength value must be greater then XSDMinLength
XSDMaxLength cannot be used with XSDLength

Examples

DEFINE myStr STRING ATTRIBUTE(XSDString,XSDMinLength="12",XMLName="MyString")

DEFINE myByte BYTE ATTRIBUTE(XSDBase64Binary,XSDMinLength="8000",XMLName="MyPicture")

Back to the top

XSDMaxLength

Restrict the length of the data to the maximum number of XML characters allowed when set on a 4GL STRING, VARCHAR, CHAR or TEXT, or the number of bytes allowed when set on a 4GL BYTE.

Notes:

XSDMinLength and XSDMaxLength can be used together, but XSDMaxLength value must be greater then XSDMinLength
XSDMaxLength cannot be used with XSDLength

Examples

DEFINE myStr STRING ATTRIBUTE(XSDString,XSDMaxLength="12",XMLName="MyString")

DEFINE myByte BYTE ATTRIBUTE(XSDBase64Binary,XSDMaxLength="8000",XMLName="MyPicture")

Back to the top

XSDEnumeration

Restrict the allowed value-space to a list of values separated by the characters |.

Notes:

To escape the separator character, simply double it like the following ||
This attribute can be set on any simple 4GL variable excepted on XSDBoolean.

Examples

DEFINE myStr STRING ATTRIBUTE(XSDString,XSDEnumeration="one|two|three|four",XMLName="MyString")

DEFINE myDec DECIMAL(3,1) ATTRIBUTE(XSDDecimal,XSDEnumeration="12.1|11.8|-24.7",XMLName="MyDecimal")

Back to the top

XSDWhiteSpace

Perform a XML string manipulation before serialization or deserialization according to one of the three allowed values : preserve, replace or collapse.

preserve : the XML string is not modified.
replace : the XML string is modified by replacing each \n,\t,\r by a single space.
collapse : the XML string is modified by replacing each \n,\t,\r by a single space, then each sequence of several spaces are replaced by one single space. Leading and trainling spaces are removed too.

Notes:

The whiteSpace facet is always performed before any other facet constraints, or serialization or deserialization process.
For any 4GL variable excepted STRING,CHAR and VARCHAR, only collapse is allowed.

Examples

DEFINE myStr STRING ATTRIBUTE(XSDString,XSDWhiteSpace="replace",XMLName="MyString")

DEFINE myDec DECIMAL(3,1) ATTRIBUTE(XSDDecimal,XSDWhiteSpace="collapse",XMLName="MyDecimal")

Back to the top

XSDPattern

Define a regular expression the value has to match to be serialized or deserialized without any error.

Notes:

The regular expression is defined in the XML Schema Part 2 specification available here.
Backslash characters '\' in a regular expression must be escaped by duplicating it.

Examples

DEFINE myStr STRING ATTRIBUTE(XSDString,XSDPattern="A.*Z",XMLName="MyString")

DEFINE myZipCode INTEGER ATTRIBUTE(XSDInt,XSDPattern="[0-9]{5}",XMLName="MyZipCode")

DEFINE myOtherZipCode INTEGER ATTRIBUTE(XSDInt,XSDPattern="\\d{5}",XMLName="myOtherZipCode") # regex is \d{5} see note

Back to the top

XSDMinInclusive

Define the minimum inclusive value allowed and depending on the data type where it is set, namely all numeric, date and time data types.

Note: The minimum value cannot exceed the implicit minimum value supported by the data type itself or the compiler will complain. For instance, with XSDShort the minimum value is -32768.

Examples

DEFINE myCode SMALLINT ATTRIBUTE(XSDShort,XSDMinInclusive="-1000",XMLName="MyCode")

DEFINE myRate DECIMAL(4,2) ATTRIBUTE(XSDDecimal,XSDMinInclusive="100.01",XMLName="MyRate")

Back to the top

XSDMaxInclusive

Define the maximum inclusive value allowed and depending on the data type where it is set, namely all numeric, date and time data types.

Note: The maximum value cannot exceed the implicit maximum value supported by the data type itself or the compiler will complain. For instance, with XSDShort the maximum value is 32767.

Examples

DEFINE myCode SMALLINT ATTRIBUTE(XSDShort,XSDMaxInclusive="1000",XMLName="MyCode")

DEFINE myRate DECIMAL(4,2) ATTRIBUTE(XSDDecimal,XSDMaxInclusive="299.99",XMLName="MyRate")

Back to the top

XSDMinExclusive

Define the minimum exclusive value allowed and depending on the data type where it is set, namely all numeric, date and time data types.

Note: The minimum value cannot exceed or be equal to the implicit minimum value supported by the data type itself or the compiler will complain. For instance, with XSDShort the minimum value is -32768.

Examples

DEFINE myCode SMALLINT ATTRIBUTE(XSDShort,XSDMinExclusive="-1000",XMLName="MyCode")

DEFINE myRate DECIMAL(4,2) ATTRIBUTE(XSDDecimal,XSDMinExclusive="100.01",XMLName="MyRate")

Back to the top

XSDMaxExclusive

Define the maximum exclusive value allowed and depending on the data type where it is set, namely all numeric, date and time data types.

Note: The maximum value cannot exceed or be equal to the implicit maximum value supported by the data type itself or the compiler will complain. For instance, with XSDShort the maximum value is 32767.

Examples

DEFINE myCode SMALLINT ATTRIBUTE(XSDShort,XSDMaxExclusive="1000",XMLName="MyCode")

DEFINE myRate DECIMAL(4,2) ATTRIBUTE(XSDDecimal,XSDMaxExclusive="299.99",XMLName="MyRate")

Back to the top

XSDTotalDigits

Define the maximum number of digits allowed on a numeric data type, fraction part inclusive if there is one.

Notes:

The total digits value cannot be equal or lower then 0.
On a 4GL decimal, the total digits value cannot be lower than the precision of the 4GL decimal itself.
Notice that a decimal without any precision and scale value is a decimal(16), therfore the total digits value must be equal or greater than 16.

Examples

DEFINE myCode SMALLINT ATTRIBUTE(XSDShort,XSDTotalDigits="4",XSDMaxExclusive="1000",XMLName="MyCode")

DEFINE myRate DECIMAL(4,2) ATTRIBUTE(XSDDecimal,XSDTotalDigits="5",XSDMaxExclusive="299.99",XMLName="MyRate")

Back to the top

XSDFractionDigits

Define the maximum number of digits allowed on the fraction part of a numeric data type.

Notes:

The fraction digits value set on a 4GL data type without XSDDecimal set, can only be 0.
On a 4GL decimal, the fraction digits value cannot be lower than the scale of the 4GL decimal itself, and must be lower than the XSDTotalDigits value if set.

Examples

DEFINE myCode SMALLINT ATTRIBUTE(XSDShort,XSDFractionDigits="0",XSDMaxExclusive="1000",XMLName="MyCode")

DEFINE myRate DECIMAL(4,2) ATTRIBUTE(XSDDecimal,XSDTotalDigits="5",XSDFractionDigits="3",XSDMaxExclusive="299.99",XMLName="MyRate")

Back to the top