Program budujący podwyrażenia służy do budowania złożonych warunków reguł na podstawie podwyrażeń przy użyciu operatorów I, LUB oraz Nie, a także grupowania za pomocą nawiasów. Program budujący reguły sprawdza poprawność reguły po wprowadzeniu zmiany i informuje o występowaniu brakujących nawiasów i nieobsługiwanych operatorów logicznych.
Aby wyświetlić tę stronę Konsoli administracyjnej, należy kliknąć opcję
.W celu zmodyfikowania reguł za pomocą programu budującego podwyrażenia niezbędne są uprawnienia administratora.
W zależności od wybranego protokołu wyświetlane są różne operandy. W poniższej tabeli uwzględniono nazwy operandów wyświetlane w konsoli, rzeczywisty operand w postaci, w jakiej zostanie wyświetlony w wyrażeniu, poprawne protokoły dla poszczególnych operandów oraz opis każdego operandu.
Wyświetlany operand | Operand | Poprawne protokoły | Opis |
---|---|---|---|
Nazwa aplikacji | application | IIOP | Nazwa aplikacji, w której zawarto komponent EJB. |
Host klienta | clienthost | HTTP, SOAP i IIOP | Pełna nazwa hosta klienta. Jest to wartość nazwy hosta komend protokołu IP (Internet Protocol). Ten operand nie obsługuje operatorów liczbowych, takich jak >, >=, <, <=. |
Port klienta | clientport | IIOP | Nazwa portu klienta. |
Adres IPv4 klienta | clientipv4 | HTTP i SOAP | Adres IPv4 klienta w postaci czterech grup cyfr oddzielonych kropkami: n.n.n.n |
Adres IPv6 klienta | clientipv6 | HTTP i SOAP | Adres komputera klienckiego w postaci 128-bitowego adresu protokołu Internet Protocol w wersji 6 w formacie x:x:x:x:x:x:x:x. |
Nazwa nagłówka informacji cookie | cookie$<nazwa> | HTTP i SOAP | Nazwa informacji cookie. Na przykład wyrażenie
cookie$Nazwa_mojej_informacji_cookie='Wartość_mojej_informacji_cookie'
testuje żądanie, aby sprawdzić, czy zawiera ono informację cookie o nazwie
Nazwa_mojej_informacji_cookie z wartością
Wartość_mojej_informacji_cookie. W celu przeprowadzenia testu
wykrywającego obecność określonej informacji cookie należy użyć jednego z
następujących wyrażeń:
|
Nazwa modułu EJB | ejbmodule | IIOP | Nazwa modułu komponentu EJB. |
Nazwa komponentu EJB | ejbname | IIOP | Nazwa komponentu EJB. |
Nazwa metody EJB | ejbmethod | IIOP | Nazwa metody komponentu EJB. |
Identyfikatory grupy | gids$<nazwa> | HTTP i SOAP | Identyfikator grupy nadawcy żądania. |
Metoda HTTP | HTTPMethod | HTTP i SOAP | Metoda HTTP żądania. Możliwe wartości to: POST, GET, PUT i DELETE. |
Typ MIME | MIMEType | HTTP i SOAP | Typ MIME żądania. |
Port | port | HTTP, SOAP i IIOP | Port nasłuchiwania, na którym na hoście jest udostępniana usługa. |
Protokół | protocol | HTTP i SOAP | Protokół komunikacyjny przesyłający żądanie. Obecnie obsługiwane protokoły to HTTP, HTTPS, SOAP i SOAPS. |
Nazwa nagłówka żądania | header$<nazwa> | HTTP i SOAP | Nazwa i wartość nagłówka. Na przykład wyrażenie header$Host='localhost' testuje żądanie, aby sprawdzić, czy zawiera nagłówek HTTP hosta o wartości localhost. W celu przeprowadzenia testu wykrywającego obecność nagłówka hosta należy użyć jednego z następujących wyrażeń: header$Host ma wartość inną niż NULL, header$Host ma wartość NULL |
Nazwa parametru zapytania żądania | queryparm$<nazwa> | HTTP i SOAP | Nazwa parametru zapytania
określona w adresie URL żądania. W przypadku każdego żądania występuje
odwzorowanie pary nazwa/wartość parametrów zapytania (jeśli istnieją). Router
na żądanie używa nazwy parametru zapytania dotyczącego żądania jako klucza do
wyszukiwania odwzorowania parametru. Jeśli ono istnieje, router wyodrębnia
wartość na potrzeby wartościowania wyrażenia reguły. W przypadku dopasowania
reguły zostanie wykonane określone działanie. W przeciwnym razie jest używane
domyślne działanie dla klasy pracy, w której zdefiniowano wyrażenie. Na przykład wyrażenie queryparm$timezone=EST testuje
żądanie, aby sprawdzić, czy zawiera parametr zapytania HTTP o nazwie timezone i wartości EST. W celu przeprowadzenia testu wykrywającego obecność parametru zapytania należy użyć jednej z następujących komend:
|
Role | roles$<nazwa> | HTTP i SOAP | Rola nadawcy żądania. |
Host serwera | serverhost | HTTP, SOAP i IIOP | Pełna nazwa hosta serwera. Ten operand nie obsługuje operatorów liczbowych, takich jak >, >=, <, <=. |
Adres IPv4 serwera | serveripv4 | HTTP i SOAP | Adres IP serwera używającego protokołu IPv4 w postaci czterech grup cyfr oddzielonych kropkami: n.n.n.n. |
Adres IPv6 serwera | serveripv6 | HTTP i SOAP | Adres serwera w postaci 128-bitowego adresu protokołu IPv6 w formacie x:x:x:x:x:x:x:x zgodnego z dokumentem RFC 1924. |
Czas | time | HTTP, SOAP i IIOP | Operand time ma następujący format:
dzień_tygodnia/dzień_miesiąca/miesiąc/rok::godzina:minuta:sekunda
Uwaga: w przypadku operandu time nie są obsługiwane pominięcia i znaki wieloznaczne.
Ukośnik (/) służy do oddzielania parametrów daty. Podwójny dwukropek (::) oddziela parametry daty od parametrów godziny, natomiast dwukropek (:) jest używany do oddzielania parametrów godziny. Należy zauważyć, że wykonywane działanie routingu jest określane przez wynik boolowski całej reguły, w której użyto operandu time. |
ID użytkownika | uid$<nazwa> | HTTP i SOAP | Identyfikator użytkownika nadawcy żądania. |
Portal wirtualny | virtualportal | HTTP i SOAP | Portal wirtualny to adres URL żądania bez kontekstowego katalogu głównego modułu WWW aplikacji produktu WebSphere® Portal. Jeśli dane żądanie jest zgodne ze zdefiniowanym portalem wirtualnym, zostanie wykonane działanie routingu określone dla danej reguły. |
Wyrażenie XPath | xpathexpr | SOAP | Wyrażenie XPath będące łańcuchem zawiera wymagane pole używane do przechowywania wyrażenia XPath, a także opcjonalne pole na potrzeby definiowania lokalnych przestrzeni nazw. Jeśli wszystkie przestrzenie nazw zawarte w wyrażeniu XPath są standardowe, drugie pole może być opcjonalne. Jeśli istnieje wiele lokalnych przestrzeni nazw, należy je rozdzielić przecinkiem (,). Oto przykład operandu xpathexpr z jedną definicją lokalnej przestrzeni nazw: xpathexpr$/soap:Envelope/soap:Body/m:getTimeZone/n:clientId$m\\=http://test.classify.ws.ibm.com,n\\=http://test2.classify.ws.ibm.com = \\'1000\\' LUB operation ma wartość inną niż NULL |
W zależności od wybranego operatora należy wpisać wartość dla podwyrażenia, które ma zostać utworzone.
Generuje podwyrażenie jako wynik określonego operandu, operatora i wartości.
To podwyrażenie należy skopiować i wkleić do reguły.