<element> element

SOAP/AM Client Development > Developer's Reference > Client Definition File Reference > Schema Reference >

<element> element

Previous pageReturn to chapter overviewNext page

This element represents an element of a <type>.

 

parents

type

children

none

Attributes

attribute name

data type

usage

default value

description

 

name

xsd:NCName

required

 

The name of the element. It must be unique within the parent <type>.

 

type

xsd:NCName

required

 

The data type of the element. Must be one of the built-in types or the name of another <type> element defined within <types>.

 

cdataWrapper

xsd:NCName

optional

 

If non-zero, the element content is wrapped in a CDATA section on serialization and upon deserialization, any CDATA sections are removed.

 

ddlName

xsd:NCName

optional

 

Alternate identifier to be used for the name of this element by the CDF2DDL utility when generating DDL. By default, CDF2DDL uses the value of the 'name' attribute as the corresponding DDL element name, but truncates or suffixes the name if it would violate DDL naming rules. Use this attribute to provide a DDL-compatible name.

 

dependsOn

xsd:NCName

optional

 

If maxOccurs is greater than 1, the name of an element (contained within the same <type> as this element) that indicates the number of array elements at runtime.

 

ignore

xsd:positiveInteger

optional

0

Indicates whether or not the element is serialize/deserialized. Typically used on elements serving as the 'dependsOn' for an array. If the value of this attribute is 0, the element is assumed to be included in the SOAP envelope. If non-zero, the element will not be included in the SOAP envelope.

 

minOccurs

xsd:positiveInteger

optional

1

If the element represents an array, the minimum number of occurrences.

 

maxOccurs

xsd:positiveInteger

optional

1

If the element represents an array, the maximum number of occurrences.

 

offset

xsd:nonNegativeInteger

optional

 

The position of this element relative to the start of the containing <type>, in bytes. If omitted, the offset is calculated based on the size and alignment rules of the preceding types.

 

size

xsd:positiveInteger

optional

 

The storage size for the element. If omitted, the default size for the type is assumed.

 

stringPadding

xsd:token

optional

 

Controls the way elements of type string are treated. The default value is inherited from the containing <type> element. Valid values are "zeros" and "spaces".

 

whitespace

xsd:NCName

optional

preserve

Causes an xml:space="default|preserve" attribute to be added to the element. Valid values are "default" and "preserve".

xsdType

xsd:NCName

optional

 

Indicates an alternate, standard XML schema type that should be used when serializing/deserializing this element to/from the SOAP envelope. If omitted, the SOAP envelope type is determined by the standard NSK/XSD type translation. A list of standard type translations can be found in built-in types.

 

encoding

xsd:NCName

optional

ISO-8859-1

Indicates an character encoding that should be used when serializing/deserializing this element to/from the SOAP envelope. If omitted, the default encoding is ISO-8859-1. A list of available encoding names can be found in Character Encoding Names.

Remarks

To override the default name generation behavior of CDF2DDL, use the ddlName attribute. To override the default data type translation behavior, modify the type attribute to the desired type name and set the xsdType to the type name that the Web service expects (what WSDL2CDF originally generated for the type attribute).