Langage de description de services web (WSDL) version 2.0 tome 2 — Compléments

2.1.1 Nom du modèle

Ce modèle comprend [nombre] message[s, en ordre] comme suit :

[énumeration, définissant chaque message] Un message [optionnel] :

1. indiqué par un composant Interface Message Reference dont la propriété {message label} est "[intitulé]" et la propriété {direction} est "[direction]"

2. [reçu|envoyé] [(du|au), ou (d'un|à un) si première mention] nœud [identificateur du nœud]

Ce modèle utilise la règle [référence de règlement d'incident].

Un composant Interface Operation utilisant ce modèle d'échange de messages a une propriété {message exchange pattern} avec la valeur "[adresse IRI du modèle]".

2.2.1 Règle de propagation Fault Replaces Message

Lorsque la règle de propagation Fault Replaces Message est en vigueur, tout message après le premier dans le modèle PEUT être remplacé par un message d'incident, lequel DOIT avoir une direction identique ^†. Le message d'incident DOIT être livré au même nœud cible que le message qu'il remplace, sauf indication contraire par une extension ou une extension de liaison. S'il n'y a pas de chemin vers ce nœud, l'incident DOIT être jeté ^†.

La règle de propagation Fault Replaces Message est identifiée par l'adresse URI suivante : http://www.w3.org/ns/wsdl/fault-replaces-message

2.2.2 Règle de propagation Message Triggers Fault

Lorsque la règle de propagation Message Triggers Fault est en vigueur, tout message y compris le premier dans le modèle PEUT déclencher un message d'incident, lequel DOIT avoir une direction opposée ^†. Le message d'incident DOIT être livré à l'émetteur du message de déclenchement, sauf indication contraire par une extension ou une extension de liaison. Tout nœud PEUT propager un message d'incident, et il NE DOIT PAS le faire plus d'une fois pour chaque message de déclenchement. S'il n'y a pas de chemin vers l'émetteur, l'incident DOIT être jeté ^†.

La règle de propagation Message Triggers Fault est identifié par l'adresse URI suivante : http://www.w3.org/ns/wsdl/message-triggers-fault

2.2.3 Règle de propagation No Faults

Lorsque la règle de propagation No Faults est en vigueur, les incidents NE DOIVENT PAS être propagés ^†.

La règle de propagation No Faults est identifiée par l'adresse URI suivante : http://www.w3.org/ns/wsdl/no-faults

2.3.1 Modèle d'échange de messages In-Only

Le modèle d'échange de message in-only comprend un seul message exactement ^†, comme suit :

1. Un message :

   • indiqué par un composant Interface Message Reference dont la propriété {message label} est "In" et la propriété {direction} est "in" ;

   • reçu d'un nœud N.

Le modèle d'échange de messages in-only utilise la règle 2.2.3 Règle de propagation No Faults ^†.

Une opération utilisant ce modèle d'échange de messages a une propriété {message exchange pattern} avec la valeur "http://www.w3.org/ns/wsdl/in-only".

2.3.2 Modèle d'échange de messages Robust In-Only

Le modèle d'échange de message robust-in-only comprend un seul message exactement ^†, comme suit :

1. Un message :

   • indiqué par un composant Interface Message Reference dont la propriété {message label} est "In" et la propriété {direction} est "in" ;

   • reçu d'un nœud N.

Le modèle d'échange de messages robust-in-only utilise la règle 2.2.2 Règle de propagation Message Triggers Fault ^†.

Une opération utilisant ce modèle d'échange de messages a une propriété {message exchange pattern} avec la valeur "http://www.w3.org/ns/wsdl/robust-in-only".

2.3.3 Modèle d'échange de messages In-Out

Le modèle d'échange de messages in-out comprend deux messages exactement, en ordre ^†, comme suit :

1. Un message :

   • indiqué par un composant Interface Message Reference dont la propriété {message label} est "In" et la propriété {direction} est "in" ;

   • reçu d'un nœud N.

2. Un message :

   • indiqué par un composant Interface Message Reference dont la propriété {message label} est "Out" et la propriété {direction} est "out" ;

   • envoyé au nœud N.

Le modèle d'échange de messages in-out utilise la règle 2.2.1 Règle de propagation Fault Replaces Message ^†.

Une opération utilisant ce modèle d'échange de messages a une propriété {message exchange pattern} avec la valeur "http://www.w3.org/ns/wsdl/in-out".

3.1.1 Relation avec le modèle de composants WSDL

L'extension de sûreté ajoute les propriétés suivantes au modèle de composant Interface Operation (défini dans [WSDL 2.0 Core Language]) :

• {safe}, OBLIGATOIRE. Un type xs:boolean indiquant si l'invocation de l'opération est certifiée sûre pour les utilisateurs. Si cette propriété est "false", aucune déclaration n'a alors été faite à propos de la sûreté de l'opération, ainsi l'opération PEUT ou non être sûre Toutefois, une opération DEVRAIT être marquée comme sûre si elle satisfait aux critères d'interaction sûre définis à la section 3.4 dans [Web Architecture] ^†.

3.1.2 Représentation XML

<description>
 <interface>
   <operation name="xs:NCName" pattern="xs:anyURI"
              wsdlx:safe="xs:boolean"? >
  </operation>
 </interface>
</description>

La représentation XML de l'extension de sûreté est un item d'information d'attribut (attribute information item) avec les propriétés d'ensemble d'information (Infoset) suivantes :

• un item d'information d'attribut safe OPTIONNEL avec les propriétés d'ensemble d'information suivantes ^† :

  • un nom local [local name] de safe ;

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

  • un type de xs:boolean.

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

Cf.  le tableau 3-1.

4.1.1 Extension wrpc:signature

L'item d'information d'attribut d'extension wrpc:signature PEUT être utilisé conjointement au style RPC pour décrire la signature exacte de la fonction représentée par une opération utilisant le style RPC.

Si présente, l'extension wrpc:signature apporte la propriété suivante au composant Interface Operation auquel elle s'applique :

• {rpc signature} OPTIONNELLE, mais DOIT être présente lorsque c'est le style RPC ^†. Une liste de couples (q, t), dont le premier composant est de type xs:QName et le deuxième de type xs:token. La valeur du deuxième composant DOIT être choisie parmi les quatre suivantes : "#in", "#out", "#inout" et "#return" ^†.

La valeur de la propriété {rpc signature} DOIT satisfaire aux conditions suivantes :

• La valeur du premier composant de chaque couple (q, t) DOIT être unique dans la liste ^† ;

• Pour chaque sous-élément des messages d'entrée et de sortie de l'opération, un couple (q, t), dont le premier composant q est égal au nom qualifié de cet élément, DOIT être présent dans la liste, à la restriction que les éléments apparaissant avec une cardinalité supérieure à un DOIVENT être traités comme un seul élément ^† ;

• Pour chaque couple (q, #in), il DOIT y avoir un sous-élément de l'élément input avec le nom q. Il NE DOIT PAS y avoir de sous-élément de l'élément output avec le nom q ^† ;

• Pour chaque couple (q, #out), il DOIT y avoir un sous-élément de l'élément output avec le nom q. Il NE DOIT PAS y avoir de sous-élément de l'élément input avec le nom q ^† ;

• Pour chaque couple (q, #inout), il DOIT y avoir un sous-élément de l'élément input avec le nom q. Il NE DOIT PAS y avoir de sous-élément de l'élément output avec le nom q ^† ;

• Pour chaque couple (q, #return), il DOIT y avoir un sous-élément de l'élément output avec le nom q. Il NE DOIT PAS y avoir de sous-élément de l'élément input avec le nom q ^†.

La signature de fonction définie par une extension wrpc:signature se détermine comme suit :

1. Commencer avec la valeur de la propriété {rpc signature}, une liste (éventuellement vide) de couples de la forme suivante :

   [(q0, t0), (q1, t1), ...]

2. Trier les éléments de cette liste en deux liste : la première (L1) comprenant les couples dont le composant t est l'un parmi {#in, #out, #inout}, la deuxième (L2) comprenant les couples dont le composant t vaut #return. Pour la composition des listes L1 et L2, l'ordre relatif des membres dans la liste originale DOIT être conservé.

   Pour aider la visualisation, notons les deux listes respectives ainsi :

   (L1) [(a0, u0), (a1, u1), ...]

   et :

   (L2) [(r0, #return), (r1, #return), ...]

3. Ensuite, si la séquence d'entrée se termine par un élément générique, la signature formelle de la fonction est :

   f([d0] a0, [d1] a1, ..., rest) => (r0, r1, ...)

   où rest est un paramètre formel représentant les éléments dans le message d'entrée filtrés par l'élément générique.

   Sinon la signature formelle de la fonction est :

   f([d0] a0, [d1] a1, ...) => (r0, r1, ...)

   c'est-à-dire que :

   • la liste des arguments formels de la fonction est [a0, a1, ...] ;

   • la direction d de chaque argument formel a est l'une parmi [in], [out] et [inout], déterminée conformément à la valeur de son atome u correspondant ;

   • la liste des paramètres de retour formels de la fonction est [r0, r1, ...] ;

   • chaque argument formel et paramètre de retour formel est typé conformément au type du sous-élément identifié par la signature (lequel est unique selon les conditions indiquées précédemment).

4.1.2 Représentation XML de l'extension wrpc:signature

La représentation XML de l'extension de signature RPC est un item d'information d'attribut avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de signature ;

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

L'item d'information d'attribut signature est un type de liste dont le type d'élément est l'union d'un type xs:QName et d'un sous-type de xs:token limité aux quatre valeurs suivantes : "#in", "#out", "#inout" et "#return". Cf. l'exemple 4-1 pour un extrait de la définition de schéma normative de ce type.

En plus, chaque élément de numéro pair (0, 2, 4, ...) dans la liste DOIT être de type xs:QName et chaque élément de numéro impair (1, 3, 5, ...) dans la liste DOIT être du sous-type de xs:token décrit au paragraphe précédent ^†.

<xs:attribute name="signature" type="wrpc:signatureType"/>

<xs:simpleType name="signatureType">
  <xs:list itemType="wrpc:signatureItemType"/>
</xs:simpleType>

<xs:simpleType name="signatureItemType">
  <xs:union memberTypes="xs:QName wrpc:directionToken"/>
</xs:simpleType>

<xs:simpleType name="directionToken">
  <xs:restriction base="xs:token">
    <xs:enumeration value="#in"/>
    <xs:enumeration value="#out"/>
    <xs:enumeration value="#inout"/>
    <xs:enumeration value="#return"/>
  </xs:restriction>
</xs:simpleType>

4.1.3 Correspondance de l'extension wrpc:signature aux propriétés d'un composant Interface Operation

Un item d'information d'attribut d'extension wrpc:signature est associé à la propriété suivante du composant Interface Operation défini par son possesseur [owner].

5.4.1 Description

Chaque liaison SOAP DOIT indiquer quelle version de SOAP est utilisée pour les opérations de l'interface à laquelle cette liaison s'applique ^†.

Par défaut, c'est SOAP 1.2 [SOAP 1.2 Part 1: Messaging Framework (Second Edition)] qui est utilisé.

5.4.2 Relation avec le modèle de composants WSDL

La spécification du protocole SOAP ajoute la propriété suivante au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {soap version}, OBLIGATOIRE. Un type xs:string ; propriété ajoutée au composant Binding.

5.4.3 Représentation XML

<description>
  <binding  name="xs:NCName" interface="xs:QName"? type="xs:anyURI"
            wsoap:version="xs:string"? >
    ...
  </binding>
</description>

La représentation XML pour indiquer la version SOAP est un item d'information d'attribut avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de version ;

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

• un type de xs:string.

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

Cf. le tableau 5-1.

5.5.1 Description

Chaque liaison SOAP DOIT indiquer quel protocole sous-jacent est utilisé ^†.

5.5.2 Relation avec le modèle de composants WSDL

La spécification du protocole SOAP ajoute la propriété suivante au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {soap underlying protocol}, OBLIGATOIRE. Un type xs:anyURI, qui est une adresse IRI absolue comme définie par [IETF RFC 3987] ; propriété ajoutée au composant Binding. Cette adresse IRI se rapporte à une liaison de protocole sous-jacent SOAP (cf. la section Cadre de liaison de protocole SOAP dans [SOAP 1.2 Part 1: Messaging Framework Second Edition)]), à utiliser pour toutes les interactions SOAP décrites par cette liaison.

5.5.3 Représentation XML

<description>
  <binding  name="xs:NCName" interface="xs:QName"? type="xs:anyURI"
            wsoap:protocol="xs:anyURI" >
    ...
  </binding>
</description>

La représentation XML pour indiquer le protocole SOAP est un item d'information d'attribut OBLIGATOIRE avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de protocol ;

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

• un type de xs:anyURI.

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

Cf. le tableau 5-2.

5.6.1 Description

Pour chaque composant Interface Fault contenu dans un composant Interface, une correspondance à un composant SOAP Fault DOIT être décrite ^†. Cette définition d'extension de liaison permet à l'utilisateur d'indiquer les code et sous-codes d'incident SOAP (SOAP Fault) transmis pour un composant Interface Fault donné.

5.6.2 Relation avec le modèle de composants WSDL

L'extension de liaison d'incident SOAP ajoute les propriétés suivantes au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {soap fault code}, OBLIGATOIRE. L'union d'un type xs:QName et d'un type xs:token ; propriété ajoutée au composant Binding Fault, où :

  • lorsque la valeur de la propriété {soap version} est "1.2", les noms qualifiés QName permis DOIVENT être ceux définis à la section 5.4.6 dans [SOAP 1.2 Part 1: Messaging Framework (Second Edition)] ^† ;

  • la valeur d'atome (token) permise est "#any".

  La valeur de cette propriété identifie un composant SOAP Fault possible pour les opérations visées. Si la valeur de cette propriété est "#any", on ne fait aucune assertion à propos de la valeur possible du code d'incident SOAP.

• {soap fault subcodes}, OBLIGATOIRE. L'union d'une liste de types xs:QName et d'un type xs:token, où la valeur d'atome permise est "#any" ; propriété ajoutée au composant Binding Fault. La valeur de cette propriété identifie un ou plusieurs sous-codes pour ce composant SOAP Fault. La liste des sous-codes est la séquence nichée (nested sequence) de sous-codes. Une liste vide représente un code d'incident sans sous-code.

5.6.3 Représentation XML

<description>
  <binding >
    <fault ref="xs:QName"
           wsoap:code="union de xs:QName, xs:token"?
           wsoap:subcodes="union de (liste de xs:QName), xs:token"? >
      <documentation />*
    </fault>*
  </binding>
</description>

La représentation XML de liaison d'un incident SOAP comporte deux items d'information d'attribut avec les propriétés d'ensemble d'information suivantes :

• un item d'information d'attribut wsoap:code OPTIONNEL ;

  • un nom local [local name] de code ;

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

  • un type d'union de xs:QName et xs:token, où la valeur d'atome permise est "#any".

• un item d'information d'attribut wsoap:subcodes OPTIONNEL ;

  • un nom local [local name] de subcodes ;

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

  • un type d'union d'une liste de xs:QName et de xs:token, où la valeur d'atome permise est "#any".

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

Cf. le tableau 5-3.

5.7.1 Description

Pour chaque composant Interface Operation contenu dans un composant Interface, en plus des règles de liaison (pour SOAP 1.2, cf. la section 5.10.3 Règles de liaison SOAP 1.2), des informations de liaison supplémentaires peuvent être définies. Cette spécification d'extension de liaison permet à l'utilisateur d'indiquer le modèle d'échange de messages SOAP (SOAP Message Exchange Pattern) et une valeur de la caractéristique d'action SOAP (SOAP Action Feature) pour chaque opération.

5.7.2 Relation avec le modèle de composants WSDL

La spécification d'extension de liaison d'opération SOAP ajoute la propriété suivante au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {soap mep default}, OPTIONNEL. Un type xs:anyURI, qui est une adresse IRI absolue comme définie par [IETF RFC 3987] ; propriété ajoutée au composant Binding ^†. La valeur de cette propriété identifie le modèle d'échange de messages SOAP par défaut de tous les composants Interface Operation d'un composant Interface auquel ce composant Binding est appliqué ;

• {soap mep}, OPTIONNEL. Un type xs:anyURI, qui est une adresse IRI absolue comme définie par [IETF RFC 3987] ; propriété ajoutée au composant Binding Operation ^†. La valeur de cette propriété identifie le modèle d'échange de messages SOAP de cette opération spécifique (cf. la section 5.10.3 Règles de liaison SOAP 1.2, paragraphe intitulé « Sélection du modèle d'échange de messages SOAP », pour les contraintes des liaisons) ;

• {soap action}, OPTIONNEL. Un type xs:anyURI, qui est une adresse IRI absolue comme définie par [IETF RFC 3987] ; propriété ajoutée au composant Binding Operation ^†. La valeur de cette propriété identifie la valeur de la caractéristique d'action SOAP du message initial du modèle d'échange de messages du composant Interface Operation lié, telle qu'indiquée dans les règles de liaison des liaisons à des versions spécifiques de SOAP (cf. la section 5.10.3 Règles de liaison SOAP 1.2 de la liaison SOAP 1.2 lorsque la valeur de la propriété {soap version} du composant Binding est "1.2").

5.7.3 Représentation XML

<description>
  <binding wsoap:mepDefault="xs:anyURI"? >
    <operation ref="xs:QName" 
               wsoap:mep="xs:anyURI"?
               wsoap:action="xs:anyURI"? >
    </operation>
  </binding>
</description>

La représentation XML pour lier un composant Binding Operation comporte deux items d'information d'attribut avec les propriété d'ensemble d'information suivantes :

• un item d'information d'attribut wsoap:mep OPTIONNEL ;

  • un nom local [local name] de mep ;

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

  • un type de xs:anyURI.

• un item d'information d'attribut wsoap:action OPTIONNEL ;

  • un nom local [local name] de action ;

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

  • un type de xs:anyURI.

L'item d'information d'attribut suivant est défini pour l'item d'information d'élément binding :

• un item d'information d'attribut wsoap:mepDefault OPTIONNEL ;

  • un nom local [local name] de mepDefault ;

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

  • un type de xs:anyURI.

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

Cf. le tableau 5-4.

5.8.1 Description

Le cadre de messagerie SOAP (SOAP messaging framework) permet à un service web d'engager une plusieurs caractéristiques (typiquement mises en œuvre en un ou plusieurs blocs d'en-tête SOAP), comme définis par des modules SOAP (cf. [SOAP 1.2 Part 1: Messaging Framework (Second Edition)]). Cette spécification d'extension de liaison permet une description des modules SOAP en vigueur à travers une liaison entière, pour chaque opération ou pour chaque message.

5.8.2 Relation avec le modèle de composants WSDL

Le composant SOAP Module ajoute la propriété suivante au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {soap modules}, OPTIONNEL. Un ensemble de composants SOAP Module comme définis à la section 5.8.3 Composant SOAP Module ; propriété ajoutée au composant Binding ;

• pareillement, {soap modules}, OPTIONNEL ; propriété ajoutée au composant Binding Operation ;

• pareillement, {soap modules}, OPTIONNEL ; propriété ajoutée au composant Binding Message Reference ;

• pareillement, {soap modules}, OPTIONNEL ; propriété ajoutée au composant Binding Fault ;

• pareillement, {soap modules}, OPTIONNEL ; propriété ajoutée au composant Binding Fault Reference.

Les modules SOAP applicables pour une opération particulière d'un service quelconque sont constitués de tous les modules définis dans les éléments input et output des composants Binding Message Reference, dans les éléments infault ou outfault des composants Binding Fault Reference, ceux définis au sein des composants Binding Fault, ceux définis au sein des composants Binding Operation et ceux définis au sein du composant Binding. Si un module est déclaré dans plusieurs composants, alors l'exigibilité (requiredness) de ce module est définie par la déclaration la plus proche, où la proximité est définie selon que l'exigibilité est décrite directement au niveau du composant Binding Message Reference ou du composant Binding Fault Reference, au niveau du composant Binding Fault ou du composant Binding Operation, ou au niveau du composant Binding, respectivement.

5.8.3 Composant SOAP Module

Le composant SOAP Module identifie un module SOAP en vigueur.

Les propriétés du composant SOAP Module sont les suivantes :

• {ref}, OBLIGATOIRE. Un type xs:anyURI, qui est une adresse IRI absolue comme définie par [IETF RFC 3987] ^†. La valeur de cette propriété identifie exclusivement le module SOAP en vigueur (selon le modèle de traitement de SOAP 1.2 [SOAP 1.2 Part 1: Messaging Framework (Second Edition)]) ;

• {required}, OBLIGATOIRE. Un type xs:boolean indiquant si le module SOAP est nécessaire ;

• {parent}, OBLIGATOIRE. Les composants Binding, Binding Operation, Binding Message Reference, Binding Fault ou Binding Fault Reference qui contiennent ce composant dans leur propriété {soap modules}.

5.8.4 Représentation XML

<description>
  <binding >
    <wsoap:module ref="xs:anyURI"
                  required="xs:boolean"? >
      <documentation ... />*
    </wsoap:module>
    <fault>
      <wsoap:module ... />*
    </fault>
    <operation>
      <wsoap:module ... />*
      <input>
        <wsoap:module ... />*
      </input>
      <output>
        <wsoap:module ... />*
      </output>
      <infault>
        <wsoap:module ... />*
      </infault>
      <outfault>
        <wsoap:module ... />*
      </outfault>
    </operation>
  </binding>
</description>

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

• un nom local [local name] de module ;

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

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

  • un item d'information d'attribut ref OBLIGATOIRE avec les propriétés d'ensemble d'information suivantes :

    • un nom local [local name] de ref ;

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

    • un type de xs:anyURI.

  • un item d'information d'attribut required OPTIONNEL 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] sans valeur ;

    • un type de xs:boolean.

  • zéro ou plus items d'information d'attribut, qualifiés d'un espace de noms. Le nom d'espace de noms [namespace name] de ces items d'information d'attribut NE DOIT PAS être "http://www.w3.org/ns/wsdl" NI "http://www.w3.org/ns/wsdl/soap".

• 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 comme définis dans [WSDL 2.0 Core Language] ;

  2. zéro ou plus items d'information d'élément, qualifiés d'un espace de noms, parmi ses sous-éléments [children]. Le nom d'espace de noms [namespace name] de ces items d'information d'élément NE DOIT PAS être "http://www.w3.org/ns/wsdl" NI "http://www.w3.org/ns/wsdl/soap".

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

Cf. le tableau 5-5.

5.8.6 Identification IRI d'un composant SOAP Module

La spécification WSDL version 2.0 tome 1 — Cœur du langage [WSDL 2.0 Core Language] définit une syntaxe d'identificateur de fragment pour identifier les composants d'un document WSDL 2.0.

Un composant SOAP Module peut être identifié en utilisant le schéma wsdl.extension du cadre XPointer (XPointer Framework) :

wsdl.extension(http://www.w3.org/ns/wsdl/soap, wsoap.module(parent/ref))

1. parent est la partie pointeur du composant {parent}, comme indiqué à l'annexe A.2 Identificateurs de fragments dans [WSDL 2.0 Core Language] ;

2. ref est la valeur de la propriété {ref} du composant.

5.9.1 Description

SOAP permet d'utiliser des blocs d'en-tête (header blocks) dans la partie en-tête du message. Cette extension de liaison permet aux utilisateurs de déclarer les blocs d'en-tête SOAP en vigueur pour chaque message et pour chaque incident.

5.9.2 Relation avec le modèle de composants WSDL

La spécification d'extension de liaison de blocs d'en-tête SOAP ajoute la propriété suivante au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {soap headers}, OPTIONNEL. Un ensemble de composants SOAP Header Block comme définis à la section 5.9.3 Composant SOAP Header Block ; propriété ajoutée au composant Binding Message Reference ;

• pareillement, {soap headers}, OPTIONNEL ; propriété ajoutée au composant Binding Fault.

5.9.3 Composant SOAP Header Block

Un composant SOAP Header Block décrit un morceau abstrait de données d'en-tête (bloc d'en-tête SOAP) qui est associé à l'échange de messages entre les parties communicantes. La présence d'un composant SOAP Header Block dans une description WSDL indique que le service gère les en-têtes et PEUT imposer à un client interagissant avec le service d'utiliser le bloc d'en-tête décrit. Zéro ou un bloc d'en-tête peut être utilisé.

Les propriétés du composant SOAP Header Block sont les suivantes :

• {element declaration}, OBLIGATOIRE. Une déclaration d'élément XML dans la propriété {element declarations} du composant Description. Cette déclaration d'élément XML représente exclusivement un bloc d'en-tête SOAP spécifique ;

• {mustUnderstand}, OBLIGATOIRE. Un type xs:boolean. Lorsque sa valeur est "true", le bloc d'en-tête SOAP DOIT être accompagné d'un item d'information d'attribut mustUnderstand SOAP avec une valeur de "true" ; dans ce cas, la déclaration d'élément XML référencée par la propriété {element declaration} DOIT admettre cet item d'information d'attribut mustUnderstand SOAP ^†. Sinon, aucune autre contrainte n'est exercée quant à la présence et à la valeur d'un item d'information d'attribut mustUnderstand SOAP ;

• {required}, OBLIGATOIRE. Un type xs:boolean indiquant si le bloc d'en-tête SOAP est nécessaire. Si la valeur est "true", alors le bloc d'en-tête SOAP DOIT être inclus dans le message ^†. Si la valeur est "false", le bloc d'en-tête SOAP PEUT être inclus ;

• {parent}, OBLIGATOIRE. Le composant Binding Fault ou Binding Message Reference qui contient ce composant dans sa propriété {soap headers}.

5.9.4 Représentation XML

<description>
  <binding name="xs:NCName" type="http://www.w3.org/ns/wsdl/soap" >
    <fault ref="xs:QName" >
      <wsoap:header element="xs:QName" mustUnderstand="xs:boolean"?
                 required="xs:boolean"? >
        <documentation />*
      </wsoap:header>*
      ...
    </fault>*
    <operation ref="xs:QName" >
      <input messageLabel="xs:NCName"?>
        <wsoap:header ... />*
        ...
      </input>*
      <output messageLabel="xs:NCName"?>
        <wsoap:header ... />*
        ...
      </output>*
    </operation>*
  </binding>
</description>

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

• un nom local [local name] de header ;

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

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

  • un item d'information d'attribut element OBLIGATOIRE avec les propriétés d'ensemble d'information suivantes :

    • un nom local [local name] de element ;

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

    • un type de xs:QName.

  • un item d'information d'attribut mustUnderstand OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

    • un nom local [local name] de mustUnderstand ;

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

    • un type de xs:boolean.

  • un item d'information d'attribut required OPTIONNEL 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] sans valeur ;

    • un type de xs:boolean.

  • zéro ou plusieurs items d'information d'attribut qualifiés d'un espace de noms. Le nom d'espace de noms [namespace name] de ces items d'information d'attribut NE DOIT PAS être "http://www.w3.org/ns/wsdl" NI "http://www.w3.org/ns/wsdl/soap".

• zéro 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 comme définis dans [WSDL 2.0 Core Language] ;

  2. zéro ou plus items d'information d'élément qualifiés d'un espace de noms parmi ses sous-éléments [children]. Le nom d'espace de noms [namespace name] de ces items d'information d'élément NE DOIT PAS être "http://www.w3.org/ns/wsdl" NI "http://www.w3.org/ns/wsdl/soap".

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

Cf. le tableau 5-6.

5.9.6 Identification IRI d'un composant SOAP Header Block

La spécification WSDL version 2.0 tome 1 — Cœur du langage [WSDL 2.0 Core Language] définit une syntaxe d'identificateur de fragment pour identifier les composants d'un document WSDL 2.0.

Un composant SOAP Header Block peut être identifié en utilisant le schéma wsdl.extension du cadre XPointer :

wsdl.extension(http://www.w3.org/ns/wsdl/soap, wsoap.header(parent/element declaration))

1. parent est la partie pointeur "wsdl.*" du composant {parent}, comme défini à l'annexe A.2 Identificateurs de fragment dans [WSDL 2.0 Core Language], c'est-à-dire sans les parties pointeurs xmlns() ;

2. element declaration est la valeur de la propriété {name} du composant Element Declaration désigné par la propriété {element declaration} du composant SOAP Header Block.

5.10.1 Identification d'une liaison SOAP 1.2 WSDL

Une liaison SOAP WSDL est identifiée comme une liaison SOAP 1.2 en affectant la valeur "1.2" à la propriété {soap version} du composant Binding.

5.10.2 Description

L'extension de liaison SOAP 1.2 WSDL définie dans cette section est une extension de la liaison SOAP définie à la section 5. Extension de liaison SOAP WSDL afin que les applications de services web puissent utiliser SOAP 1.2 [SOAP 1.2 Part 1: Messaging Framework (Second Edition)].

L'extension de liaison SOAP 1.2 WSDL gère la liaison HTTP SOAP 1.2 définie dans la spécification [SOAP 1.2 Part 2: Adjuncts (Second Edition)]. On l'indique en affectant l'adresse URI "http://www.w3.org/2003/05/soap/bindings/HTTP/" (comme défini par [SOAP 1.2 Part 2: Adjuncts (Second Edition)]) à la propriété {soap underlying protocol}. D'autres valeurs de protocole PEUVENT être utilisées pour cette propriété en conjonction avec l'extension de liaison SOAP 1.2 définie par cette spécification, à condition que la sémantique de ces protocoles soit cohérente avec cette extension de liaison.

Les règles par défaut de la section 5.10.3 Règles de liaison SOAP 1.2 définissent la relation entre les modèles d'échange de messages SOAP définis dans [SOAP 1.2 Part 2: Adjuncts (Second Edition)] et les modèles d'échange de messages WSDL définis à la section 2. Modèles d'échange de messages prédéfinis.

5.10.3 Règles de liaison SOAP 1.2

Ces règles de liaison sont applicables aux liaisons SOAP 1.2.

• Caractéristique d'action SOAP. La valeur de la caractéristique d'action SOAP (SOAP Action Feature) du message initial du modèle d'échange de messages du composant Interface Operation lié est indiquée par la propriété {soap action} de ce composant Binding Operation. Si le composant Binding Operation n'a pas de propriété {soap action} définie, alors la caractéristique d'action SOAP (cf. [SOAP 1.2 Part 2: Adjuncts (Second Edition)]) n'a pas de valeur. Sinon, sa valeur est celle de la caractéristique d'action SOAP du message initial du modèle d'échange de messages. La propriété {soap action} n'a aucun effet sur une liaison au modèle d'échange de messages SOAP Response SOAP.

• Sélection du modèle d'échange de messages SOAP. Pour un composant Interface Operation donné, s'il existe un composant Binding Operation dont la propriété {interface operation} correspond au composant en question et que sa propriété {soap mep} a une valeur, alors le modèle d'échange de messages SOAP est la valeur de la propriété {soap mep}. Sinon le modèle d'échange de messages SOAP est la valeur de la propriété {soap mep default} du composant Binding, le cas échéant. Sinon, la propriété {message exchange pattern} du composant Interface Operation DOIT avoir la valeur "http://www.w3.org/ns/wsdl/in-out", et le modèle d'échange de messages SOAP est l'adresse URI "http://www.w3.org/2003/05/soap/mep/request-response/" identifiant le modèle d'échange de messages Request-Response SOAP comme défini dans [SOAP 1.2 Part 2: Adjuncts (Second Edition)] ^†.

• Élément Detail SOAP. Le cas échéant, la valeur de l'élément Detail SOAP DOIT être l'item d'information d'élément identifié par la propriété {element declaration} du composant Interface Fault ^†.

• Sélection de méthode HTTP. Cette règle de liaison par défaut est applicable lorsque la valeur de la propriété {soap underlying protocol} du composant Binding est "http://www.w3.org/2003/05/soap/bindings/HTTP/". Si le modèle d'échange de messages SOAP sélectionné, comme indiqué ci-dessus, a la valeur "http://www.w3.org/2003/05/soap/mep/request-response/", alors la méthode HTTP utilisée est "POST". Si le modèle d'échange de messages SOAP sélectionné a la valeur "http://www.w3.org/2003/05/soap/mep/soap-response/", alors la méthode HTTP utilisée est "GET" ^†.

5.10.4 Liaison des modèles d'échange de messages WSDL 2.0 aux modèles d'échange de messages SOAP 1.2

Cette section décrit la relation entre les composants WSDL et les propriétés de modèle d'échange de messages SOAP 1.2, décrites dans [SOAP 1.2 Part 2: Adjuncts (Second Edition)].

6.4.1 Sélection de la méthode HTTP

Lors de la formulation du message HTTP à transmettre, la méthode de la requête HTTP DOIT être sélectionnée d'après l'un des cas suivants ^† :

• Pour un composant Interface Operation donné, s'il existe un composant Binding Operation dont la propriété {interface operation} correspond au composant en question et que sa propriété {http method} a une valeur, alors la valeur de la propriété {http method} ;

• Sinon, la valeur de la propriété {http method default} du composant Binding, le cas échéant ;

• Sinon, si une propriété {safe}, comme définie à la section 3.1 Sûreté des opérations, est présente sur le composant Interface Operation lié et a une valeur de "true", la valeur "GET" ;

• Sinon, la valeur "POST".

6.4.2 Sélection du codage de contenu HTTP

Lors de la formulation du message HTTP à transmettre, le codage de contenu (content encoding) d'un composant Binding Message Reference donné est déterminé comme suit ^† :

• Si la propriété {http content encoding} a une valeur non vide, un champ d'en-tête Content-Encoding DOIT être inséré avec la valeur de cette propriété ;

• Sinon, si la valeur de la propriété {http content encoding default} du composant Binding Operation parent a une valeur non vide, un champ d'en-tête Content-Encoding DOIT être inséré avec la valeur de cette propriété ;

• Sinon, si la valeur de la propriété {http content encoding default} du composant Binding grand-parent a une valeur non vide, un champ d'en-tête Content-Encoding DOIt être inséré avec la valeur de cette propriété.

Lors de la formulation du message d'incident HTTP à transmettre, le codage de contenu d'un composant Binding Fault donné est déterminé comme suit ^† ;

• Si la propriété {http content encoding} a une valeur non vide, alors un champ d'en-tête Content-Encoding DOIT être inséré avec la valeur de cette propriété ;

• Si la propriété {http content encoding default} a une valeur non vide, alors un champ d'en-tête Content-Encoding DOIT être inséré avec la valeur de cette propriété.

Le corps du message de réponse est codé avec le codage de contenu indiqué.

6.4.3 Construction de la charge utile et format de sérialisation

Lors de la formulation du message HTTP à transmettre, le contenu de la charge utile (c'est-à-dire le contenu du corps de message HTTP) DOIT être celui qui est défini par les composants Interface Message Reference ou Interface Fault correspondants, sérialisé comme indiqué par le format de sérialisation utilisé ^†.

[Définition : Le format de sérialisation (serialization format) est un atome de type de média (de la forme "type/sous-type"). Il identifie les règles pour sérialiser la charge utile dans un message HTTP. Sa valeur est définie par les règles suivantes. Le format de sérialisation de la requête HTTP DOIT être dans la gamme de type de média (media type range) indiquée par la propriété {http input serialization}. Le format de sérialisation de la réponse HTTP DOIT être dans la gamme de type de média indiquée par la propriété {http output serialization}. Le format de sérialisation HTTP d'un incident DOIT être dans la gamme de type de média indiquée par la propriété {http fault serialization}. Le concept de gamme de type de média est défini à la section 14.1 dans [IETF RFC 2616]. Le format de sérialisation PEUT avoir des paramètres de type de média associés (définis par la production parameter de media-range à la section 14.1 dans [IETF RFC 2616]).]

La section 6.8 Format de sérialisation des données d'instance définit les formats de sérialisation gérés par cette extension de liaison ainsi que leurs contraintes.

• Composant Interface Message Reference :

  • Si la valeur de la propriété {message content model} du composant Interface Message Reference lié est "#any" ou "#element", la sérialisation des données d'instance est indiquée comme définie à la section 6.4.3.1 Règles de sérialisation des messages XML ;

  • Si la valeur est "#none", alors la charge utile DOIT être vide et la valeur de la propriété de sérialisation correspondante ({http input serialization} ou {http output serialization}) est ignorée ^† ;

  • Si la valeur est "#other", alors le format de sérialisation et ses paramètres de type de média associés, le cas échéant, définissent la valeur du champ d'entité d'en-tête Content-Type comme défini à la section 14.17 dans [IETF RFC 2616]. La sérialisation de la charge utile n'est pas définie.

• Composant Interface Fault : la sérialisation des données d'instance est indiquée comme définie à la section 6.4.3.1 Règles de sérialisation des messages XML.

Si le composant Interface Message Reference, ou le composant Interface Fault, est déclaré en utilisant un système de typage non-XML (comme examiné à la section Types dans [WSDL 2.0 Core Language]), alors d'autres règles de liaison DOIVENT être définies dans une spécification d'extension pour indiquer comment associer (map) ces composants dans l'enveloppe HTTP ^†.

6.4.4 Format de sérialisation d'entrée et de sortie par défaut

La section tableau 6-1 définit les valeurs par défaut des valeurs GET, POST, PUT et DELETE de la méthode HTTP, sélectionnée selon la section 6.4.1 Sélection de la méthode HTTP.

La valeur par défaut des propriétés {http input serialization} et {http output serialization} pour toute autre méthode HTTP sélectionnée est application/xml.

D'autres mécanismes que ceux de réglage des propriétés de sérialisation PEUVENT modifier le format de sérialisation des données d'instance correspondant au message. Un exemple d'une telle modification est celui des règles de sérialisation d'adresse IRI HTTP de la liaison SOAP WSDL définies à la section 5.3 Règles de liaison SOAP. Cette extension de liaison indique que le modèle d'échange de messages SOAP Response (section 6.3 dans [SOAP 1.2 Part 2: Adjuncts (Second Edition)]) ne gère une sérialisation de message d'entrée que comme application/x-www-form-urlencoded. Les autres modèles d'échange de messages ou extensions de liaison fournissent d'autres exemples.

6.4.5 Construction d'en-tête HTTP

Si la propriété {http headers} comme définie à la section 6.6 Déclaration des en-têtes HTTP existe et n'est pas vide dans un composant Binding Message Reference ou Binding Fault, les en-têtes HTTP conformes à chaque composant HTTP Header contenu dans cette propriété {http headers} PEUVENT être sérialisés comme suit ^† :

• Le nom de champ d'en-tête HTTP utilisé dans la valeur de la propriété {name} du composant HTTP Header. La liaison HTTP NE DOIT PAS établir de champ d'en-tête HTTP correspondant à la valeur de la propriété {name} déjà fixée par un autre mécanisme, tel que la pile HTTP ou une autre caractéristique ^† ;

• La valeur de champ d'en-tête HTTP, dont le type XML Schema est déclaré par la propriété {type definition} du composant HTTP Header, est sérialisée selon les règles de la production field-value à la section 4.2 de [IETF RFC 2616].

Si la valeur de la propriété {required} d'un composant HTTP Header est "true", l'inclusion de ce champ d'en-tête HTTP est OBLIGATOIRE ^†, sinon elle est OPTIONNELLE.

6.4.6 Adresse IRI de requête HTTP

Lors de la formulation de la requête HTTP, l'adresse IRI de la requête HTTP est une référence IRI absolue et c'est la valeur de la propriété {http location} du composant Binding Operation, résolue en utilisant la valeur de la propriété {address} du composant Endpoint (cf. la section 5 de [IETF RFC 3986]) ^†. Si la propriété {http location} n'est pas établie, l'adresse IRI de requête HTTP est la valeur de la propriété {address} du composant Endpoint. Les sérialisations d'entrée peuvent définir des règles de traitement supplémentaires, à appliquer à la valeur de {http location} avant de lancer le processus de résolution de référence, c'est-à-dire avant de la combiner avec la propriété {address} de l'élément endpoint pour former l'adresse IRI de requête HTTP. Ainsi, les trois formats de sérialisation décrits à la section 6.8 Format de sérialisation des données d'instance définissent une syntaxe pour utiliser la propriété {http location} comme gabarit avec les éléments des données d'instance.

Si l'adresse IRI résultante utilise le schéma https, alors on utilise HTTP sur le protocole TLS [IETF RFC 2818] pour envoyer la requête HTTP.

L'adresse IRI de requête HTTP qui identifie la ressource sur laquelle appliquer la demande est transmise en utilisant les champs d'en-tête Request-URI et, en option, Host, comme définis dans [IETF RFC 2616].

6.5.1 Description

Cette spécification d'extension de liaison fournit à HTTP une liaison aux composants Interface Operation dont la propriété {message exchange pattern} a l'une des valeurs suivantes :

• "http://www.w3.org/ns/wsdl/in-only"

• "http://www.w3.org/ns/wsdl/robust-in-only"

• "http://www.w3.org/ns/wsdl/in-out"

Cette extension de liaison HTTP PEUT être utilisée avec d'autres modèles d'échange de messages, tels que des modèles d'échange de messages hors-bande, à condition de définir des sémantiques supplémentaires, par exemple, au travers d'une extension.

Chaque modèle d'échange de messages parmi les trois cités implique l'échange d'un ou deux messages ou incidents. Le premier est transmis en utilisant une requête HTTP et le deuxième en utilisant la réponse HTTP correspondante ^†. Au cas où un seul message est envoyé, le corps de message de la réponse HTTP DOIT être vide ^†.

Pour les réponses réussies, le code de réponse HTTP DOIT être le suivant :

• 202 lorsque le modèle d'échange de messages est "http://www.w3.org/ns/wsdl/in-only" ^† ;

• 204 lorsque le modèle d'échange de messages est "http://www.w3.org/ns/wsdl/robust-in-only" ^†.

Pour chaque composant Binding Operation correspondant à de tels composants Interface Operation, cette spécification d'extension de liaison permet à l'utilisateur d'indiquer la méthode HTTP à utiliser, la sérialisation d'entrée, de sortie et d'incident, et l'emplacement de l'opération liée.

6.5.2 Relation avec le modèle de composants WSDL

L'extension de liaison HTTP ajoute les propriétés suivantes au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {http location}, OPTIONNELLE. Un type xs:anyURI ; propriété ajoutée au composant Binding Operation. Elle DOIT contenir une référence IRI et NE DOIT PAS inclure de composant identificateur de fragment ^† ;

• {http method default}, OPTIONNELLE. Un type xs:string ; propriété ajoutée au composant Binding, indiquant la valeur par défaut de la méthode de requête HTTP pour tous les composants Interface Operation d'un composant Interface auquel ce composant Binding est appliqué ;

• {http method}, OPTIONNELLE. Un type xs:string ; propriété ajoutée au composant Binding Operation, indiquant la valeur de la méthode de requête HTTP pour ce composant Binding Operation spécifique ;

• {http input serialization}, OBLIGATOIRE. Un type xs:string ; propriété ajoutée au composant Binding Operation, indiquant les règles de sérialisation permises du message de requête HTTP pour cette opération spécifique, comme décrites à la section 6.5.3 Spécification des règles de sérialisation permises ;

• {http output serialization}, OBLIGATOIRE. Un type xs:string ; propriété ajoutée au composant Binding Operation, indiquant les règles de sérialisation permises du message de réponse HTTP pour cette opération spécifique, comme décrites à la section 6.5.3 Spécification des règles de sérialisation permises ;

• {http fault serialization}, OBLIGATOIRE. Un type xs:string ; propriété ajoutée au composant Binding Operation, indiquant les règles de sérialisation permises du message de réponse HTTP pour cette opération spécifique en cas de retour d'un incident, comme décrites à la section 6.5.3 Spécification des règles de sérialisation permises ;

• {http query parameter separator default}, OBLIGATOIRE. Un type xs:string ; propriété ajoutée au composant Binding, indiquant le caractère de séparation par défaut du paramètre d'interrogation (query parameter) pour tous les composants Interface Operation d'un composant Interface auquel ce composant Binding est appliqué ;

• {http query parameter separator}, OPTIONNELLE. Un type xs:string ; propriété ajoutée au composant Binding Operation, indiquant le caractère de séparation du paramètre d'interrogation pour ce composant Binding Operation.

6.5.3 Spécification des règles de sérialisation permises

La valeur des propriétés {http input serialization}, {http output serialization} et {http fault serialization} est similaire à la valeur permise pour l'en-tête HTTP Accept, définie par la spécification HTTP 1.1 (cf. la section 14.1 dans [IETF RFC 2616]), et elle DOIT suivre les règles de production définies dans cette section sauf pour ce qui suit ^† :

1. Le préfixe "Accept:" NE DOIT PAS être utilisé ;

2. La règle qdtext change de :

   qdtext = <tout TEXT sauf<">>

   Pour :

   qdtext = <tout CHAR sauf<">>

   Cette modification est apportée pour interdire les « OCTET » non-US-ASCII.

Ces propriétés indiquent la gamme des types de média et des paramètres associés avec lesquels une instance PEUT être sérialisée. La valeur du format de sérialisation utilisé pour un message est un type de média qui DOIT être couvert par cette gamme ^†. On NE DEVRAIT PAS utiliser de caractères génériques (wildcards), par exemple, "application/*", dans cet item d'information d'attribut car ils peuvent entraîner des problèmes d'interopérabilité ^†.

L'utilisation des propriétés {http input serialization}, {http output serialization} et {http fault serialization} est spécifiée à la section 6.4.3 Construction de la charge utile et format de sérialisation.

6.5.4 Représentation XML

<description>
 <binding whttp:methodDefault="xs:string"?
          whttp:queryParameterSeparatorDefault="xs:string"? >
   <operation ref="xs:QName" 
              whttp:location="xs:anyURI"?
              whttp:method="xs:string"? 
              whttp:inputSerialization="xs:string"? 
              whttp:outputSerialization="xs:string"? 
              whttp:faultSerialization="xs:string"?
              whttp:queryParameterSeparator="xs:string"? >
  </operation>
 </binding>
</description>

La représentation XML de liaison d'une opération consiste en six items d'information d'attribut avec les propriétés d'ensemble d'information suivantes :

• un item d'information d'attribut location OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de location ;

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

  • un type de xs:anyURI.

• un item d'information d'attribut method OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de method ;

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

  • un type de xs:string.

• un item d'information d'attribut inputSerialization OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de inputSerialization ;

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

  • un type de xs:string.

• un item d'information d'attribut outputSerialization OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de outputSerialization ;

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

  • un type de xs:string.

• un item d'information d'attribut faultSerialization OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de faultSerialization ;

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

  • un type de xs:string.

• un item d'information d'attribut queryParameterSeparator OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de queryParameterSeparator ;

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

  • un type de xs:string, dont la facette pattern est "[&;a-zA-Z0-9\-\._~!$'\(\):@/\?\*\+,]{1,1}" ; les caractères « & » et « ; » sont les plus souvent employés dans la pratique.

Les items d'information d'attribut suivants de l'item d'information d'élément binding sont définis :

• un item d'information d'attribut methodDefault OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de methodDefault ;

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

  • un type de xs:string.

• un item d'information d'attribut queryParameterSeparatorDefault OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de queryParameterSeparatorDefault.

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

  • un type de xs:string dont la facette length est "1". Les caractères admis sont les mêmes que pour la propriété {http query parameter separator} ci-dessus.

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

See tableau 6-2.

6.6.1 Description

HTTP permet l'utilisation d'en-têtes dans les messages. Cette extension de liaison permet aux utilisateurs de déclarer les en-têtes HTTP en vigueur pour chaque message et pour chaque incident.

6.6.2 Relation avec le modèle de composants WSDL

La spécification d'extension de liaison du composant HTTP Header ajoute les propriétés suivantes au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {http headers}, OPTIONNELLE. Un ensemble de composants HTTP Header comme définis à la section 6.6.3 Composant HTTP Header ; propriété ajoutée au composant Binding Message Reference ;

• pareillement, {http headers}, OPTIONNELLE ; propriété ajoutée au composant Binding Fault.

La propriété {http headers} d'un composant Binding Message Reference ou Binding Fault NE DOIT PAS contenir plusieurs composants HTTP Header avec la même propriété {name} ^†

6.6.3 Composant HTTP Header

Un composant HTTP Header décrit un morceau abstrait de données d'en-tête (champ d'en-tête HTTP) associé à l'échange de messages entre les parties communicantes. La présence d'un composant HTTP Header dans une description WSDL indique que le service gère les en-têtes et PEUT imposer au client interagissant avec lui d'utiliser le champ d'en-tête décrit. Zéro ou un seul tel champ d'en-tête peut être utilisé.

Les propriétés du composant HTTP Header sont les suivantes :

• {name}, OBLIGATOIRE. Un type xs:string dont la facette pattern est "[!#-'*+\-.0-9A-Z^-z|~]+" ; c'est le nom du champ d'en-tête HTTP. La valeur de cette propriété suit les règles de la production field-name, comme définie à la section 4.2 de [IETF RFC 2616] ;

• {type definition}, OBLIGATOIRE. Un composant Type Definition, dans la propriété {type definitions} du composant Description, contraignant la valeur du champ d'en-tête HTTP. Ce type DOIT être un type simple ^† ;

• {required}, OBLIGATOIRE. Un type xs:boolean indiquant si le champ d'en-tête HTTP est nécessaire. Si la valeur est "true", alors le champ d'en-tête HTTP DOIT être inclus dans le message ^†. Si la valeur est "false", le champ d'en-tête HTTP PEUT être inclus ;

• {parent}, OBLIGATOIRE. Le composant Binding Fault ou Binding Message Reference qui contient ce composant dans sa propriété {http headers}.

6.6.4 Représentation XML

<description>
  <binding name="xs:NCName" type="http://www.w3.org/ns/wsdl/http" >
    <fault ref="xs:QName">
      <whttp:header name="xs:string" type="xs:QName"
                    required="xs:boolean"? >
        <documentation />*
      </whttp:header>*
      ...
    </fault>*
    <operation ref="xs:QName" >
      <input messageLabel="xs:NCName"?>
        <whttp:header ... />*
        ...
      </input>*
      <output messageLabel="xs:NCName"?>
        <whttp:header ... />*
        ...
      </output>*
    </operation>*
  </binding>
</description>

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

• un nom local [local name] de header ;

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

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

  • un item d'information d'attribut name OBLIGATOIRE avec les propriétés d'ensemble d'information suivantes :

    • un nom local [local name] de name ;

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

    • un type de xs:string dont la facette pattern est "[!#-'*+\-.0-9A-Z^-z|~]+".

  • un item d'information d'attribut type OBLIGATOIRE avec les propriétés d'ensemble d'information suivantes :

    • un nom local [local name] de type ;

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

    • un type de xs:QName.

  • un item d'information d'attribut required OPTIONNEL 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] sans valeur ;

    • un type de xs:boolean.

  • zéro ou plus items d'information d'attribut qualifiés d'un espace de noms. Le nom d'espace de noms [namespace name] de ces items d'information d'attribut NE DOIT PAS être "http://www.w3.org/ns/wsdl" NI "http://www.w3.org/ns/wsdl/http".

• 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 comme défini dans [WSDL 2.0 Core Language] ;

  2. zéro ou plus items d'information d'élément, qualifiés d'un espace de noms, parmi ses sous-éléments [children]. Le nom d'espace de noms [namespace name] de ces items d'information d'élément NE DOIT PAS être "http://www.w3.org/ns/wsdl" NI "http://www.w3.org/ns/wsdl/http".

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

Cf.  le tableau 6-3.

6.6.6 Identification IRI d'un composant HTTP Header

WSDL version 2.0 tome 1 [WSDL 2.0 Core Language] définit une syntaxe d'identificateur de fragment pour identifier les composants d'un document WSDL 2.0.

Un composant HTTP Header peut être identifié en utilisant le schéma wsdl.extension du cadre XPointer :

wsdl.extension(http://www.w3.org/ns/wsdl/http, whttp.header(parent/name))

1. parent est la partie pointeur du composant {parent}, comme défini dans la spécification WSDL version 2.0 tome 1 — Cœur du langage ;

2. name est la valeur de la propriété {name}.

6.7.1 Description

Pour chaque composant Interface Fault contenu dans un composant Interface, un code d'erreur HTTP PEUT être défini. Il représente le code d'erreur qui sera utilisé par le service au cas où l'incident doit être retourné.

La définition d'incident DEVRAIT correspondre à celle des codes d'erreur HTTP, comme définis à la section 8 de [IETF RFC 3205] ^†.

6.7.2 Relation avec le modèle de composants WSDL

L'extension de liaison d'incident HTTP ajoute la propriété suivante au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {http error status code}, OBLIGATOIRE. L'union d'un type xs:int et d'un type xs:token, où la valeur d'atome permise est "#any" ; propriété ajoutée au composant Binding Fault. Une valeur entière de cette propriété identifie l'erreur Status-Code, comme définie par [IETF RFC 2616], que le service utilisera au cas où l'incident est retourné ^†. Si la valeur de cette propriété est "#any", le service ne fait aucune réclamation.

6.7.3 Représentation XML

<description>
  <binding >
    <fault ref="xs:QName"
           whttp:code="union de xs:int, xs:token"? >
    </fault>*
  </binding>
</description>

La représentation XML pour lier un incident HTTP est un item d'information d'attribut avec les propriétés d'ensemble d'information suivantes :

• un item d'information d'attribut code OPTIONNEL ;

  • un nom local [local name] de code ;

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

  • un type composé de l'union d'un type xs:int et d'un type xs:token, où la valeur d'atome permise est "#any".

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

Cf. le tableau 6-4.

6.8.1 Sérialisation des données d'instance dans les parties de l'adresse IRI de requête HTTP

Cette section définit les règles de modélisation (templating rules) de la propriété {http location} du composant Binding Operation. Une modélisation est utilisée par les formats de sérialisation, définis à la section 6.8 Format de sérialisation des données d'instance, et elle PEUT être réutilisée par d'autres formats de sérialisation.

Avec cette liaison HTTP, une partie des données d'instance des requêtes HTTP PEUT être sérialisée dans la requête HTTP et une autre partie PEUT l'être dans le corps du message HTTP.

Si la propriété {style} du composant Interface Operation lié a une valeur de "http://www.w3.org/ns/wsdl/style/iri", comme définie à la section 4.2 Style IRI, et si la propriété {http location} du composant Binding Operation est présente, la valeur de la propriété {http location} du composant est utilisée comme gabarit (template) ^†, lequel est combiné avec la propriété {address} de l'élément endpoint pour former l'adresse IRI complète à utiliser dans une requête HTTP, comme défini à la section 6.5.2 Relation avec le modèle de composants WSDL.

L'adresse IRI obtenue DOIT être associée à une adresse URI à utiliser dans la requête HTTP, selon la section 3.1 Correspondance des adresse IRI aux adresses URI de la spécification IRI [IETF RFC 3987] ^†. Un format de sérialisation PEUT définir des règles supplémentaires pour la sérialisation de l'adresse IRI de requête HTTP.

httpLocation ::= charData? (( openBrace | closeBrace | template ) charData?)*
charData ::= [^{}]*
openBrace ::= '{{'
closeBrace ::= '}}'
template ::= rawTemplate | encodedTemplate
rawTemplate ::= '{!' NCName '}'
encodedTemplate ::= '{' NCName '}'

{scheme}://{host}:{port}/temperature/{town}

{!myIRI}

6.8.2 Sérialisation comme type "application/x-www-form-urlencoded"

Ce format de sérialisation est conçu pour permettre à un client ou un service web de produire une adresse IRI fondée sur les données d'instance d'un message et de sérialiser une chaîne d'interrogation (query string) dans le corps de message HTTP comme type application/x-www-form-urlencoded.

Si ce format est utilisé, alors la propriété {style} du composant Interface Operation lié DOIT contenir une valeur de "http://www.w3.org/ns/wsdl/style/iri", comme définie à la section 4.2 Style IRI, c'est-à-dire que ce format de sérialisation peut seulement être utilisé pour sérialiser la requête HTTP correspondant au message initial d'une opération d'interface ^†.

Pour la liaison HTTP définie dans cette section (6. Extension de liaison HTTP WSDL), on PEUT utiliser "application/x-www-form-urlencoded" comme format de sérialisation pour un message d'entrée (requête HTTP) ; mais on NE DOIT PAS l'utiliser comme format de sérialisation pour un message de sortie ou d'incident (réponse HTTP) ^†.

<data>
  <town>Fréjus</town>
  <date>2007-06-26</date>
  <unit>C</unit>
</data>

'temperature/{town}'

'&'

date=2007-06-26&unit=C

<operation ref='t:data'
    whttp:location='temperature/{town}'
    whttp:method='GET' />

<endpoint name='e' binding='t:b'
    address='http://ws.example.com/service1/' />

GET http://ws.example.com/service1/temperature/Fr%C3%A9jus?date=2007-06-26&unit=C HTTP/1.1
Host: ws.example.com

<operation ref='t:data'
    whttp:inputSerialization='application/x-www-form-urlencoded'
    whttp:location='temperature/{town}'
    whttp:method='POST' />

<endpoint name='e' binding='t:b'
    address='http://ws.example.com/service1/' />

POST http://ws.example.com/service1/temperature/Fr%C3%A9jus HTTP/1.1
Host: ws.example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: …

date=2007-06-26&unit=C

6.8.3 Sérialisation comme type "application/xml"

Dans cette sérialisation, pour les requêtes HTTP, les règles définies à la section 6.8.1 Sérialisation des données d'instance dans les parties de l'adresse IRI de requête HTTP pour construire l'adresse IRI de requête HTTP s'appliquent, si la propriété {style} du composant Interface Operation lié a une valeur de "http://www.w3.org/ns/wsdl/style/iri", comme définie à la section 4.2 Style IRI.

Les données d'instance du message d'entrée, de sortie ou d'incident sont sérialisées en un document XML dans le corps de message du message HTTP, en suivant la sérialisation définie dans [Canonical XML]. De ce fait, elle convient seulement pour les requêtes HTTP utilisant des méthodes admettant un corps de message (c'est-à-dire, pour les messages d'entrée de la liaison HTTP définie dans cette spécification où la méthode HTTP sélectionnée a un corps), et pour les réponses HTTP (c'est-à-dire, pour les messages de sortie et d'incident de la liaison HTTP définie dans cette spécification).

L'en-tête HTTP Content-Type DOIT avoir la valeur application/xml [IETF RFC 3023], ou un type de média compatible avec application/xml, comme défini à la section 6.4.3.1 Règles de sérialisation des messages XML ^†. D'autres en-têtes HTTP PEUVENT être utilisés.

6.8.4 Sérialisation comme type "multipart/form-data"

Dans cette sérialisation, pour les requêtes HTTP, les règles définies à la section 6.8.1 Sérialisation des données d'instance dans les parties de l'adresse IRI de requête HTTP pour construire l'adresse IRI de requête HTTP s'appliquent, si la propriété {style} du composant Interface Operation lié a une valeur de "http://www.w3.org/ns/wsdl/style/iri", comme définie à la section 4.2 Style IRI.

Ce format, pour la compatibilité à l'existant, permet d'utiliser des clients XForms avec des serveurs [IETF RFC 2388]. Ce format de sérialisation ne peut être utilisé que pour lier des composants Interface Operation dont la propriété {style} a une valeur de "http://www.w3.org/ns/wsdl/style/multipart", comme définie à la section 4.3 Style multipart, c'est-à-dire qu'on ne peut utiliser ce format de sérialisation que pour sérialiser la requête HTTP correspondant au message initial d'une opération d'interface ^†.

Spécifiquement, pour la liaison HTTP définie dans cette section (6. Extension de liaison HTTP WSDL), on PEUT utiliser "multipart/form-data" comme format de sérialisation pour un message d'entrée (requête HTTP) ; mais on NE DOIT PAS l'utiliser comme format de sérialisation pour un message de sortie ou d'incident (réponse HTTP) ^†. Ce format sérialise les données d'instance dans le corps de message HTTP et convient seulement pour les requêtes HTTP utilisant des méthodes admettant un corps de message.

Chaque élément dans la séquence est sérialisé en une partie comme suit :

1. L'en-tête Content-Disposition DOIT avoir la valeur form-data, et son paramètre name être le nom local de l'élément ^† ;

2. L'en-tête Content-Type DOIT avoir pour valeur ^† :

   • application/xml (ou un type de média compatible avec application/xml) si l'élément a un type complexe ;

   • application/octet-stream si l'élément est de type xs:base64Binary, xs:hexBinary, ou d'un type dérivé ;

   • text/plain si l'élément a un type simple ; le paramètre charset DOIT être réglé de façon appropriée. Les codages UTF-8 ou UTF-16 DOIVENT être gérés au minimum.

3. Si le type est xs:base64Binary, xs:hexBinary, xs:anySimpleType, ou un type dérivé, le contenu de la partie est le contenu de l'élément. Si c'est un type complexe, l'élément est sérialisé suivant les règles définies à la section 6.8.3 Sérialisation comme type "application/xml".

Les données d'instance NE DOIVENT PAS contenir d'éléments avec un attribut xs:nil dont la valeur est "true" ^†.

<data>
  <town>
    <name>Fréjus</name>
    <country>France</country>
  </town>
  <date>2007-06-26</date>
</data>

<operation ref='t:data'
    whttp:location='temperature'
    whttp:method='POST'
    whttp:inputSerialization='multipart/form-data'/>

Content-Type: multipart/form-data; boundary=AaB03x
Content-Length: xxx
        
--AaB03x
Content-Disposition: form-data; name="town"
Content-Type: application/xml

<town>
  <name>Fréjus</name>
  <country>France</country>
</town>
--AaB03x
Content-Disposition: form-data; name="date"
Content-Type: text/plain; charset=utf-8

2007-06-26
--AaB03x--

6.9.1 Description

Chaque composant Binding Message Reference et Binding Fault PEUT indiquer quels codages de contenu, comme définis à la section 3.5 de [IETF RFC 2616], sont disponibles pour ce message particulier.

L'extension de liaison HTTP fournit un mécanisme pour indiquer une valeur par défaut au niveau des composants Binding et Binding Operation.

Si aucune valeur n'est définie, aucune revendication n'est faite.

6.9.2 Relation avec le modèle de composants WSDL

La spécification d'extension de liaison HTTP ajoute les propriétés suivantes au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {http content encoding default}, OPTIONNELLE. Un type xs:string ; propriété ajoutée au composant Binding. Cette propriété indique les codages de contenu par défaut disponibles pour tous les composants Binding Message Reference et Binding Fault de ce composant Binding ;

• {http content encoding default}, OPTIONNELLE. Un type xs:string ; propriété ajoutée au composant Binding Operation. Cette propriété indique les codages de contenu par défaut disponibles pour tous les composants Binding Message Reference de ce composant Binding Operation ;

• {http content encoding}, OPTIONNELLE. Un type xs:string ; propriété ajoutée au composant Binding Message Reference. Cette propriété indique les codages de contenu disponibles pour ce composant Binding Message Reference. Si cette propriété n'a pas de valeur, la valeur de la propriété {http content encoding default} du composant Binding Operation parent est utilisée à la place. Si cette propriété elle-même n'a pas de valeur, c'est la valeur de celle du composant Binding parent du composant Binding Operation qui est alors utilisée ;

• pareillement, {http content encoding}, OPTIONNELLE ; propriété ajoutée au composant Binding Fault.

Ces propriétés ne sont pas pertinentes lorsque HTTP 1.0 est utilisé.

6.9.3 Représentation XML

<description>
  <binding name="xs:NCName" interface="xs:QName"? type="xs:anyURI"
           whttp:contentEncodingDefault="xs:string"? >

    <fault ref="xs:QName"
           whttp:contentEncoding="xs:string"? >
    </fault>*

    <operation location="xs:anyURI"?
               whttp:contentEncodingDefault="xs:string"? >
      <input messageLabel="xs:NCName"? 
             whttp:contentEncoding="xs:string"? />

      <output messageLabel="xs:NCName"?
              whttp:contentEncoding="xs:string"? />

    </operation>
  </binding>
</description>

La représentation XML pour indiquer le codage de contenu est un item d'information d'attribut OPTIONNEL pour les items d'information d'élément input, output et fault avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de contentEncoding ;

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

• un type de xs:string.

La représentation XML pour indiquer le codage de contenu par défaut est un item d'information d'attribut OPTIONNEL pour l'item d'information d'élément binding ou pour les items d'information d'élément operation sous-éléments de l'élément binding, avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de contentEncodingDefault ;

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

• un type de xs:string.

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

Cf. le tableau 6-8.

6.10.1 Description

La propriété {http cookies} permet aux composants Binding d'indiquer que des cookies HTTP (définis dans [IETF RFC 2965]) sont utilisés par des opérations spécifiques de l'interface à laquelle s'applique cette liaison.

6.10.2 Relation avec le modèle de composants WSDL

La spécification d'extension de liaison HTTP ajoute la propriété suivante au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {http cookies}, OBLIGATOIRE. Un type xs:boolean ; propriété ajoutée au composant Binding.

6.10.3 Représentation XML

<description>
  <binding name="xs:NCName" interface="xs:QName"? type="xs:anyURI"
           whttp:cookies="xs:boolean"? >
  </binding>
</description>

La représentation XML pour indiquer l'utilisation de cookies HTTP est un item d'information d'attribut OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

• un nom local [local name] de cookies ;

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

• un type de xs:boolean.

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

Cf. le tableau 6-9.

6.11.1 Description

Chaque composant Endpoint PEUT indiquer l'utilisation d'un mécanisme d'authentification d'accès HTTP (défini dans [IETF RFC 2616]) pour l'extrémité décrite.

Cette spécification d'extension de liaison permet d'indiquer les schéma et domaine (realm) d'authentification.

6.11.2 Relation avec le modèle de composants WSDL

La spécification d'extension de liaison HTTP ajoute les propriétés suivantes au modèle de composants WSDL (défini dans [WSDL 2.0 Core Language]) :

• {http authentication scheme}, OPTIONNELLE. Un type xs:token avec la valeur "basic" ou "digest" ; propriété ajoutée au composant Endpoint, correspondant au schéma d'authentification utilisé. Si présente, cette propriété indique le schéma d'authentification en vigueur : "basic" indique le schéma d'authentification d'accès Basic et "digest" le schéma d'authentification d'accès Digest, comme définis dans [IETF RFC 2617] ;

• {http authentication realm}, OPTIONNELLE. Un type xs:string ; propriété ajoutée au composant Endpoint. Elle correspond au paramètre d'authentification de domaine défini dans [IETF RFC 2617]. Si la propriété {http authentication scheme} est présente, alors cette propriété DOIT l'être ^†.

6.11.3 Représentation XML

<description>
  <service>
    <endpoint name="xs:NCName" binding="xs:QName" address="xs:anyURI"? >
              whttp:authenticationScheme="xs:token"? 
              whttp:authenticationRealm="xs:string"? />
    </endpoint>
  </service>
</description>

La représentation XML pour indiquer l'utilisation d'une authentification d'accès HTTP consiste en deux items d'information d'attribut OPTIONNELS avec les propriétés d'ensemble d'information suivantes :

• un item d'information d'attribut authenticationScheme OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de authenticationScheme ;

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

  • un type de xs:token, où les valeurs d'atome permises sont "basic" et "digest".

• un item d'information d'attribut authenticationRealm OPTIONNEL avec les propriétés d'ensemble d'information suivantes :

  • un nom local [local name] de authenticationRealm ;

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

  • un type de xs:string.

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

Cf. le tableau 6-10.