Table of contents

Appendices

2.3 Part

The Part Component[top]

A part component describes a portion of a particular message that a web service sends or receives. The format of a part is described by reference to type definition or element declaration components. Such components may be drawn from any appropriate type system. However WSDL makes special recognition of the XML Schema language [XMLSchemaP1],[XMLSchemaP2] as the RECOMMENDED type specification language (see [Types]).

Part components are local to a given message component, they cannot be referred to by QName.

The properties of the Part Component are as follows:

• {name} An NCName as defined by [XMLNS].

• {content reference} A reference to either an element declaration or a type definition component

For each part component in the {parts} property of a given message component the {name} property MUST be unique.

XML Representation of Part Component[top]

The XML representation for a part definition is an element information item with the following Infoset properties;

• A [local name] of part

• A [namespace name] of http://www.w3.org/2003/03/wsdl

• Two or more attribute information items amongst its [attributes] as follows;

  • A name attribute information item as described below in [ ].

  • One of the following;

    • An element attribute information item as described below in [ ].

    • A type attribute information item as described below in [ ].

    • A namespace qualified attribute information item in a namespace other than http://www.w3.org/2003/03/wsdl indicating the validation rules for this part in an alternative schema language.

  • Zero or more namespace qualified attribute information items. The [namespace name] of such attribute information items MUST NOT be http://www.w3.org/2003/03/wsdl.

• Zero or more element information items amongst its [children] in order, as follows;

  • An optional documentation element information item (see [Documentation]) amongst its [children].

  • Zero or more namespace qualified element information items. Such element information items MUST be a member of one of the element substitution groups related to message parts described in [Language Extensibility].

A part carries information about its type system by the reference contained in the type, element, or alternative qualified attribute information item. The schema language used is determined by examining the referred-to namespace and associating it with an imported or embedded schema. WSDL uses the type and element attribute information items to refer to constructs in XML Schema [XMLSchemaP1],[XMLSchemaP2]. Alternative schema languages may re-use these attribute information items if appropriate. If the concepts embodied by the type and element attribute information item are not appropriate for an alternative schema language, that language should specify an alternative attribute information item with prescribed semantics. Such attribute information items are not defined by this specification.

name attribute information item with part [owner][top]

The name attribute information item identifies a given part element information item inside a given message element information item.

The name attribute information item has the following Infoset properties:

• A [local name] of name

• A [namespace name] which has no value

The type of the name attribute information item is xs:NCName.

element attribute information item[top]

The element attribute information item refers, by QName, to an element declaration component.

The element attribute information item has the following Infoset properties:

• A [local name] of element

• A [namespace name] which has no value

The type of the element attribute information item is xs:QName.

type attribute information item[top]

The type attribute information item refers, by QName, to a type description component.

The type attribute information item has the following Infoset properties:

• A [local name] of type

• A [namespace name] which has no value

The type of the type attribute information item is xs:QName.

Mapping Part's XML Representation to Component Properties[top]

The mapping between the properties of the Part Component (see [The Part Component]) and the XML Representation of the part element information item (see [XML Representation of Part Component]) is as described in [tab_Part_Mapping].