Le générateur de sous-expression permet de générer des conditions de règles complexes issues de sous-expressions en utilisant AND, OR, NOT et le regroupement mis entre parenthèses. Le générateur de règles valide la règle lorsque des modifications sont appliquées, il vous informe également de la non-concordance des parenthèses mais aussi des opérateurs logiques non pris en charge.
Pour afficher cette page de console d'administration, cliquez sur Serveurs > Routeurs On Demand > nom_odr> Propriétés des routeurs On Demand HTTP > Règles HTTP de la stratégie de routage > Ajouter > Générateur de sous-expression.
Pour modifier des règles à l'aide du générateur de règles, vous devez disposer des privilèges d'administration Administrateur.
Selon le protocole que vous sélectionnez, plusieurs opérandes vous sont proposés. Le tableau ci-dessous présente les noms des opérandes tels qu'ils s'affichent dans la console, l'opérande réel tel qu'il apparaît dans l'expression, les protocoles valides pour chaque opérande et la description de chaque opérande.
Variable de demande | Protocoles valides | Description | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
application |
IIOP | Nom de l'application d'entreprise contenant l'EJB. | ||||||||||||||||||
clienthost | HTTP SOAP IIOP SIP |
Nom d'hôte complet du client. Il s'agit de la valeur du nom d'hôte de la commande IP. Cet opérande ne prend pas en charge les opérateurs numériques tels que >, >=, <, <=. | ||||||||||||||||||
clientport |
IIOP | Nom du port client. | ||||||||||||||||||
clientipv4 | HTTP SOAP SIP |
Adresse IP de l'ordinateur client utilisant le type d'adresse à quartet descripteur Internet Protocol version 4 (IPv4) n.n.n.n. | ||||||||||||||||||
clientipv6 | HTTP SOAP SIP |
Type d'adresse Internet Protocol version 6 (IPv6) 128 bits x:x:x:x:x:x:x:x suivant la RFC 1924 de l'ordinateur client. | ||||||||||||||||||
En-tête de contact | SIP |
Zone de l'en-tête de contact |
||||||||||||||||||
Identificateur URI de contact | SIP |
Zone de l'URI de l'en-tête de contact |
||||||||||||||||||
cookie$<nom> | HTTP SOAP |
Nom d'un cookie. Par exemple, l'expression cookie$My_Cookie_Name='My_Cookie_Value' teste
une demande pour savoir si elle contient un cookie nommé My_Cookie_Name associé à une valeur My_Cookie_Value. Pour vérifier la présence ou l'absence d'un cookie particulier, utilisez l'une des expressions suivantes : cookie$MyCookieName IS NOT NULL cookie$MyCookieName IS NULL |
||||||||||||||||||
ejbmodule |
IIOP | Nom de module d'un EJB. | ||||||||||||||||||
ejbname |
IIOP | Nom d'un EJB. | ||||||||||||||||||
ejbmethod |
IIOP | Nom d'une méthode contenue dans l'EJB. | ||||||||||||||||||
En-tête d'origine | SIP |
Zone de l'en-tête d'origine. |
||||||||||||||||||
Nom affiché d'en-tête d'origine | SIP |
Zone du nom affiché de l'en-tête d'origine. |
||||||||||||||||||
URI d'origine | SIP |
Zone de l'URI de l'en-tête d'origine. |
||||||||||||||||||
Hôte URI d'origine | SIP |
Zone de l'hôte de l'en-tête d'origine. |
||||||||||||||||||
Port URI d'origine | SIP |
Zone du port de l'URI de l'en-tête d'origine. |
||||||||||||||||||
Utilisateur URI d'origine | SIP |
Zone de l'utilisateur de l'en-tête d'origine. |
||||||||||||||||||
header$<nom> | HTTP SOAP SIP |
Nom et valeur de l'en-tête. Par exemple, l'expression header$Host='localhost' teste une demande pour voir si elle contient un en-tête d'hôte HTTP associé à la valeur localhost.
Pour vérifier la présence ou l'absence de l'en-tête d'hôte, utilisez l'une des expressions suivantes : header$Host IS NOT NULL header$Host IS NULL |
||||||||||||||||||
HTTPMethod | HTTP SOAP |
Méthode HTTP de la demande. Les valeurs possibles sont POST, GET, PUT et DELETE. | ||||||||||||||||||
TypeMIME | HTTP SOAP |
Type MIME de la demande. | ||||||||||||||||||
operation | SOAP | Nom d'une opération de service Web. | ||||||||||||||||||
percentage$<val> | HTTP SOAP IIOP SIP |
L'opérande de pourcentage a true comme résultat d'un pourcentage fixe de la durée. Par exemple : percentage$50 a pour résultat true dans 50 % de la durée en moyenne. | ||||||||||||||||||
port | HTTP SOAP IIOP SIP |
Port d'écoute sur lequel la demande a été reçue. | ||||||||||||||||||
protocol | HTTP SOAP |
Protocoles de communication qui transmettent la demande. Les protocoles actuellement pris en charge sont HTTP, HTTPS, SOAP et SOAPS. | ||||||||||||||||||
queryparm$<nom> | HTTP SOAP |
Nom et valeur de l'en-tête. Par exemple, l'expression queryparm$timezone='EST' teste une demande permettant de vérifier si elle contient un paramètre de requête HTTP nommé timezone associé à une valeur EST. Pour vérifier la présence ou l'absence d'un paramètre de demande particulier, utilisez l'une des expressions suivantes : queryparm$timezone IS NOT NULL queryparm$timezone IS NULL |
||||||||||||||||||
rampup$<heure_de_début>$<heure_de_fin> | HTTP SOAP IIOP SIP |
L'opérande rampup attribue la valeur true à un pourcentage variable de la durée. Il a toujours la valeur false avant l'<heure_de_début> et la valeur
true après l'<heure_de_fin>.
Au fur et à mesure que l'heure progresse de l'<heure_de_début> vers l'<heure_de_fin>,
il prend la valeur true, un pourcentage augmentant de façon linéaire. Le format de l'<heure_de_début> et de l'<heure_de_fin> est jour/mois/année::heure:min:sec. où jour représente le jour du mois, mois représente l'un des douze mois : Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec, année représente les 4 chiffres de l'année, heure les 2 chiffres de l'heure exprimée de 0 à 24 et min et sec représentent respectivement les minutes et les secondes exprimées par 2 chiffres.Exemple : rampup$01/Jan/2007::08:00:00$01/Jan/2007::17:00:00 prend occasionnellement la valeur true à 8 h le 1er janvier 2007 et a toujours la valeur true à l'heure à laquelle se termine l'augmentation progressive, à 17 h le même jour. |
||||||||||||||||||
Transport de la demande | SIP |
Le transport de la demande. |
||||||||||||||||||
URI de la demande | SIP |
L'URI de la demande. |
||||||||||||||||||
Hôte URI de la demande | SIP |
Hôte de l'URI de la demande |
||||||||||||||||||
Port URI de la demande | SIP |
Port de l'URI de la demande. |
||||||||||||||||||
Utilisateur URI de la demande | SIP |
L'utilisateur de l'URI de la demande. |
||||||||||||||||||
Schéma d'en-tête d'origine | SIP |
Zone du schéma de l'en-tête d'origine. |
||||||||||||||||||
Schéma d'en-tête de destination | SIP |
Zone du schéma de l'en-tête de destination |
||||||||||||||||||
Schéma de l'URI | SIP |
Schéma de l'URI. |
||||||||||||||||||
serverhost | HTTP SOAP IIOP SIP |
Nom d'hôte complet du serveur. Cet opérande ne prend pas en charge les opérateurs numériques tels que >, >=, <, <=. | ||||||||||||||||||
serveripv4 | HTTP SOAP SIP |
Adresse IP du serveur utilisant le type d'adresse à quartet descripteur IPv4 n.n.n.n. | ||||||||||||||||||
serveripv6 | HTTP SOAP SIP |
Type d'adresse IPv6 128 bits x:x:x:x:x:x:x:x suivant la RFC 1924 du serveur. | ||||||||||||||||||
service | SOAP |
Nom d'un service Web. | ||||||||||||||||||
Méthode SIP | SIP |
Méthode de la requête. Valeurs admises : INVITE, TRYING, RINGING, ACK, OK et BYE. Si le message n'est pas une demande, cet opérande renvoie la valeur null. |
||||||||||||||||||
Code de réponse | SIP |
Code de la réponse. Si le message n'est pas une réponse, cet opérande renvoie la valeur -1. |
||||||||||||||||||
time | HTTP SOAP IIOP |
Cet opérande permet de définir la date et l'heure du jour où une demande donnée doit être traitée. heure_de_début et heure_de_fin sont deux zones facultatives. Si une demande est reçue en dehors de la fenêtre définie, la demande ne sera pas traitée. Le format des zones Heure de début et Heure de fin est le suivant : jour_de_la_semaine/jour_du_mois/mois/année::heure:minute:seconde. Par exemple, "mardi 11 avril 2007 à 13:03:45" est indiqué sous la forme suivante : Mar/11/Avr/2007::13:03:45 Vous pouvez utiliser le caractère générique * dans n'importe quelle zone. Par exemple, le 1er de chaque mois est indiqué sous la forme */1. Les valeurs du jour_de_la_semaine sont Sun, Mon, Tue, Wed, Thu, Fri, Sat et les valeurs du jour_du_mois vont de 1 à 31. La valeur mois est une valeur non numérique représentant les douze mois : Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec. La valeur année est constituée des quatre chiffres de l'année. par exemple : 2007. La valeur de l'heure est l'heure du jour au format 24 heures. Par exemple, 8 h est représenté par ::8. Les minutes et les secondes sont exprimées par des nombres compris entre 0 et 59. La barre oblique (/) est utilisée pour séparer les paramètres de la date, les deux points répétés (::) sont utilisés pour distinguer les valeurs de la date et de l'heure et les deux points (:) sont utilisés pour séparer les paramètres de l'heure du jour. Notez que le résultat booléen de la règle entière dans laquelle l'opérande time est utilisé détermine l'action de routage à entreprendre. |
||||||||||||||||||
Hôte client de destination | SIP |
Zone de l'hôte client de l'en-tête de destination. |
||||||||||||||||||
En-tête de destination | SIP |
Zone de l'en-tête de destination. |
||||||||||||||||||
Nom affiché d'en-tête de destination | SIP |
Zone du nom affiché de l'en-tête de destination. |
||||||||||||||||||
URI de destination | SIP |
Zone de l'URI de l'en-tête de destination |
||||||||||||||||||
Hôte URI de destination | SIP |
Zone du port de l'URI de l'en-tête de destination |
||||||||||||||||||
Utilisateur URI de destination | SIP |
Zone de l'utilisateur de l'en-tête de destination |
||||||||||||||||||
hôte virtuel | HTTP SOAP |
Les ports virtuels sont créés dans WebSphere® Portal Server et WebSphere Extended Deployment prend en charge cet opérande pour une meilleure intégration à WebSphere Portal Server. Le port virtuel correspond à l'URL de la demande moins la racine de contexte du module Web de l'application WebSphere Portal. Si une demande particulière correspond au portail virtuel défini, l'action de routage définie pour cette règle est adoptée. | ||||||||||||||||||
xpathexpr | SOAP |
L'expression de la chaîne XPath comporte une zone obligatoire destinée à contenir l'expression XPath et une zone facultative pour la définition d'un ou de plusieurs espaces de noms locaux. Si tous les espaces de noms contenus dans l'expression XPath sont standard, la seconde zone peut être facultative. dans le cas de plusieurs espaces de noms, ceux-ci sont séparés par une virgule (,). Voici un exemple d'expression xpathexpr avec une définition d'espace de noms local :xpathexpr$/soap:Envelope/soap:Body/m:getTimeZone/n:clientId$m\\=http://test.classify.ws.ibm.com,n\\=http://test2.classify.ws.ibm.com = \\'1000\\' or operation IS NOT NULL Dans ce qui précède, l'expression XPath est /soap:Envelope/soap:Body/n:getTimeZone/n:clientId. Elle contient l'espace de nom local de n. Par conséquent, la deuxième zone de l'expression est définie sous la forme n \\=http://test.classify.ws.ibm.com. Le signe dollar ($) permet de marquer le début d'une définition de zone. Les doubles barres obliques inverses constituent la séquence d'échappement dans cet exemple. Une séquence d'échappement est entrée pour le premier signe égal (=) car il fait partie de la définition de l'espace de nom local, alors que le deuxième signe égal (=) est l'opérateur dans l'expression de classification, qui ne doit pas être associé à une séquence d'échappement. L'exemple suivant représente une expression xpathexpr contenant deux espaces de noms locaux : xpathexpr$/soap:Envelope/soap:Body/m:getTimeZone/n:clientId$m\\=http://test.classify.ws.ibm.com,n\\=http://test2.classify.ws.ibm.com = \\'1000\\' or operation IS NOT NULL Voici une liste des espaces de noms standard pour xpathexpr :
|
Selon l'opérateur que vous aurez choisi, saisissez une valeur pour la sous-expression que vous choisissez de créer.
Générez la sous-expression issue de l'opérande, de l'opérateur et des valeurs que vous avez spécifiés.
Cliquez pour ajouter à la case située dans le panneau des règles.
Centre de documentation de WebSphere Virtual Enterprise (en ligne)