Langage de description de services web (WSDL) version 2.0 tome 1 — Cœur du langage

1.4.1 Mots-clés du RFC 2119

Les mots-clés « DOIT », « NE DOIT PAS », « OBLIGATOIRE », « DEVRA », « NE DEVRA PAS », « DEVRAIT », « NE DEVRAIT PAS », « RECOMMANDÉ », « PEUT » et « OPTIONNEL » dans ce document doivent s'interpréter selon le RFC 2119 [IETF RFC 2119].

1.4.2 Espaces de noms du RFC 3986

Les noms d'espaces de noms de la forme générale "http://example.org/..." ou "http://example.com/..." représentent des adresses URI d'application ou dépendantes du contexte [IETF RFC 3986].

1.4.3 Type anyURI de XML Schema

Cette spécification utilise le type xs:anyURI de XML Schema, cf. [XML Schema: Datatypes]. Il est défini de façon à ce que les valeurs xs:anyURI soient essentiellement des adresses IRI, cf. [IETF RFC 3987]. La conversion des valeurs xs:anyURI en adresses URI réelles intervient au travers d'une procédure d'échappement (escaping procedure) définie dans [XLink 1.0], laquelle est essentiellement identique à celle décrite dans la section 3.1 de [IETF RFC 3987]).

Pour l'interopérabilité, les créateurs (authors) WSDL sont conviés à ne pas utiliser les caractères US-ASCII suivants : « < », « > », « " », espace, « { », « } », « | », « \ », « ^ » et « ` », admis dans les valeurs de type xs:anyURI mais pas dans les adresses IRI.

1.4.4 Préfixes et espaces de noms utilisés dans cette spécification

Cette spécification utilise tout du long des préfixes d'espaces de noms prédéfinis ; les voici dans la liste suivante. Notez que le choix d'un préfixe d'espace de noms est arbitraire et n'a pas d'importance sémantique (cf. [XML Namespaces]).

1.4.5 Termes utilisés dans cette spécification

Cette section décrit les termes et concepts introduits dans le tome 1 de la spécification WSDL version 2.0 (ce document).

Valeur réelle

Comme dans la spécification [XML Schema : Structures], l'expression « valeur réelle » (actual value) se rapporte au membre de l'espace de valeurs de la définition de type simple associée à un item d'information d'attribut qui correspond à sa valeur normalisée. Ce sera souvent une chaîne mais ça peut être un entier, un booléen, une adresse IRI, etc.

Schéma incorporé

Un schéma XML défini dans l'item d'information d'élément wsdl:types d'une description WSDL 2.0. Par exemple, un schéma XML défini dans l'item d'information d'élément xs:schema, cf. la section 3.1.2 Incorporation d'un schéma XML.

1.4.6 Propriétés de l'ensemble d'information XML

Cette spécification se réfère à des propriétés dans l'ensemble d'information XML [XML Information Set]. Ces propriétés sont signalées par des crochets, ainsi [children] et [attributes].

1.4.7 Propriétés du modèle de composants WSDL 2.0

Cette spécification définit et se réfère à des propriétés du modèle de composants WSDL 2.0, cf. la section 2. Modèle de composants. Ces propriétés sont signalées par des accolades, ainsi {name}, {interfaces}.

Cette spécification obéit à une convention d'écriture cohérente pour les propriétés du modèle de composants qui se rapportent aux composants. Si une propriété se rapporte à un composant obligatoire ou optionnel, le nom de propriété est le même que celui du composant. Si une propriété se rapporte à un ensemble de composants, le nom de propriété prend alors la forme du pluriel du nom de composant.

1.4.8 Notation Z

La notation Z [Z notation Reference Manual] a été utilisée pour le développement de cette spécification. La notation Z est un langage de définition formel fondé sur une notation mathématique standard. La notation Z de cette spécification a été contrôlée à l'aide du vérificateur de saisie (type-checker) Fuzz 2000 [Fuzz 2000].

La notation Z n'étant pas très connue, elle n'est pas incluse dans la version normative de cette spécification. Par contre, la notation Z est incluse dans une version non normative, où on peut la cacher ou la faire apparaître dynamiquement. Les navigateurs affichent correctement les caractères Unicode mathématiques, à condition que les fontes (fonts) nécessaires soient installées. Les fontes mathématiques pour Mozilla Firefox sont téléchargeables sur le site web de Mozilla.

La notation Z a été utilisée pour améliorer la qualité du texte normatif définissant le modèle de composants et pour s'assurer que la suite de tests couvrait toutes les règles importantes impliquées par le modèle de composants. Par contre, la notation Z n'étant pas normative, tout conflit intervenant entre elle et le texte normatif sera considéré comme une erreur de la notation Z. Les lecteurs et les développeurs (implementers) peuvent néanmoins trouver la notation Z utile lorsque le texte normatif n'est pas clair.

La syntaxe de la notation Z présente deux aspects contredisant les conventions d'écriture décrites dans les sections précédentes. Dans la notation Z, les crochets servent à introduire des ensembles de base, par exemple [ID], en contradiction de leur utilisation pour signaler les propriétés de l'ensemble d'information XML, cf. la section 1.4.6 Propriétés de l'ensemble d'information XML. Dans la notation Z encore, les accolades servent à indiquer un ensemble et son contenu, par exemple {1, 2, 3}, en contradiction de leur utilisation pour signaler les propriétés du modèle de composants de WSDL 2.0, cf. la section 1.4.7 Propriétés du modèle de composants WSDL 2.0. Quoi qu'il en soit, la signification attendue des crochets et des accolades devrait être claire dans le contexte, et ces conflits d'écriture ne devraient pas entraîner de confusion.

1.4.9 Pseudo-schémas BNF

Des pseudo-schémas sont fournis pour chaque composant en préalable de leur description. Ils utilisent des conventions de type BNF pour les attributs et les éléments : un caractère « ? » indique une nature optionnelle (c'est-à-dire zéro ou une apparition), un caractère « * » indique zéro ou plus apparitions, le caractère « + » indique une ou plusieurs apparitions, les caractères « [ » et « ] » servent à former des groupes, et le caractère « | » représente un choix. Les attributs reçoivent conventionnellement une valeur qui correspond à leur type, tel que défini dans le schéma normatif. Les éléments à contenu simple reçoivent conventionnellement une valeur qui correspond au type de leur contenu, tel que défini dans le schéma normatif. Les pseudo-schémas ne contiennent pas de points d'extension pour la concision.

<!-- exemple de pseudo-schéma -->
<élément_défini
      attribut_obligatoire_de_type_string="xs:string"
      attribut_optionnel_de_type_int="xs:int"? >
  <élément_obligatoire />
  <élément_optionnel />?
  <un_ou_plusieurs_de_ces_éléments />+
  [ <choix_1 /> | <choix_2 /> ]*
</élément_défini>

1.4.10 Assertions

Les assertions concernant des documents et des composants WSDL 2.0 que le schéma XML de WSDL 2.0 ne fait pas valoir (non enforced) sont signalées par une croix « † » en fin de phrase. À chaque assertion est affecté un identificateur unique composé d'un préfixe textuel descriptif et d'un suffixe numérique unique. Les suffixes numériques sont attribués successivement et jamais réutilisés ; il peut donc y avoir des trous dans la succession. Les identificateurs d'assertion PEUVENT être utilisés par les mises en œuvre de cette spécification quel qu'en soit le but, par exemple pour l'identification d'erreurs (error reporting).

Les assertions et leurs identificateurs sont repris dans la section E. Récapitulatif des assertions.

2.1.1 Le composant Description

Au niveau supérieur, le composant Description est juste un conteneur pour deux catégories de composants : les composants WSDL 2.0 (WSDL 2.0 components) et les composants de système de typage (type system components).

Les composants WSDL 2.0 sont des interfaces, des liaisons et des services. Les composants de système de typage sont des déclarations d'éléments et des définitions de types.

Les composants de système de typage décrivent les contraintes exercées sur le contenu d'un message. Par défaut, ces contraintes sont exprimées en fonction de l'ensemble d'information XML [XML Information Set], c'est-à-dire qu'elles définissent les propriétés de nom local [local name], de nom d'espace de noms [namespace name], de sous-éléments [children] et d'attributs [attributes] d'un item d'information d'élément. Les systèmes de typage fondés sur d'autres modèles de données sont généralement pris en charge par des extensions de WSDL 2.0 ; cf. la section 6. Extensibilité du langage. Au cas où une extension définit des informations équivalentes à celles d'une déclaration d'élément global XML Schema, on peut la traiter comme si elle était une telle déclaration.

Cette spécification ne définit pas quel serait le comportement d'un document WSDL 2.0 utilisant simultanément plusieurs langages de schéma pour décrire des composants de système de typage.

Un composant Element Declaration définit le nom et le modèle de contenu d'un item d'information d'élément tels ceux définis par une déclaration d'élément globale XML Schema. Le composant a une propriété {name} qui est le nom qualifié QName de l'item d'information d'élément et une propriété {system} qui est l'adresse IRI de l'espace de noms des items d'information d'élément d'extension du système de typage, par exemple l'espace de noms de XML Schema.

Un composant Type Definition définit le modèle de contenu d'un item d'information d'élément tel que celui défini par une définition de type globale XML Schema. Le composant a une propriété {name} qui est le nom qualifié QName du type et une propriété {system} qui est l'adresse IRI de l'espace de noms des items d'information d'élément du système de typage, par exemple l'espace de noms de XML Schema.

Les composants Interface, Binding, Service, Element Declaration et Type Definition sont directement contenus dans le composant Description ; on les appelle des composants de niveau supérieur (top-level components). Les composants WSDL 2.0 de niveau supérieur contiennent d'autres composants, par exemple les composants Interface Operation et Endpoint, que l'on appelle des composants nichés (nested components). Les composants nichés peuvent contenir d'autres composants nichés. Le composant contenant un composant niché est appelé le parent (parent) du composant niché. Les composants nichés ont une propriété {parent} qui est une référence à leur composant parent.

Les propriétés du composant Description sont les suivantes :

• {interfaces}, OPTIONNELLE. Un ensemble de composants Interface.

• {bindings}, OPTIONNELLE. Un ensemble de composants Binding.

• {services}, OPTIONNELLE. Un ensemble de composants Service.

• {element declarations}, OPTIONNELLE. Un ensemble de composants Element Declaration.

• {type definitions}, OBLIGATOIRE. Un ensemble de composants Type Definition.

L'ensemble des composants de niveau supérieur contenus dans le composant Description associé au document WSDL 2.0 initial se compose des composants définis dans le document initial, plus les composants associés aux documents WSDL 2.0 inclus par le document initial, plus les composants définis par les autres documents WSDL 2.0 dans les espaces de noms importés par le document initial. Le modèle de composants ne fait aucune distinction entre les composants définis dans le document initial et ceux définis dans les documents inclus ou les espaces de noms importés. Par contre, tout document WSDL 2.0 contenant des définitions de composants qui se réfèrent par un nom qualifié QName à des composants WSDL 2.0 appartenant à un espace de noms différent DOIT contenir un item d'information d'élément wsdl:import pour cet espace de noms (cf. la section 4.2 Importation des descriptions). En outre, toutes les références QName (QName references), qu'elles soient au même espace de noms ou à des espaces de noms différents, doivent se résoudre en composants (cf. la section 2.17 Résolution des noms qualifiés QName).

Lorsqu'on utilise le langage XML Schema pour décrire des composants de système de typage, l'inclusion des composants Element Declaration et Type Definition dans un composant Description obéit aux règles édictées dans la section 3.1 Utilisation du langage de définition XML Schema du W3C.

Outre des composants WSDL 2.0 et des composants de système de typage, on PEUT ajouter des composants d'extension supplémentaires, cf. la section 6. Extensibilité du langage. On PEUT aussi ajouter par extension des propriétés supplémentaires aux composants WSDL 2.0 et aux composants de système de typage.

2.1.2 Représentation XML du composant Description

<description
      targetNamespace="xs:anyURI" >
  <documentation />*
  [ <import /> | <include /> ]*
  <types />?
  [ <interface /> | <binding /> | <service /> ]*
</description>

Les descriptions WSDL 2.0 sont représentées en XML par un ou plusieurs ensembles d'information WSDL 2.0, c'est-à-dire un ou plusieurs items d'information d'élément description. Un ensemble d'information WSDL 2.0 contient les représentations d'une collection de composants WSDL 2.0 partageant un espace de noms cible commun et zéro ou plus items d'information d'élément wsdl:import, cf. la section 4.2 Importation des descriptions, correspondant à une collection avec des composants de plusieurs espaces de noms cibles.

Les composants définis ou inclus directement dans un composant Description sont dits appartenir au même espace de noms cible (target namespace). Ainsi, l'espace de noms cible regroupe un ensemble de définitions de composants liés et représente un nom univoque pour la sémantique attendue de la collection de composants. La valeur de l'item d'information d'attribut targetNamespace DEVRAIT être résolvable ^†. Elle DEVRAIT se résoudre en un document exploitable par un humain ou une machine définissant directement ou indirectement la sémantique attendue de ces composants ^†. Elle PEUT se résoudre en un document WSDL 2.0 fournissant une information de description de service pour cet espace de noms ^†.

Si un document WSDL 2.0 est scindé en plusieurs documents WSDL 2.0 (lesquels peuvent être combinés au besoin selon les indications de la section 4.1 Inclusion des descriptions), alors l'item d'information d'élément targetNamespace DEVRAIT se résoudre en un document WSDL 2.0 maître comprenant tous les documents WSDL 2.0 nécessaires pour cette description de service ^†. Cette approche permet la bonne résolution des identificateurs de fragment d'indicateur de composant WSDL 2.0.

Les composants appartenant à des espaces de noms importés ont des valeurs d'espace de noms cible différentes de celle du document WSDL 2.0 importeur. L'importation est donc le mécanisme pour utiliser des composants d'un espace de noms dans la définition de composants d'un autre espace de noms.

Notez que chaque document WSDL 2.0 ou composant de système de typage de même nature doit être identifié de façon unique par son nom qualifié. C'est-à-dire que, si deux composants distincts de même nature (Interface, Binding, etc.) sont dans le même espace de noms cible, alors leurs noms qualifiés DOIVENT être uniques. En revanche, des composants de types différents (par exemple, un composant Interface et un composant Binding) PEUVENT avoir le même nom qualifié QName. Les noms qualifiés des composants doivent donc être uniques dans l'espace de ces composants au sein d'un espace de noms cible donné.

L'item d'information d'élément description a les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de description ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• un ou plusieurs items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut targetNamespace OBLIGATOIRE comme décrit à la section 2.1.2.1 Item d'information d'attribut targetNamespace ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit ^† :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément parmi les suivants, dans un ordre quelconque :

     • zéro ou plus items d'information d'élément include (cf. la section 4.1 Inclusion des descriptions) ;

     • zéro ou plus items d'information d'élément import (cf. la section 4.2 Importation des descriptions) ;

     • zéro ou plus items d'information d'éléments, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

  3. un item d'information d'élément types OPTIONNEL (cf. la section 3. Types) ;

  4. zéro ou plus items d'information d'élément parmi les suivants, dans un ordre quelconque :

     • un item d'information d'élément interface (cf. la section 2.2.2 Représentation XML du composant Interface) ;

     • des items d'information d'élément binding (cf. la section 2.7.2 Représentation XML du composant Binding) ;

     • des items d'information d'élément service (cf. la section 2.12.2 Représentation XML du composant Service) ;

     • zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

2.1.3 Correspondance de la représentation XML de Description aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément description (cf. la section 2.1.2 Représentation XML du composant Description) aux propriétés du composant Description est décrite dans le tableau 2-1.

2.2.1 Le composant Interface

Un composant Interface décrit les séquences de messages qu'un service envoie ou reçoit. Il regroupe les messages liés en opérations. Une opération est une séquence de messages entrants et sortants, et une interface est un ensemble d'opérations.

Une interface peut en option étendre une ou plusieurs interfaces. Afin d'éviter les définitions circulaires, une interface NE DOIT PAS apparaître dans l'ensemble d'interfaces qu'elle étend, que ce soit directement ou indirectement ^†. L'ensemble des opérations disponibles dans une interface comprend toutes les opérations définies par les interfaces que cette interface étend directement ou indirectement, ainsi que toutes les opérations qu'elle définit directement. Les opérations définies directement dans une interface sont appelées les opérations déclarées (declared operations) de l'interface. Au cours du processus, les composants d'opération équivalents, selon la section 2.15 Équivalence des composants, sont traités comme un seul composant. Le mécanisme d'extension d'interface agit de façon similaire pour tous les autres composants susceptibles d'être définis dans une interface, à savoir les composants Interface Fault.

Les interfaces sont des structures nommées qui peuvent être appelées par un nom qualifié QName (cf. la section 2.17 Résolution des noms qualifiés QName). Les composants Binding, par exemple, se réfèrent aux interfaces de cette façon.

Les propriétés du composant Interface sont les suivantes :

• {name}, OBLIGATOIRE. Un nom qualifié xs:QName.

• {extended interfaces}, OPTIONNELLE. Un ensemble de composants Interface déclarés que cette interface étend.

• {interface faults}, OPTIONNELLE. L'ensemble des composants Interface Fault déclarés. Notez que le nom d'espace de noms de la propriété {name} de chaque composant Interface Fault dans cet ensemble est le même que celui de la propriété {name} de ce composant Interface.

• {interface operations}, OPTIONNELLE. Un ensemble de composants Interface Operation déclarés. Notez que le nom d'espace de noms de la propriété {name} de chaque composant Interface Operation dans cet ensemble est le même que celui de la propriété {name} de ce composant Interface.

Pour chaque composant Interface dans la propriété {interfaces} d'un composant Description, la propriété {name} DOIT être unique ^†.

2.2.2 Représentation XML du composant Interface

<description>
  <interface
        name="xs:NCName" 
        extends="liste de xs:QName"?
        styleDefault="liste de xs:anyURI"? >
    <documentation />*
    [ <fault /> | <operation /> ]*
  </interface>
</description>

La représentation XML d'un composant Interface est un item d'information d'élément avec les propriétés d'ensemble d'information suivante :

• un nom local [local name] de interface ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• un ou plusieurs items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut name OBLIGATOIRE comme décrit ci-dessous à la section 2.2.2.1 Item d'information d'attribut name avec élément possesseur [owner element] interface ;

  • un item d'information d'attribut extends OPTIONNEL comme décrit ci-dessous à la section 2.2.2.2 Item d'information d'attribut extends ;

  • un item d'information d'attribut styleDefault OPTIONNEL comme décrit ci-dessous à la section 2.2.2.3 Item d'information d'attribut styleDefault ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément parmi les suivants, dans un ordre quelconque :

     • zéro ou plus items d'information d'élément fault, cf. la section 2.3.2 Représentation XML du composant Interface Fault ;

     • zéro ou plus items d'information d'élément operation, cf. la section 2.4.2 Représentation XML du composant Interface Operation ;

     • zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

2.2.3 Correspondance de la représentation XML de Interface aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément interface (cf. la section 2.2.2 Représentation XML du composant Interface) aux propriétés du composant Interface est décrite dans le tableau 2-2.

Rappellez-vous, cf. la section 2.2.1 Le composant Interface, que les composants Interface dans la propriété {extended interfaces} d'un composant Interface donné NE DOIVENT PAS contenir de composant Interface dans l'une de leurs propriétés {extended interfaces}, pour dire que les interfaces d'extension récursives sont prohibées.

2.3.1 Le composant Interface Fault

Un incident (fault) est un événement survenant pendant l'exécution d'un échange de messages, qui bouleverse le flux normal des messages.

Un incident survient typiquement lorsqu'une partie est dans l'impossibilité de communiquer une condition d'erreur dans le flux de messages normal ou souhaite terminer un échange de messages. Un message d'incident peut être utilisé pour communiquer une information hors bande telle que la raison de l'erreur, l'origine de la panne, ainsi que d'autres diagnostics informels tel qu'une trace de pile de programme (program stack trace).

Un composant Interface Fault décrit un incident qui PEUT se produire au cours de l'invocation d'une opération de l'interface. Le composant Interface Fault déclare un incident abstrait en le nommant et en indiquant le contenu du message d'incident. Le composant Interface Operation indique quand et comment le message d'incident circule.

Le composant Interface Fault fournit un mécanisme clair pour nommer et décrire l'ensemble des incidents qu'une interface peut générer. Cela permet aux opérations d'identifier aisément par leur nom les incidents individuels que les interfaces peuvent générer. Ce mécanisme permet d'identifier immédiatement le même incident survenant à travers plusieurs opérations et référencé dans plusieurs liaisons, et de réduire la multiplication des descriptions d'un incident individuel.

D'autres incidents que ceux décrits dans le composant Interface peuvent également être générés à l'exécution (at run-time), c'est-à-dire que les incidents forment un ensemble ouvert. Le composant Interface décrit les incidents ayant une sémantique au niveau de l'application, c'est-à-dire que le client ou le services sont censés les prendre en charge et potentiellement récupérer d'eux, dans le cadre de la logique de traitement de l'application. Par exemple, un composant Interface qui accepte un numéro de carte de crédit peut décrire les incidents indiquant que le numéro de la carte est invalide, qu'elle a été signalée volée ou qu'elle est périmée. Le composant Interface ne décrit pas les incidents de systèmes généraux tels que les pannes de réseau, les conditions de dépassement de mémoire, les conditions de pénurie d'espace disque, les formats de message invalides, etc., même si ces incidents peuvent survenir dans le cadre de l'échange de messages. De tels incidents de systèmes généraux peuvent survenir au cours de n'importe quel échange de messages et les décrire explicitement dans un composant Interface n'est donc pas informatif.

Les propriétés du composant Interface Fault sont les suivantes :

• {name}, OBLIGATOIRE. Un nom qualifié xs:QName ;

• {message content model}, OBLIGATOIRE. Un type xs:token ayant l'une des valeurs suivantes : #any, #none, #other ou #element ^†. Une valeur de #any indique que le contenu des incidents est n'importe quel élément seul ; une valeur de #none indique qu'il n'y aucun contenu d'incident ; une valeur de #other indique que le contenu d'incident est décrit par une autre propriété d'extension référençant une déclaration dans un système de typage d'extension non-XML ; une valeur de #element indique que l'incident se compose d'un seul élément décrit par la déclaration d'élément globale référencée par la propriété {element declaration}. Cette propriété n'est utilisée que si l'incident est décrit en utilisant un modèle de données fondé sur XML ;

• {element declaration}, OPTIONNELLE. Une référence à un composant Element Declaration dans la propriété {element declarations} du composant Description. Cet élément représente le contenu, ou « charge utile » (payload), de l'incident. Lorsque la propriété {message content model} a la valeur #any ou #none, la propriété {element declaration} DOIT être vide ^† ;

• {parent}, OBLIGATOIRE. Le composant Interface qui contient ce composant dans sa propriété {interface faults}.

Pour chaque composant Interface Fault dans la propriété {interface faults} d'un composant Interface, la propriété {name} doit être unique. Notez que le schéma XML normatif de WSDL 2.0 fait valoir cette contrainte.

Les composants Interface Fault sont identifiés de manière unique par le nom qualifié QName du composant Interface englobant et le nom qualifié du composant Interface Fault même.

Au cas où deux (ou plus) composants Interface Fault ont des propriétés {name} de même valeur, en raison d'une interface qui étend une ou plusieurs autres interfaces, alors les modèles de composant de ces composants Interface Fault DOIVENT être équivalents (cf. la section 2.15 Équivalence des composants) ^†. Si les composants Interface Fault sont équivalents, alors ils sont censés fusionner en un seul composant. Au sein du même composant Interface, si deux composants Interface Fault ne sont pas équivalents, alors leurs propriétés {name} NE DOIVENT PAS être égales.

À cause des règles précédentes, notez que si deux interfaces ont la même valeur de nom d'espace de noms pour leurs propriétés {name} et ont aussi un ou plusieurs incidents avec la même valeur pour leurs propriétés {name}, alors ces interfaces ne peuvent pas les deux former une partie de la chaîne de dérivation d'une interface dérivée, à moins que ces incidents n'en soient qu'un.

Pour la raison précédente, une bonne pratique DEVRAIT être de s'assurer, le cas échéant, que le nom local de la propriété {name} des composants Interface Fault au sein d'un espace de noms soit unique, rendant ainsi possible une telle dérivation sans erreur accidentelle ^†.

Si un sytème de typage non fondé sur l'ensemble d'information XML [XML Information Set] est en vigueur (comme examiné dans la section 3.2 Utitilisation d'autres langages de schéma), alors il faudrait ajouter d'autres propriétés au composant Interface Fault (en même temps que des attributs d'extension à sa représentation XML) afin de pouvoir associer ces types de message au message de référence.

2.3.2 Représentation XML du composant Interface Fault

<description>
  <interface>
    <fault
          name="xs:NCName" 
          element="union de xs:QName, xs:token"? >
      <documentation />*
    </fault>
  </interface>
</description>

La représentation XML d'un composant Interface Fault est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de fault ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• un ou plusieurs items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut name OBLIGATOIRE comme décrit ci-dessous à la section 2.3.2.1 Item d'information d'attribut name avec élément possesseur [owner element] fault ;

  • un item d'information d'attribut element OPTIONNEL comme décrit à la section 2.3.2.2 Item d'information d'attribut element avec élément possesseur [owner element] fault ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

2.3.3 Correspondance de la représentation XML de Interface Fault aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément fault (cf. la section 2.3.2 Représentation XML du composant Interface Fault) aux propriétés du composant Interface Fault est décrite dans le tableau 2-3.

2.4.1 Le composant Interface Operation

Un composant Interface Operation décrit une opération prise en charge par une interface donnée. Une opération est une interaction avec le service consistant en un ensemble de messages échangés (ordinaires et d'incident) entre le service et les autres parties prenantes de l'interaction. Le séquencement (sequencing) et la cardinalité des messages impliqués dans une interaction particulière sont régis par le modèle d'échange de messages (message exchange pattern) utilisé par l'opération (cf. la propriété {message exchange pattern}).

Un modèle d'échange de messages définit les paramètres fictifs (placeholders) des messages, les participants du modèle (c'est-à-dire les émetteurs et les récepteurs des messages), et la cardinalité et le séquencement des messages échangés par les participants. Les paramètres fictifs de message sont associés à des types de message spécifiques par l'opération utilisant le modèle au moyen de références de message et d'incident (cf les propriétés {interface message references} et {interface fault references}). Le service dont l'opération utilise le modèle devient un participant du modèle. Cette spécification ne définit pas de langage interprétable par une machine pour décrire des modèles d'échange de messages ni ne définit de modèles spécifiques. La spécification complémentaire [WSDL 2.0 Adjuncts] définit un ensemble de tels modèles et définit des adresses IRI d'identification, dont chacune PEUT être utilisée comme valeur de la propriété {message exchange pattern}.

Les propriétés du composant Interface Operation sont les suivantes :

• {name}, OBLIGATOIRE. Un nom qualifié xs:QName ;

• {message exchange pattern}, OBLIGATOIRE. Un type xs:anyURI identifiant le modèle d'échange de messages utilisé par l'opération. Cette adresse xs:anyURI DOIT être une adresse IRI absolue (cf. [IETF RFC 3987]) ^† ;

• {interface message references}, OPTIONNELLE. Un ensemble de composants Interface Message Reference pour les messages ordinaires que l'opération accepte ou envoie ;

• {interface fault references}, OPTIONNELLE. Un ensemble de composants Interface Fault Reference pour les messages d'incident que l'opération accepte ou envoie ;

• {style}, OPTIONNELLE. Un ensemble d'adresses xs:anyURI identifiant les règles utilisées pour construire les propriétés {element declaration} de la propriété {interface message references} (cf. la section 2.4.1.2 Style d'opération). Ces adresses xs:anyURI DOIVENT être des adresses IRI absolues (cf. [IETF RFC 3986]) ^† ;

• {parent}, OBLIGATOIRE. Le composant Interface qui contient ce composant dans sa propriété {interface operations}.

Pour chaque composant Interface Operation dans la propriété {interface operations} d'un composant Interface, la propriété {name} DOIT être unique. Notez que le schéma XML normatif de WSDL 2.0 fait valoir cette contrainte.

Les composants Interface Operation sont identifiés de manière unique par le nom qualifié QName du composant Interface englobant et le nom qualifié QName du composant Interface Operation même.

Au cas où deux (ou plus) composants Interface Operation ont des propriétés {name} de même valeur, en raison d'une interface qui étend une ou plusieurs interfaces, alors les modèles de composant de ces composants Interface Operation DOIVENT être équivalents (cf. la section 2.15 Équivalence des composants) ^†. Si les composants Interface Operation sont équivalents, alors ils sont censés fusionner en un seul composant. Au sein du même document Interface, si deux composants Interface Operation ne sont pas équivalents, alors leurs propriétés {name} NE DOIVENT PAS être égales.

À cause des règles précédentes, notez que si deux interfaces ont la même valeur de nom d'espace de noms pour leurs propriétés {name} et ont aussi une ou plusieurs opérations avec la même valeur pour leurs propriétés {name}, alors ces interfaces ne peuvent pas les deux former une partie de la chaîne de dérivation d'une interface dérivée, à moins que ces opérations n'en soient qu'une.

Pour la raison précédente, une bonne pratique DEVRAIT être de s'assurer, le cas échéant, que le nom local de la propriété {name} des composants Interface Operation au sein d'un espace de noms soit unique, rendant ainsi possible une telle dérivation sans erreur accidentelle ^†

Plusieurs composants Interface Fault Reference dans la propriété {interface fault references} d'un composant Interface Operation peuvent se rapporter au même libellé de message (message label). Auquel cas, les types d'incident listés définissent les autres messages d'incident. Cela permet d'indiquer qu'il y a plus d'un type d'incident lié à ce message.

2.4.2 Représentation XML du composant Interface Operation

<description>
  <interface>
    <operation
          name="xs:NCName" 
          pattern="xs:anyURI"?
          style="liste de xs:anyURI"? >
      <documentation />*
      [ <input /> | <output /> | <infault /> | <outfault /> ]*
    </operation>
  </interface>
</description>

La représentation XML d'un composant Interface Operation est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de operation ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• deux ou plus items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut name OBLIGATOIRE comme décrit ci-dessous à la section 2.4.2.1 Item d'information d'attribut name avec élément possesseur [owner element] operation ;

  • un item d'information d'attribut pattern OPTIONNEL comme décrit ci-dessous à la section 2.4.2.2 Item d'information d'attribut pattern avec élément possesseur [owner element] operation ;

  • un item d'information d'attribut style OPTIONNEL comme décrit ci-dessous à la section 2.4.2.3 Item d'information d'attribut style avec élément possesseur [owner element] operation ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont l'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• un ou plusieurs items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. un ou plusieurs items d'information d'élément parmi les suivants, dans un ordre quelconque :

     • un ou plusieurs items d'information d'élément parmi les suivants, dans un ordre quelconque :

       • zéro ou plus items d'information d'élément input (cf. la section 2.5.2 Représentation XML du composant Interface Message Reference) ;

       • zéro ou plus items d'information d'élément output (cf. la section 2.5.2 Représentation XML du composant Interface Message Reference) ;

       • zéro ou plus items d'information d'élément infault (cf. la section 2.6.2 Représentation XML du composant Interface Fault Reference) ;

       • zéro ou plus items d'information d'élément outfault (cf. la section 2.6.2 Représentation XML du composant Interface Fault Reference).

     • zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

2.4.3 Correspondance de la représentation XML de Interface Operation aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément operation (cf. la section 2.4.2 Représentation XML du composant Interface Operation) aux propriétés du composant Interface Operation (cf. la section 2.4.1 Le composant Interface Operation) est décrite dans le tableau 2-4.

2.5.1 Le composant Interface Message Reference

Un composant Interface Message Reference définit le contenu, ou charge utile, d'un message échangé dans une opération. Par défaut, le contenu du message est défini par un système de typage fondé sur XML tel que XML Schema. D'autres systèmes de typage peuvent être utilisés via le mécanisme d'extension de système de typage de WSDL 2.0.

Un modèle d'échange de messages définit un ensemble de messages fictifs, qui interviennent dans le modèle, et leur affecte des libellés de message (message labels) uniques (par exemple, 'In', 'Out'). Le but d'un composant Interface Message Reference est d'associer un élément de message réel (une déclaration de message XML ou un autre déclaration ; cf. la section 3.2 Utilisation d'autres langages de schéma) à un message dans le modèle, identifié par un libellé de message. Plus tard, à l'instanciation du modèle d'échange de messages, les messages correspondant à ce libellé particulier suivront les affectations d'éléments faites par le composant Interface Message Reference.

Les propriétés du composant Interface Message Reference sont les suivantes :

• {message label}, OBLIGATOIRE. Un nom sans deux-points xs:NCName (Non-Colon Name). Cette propriété identifie le rôle joué par le message dans la propriété {message exchange pattern} du composant Interface Operation contenant le message. La valeur de cette propriété DOIT correspondre au nom d'un message fictif défini par le modèle d'échange de messages ^† ;

• {direction}, OBLIGATOIRE. Un type xs:token ayant la valeur in ou out, indiquant respectivement si le message arrive au service ou en vient ^†. La direction DOIT être la même que celle du message identifié par la propriété {message label} dans la propriété {message exchange pattern} du composant Interface Operation contenant le message ^† ;

• {message content model}, OBLIGATOIRE. Un type xs:token avec l'une des valeurs suivantes : #any, #none, #other ou #element ^†. Une valeur de #any indique que le contenu du message est un élément seul ; une valeur de #none indique que le message n'a pas de contenu ; une valeur de #other indique que le contenu du message est décrit par une autre propriété d'extension référençant une déclaration dans un système de typage d'extension non-XML ; une valeur de #element indique que le message se compose d'un seul élément décrit par la déclaration d'élément globale référencée par la propriété {element declaration}. Cette propriété n'est utilisée que si le message est décrit en utilisant un modèle de données fondé sur XML ;

• {element declaration}, OPTIONNELLE. Une référence à un composant Element Declaration dans la propriété {element declarations} du composant Description. Cette élément représente le contenu ou « charge utile » du message. Lorsque la propriété {message content model} a la valeur #any ou #none, la propriété {element declaration} DOIT être vide ^† ;

• {parent}, OBLIGATOIRE. Le composant Interface Operation qui contient ce composant dans sa propriété {interface message references}.

Pour chaque composant Interface Message Reference dans la propriété {interface message references} d'un composant Interface Operation, sa propriété {message label} DOIT être unique ^†.

Si un système de typage non fondé sur l'ensemble d'information XML est en vigueur (comme étudié dans la section 3.2 Utilisation d'autres langages de schéma), alors il faudrait ajouter les propriétés supplémentaires au composant Interface Message Reference (en même temps que les attributs d'extension à sa représentation XML) afin de pouvoir associer ces types de message à la référence de message.

2.5.2 Représentation XML du composant Interface Message Reference

<description>
  <interface>
    <operation>
      <input
            messageLabel="xs:NCName"?
            element="union de xs:QName, xs:token"? >
        <documentation />*
      </input>
      <output
            messageLabel="xs:NCName"?
            element="union de xs:QName, xs:token"? >
        <documentation />*
      </output>
    </operation>
  </interface>
</description>

La représentation XML d'un composant Interface Message Reference est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de input ou output ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• zéro ou plus items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut messageLabel OPTIONNEL comme décrit ci-dessous à la section 2.5.2.1 Item d'information d'attribut messageLabel avec élément possesseur [owner element] input ou output ;

  • un item d'information d'attribut element OPTIONNEL comme décrit ci-dessous à la section 2.5.2.2 Item d'information d'attribut element avec élément possesseur [owner element] input ou output ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

2.5.3 Correspondance de la représentation XML de Interface Message Reference aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément de la référence de message d'interface (cf. la section 2.5.2 Représentation XML du composant Interface Message Reference) aux propriétés du composant Interface Message Reference (cf. la section 2.5.1 Le composant Interface Message Reference) est décrite dans le tableau 2-5 et utilise les définitions suivantes.

Définir le modèle d'échange de messages de l'item d'information d'élément comme étant la propriété {message exchange pattern} du composant Interface Operation parent.

Définir la direction de message de l'item d'information d'élément comme valant in si le nom local de celui-ci est input, et out si le nom local est output.

Notez que l'item d'information d'attribut messageLabel d'un item d'information d'élément de la référence de message d'interface doit être présent si le modèle d'échange de messages a plus d'un message fictif dont la propriété {direction} est égale à la direction du message.

Si l'item d'information d'attribut messageLabel d'un item d'information d'élément d'une référence de message d'interface est présent, alors sa valeur réelle DOIT correspondre à la propriété {message label} d'un message fictif dont la propriété {direction} est égale à la direction du message ^†.

Si l'item d'information d'attribut messageLabel d'un item d'information d'élément d'une référence de message d'interface est absent, alors il DOIT y avoir un message fictif unique dont la propriété {direction} est égale à la direction du message ^†.

Définir le libellé de message effectif (effective message label) d'un item d'information d'élément d'une référence de message d'interface comme étant soit la valeur réelle de l'item d'information d'attribut messageLabel si présent, soit la propriété {message label} du message fictif unique dont la propriété {direction} est égale à la direction du message si l'item d'information d'attribut est absent.

Si le nom local est input, alors le modèle d'échange de messages DOIT avoir au moins un message fictif avec une direction de "In" ^†.

Si le nom local est output, alors le modèle d'échange de messages DOIT avoir au moins un message fictif avec une direction de "Out" ^†.

Si le nom local est infault, alors le modèle d'échange de messages DOIT comporter au moins un incident dans la direction "In" ^†.

Si le nom local est outfault, alors le modèle d'échange de messages DOIT comporter au moins un incident dans la direction "Out" ^†.

2.6.1 Le composant Interface Fault Reference

Un composant Interface Fault Reference associe un type défini, indiqué par un composant Interface Fault, à un message d'incident échangé dans une opération.

Un modèle d'échange de messages définit un ensemble de messages fictifs, qui interviennent dans le modèle, et leur affecte des libellés de message uniques au sein du modèle (par exemple, "In", "Out"). Le but d'un composant Interface Fault Reference est d'associer un type de message réel (une déclaration d'élément XML ou une autre déclaration, cf. la section 3.2 Utilisation d'autres langages de schéma en contenu du message, défini par un composant Interface Fault) à un message d'incident survenant dans le modèle. Pour identifier le message d'incident qu'il décrit, le composant Interface Fault Reference utilise le libellé du message auquel il se rapporte comme clé.

Comme indiqué précédemment, la spécification complémentaire [WSDL 2.0 Adjuncts] définit plusieurs règlements de propagation d'incident utilisables par un modèle d'échange de messages donné. Pour le règlement fault-replaces-message, le message auquel se rapporte l'incident identifie le message à la place duquel le message d'incident déclaré apparaîtra. Ainsi, le message d'incident voyagera dans la même direction que celle du message qu'il remplace dans le modèle. Pour le règlement message-triggers-fault, le message auquel l'incident se rapporte identifie le message à la suite duquel l'incident indiqué peut apparaître, en direction opposée du message en question. C'est-à-dire que le message d'incident voyagera dans la direction opposée du message qu'il suit dans le modèle d'échange de messages.

Les propriétés du composant Interface Fault Reference sont les suivantes :

• {interface fault}, OBLIGATOIRE. Un composant Interface Fault dans la propriété {interface faults} du composant Interface parent [parent] (ou dans un composant Interface qui étend celui-ci directement ou indirectement) du composant Interface Operation parent [parent]. L'identification du composant Interface Fault définit donc indirectement le contenu (ou charge utile) réel du message d'incident ;

• {message label}, OBLIGATOIRE. Un nom de type xs:NCName. Cette propriété identifie le message auquel cet incident se rapporte parmi ceux définis dans la propriété {message exchange pattern} du composant Interface Operation dans lequel le message est contenu. La valeur de cette propriété DOIT correspondre au nom d'un message fictif défini par le modèle d'échange de messages ^† ;

• {direction}, OBLIGATOIRE. Un type xs:token avec l'une des valeurs in ou out, indiquant respectivement si l'incident arrive au service ou en vient. La direction DOIT être cohérente avec celle impliquée par le règlement de propagation d'incident utilisé dans le modèle d'échange de messages de l'opération ^†. Par exemple, si le règlement fault-replaces-message est utilisé, alors un incident se rapportant à un message sortant aurait une valeur de propriété {direction} de out. Par contre, si c'est le règlement message-triggers-fault, alors un incident se rapportant à un message sortant aurait une valeur de propriété {direction} de in puisque l'incident voyage dans la direction opposée de celle du message ;

• {parent}, OBLIGATOIRE. Le composant Interface Operation qui contient ce composant dans sa propriété {interface fault references}.

Pour chaque composant Interface Fault Reference dans la propriété {interface fault references} d'un composant Interface Operation, la combinaison de ses propriétés {interface fault} et {message label} DOIT être unique ^†.

2.6.2 Représentation XML du composant Interface Fault Reference

<description>
  <interface>
    <operation>
      <infault
            ref="xs:QName"
            messageLabel="xs:NCName"? >
        <documentation />*
      </infault>*
      <outfault
            ref="xs:QName"
            messageLabel="xs:NCName"? >
        <documentation />*
      </outfault>*
    </operation>
  </interface>
</description>

La représentation XML d'un composant Interface Fault Reference est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de infault ou outfault ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• un ou plusieurs items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut ref OBLIGATOIRE comme décrit ci-dessous à la section 2.6.2.1 Item d'information d'attribut ref avec élément possesseur [owner element] infault ou outfault ;

  • un item d'information d'attribut messageLabel OPTIONNEL comme décrit ci-dessous à la section 2.6.2.2 Item d'information d'attribut messageLabel avec élément possesseur [owner element] infault ou outfault ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

2.6.3 Correspondance de la représentation XML de Interface Fault Reference aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément de la référence de message (cf. la section 2.6.2 Représentation XML du composant Interface Fault Reference) aux propriétés du composant Interface Fault Reference (cf. la section 2.6.1 Le composant Interface Fault Reference) est décrite dans le tableau 2-6 et utilise les définitions suivantes.

Définir le modèle d'échange de messages de l'item d'information d'élément comme étant la propriété {message exchange pattern} du composant Interface Operation parent [parent].

Définir la direction d'incident de l'item d'information d'élément comme étant in si le nom local de celui-ci est infault, et out si le nom local est outfault.

Définir la direction de message de l'item d'information d'élément comme étant la propriété {direction} du message fictif associé à l'incident comme indiqué par le règlement de propagation d'incident du modèle d'échange de messages.

L'item d'information d'attribut messageLabel d'un item d'information d'élément de référence d'incident d'interface DOIT être présent si le modèle d'échange de messages a plus d'un message fictif dont la propriété {direction} est égale à la direction du message ^†.

Si l'item d'information d'attribut messageLabel d'un item d'information d'élément de référence d'incident d'interface est présent, alors sa valeur réelle DOIT correspondre à la propriété {message label} d'un message fictif dont la propriété {direction} est égale à la direction du message ^†.

Si l'item d'information d'attribut messageLabel d'un item d'information d'élément de référence d'incident d'interface est absent, alors il DOIT y avoir un seul message fictif dont la propriété {direction} est égale à la direction du message ^†.

Définir le libellé de message effectif d'un item d'information d'élément de référence d'incident d'interface comme étant soit la valeur réelle de l'item d'information d'attribut messageLabel si présent, soit la propriété {message label} du message fictif unique dont la propriété {direction} est égale à la direction du message si l'item d'information d'attribut est absent.

2.7.1 Le composant Binding

Un composant Binding décrit un format de message et un protocole de transmission concrets que l'on peut utiliser pour définir une extrémité (cf. la section 2.13 Extrémité). C'est-à-dire qu'un composant Binding définit les détails de mise en œuvre nécessaires pour accéder au service.

Les composants Binding peuvent être utilisés pour décrire de telles informations de manière réutilisable pour toute interface ou spécifiquement pour une interface donnée. En outre, on PEUT définir des informations de liaison par opération (cf. la section 2.9.1 Le composant Binding Operation) au sein d'une interface, en plus de les définir sur toutes les opérations de l'interface.

Si un composant Binding définit des détails de liaison spécifiques d'une opération (par des composants Binding Operation) ou des détails d'incident de liaison (par des composants Binding Fault), alors il DOIT définir l'interface à laquelle il s'applique, pour indiquer de quelle interface les opérations proviennent ^†.

Inversement, un composant Binding qui omet de détailler la liaison spécifique d'une opération et les incidents de liaison PEUT omettre d'indiquer une interface. Les composants Binding qui n'indiquent pas d'interface PEUVENT être utilisés pour définir des détails de liaison indépendants d'une opération pour les composants Service avec diverses interfaces. C'est-à-dire que ces composants Binding sont réutilisables à travers une ou plusieurs interfaces.

Cette spécification ne détaille aucune liaison concrète. La spécification complémentaire Langage de description de services web (WSDL) version 2.0 tome 2 — Compléments [WSDL 2.0 Adjuncts] définit de telles liaisons pour SOAP 1.2 [SOAP 1.2 Part 1: Messaging Framework (Second Edition)] et HTTP [IETF RFC 2616]. D'autres spécifications PEUVENT définir des détails de liaison supplémentaires. Ces spécifications sont censées annoter le composant Binding (et ses sous-composants) avec des propriétés supplémentaires et définir la correspondance de la représentation XML à ces propriétés.

Un composant Binding qui définit les liaisons d'un composant Interface DOIT définir les liaisons de toutes les opérations de ce composant Interface ^†. Les liaisons peuvent être établies via des règles par défaut (defaulting rules) permettant de définir des liaisons par défaut pour toutes les opérations et tous les incidents (par exemple, cf. [WSDL 2.0 Adjuncts]), ou en définissant les liaisons de chaque composant Interface Operation et Interface Fault du composant Interface.

De la même façon, à chaque fois qu'un composant Binding réutilisable (c'est-à-dire l'un n'indiquant pas de composant Interface) est appliqué à un composant Interface spécifique dans le contexte d'un composant Endpoint (cf. la section 2.13.1 Le composant Endpoint), le composant Binding DOIT définir les liaisons de chaque composant Interface Operation et Interface Fault du composant Interface, via une combinaison de propriétés définies sur le composant Binding même et les règles de liaison par défaut spécifiques de son type de liaison ^†.

Un composant Binding qui définit les liaisons d'un composant Interface DOIT définir les liaisons de tous les incidents de ce composant Interface référencés par les opérations dans ce composant Interface ^†. Comme pour les opérations, la liaison peut être définie par des règles par défaut. Notez que seuls les incidents réellement référencés par des opérations sont tenus d'avoir des liaisons.

Les liaisons sont des structures nommées qui peuvent être appelées par un nom qualifié QName (cf. la section 2.17 Résolution des noms qualifiés QName). Les composants Endpoint, par exemple, se réfèrent aux liaisons de cette façon.

Les propriétés du composant Binding sont les suivantes :

• {name}, OBLIGATOIRE. Un nom qualifié xs:QName ;

• {interface}, OPTIONNELLE. Un composant Interface indiquant l'interface pour laquelle les informations de liaison sont définies ;

• {type}, OBLIGATOIRE. Un type xs:anyURI. Cette adresse xs:anyURI DOIT être une adresse IRI absolue telle que définie par [IETF RFC 3987] ^†. La valeur de cette adresse IRI indique quelle sorte de détails de liaison concrets sont contenus dans ce composant Binding. Les spécifications (telle que [WSDL 2.0 Adjuncts]) qui définissent de tels détails de liaison concrets DOIVENT définir des valeurs appropriées pour cette propriété. La valeur de cette propriété PEUT être le nom d'espace de noms des éléments ou attributs d'extension qui définissent ces détails de liaison concrets ;

• {binding faults}, OPTIONNELLE. Un ensemble de composants Binding Fault ;

• {binding operations}, OPTIONNELLE. Un ensemble de composants Binding Operation.

Pour chaque composant Binding dans la propriété {bindings} d'un composant Description, la propriété {name} DOIT être unique ^†.

2.7.2 Représentation XML du composant Binding

<description>
  <binding
        name="xs:NCName" 
        interface="xs:QName"?
        type="xs:anyURI" >
    <documentation />*
    [ <fault /> | <operation /> ]*
  </binding>
</description>

La représentation XML d'un composant Binding est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de binding ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• deux ou plus items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut name OBLIGATOIRE comme décrit ci-dessous à la section 2.7.2.1 Item d'information d'attribut name avec élément possesseur [owner element] binding ;

  • un item d'information d'attribut interface OPTIONNEL comme décrit ci-dessous à la section 2.7.2.2 Item d'information d'attribut interface avec élément possesseur [owner element] binding ;

  • un item d'information d'attribut type OBLIGATOIRE comme décrit ci-dessous à la section 2.7.2.3 Item d'information d'attribut type avec élément possesseur binding ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément parmi les suivants, dans un ordre quelconque :

     • zéro ou plus items d'information d'élément fault (cf. la section 2.8.2 Représentation XML du composant Binding Fault) ;

     • zéro ou plus items d'information d'élément operation (cf. la section 2.9.2 Représentation XML du composant Binding Operation) ;

     • zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl". De tels items d'information d'élément ne sont pas considérés comme étant des éléments d'extension de liaison (cf. la section 2.7.2.4 Éléments d'extension de liaison).

2.7.3 Correspondance de la représentation XML de Binding aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément binding (cf. la section 2.7.2 Représentation XML du composant Binding) aux propriétés du composant Binding (cf. la section 2.7.1 Le composant Binding) est décrite dans le tableau 2-7.

2.8.1 Le composant Binding Fault

Un composant Binding Fault décrit une liaison concrète d'un incident particulier dans une interface vers un format de message concret particulier. Un incident particulier d'une interface est identifié de manière unique par sa propriété {name}.

Notez que l'incident n'apparaît pas de lui-même, il survient dans le cadre d'un échange de messages tel que défini par un composant Interface Operation (et sa contrepartie de liaison, le composant Binding Operation). Ainsi, l'information de liaison d'incident définie dans un composant Binding Fault décrit comment les incidents survenant au cours de l'échange de messages d'une opération seront formatés et transportés.

Les propriétés du composant Binding Fault sont les suivantes :

• {interface fault}, OBLIGATOIRE. Un composant Interface Fault dans la propriété {interface faults} du composant Interface identifié par la propriété {interface} du composant Binding parent, ou d'un composant Interface que ce composant Interface étend directement ou indirectement. C'est le composant Interface Fault pour lequel une information de liaison est définie ;

• {parent}, OBLIGATOIRE. Le composant Binding qui contient ce composant dans sa propriété {binding faults}.

Pour chaque composant Binding Fault dans la propriété {binding faults} d'un composant Binding, la propriété {interface fault} DOIT être unique ^†. C'est-à-dire que l'on ne peut pas définir plusieurs liaisons pour le même incident dans un composant Binding donné.

2.8.2 Représentation XML du composant Binding Fault

<description>
  <binding>
    <fault
          ref="xs:QName" >
      <documentation />*
    </fault>
  </binding>
</description>

La représentation XML d'un composant Binding Fault est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de fault ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• un ou plusieurs items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut ref OBLIGATOIRE comme décrit ci-dessous à la section 2.8.2.1 Item d'information d'attribut ref avec élément possesseur [owner element] fault ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl". Ces items d'information d'élément sont considérés comme étant des éléments d'extension d'incident de liaison comme décrit ci-dessous (cf. la section 2.8.2.2 Éléments d'extension d'incident de liaison).

2.8.3 Correspondance de la représentation XML de Binding Fault aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément fault (cf. la section 2.8.2 Représentation XML du composant Binding Fault) aux propriétés du composant Binding Fault (cf. la section 2.8.1 Le composant Binding Fault) est décrite dans le tableau 2-8.

2.9.1 Le composant Binding Operation

Le composant Binding Operation décrit le format (ou les formats) de message et l'interaction (ou les interactions) concrets associés à une opération d'interface particulière pour une extrémité donnée. Une opération particulière d'une interface est identifiée de manière unique par sa propriété {name}.

Les propriétés du composant Binding Operation sont les suivantes :

• {interface operation}, OBLIGATOIRE. Un composant Interface Operation dans la propriété {interface operations} du composant Interface identifié par la propriété {interface} du composant Binding parent [parent], ou un composant Interface que ce composant Interface étend directement ou indirectement. C'est le composant Interface Operation pour lequel une information de liaison est définie ;

• {binding message references}, OPTIONNELLE. Un ensemble de composants Binding Message Reference ;

• {binding fault references}, OPTIONNELLE. Un ensemble de composants Binding Fault Reference ;

• {parent}, OBLIGATOIRE. Le composant Binding qui contient ce composant dans sa propriété {binding operations}.

Pour chaque composant Binding Operation dans la propriété {binding operations} d'un composant Binding, la propriété {interface operation} DOIT être unique ^†. C'est-à-dire que l'on ne peut pas définir plusieurs liaisons pour la même opération dans un composant Binding donné.

2.9.2 Représentation XML du composant Binding Operation

<description>
  <binding>
    <operation
          ref="xs:QName" >
      <documentation />*
      [ <input /> | <output /> | <infault /> | <outfault /> ]*
    </operation>
  </binding>
</description>

La représentation XML d'un composant Binding Operation est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de operation ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• un ou plusieurs items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut ref OBLIGATOIRE comme décrit ci-dessous à la section 2.9.2.1 Item d'information d'attribut ref avec élément possesseur [owner element] operation ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément parmi les suivants, dans un ordre quelconque :

     • zéro ou plus items d'information d'élément input (cf. la section 2.10 Référence de message de liaison) ;

     • zéro ou plus items d'information d'élément output (cf. la section 2.10 Référence de message de liaison) ;

     • zéro ou plus items d'information d'élément infault (cf. la section 2.11 Référence d'incident de liaison) ;

     • zéro ou plus items d'information d'élément outfault (cf. la section 2.11 Référence d'incident de liaison) ;

     • zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas " http://www.w3.org/ns/wsdl". Ces items d'information d'élément sont considérés comme étant des éléments d'extension d'opération de liaison comme décrit ci-dessous (cf. la section 2.9.2.2 Éléments d'extension d'opération de liaison).

2.9.3 Correspondance de la représentation XML de Binding Operation aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément operation (cf. la section 2.9.2 Représentation XML du composant Binding Operation) aux propriétés du composant Binding Operation est décrite dans le tableau 2-9.

2.10.1 Le composant Binding Message Reference

Un composant Binding Message Reference décrit une liaison concrète d'un message particulier participant à une opération vers un format de message concret particulier.

Les propriétés du composant Binding Message Reference sont les suivantes :

• {interface message reference}, OBLIGATOIRE. Un composant Interface Message Reference parmi ceux dans la propriété {interface message references} du composant Interface Operation lié par le composant Binding Operation conteneur.

• {parent}, OBLIGATOIRE. Le composant Binding Operation qui contient ce composant dans sa propriété {binding message references}.

Pour chaque composant Binding Message Reference dans la propriété {binding message references} d'un composant Binding Operation, la propriété {interface message reference} DOIT être unique ^†. C'est-à-dire que le même message ne peut pas être lié deux fois au sein de la même opération.

2.10.2 Représentation XML du composant Binding Message Reference

<description>
  <binding>
    <operation>
      <input
            messageLabel="xs:NCName"? >
        <documentation />*
      </input>
      <output
            messageLabel="xs:NCName"? >
        <documentation />*
      </output>
    </operation>
  </binding>
</description>

La représentation XML d'un composant Binding Message Reference est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de input ou output ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• zéro ou plus items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut messageLabel OPTIONNEL comme décrit ci-dessous à la section 2.10.2.1 Item d'information d'attribut messageLabel avec élément possesseur [owner element]input ou output ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl". Ces items d'information d'élément sont considérés comme étant des éléments d'extension de référence de message de liaison comme décrit ci-dessous (cf. la section 2.10.2.2 Éléments d'extension de référence de message de liaison).

2.10.3 Correspondance de la représentation XML de Binding Message Reference aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément binding (cf. la section 2.10.2 Représentation XML du composant Binding Message Reference) aux propriétés du composant Binding Message Reference est décrite dans le tableau 2-10 et utilise les définitions suivantes.

Définir le modèle d'échange de messages de l'item d'information d'élément comme étant la propriété {message exchange pattern} du composant Interface Operation lié.

Définir la direction de message de l'item d'information d'élément comme étant in si le nom local de celui-ci est input et out si le nom local est output.

Notez que l'item d'information d'attribut messageLabel de l'item d'information d'élément d'une référence de message de liaison doit être présent si le modèle d'échange de messages a plus d'un message fictif (placeholder message) dont la propriété {direction} est égale à la direction de message.

Si l'item d'information d'attribut messageLabel de l'item d'information d'élément d'une référence de message de liaison est présent, alors sa valeur réelle DOIT correspondre à la propriété {message label} d'un message fictif dont la propriété {direction} est égale à la direction de message ^†.

Si l'item d'information d'attribut messageLabel de l'item d'information d'élément d'une référence de message de liaison est absent, alors il DOIT y avoir un message fictif unique dont la propriété {direction} est égale à la direction de message ^†.

Définir le libellé de message effectif (effective message label) d'un item d'information d'élément de référence de message de liaison comme étant soit la valeur réelle de l'item d'information d'attribut messageLabel si présent, soit la propriété {message label} du message fictif unique dont la propriété {direction} est égale à la direction de message si l'item d'information d'attribut est absent.

2.11.1 Le composant Binding Fault Reference

Un composant Binding Fault Reference décrit une liaison concrète d'un incident particulier participant à une opération vers un format de message concret particulier.

Les propriétés du composant Binding Fault Reference sont les suivantes :

• {interface fault reference}, OBLIGATOIRE. Un composant Interface Fault Reference parmi ceux dans la propriété {interface fault references} du composant Interface Operation lié par le composant Binding Operation parent ;

• {parent}, OBLIGATOIRE. Le composant Binding Operation qui contient ce composant dans sa propriété {binding fault references}.

Pour chaque composant Binding Fault Reference dans la propriété {binding fault references} d'un composant Binding Operation, la propriété {interface fault reference} DOIT être unique ^†. C'est-à-dire que le même incident ne peut pas être lié deux fois au sein de la même opération.

2.11.2 Représentation XML du composant Binding Fault Reference

<description>
  <binding>
    <operation>
      <infault
            ref="xs:QName"
            messageLabel="xs:NCName"?>
        <documentation />*
      </infault>
      <outfault
            ref="xs:QName"
            messageLabel="xs:NCName"?>
        <documentation />*
      </outfault>
    </operation>
  </binding>
</description>

La représentation XML d'un composant Binding Fault Reference est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de infault ou outfault ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• un ou plusieurs items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut ref OBLIGATOIRE comme décrit ci-dessous à la section 2.11.2.1 Item d'information d'attribut ref avec élément possesseur [owner element] infault ou outfault ;

    un item d'information d'attribut messageLabel OPTIONNEL comme décrit ci-dessous à la section 2.11.2.2 Item d'information d'attribut messageLabel avec élément possesseur [owner element] infault ou outfault ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl". Ces items d'information d'élément sont considérés comme étant des éléments d'extension de référence d'incident de liaison comme décrit ci-dessous (cf. la section 2.11.2.3 Éléments d'extension de référence d'incident de liaison).

2.11.3 Correspondance de la représentation XML de Binding Fault Reference aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément binding (cf. la section 2.11.2 Représentation XML du composant Binding Fault Reference) aux propriétés du composant Binding Fault Reference est décrite dans le tableau 2-11 et utilise les définitions suivantes.

Définir le modèle d'échange de messages (message exchange pattern) de l'item d'information d'élément comme étant la propriété {message exchange pattern} du composant Interface Operation lié.

Définir la direction d'incident (fault direction) de l'item d'information d'élément comme étant in si le nom local de celui-ci est infault et out si le nom local est outfault.

Définir la direction de message (message direction) de l'item d'information d'élément comme étant la propriété {direction} du message fictif associé à l'incident, définie par le règlement de propagation d'incident (fault propagation ruleset) du modèle d'échange de messages.

L'item d'information d'attribut messageLabel DOIT être présent si le modèle d'échange de messages a plus d'un message fictif dont la propriété {direction} est égale à la direction de message ^†.

Si l'item d'information d'attribut messageLabel d'un item d'information d'élément de référence d'incident de liaison est présent, alors sa valeur réelle DOIT correspondre à la propriété {message label} d'un message fictif dont la propriété {direction} est égale à la direction de message ^†.

Si l'item d'information d'attribut messageLabel d'un item d'information d'élément de référence d'incident de liaison est absent, alors il DOIT y avoir un message fictif unique dont la propriété {direction} est égale à la direction de message ^†.

Définir le libellé de message effectif (effective message label) d'un item d'information d'élément comme étant soit la valeur réelle de l'item d'information d'attribut messageLabel si présent, soit la propriété {message label} du message fictif unique dont la propriété {direction} est égale à la direction de message si l'item d'information d'attribut est absent.

Il DOIT y avoir un composant Interface Fault Reference dans la propriété {interface fault references} du composant Interface Operation lié dont la propriété {message label} est égale au libellé de message effectif et la propriété {interface fault} est égale à un composant Interface Fault avec une propriété {name} égale à l'item d'information d'attribut ref ^†.

2.12.1 Le composant Service

Un composant Service décrit un ensemble d'extrémités (cf. la section 2.13 Extrémité) où y est fournie une mise en œuvre déployée particulière du service. Les extrémités (endpoints) sont en effet des lieux de remplacement (alternate places) où le service est fourni.

Les services sont des structures nommées auxquelles on peut se référer par un nom qualifié QName (cf. la section 2.17 Résolution des noms qualifiés QName).

Les propriétés du composant Service sont les suivantes :

• {name}, OBLIGATOIRE. Un nom qualifié xs:QName ;

• {interface}, OBLIGATOIRE. Un composant Interface ;

• {endpoints}, OBLIGATOIRE. Un ensemble non vide de composants Endpoint.

Pour chaque composant Service dans la propriété {services} d'un composant Description, la propriété {name} DOIT être unique ^†.

2.12.2 Représentation XML du composant Service

<description>
  <service
        name="xs:NCName" 
        interface="xs:QName" >
    <documentation />*
    <endpoint />+
  </service>
</description>

La représentation XML d'un composant Service est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de service ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• deux ou plus items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut name OBLIGATOIRE comme décrit ci-dessous à la section 2.12.2.1 Item d'information d'attribut name avec élément possesseur [owner element] service ;

  • un item d'information d'attribut interface OBLIGATOIRE comme décrit ci-dessous à la section 2.12.2.2 Item d'information d'attribut interface avec élément possesseur [owner element] service ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• un ou plusieurs items d'information d'élément parmi ses sous-éléments, en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. un ou plusieurs items d'information d'élément parmi les suivants, dans un ordre quelconque :

     • un ou plusieurs items d'information d'élément endpoint (cf. la section 2.13.2 Représentation XML du composant Endpoint ;

     • zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

2.12.3 Correspondance de la représentation XML de Service aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément service (cf. la section 2.12.2 Représentation XML du composant Service) aux propriétés du composant Service est décrite dans le tableau 2-12.

2.13.1 Le composant Endpoint

Un composant Endpoint définit les particularités d'une extrémité spécifique à laquelle un service donné est disponible.

Les composants Endpoint sont locaux à un composant Service donné (cf. la section A.2 Identificateurs de fragment).

Le composant Binding indiqué par la propriété {binding} d'un composant Endpoint est dit appliqué au composant Interface qui est la valeur de la propriété {interface} du composant Service parent du composant Endpoint. Conformément aux contraintes indiquées ci-dessous, si ce composant Binding a une propriété {interface}, alors la valeur de celle-ci doit être le composant Interface auquel le composant Binding est appliqué.

La propriété {address} est optionnelle afin que d'autres moyens que des adresses IRI puissent être utilisés, par exemple une référence d'extrémité de type WS-Addressing (WS-Addressing Endpoint Reference) [WSA 1.0 Core]. Il est possible également, dans certains scénarios, qu'une adresse ne soit pas nécessaire, auquel cas cette propriété peut être absente.

Les propriétés du composant Endpoint sont les suivantes :

• {name}, OBLIGATOIRE. Un nom xs:NCName ;

• {binding}, OBLIGATOIRE. Un composant Binding ;

• {address}, OPTIONNELLE. Un type xs:anyURI. Cette adresse xs:anyURI DOIT être une adresse IRI absolue comme défini par [IETF RFC 3987] ^†. Si présent, la valeur de cette attribut représente l'adresse de réseau où est offert le service indiqué par la propriété {interface} du composant Service parent, via la liaison indiquée par la propriété {binding}. À noter que la présence dans cette propriété de caractères « ? » et « # » peut engendrer des conflits avec ceux potentiels ajoutés par le mécanisme de sérialisation de chaîne de requête, comme défini dans la section 6.8.2 Sérialisation comme type "application/x-www-form-urlencoded" ([WSDL 2.0 Adjuncts] ;

• {parent}, OBLIGATOIRE. Le composant Service qui contient ce composant dans sa propriété {endpoints}.

Pour chaque composant Endpoint dans la propriété {endpoints} d'un composant Service, la propriété {name} DOIt être unique. Notez que le schéma XML normatif de WSDL 2.0 fait valoir cette contrainte.

Pour chaque composant Endpoint dans la propriété {endpoints} d'un composant Service, la propriété {binding} DOIT soit être un composant Binding avec une propriété {interface} non définie, soit un composant Binding avec une propriété {interface} égale à la propriété {interface} du composant Service ^†.

2.13.2 Représentation XML du composant Endpoint

<description>
  <service>
    <endpoint
          name="xs:NCName" 
          binding="xs:QName"
          address="xs:anyURI"? >
      <documentation />*
    </endpoint>+
  </service>
</description>

La représentation XML d'un composant Endpoint est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de endpoint ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;

• deux ou plus items d'information d'attribut parmi ses attributs [attributes] comme suit :

  • un item d'information d'attribut name OBLIGATOIRE comme décrit ci-dessous à la section 2.13.2.1 Item d'information d'attribut name avec élément possesseur [owner element] endpoint ;

  • un item d'information d'attribut binding OBLIGATOIRE comme décrit ci-dessous à la section 2.13.2.2 Item d'information d'attribut binding avec élément possesseur [owner element] endpoint ;

  • un item d'information d'attribut address OPTIONNEL comme décrit ci-dessous à la section 2.13.2.3 Item d'information d'attribut address avec élément possesseur [owner element] endpoint ;

  • zéro ou plus items d'information d'attribut, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl".

• zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :

  1. zéro ou plus items d'information d'élément documentation (cf. la section 5. Documentation) ;

  2. zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name] n'est pas "http://www.w3.org/ns/wsdl". Ces items d'information d'élément sont considérés comme étant des éléments d'extension d'extrémité comme décrit ci-dessous (cf. la section 2.13.2.4 Éléments d'extension d'extrémité).

2.13.3 Correspondance de la représentation XML de Endpoint aux propriétés de composant

La correspondance de la représentation XML de l'item d'information d'élément endpoint (cf. la section 2.13.2 Représentation XML du composant Endpoint) aux propriétés du composant Endpoint est décrite dans le tableau 2-13.

3.1.1 Importation d'un schéma XML

L'importation d'un schéma XML utilise la syntaxe et la sémantique du mécanisme xs:import définit par XML Schema [XML Schema: Structures], [XML Schema: Datatypes], sauf les différences définies dans cette section et la suivante. Les composants de schéma définis dans l'espace de noms importé sont référençables par nom qualifié QName (cf. la section 2.17 Résolution des noms qualifiés QName). Seuls les composants dans l'espace de noms importé sont référençables dans le document WSDL 2.0. Pour chaque composant dans l'espace de noms importé, un composant correspondant Element Declaration, ou Type Definition, DOIT apparaître respectivement dans la propriété {element declarations}, ou {type definitions}, du composant Description correspondant au document WSDL qui importe le schéma, ou qui importe directement ou indirectement un document WSDL important le schéma ^†. Les composants de schéma qui ne sont pas dans un espace de noms importé NE DOIVENT PAS apparaître dans les propriétés {element declarations} ou {type definitions} ^†.

Un item d'information d'élément sous-élément de l'item d'information d'élément types est défini avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de import ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/2001/XMLSchema" ;

• un ou deux items d'information d'attribut comme suit :

  • un item d'information d'attribut namespace OBLIGATOIRE comme décrit ci-dessous ;

  • un item d'information d'attribut schemaLocation OPTIONNEL comme décrit ci-dessous.

3.1.2 Incorporation de schéma XML

L'incorporation d'un schéma XML utilise l'item d'information d'élément xs:schema de niveau supérieur existant défini par XML Schema [XML Schema: Structures]. Conceptuellement, on peut assimiler l'incorporation au simple copier-coller d'un document de schéma existant quelque part dans l'item d'information d'élément types.

Les composants de schéma définis et déclarés dans le document de schéma incorporé sont référençables par nom qualifié QName (cf. la section 2.17 Résolution des noms qualifiés QName). Seuls les composants définis et déclarés dans le schéma même et les composants qu'il inclut via xs:include sont référençables. Pour chaque composant défini et déclaré dans le document de schéma incorporé ou inclus par xs:include, un composant Element Declaration, ou Type Definition, DOIT apparaître respectivement dans la propriété {element declarations}, ou {type definitions}, du composant Description correspondant au document WSDL qui contient le schéma, ou qui importe directement ou indirectement un document WSDL qui contient le schéma ^†. Les composants de schéma non définis ou déclarés dans le document de schéma incorporé, ou inclus par xs:include, NE DOIVENT PAS apparaître dans les propriétés {element declarations} ou {type definitions} ^†.

Notez que les composants dans l'espace de noms que le schéma incorporé importe via xs:import ne sont pas automatiquement référençables depuis le document WSDL 2.0 contenant le schéma incorporé. Si l'espace de noms référencé dans un nom qualifié QName est contenu dans un schéma incorporé, il PEUT être importé sans attribut schemaLocation, tant que le schéma incorporé est résolu dans le modèle de composants courant.

Notez que les composants définis dans un schéma XML incorporé ne sont pas automatiquement référençables au sein du document WSDL 2.0 qui a importé (avec wsdl:import) le document WSDL 2.0 incorporant le schéma (cf. la section 4.2 Importation des descriptions pour plus de détails). Pour cette raison, il est recommandé de placer les documents de schéma XML dans des documents séparés et de les importer à l'aide de xs:import, plutôt que de les incorporer à un document WSDL 2.0.

À l'intérieur d'un schéma XML incorporé, on PEUT utiliser les items d'information d'élément xs:import et xs:include pour référencer d'autres schémas XML incorporés dans le même document WSDL 2.0 ou ailleurs, à condition de définir une valeur appropriée, telle qu'un identificateur de fragment (cf. [XML Schema: Structures], section 4.3.1) pour leurs items d'information d'attribut schemaLocation. Pour xs:import, l'attribut schemaLocation n'est pas nécessaire tant que l'espace de noms est résolu dans le modèle de composants courant. La sémantique de tels items d'information d'élément est régie exclusivement par la spécification XML Schema [XML Schema: Structures].

Un document WSDL 2.0 PEUT incorporer deux schémas ou plus du même targetNamespace. Ainsi, deux (ou plus) schémas incorporés peuvent avoir le même targetNamespace, à condition qu'ils ne définissent pas les même éléments ou types. Un document WSDL 2.0 NE DOIT PAS définir le même élément ou type dans plusieurs schémas incorporés ^†. Notez que le processeur XML Schema sous-jacent a la charge d'établir l'ensemble cohérent des composants de schéma.

L'item d'information d'élément xs:schema a les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de schema ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/2001/XMLSchema" ;

• des items d'information d'attribut supplémentaires OPTIONNELS comme défini pour l'item d'information d'élément xs:schema par la spécification XML Schema ;

• zéro ou plus items d'information d'élément sous-élément comme défini pour item d'information d'élément xs:schema par la spécification XML Schema.

3.1.3 Références des déclarations d'élément et des définitions de type

Qu'elles soient incorporées ou importées, les déclarations d'élément globales présentes dans un schéma sont référençables depuis un composant Interface Message Reference ou Interface Fault. De même, indépendemment de ce qu'elles sont incorporées ou importées, les définitions de type globales présentes dans un schéma sont référençables depuis d'autres composants.

Une déclaration xs:element globale nommée est référençable depuis l'item d'information d'attribut element d'un item d'information d'élément input, output (cf. la section 2.5.2 Représentation XML du composant Interface Message Reference) ou fault (cf. la section 2.3.2 Représentation XML du composant Interface Fault). Le nom qualifié QName de la déclaration d'élément est construit à partir du targetNamespace du schéma et de la valeur de l'item d'information d'attribut name de l'item d'information d'élément xs:element. Notez que l'item d'information d'attribut element ne peut pas se référer à une définition globale xs:simpleType ou xs:complexType, puisque celles-ci se trouvent dans un espace de symboles différent des déclarations d'élément globales. Si l'item d'information d'attribut element contenait par erreur le nom qualifié QName d'une définition de type, cela se traduirait par l'échec de la résolution de la déclaration d'élément.

3.3.1 Item d'information d'attribut wsdlx:interface

WSDL 2.0 fournit un item d'information d'attribut global avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de interface ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl-extensions".

Le type de l'item d'information d'attribut wsdlx:interface est un nom qualifié xs:QName qui définit la propriété {name} d'un composant Interface ^†.

3.3.2 Item d'information d'attribut wsdlx:binding

WSDL 2.0 fournit un item d'information d'attribut global avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de binding ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl-extensions".

Le type de l'item d'information d'attribut wsdlx:binding est un nom qualifié xs:QName qui définit la propriété {name} d'un composant Binding ^†.

3.3.3 Cohérence de wsdlx:interface et wsdlx:binding

Les attributs wsdlx:interface et wsdlx:binding peuvent être utilisés indépendamment ou ensemble. Si wsdlx:interface et wsdlx:binding sont utilisés ensemble, alors ils DOIVENT satisfaire aux mêmes règles de cohérence qui s'appliquent à la propriété {interface} d'un composant Service et à la propriété {binding} d'un composant Endpoint niché, c'est-à-dire que la liaison se réfère soit à l'interface du service, soit ne se réfère à aucune interface ^†.

3.3.4 Utilisation de wsdlx:interface et wsdlx:binding avec xs:anyURI

Les attributs wsdlx:interface et wsdlx:binding sont utilisés pour décrire des items d'information d'élément et des items d'information d'attribut dont le type est xs:anyURI, ou une restriction de celui-ci, ainsi que des messages qui contiennent la propriété {address} d'un composant Endpoint. Cela se fait en incluant l'item d'information d'attribut wsdlx:interface ou wsdlx:binding dans l'item d'information d'élément xs:element, xs:simpleType ou xs:attribute du composant XML Schema correspondant.

4.1.1 Item d'information d'attribut location avec élément possesseur [owner element] include

L'item d'information d'attribut location a les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de location ;

• un nom d'espace de noms [namespace name] sans valeur.

Un item d'information d'attribut location est de type xs:anyURI. Sa valeur réelle est l'adresse de l'emplacement d'informations à propos de l'espace de noms identifié par l'item d'information d'attribut targetNamespace de l'item d'information d'élément description contenant.

L'adresse IRI indiquée par location DOIT se résoudre en un document WSDL 2.0 ^† (cf. la section 7. Localisation des documents WSDL 2.0).

La valeur réelle de l'item d'information d'attribut targetNamespace du document WSDL 2.0 inclus DOIT correspondre à la valeur réelle de l'item d'information d'attribut targetNamespace de l'item d'information d'élément description parent [parent] de l'item d'information d'élément include ^†.

4.2.1 Item d'information d'attribut namespace

L'item d'information d'attribut namespace a les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de namespace ;

• un nom d'espace de noms [namespace name] sans valeur.

L'item d'information d'attribut namespace est de type xs:anyURI. Sa valeur réelle indique que le document WSDL 2.0 contenant PEUT contenir des références qualifiées à des composants WSDL 2.0 dans cet espace de noms (via un ou plusieurs préfixes définis par des déclarations d'espace de noms de façon normale). Cette valeur NE DOIT PAS correspondre à la valeur réelle de l'item d'information d'attribut targetNamespace dans le document WSDL 2.0 englobant ^†. Si l'attribut location dans l'item d'information d'élément import est résolvable, alors il DOIT référencer un document WSDL 2.0 ^†. Si l'item d'information d'attribut location de l'item d'information d'élément import est résolvable, alors la valeur réelle de l'item d'information d'attribut namespace DOIT être identique à la valeur réelle de l'item d'information d'attribut targetNamespace du document WSDL 2.0 référencé (cf. la section 7. Localisation des documents WSDL 2.0) ^†.

4.2.2 Item d'information d'attribut location avec élément possesseur [owner element] import

L'item d'information d'attribut location a les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de location ;

• un nom d'espace de noms [namespace name] sans valeur.

L'item d'information d'attribut location est de type xs:anyURI. Si présent, sa valeur réelle donne une indication de l'endroit où trouver une sérialisation d'un document WSDL 2.0 avec des définitions pour l'espace de noms importé.

L'item d'information d'attribut location est optionnel. Cela permet de construire des composants WSDL 2.0 à partir d'autres informations qu'une sérialisation XML 1.0 d'un document WSDL 2.0. Cela permet aussi de développer des processeurs WSDL 2.0 qui ont la connaissance préalable (c'est-à-dire intégrée) de certains espaces de noms.

6.1.1 Extensions obligatoires

Les éléments d'extension peuvent être marqués comme obligatoires en les annotant avec un item d'information d'attribut wsdl:required (cf. la section 6.1.2 Item d'information d'attribut required) avec une valeur de "true". Une extension obligatoire est une extension qui PEUT changer la signification de l'élément auquel elle est associée, de telle sorte que la signification de l'élément n'est plus régie par cette spécification. Au contraire, la signification de l'élément contenant l'extension obligatoire est régie par cette extension. Ainsi, la définition de la signification de l'élément est déléguée à la spécification qui définit l'extension.

Une extension non marquée comme obligatoire NE DOIT PAS invalider la signification d'une partie quelconque d'un document WSDL 2.0 ^†. Ainsi, une extension non obligatoire fournit simplement une description supplémentaire des capacités du service. Cette spécification ne fournit aucun mécanisme pour marquer comme obligatoire les attributs d'extension. De fait, aucun attribut d'extension n'est obligatoire.

Si un document WSDL 2.0 déclare une extension comme étant optionnelle (c'est-à-dire non obligatoire), alors le service web NE DOIT PAS supposer que le client gère cette extension, sauf si le service web sait (par un autre moyen) que le client a en fait choisi d'engager et de gérer cette extension ^†.

Par contre, un client PEUT engager une extension déclarée comme étant optionnelle dans le document WSDL 2.0. Le service web DOIT donc gérer chaque extension déclarée comme étant optionnelle dans le document WSDL 2.0, en plus de gérer chaque extension déclarée comme étant obligatoire ^†.

La validité d'un document WSDL 2.0 ne peut être évaluée que dans le contexte de l'ensemble des extensions gérées. Un document WSDL 2.0 contenant une extension obligatoire mais non gérée est invalide par rapport à cet ensemble d'extensions gérées.

6.1.2 Item d'information d'attribut required

WSDL 2.0 fournit un item d'information d'attribut global avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de required ;

• un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl".

Le type de l'item d'information d'attribut required est xs:boolean. Sa valeur par défaut est "false" (ainsi les extensions ne sont pas obligatoires par défaut).