The complex property
@xsd provides a mapping
of data types for use when EGL code interacts with a Web service:
- On the service side of the transmission
- Establishes a set of validation rules that limit the kind of data that
will be provided to the service at run time
- On the client side
- Ensures a valid mapping between an EGL data type and the type of data
submitted to or received from the service
The @xsd property affects an XSD element in the Web Service Description
Language (WSDL) definition that is present on the service side of transmission
(when an EGL Web Service is running) or that is used for runtime processing
on the client side of transmission (when an EGL client is interacting with
a Web service). The property is available for DataItem parts, for primitive-field
declarations within a Record part, and for Record parts; but in most cases
you do not need to specify these properties because settings are provided
by default or by an EGL wizard.
Note: When you are specifying the property for a Record part or when you are
creating an interface to a Web service, the only property fields that have
an effect are elementName and namespace.
The
@xsd property fields and their types are as follows:
- elementName String
- Identifies the name of the xsd element in the WSDL definition. The default
is either the name of the EGL part name (for DataItem parts and Record parts)
or the name of an EGL variable (for primitive declarations in an EGL Record
part).
- namespace String
- Specifies the namespace that represents the scope in which the element
name resides. The default is the inversion of the EGL package name; if the
package is named a1.b2.c3, for example, the default namespace is c3.b2.a1.
- base STRING
- Indicates the xsd type in the WSDL definition of the element.
- minLength STRING
- Specifies the minimum valid length of input. This property field is meaningful
only in the following case:
- The xsd type is xsd:string or a value derived from xsd:string; and
- You are creating an EGL Web service.
In other cases, the property field is ignored.
- maxLength STRING
- Specifies the maximum valid length of input. This property field is meaningful
only in the following case:
- The XSD type is xsd:string or a value derived from xsd:string; and
- You are creating an EGL Web service.
In other cases, the property field is ignored.
- pattern STRING
- Specifies a regular expression used to validate the input. This property
field is meaningful only in the following case:
- The XSD type is xsd:string or a value derived from xsd:string; and
- You are creating an EGL Web service.
In other cases, the property field is ignored.
- enumeration STRING[ ]
- Specifies an array of valid values. This property field is meaningful
only in the following case:
- The XSD type is xsd:string or a value derived from xsd:string; and
- You are creating an EGL Web service.
In other cases, the property field is ignored.
- whitespace STRING
- Indicates how whitespace is handled, as described in the W3C Web site
mentioned earlier. This property field is meaningful only if you are creating
an EGL Web service and is otherwise ignored.
- maxInclusive STRING
- Indicates the maximum value of a xsd:string, xsd:time, or xsd:datetime
field when the value you specify is itself valid. This property field is meaningful
only when you create an EGL Web service and is otherwise ignored.
- minInclusive STRING
- Indicates the minimum value of a xsd:string, xsd:time, or xsd:datetime
field when the value you specify is itself valid. This property field is meaningful
only when you create an EGL Web service and is otherwise ignored.
- maxExclusive STRING
- Indicates the maximum value of a xsd:string, xsd:time, or xsd:datetime
field when the value you specify is not valid. This property field is meaningful
only when you create an EGL Web service and is otherwise ignored.
- minExclusive STRING
- Indicates the minimum value of a xsd:string, xsd:time, or xsd:datetime
field when the value you specify is not valid. This property field is meaningful
only when you create an EGL Web service and is otherwise ignored.
For details on default mappings. see Data conversions between WSDL and
EGL.