sib: syntaxe des URL
La syntaxe de l'URL sib: est la suivante :
sib:/[destination|chemin]?propriété_1=valeur_1&propriété_2=valeur_2&...
où :- Les crochets ("[ ]") indiquent que le paramètre est facultatif.
- Le type de transport est sib:, suivi de /destination pour spécifier un type de destination ou de /path, pour spécifier un chemin de routage de transmission, puis d'une "chaîne de requête" contenant une ou plusieurs propriétés. Les propriétés admises sont décrites dans les sections ultérieures de cette rubrique.
Propriétés requises
Les propriétés suivantes sont
requises. Elles permettent de spécifier la destination de la demande.
Remarque : Les noms de
destination doivent tous être complets.
Ils doivent inclure le nom du bus
d'intégration de services, ainsi que le nom de la destination. Utilisez la syntaxe
bus:destination.
Si un nom de bus ou de destination contient un signe deux-points ou une virgule, placez
ce nom entre guillemets (""). S'il contient un guillemet, doublez ce guillemet.
- destinationName
- Nom de la destination.
- chemin d'accès
- Chemin de routage de transmission, sous forme de séquence de noms de destination séparés par des virgules.
- replyDestinationName
- Nom de la destination à utiliser pour la réponse.
- inboundService
- Nom du service de communications entrantes qui identifie la pièce jointe spécifique utilisée par l'application demandeur. Vous pouvez omettre cette valeur si la destination correspond à une destination de services à laquelle est associée une configuration de service de communications sortantes, car dans ce cas, le demandeur est connecté au service de communications sortantes via la destination de services.
- timeout
- Durée pendant laquelle le demandeur attend une réponse. La valeur par défaut est de 60 secondes. La valeur zéro correspond à une attente illimitée.
Propriétés liées aux technologies d'intégration de services
Les propriétés suivantes sont facultatives. Si vous ne spécifiez pas de valeur pour une propriété, la valeur par défaut est utilisée. Pour plus d'informations sur les valeurs admises pour ces propriétés, voir les informations de l'API générée relatives à l'interface SIMessage.
- reliability
- Fiabilité du message de demande.
- timeToLive
- Durée (en millisecondes) avant l'arrivée à expiration de la demande. La valeur zéro
indique que la demande n'arrive jamais à expiration.Remarque : La propriété timeout (voir les propriétés requises) correspond à la durée pendant laquelle le demandeur bloque l'unité d'exécution de l'application en attendant une réponse à une opération de demande et réponse. Les propriétés facultativestimeToLive et replyTimeToLive indiquent combien de temps les messages de demande et de réponse doivent être traités par les moteurs de messagerie. Le temps de traitement lors de l'implémentation du service n'est pas inclus. Généralement le délai d'expiration correspond donc à la somme des délais d'expiration de la demande et de la réponse et de la durée de traitement du service.
- Priority
- Priorité du message de demande.
- user
- ID utilisateur requis pour accéder à la destination de la demande.
- mot de passe
- Mot de passe requis pour accéder à la destination de la demande.
- replyReliability
- Fiabilité du message de réponse.
- replyTimeToLive
- Durée (en millisecondes) avant l'arrivée à expiration de la réponse. La valeur zéro indique que la réponse n'arrive jamais à expiration.
- replyPriority
- Priorité du message de réponse.
Autres propriétés
Vous pouvez également inclure des propriétés
définies par l'utilisateur dans l'URL. Ces propriétés doivent être nommées avec le
préfixe user. "user".
Par
exemple :
sib:/destination?destinationName=myBus:myDestination & reliability=assured & user.customData=XYZ
Une fois la demande envoyée, l'URL est elle-même disponible dans les propriétés du message. Elle est intitulée inbound.url.