Info Engine Users Guide

8/13/2019 Info Engine Users Guide

http://slidepdf.com/reader/full/info-engine-users-guide 1/500

I n f o * E n g i n e ® U s e r ’ s G u W i n d c h i l l ® 1 0 . 1 M 0 3 0

J a n u a r y 2 0 1



C o p y r i g h t © 2 0 1 2 P a r a m e t r i c T e c h n o l o g y C o r p o r a t i o n a n d / o r IA l l R i g h t s R e s e r v e d .

U s e r a n d t r a i n i n g g u i d e s a n d r e l a t e d d o c u m e n t a t i o n f r o m P a r a m e t r i c

s u b s i d i a r y c o m p a n i e s ( c o l l e c t i v e l y " P T C " ) a r e s u b j e c t t o t h e c o p y r i gc o u n t r i e s a n d a r e p r o v i d e d u n d e r a l i c e n s e a g r e e m e n t t h a t r e s t r i c t s c od o c u m e n t a t i o n . P T C h e r e b y g r a n t s t o t h e l i c e n s e d s o f t w a r e u s e r t h e rt h i s d o c u m e n t a t i o n i f p r o v i d e d o n s o f t w a r e m e d i a , b u t o n l y f o r i n t e r nt h e l i c e n s e a g r e e m e n t u n d e r w h i c h t h e a p p l i c a b l e s o f t w a r e i s l i c e n s e dc o p y r i g h t n o t i c e a n d a n y o t h e r p r o p r i e t a r y n o t i c e p r o v i d e d b y P T C . Tw i t h o u t t h e e x p r e s s w r i t t e n c o n s e n t o f P T C . T h i s d o c u m e n t a t i o n m a yo r r e d u c e d t o a n y f o r m , i n c l u d i n g e l e c t r o n i c m e d i a , o r t r a n s m i t t e d o r w i t h o u t t h e p r i o r w r i t t e n c o n s e n t o f P T C a n d n o a u t h o r i z a t i o n i s g r a n t

I n f o r m a t i o n d e s c r i b e d h e r e i n i s f u r n i s h e d f o r g e n e r a l i n f o r m a t i o n o n a n d s h o u l d n o t b e c o n s t r u e d a s a w a r r a n t y o r c o m m i t m e n t b y P T C . P Tf o r a n y e r r o r s o r i n a c c u r a c i e s t h a t m a y a p p e a r i n t h i s d o c u m e n t .

T h e s o f t w a r e d e s c r i b e d i n t h i s d o c u m e n t i s p r o v i d e d u n d e r w r i t t e n l i c

s e c r e t s a n d p r o p r i e t a r y i n f o r m a t i o n , a n d i s p r o t e c t e d b y t h e c o p y r i g h c o u n t r i e s . I t m a y n o t b e c o p i e d o r d i s t r i b u t e d i n a n y f o r m o r m e d i u m , m a n n e r n o t p r o v i d e d f o r i n t h e s o f t w a r e l i c e n s e s a g r e e m e n t e x c e p t w

U N A U T H O R I Z E D U S E O F S O F T W A R E O R I T S D O C U M E N T A TD A M A G E S A N D C R I M I N A L P R O S E C U T I O N . P T C r e g a r d s s o f t w o f f e n d e r s a c c o r d i n g l y . W e d o n o t t o l e r a t e t h e p i r a c y o f P T C s o f t w a r ea n d c r i m i n a l l y ) t h o s e w h o d o s o u s i n g a l l l e g a l m e a n s a v a i l a b l e , i n c l ur e s o u r c e s . A s p a r t o f t h e s e e f f o r t s , P T C u s e s d a t a m o n i t o r i n g a n d s c o ud a t a o n u s e r s o f i l l e g a l c o p i e s o f o u r s o f t w a r e . T h i s d a t a c o l l e c t i o n i s l i c e n s e d s o f t w a r e f r o m P T C a n d i t s a u t h o r i z e d d i s t r i b u t o r s . I f y o u a r ea n d d o n o t c o n s e n t t o t h e c o l l e c t i o n a n d t r a n s m i s s i o n o f s u c h d a t a ( i n ct h e i l l e g a l v e r s i o n , a n d c o n t a c t P T C t o o b t a i n a l e g a l l y l i c e n s e d c o p y .

I m p o r t a n t C o p y r i g h t , T r a d e m a r k , P a t e n t , a n d L i c e n s i n g I n f o r m a t i o n

o f y o u r P T C s o f t w a r e . U N I T E D S T A T E S G O V E R N M E N T R E S T R I C T E D R I G H T S L E G

T h i s d o c u m e n t a n d t h e s o f t w a r e d e s c r i b e d h e r e i n a r e C o m m e r c i a l C o p u r s u a n t t o F A R 1 2 . 2 1 2 ( a ) - ( b ) ( O C T ’ 9 5 ) o r D F A R S 2 2 7 . 7 2 0 2 - 1 ( a ) a p r o v i d e d t o t h e U S G o v e r n m e n t u n d e r a l i m i t e d c o m m e r c i a l l i c e n s e oa b o v e c l a u s e s , u s e , d u p l i c a t i o n , o r d i s c l o s u r e b y t h e G o v e r n m e n t i s s i n s u b p a r a g r a p h ( c ) ( 1 ) ( i i ) o f t h e R i g h t s i n T e c h n i c a l D a t a a n d C o m p u2 5 2 . 2 2 7 - 7 0 1 3 ( O C T ’ 8 8 ) o r C o m m e r c i a l C o m p u t e r S o f t w a r e - R e s t r i c( J U N ’ 8 7 ) , a s a p p l i c a b l e . 0 1 0 1 2 0 1 2

P a r a m e t r i c T e c h n o l o g y C o r p o r a t i o n , 1 4 0 K e n d r i c k S t r e e t , N e e d



C o n t e n t

A b o u t T h i s G u i d e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

I n f o * E n g i n e A r c h i t e c t u r e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I d e n t i f y i n g t h e I n f o * E n g i n e C o m p o n e n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . .I d e n t i f y i n g B a s i c C o n g u r a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I n t e r a c t i n g w i t h I n f o * E n g i n e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . M a n a g i n g t h e E x e c u t i o n o f I n f o * E n g i n e T a s k s . . . . . . . . . S t a r t i n g a n d L o c a t i n g I n f o * E n g i n e C o m p o n e n t s . . . . . . . . . . . . . . . . . S e t t i n g U p C o n n e c t i o n s T h r o u g h A d a p t e r s . . . . . . . . . . . . . . . . . . . . . . . . .

I n f o * E n g i n e D a t a M a n a g e m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A b o u t I n f o * E n g i n e D a t a M a n a g e m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .M a n a g i n g a n d M a n i p u l a t i n g G r o u p s w i t h I n f o * E n g i n e . . . . . .C o n t e x t G r o u p s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D y n a m i c P a r a m e t e r V a l u e S u b s t i t u t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . U p l o a d i n g a n d D o w n l o a d i n g B L O B s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E x a m p l e F e d e r a t e d S e a r c h f o r P a r t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

I n f o * E n g i n e J S P P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A u t h o r i n g I n f o * E n g i n e J a v a S e r v e r P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . .I n f o * E n g i n e C u s t o m T a g s a n d J S P P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . A d a p t e r W e b j e c t s a n d J S P P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . T a s k W e b j e c t s a n d J S P P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .D i s p l a y W e b j e c t s a n d J S P P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . M u l t i p l e W e b j e c t E x e c u t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .S u c c e s s a n d F a i l u r e P r o c e s s i n g f o r W e b j e c t s . . . . . . . . . . . . . . . . . . . . .C a t c h i n g E x c e p t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

I n f o * E n g i n e T a s k s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A b o u t I n f o * E n g i n e T a s k s a n d T a s k R u l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A u t h o r i n g I n f o * E n g i n e T a s k s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . U s i n g t h e I n f o * E n g i n e T a s k E d i t o r . . . . . . . . . . . . . . . . . . . . . . . . . . U n d e r s t a n d i n g X M L O u t p u t f o r I n f o * E n g i n e G r o u p s . . . . . . . . . . . . N e s t i n g T a s k s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

P a c k a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

A b o u t P a c k a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P r o v i d i n g L D A P D i r e c t o r y I n f o r m a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . U s i n g t h e P a c k a g e M a n a g e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

C r e d e n t i a l s M a p p i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A u t h e n t i c a t i o n t h r o u g h C r e d e n t i a l s M a p p i n g . . . . . . . . . . . C r e d e n t i a l s M a p p i n g f o r A d a p t e r s . . . . . . . . . . . . . . . . . . . . . . . . . . .C r e d e n t i a l s M a p p i n g f o r M O M s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

C u s t o m T a g L i b r a r i e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A b o u t t h e C u s t o m T a g L i b r a r y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3



T a s k - B a s e d T a g L i b r a r y I m p l e m e n t a t i o n . . . . . . . . . . . . . . . . . . . . . . . .J a v a - B a s e d T a g L i b r a r y I m p l e m e n t a t i o n . . . . . . . . . . . . . . . . . . . . . . . .E x p r e s s i o n L a n g u a g e S u p p o r t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

C u s t o m W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . R e q u i r e d A t t r i b u t e s f o r C u s t o m W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . .C r e a t i n g a n E x t e r n a l C u s t o m W e b j e c t . . . . . . . . . . . . . . . . . . . . . . . . . . . .

W e b S e r v i c e s F r a m e w o r k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A b o u t W e b S e r v i c e I m p l e m e n t a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .U s i n g I n f o * E n g i n e W e b S e r v i c e s T o o l i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . U n d e r s t a n d i n g t h e S e c u r i t y R e q u i r e m e n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . W r i t i n g a n I n f o * E n g i n e - b a s e d W e b S e r v i c e . . . . . . . . . . . . . . . . . . . . . . . . . . . .W r i t i n g a J a v a - b a s e d W e b S e r v i c e C l i e n t . . . . . . . . . . . . . . . . . . . . . . . W r i t i n g a J a v a - b a s e d W e b S e r v i c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .U s i n g t h e W e b S e r v i c e D e p l o y m e n t B u i l d S c r i p t . . . . . . . . . . . . .

U s i n g S O A P A t t a c h m e n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C o n s u m i n g E x t e r n a l S e r v i c e s f r o m W i n d c h i l l . . . . . . . . . . . . . . . . . . . . . . . . . . . . W e b S e r v i c e E x a m p l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . U s e r n a m e A u t h e n t i c a t i o n w i t h S y m m e t r i c K e y s E x a m p l e . . . . . . . . . . .

S O A P S e r v i c e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L e g a c y S e r v i c e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .I n f o * E n g i n e T a s k I n v o c a t i o n w i t h S O A P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I n f o * E n g i n e J a v a E E C o n n e c t o r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .E x a m p l e S t a n d a l o n e J a v a S O A P C l i e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

S e r v e r A c c e s s K i t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A b o u t t h e S e r v e r A c c e s s K i t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

E x a m p l e S A K A p p l i c a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .I n f o * E n g i n e C u s t o m T a g R e f e r e n c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

S c r i p t l e t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E x p r e s s i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .D e c l a r a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D i r e c t i v e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I n f o * E n g i n e T a g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

D i s p l a y W e b j e c t R e f e r e n c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D i s p l a y W e b j e c t s f o r H T M L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .I m a g e W e b j e c t s f o r J P E G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

T a s k W e b j e c t R e f e r e n c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A d m i n i s t r a t i v e W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .G r o u p W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . M a n a g e m e n t W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .M e s s a g e W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . W e b E v e n t S e r v i c e W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4 I n f o * E n g i n e ® U s e r ’ s G u i d e



A b o u t T h i s G

T h e I n f o * E n g i n e U s e r ' s G u i d e d o c u m e n t s t h e u s e o f I n f o * E n g i nt o o l s . T h e i n f o r m a t i o n p r o v i d e d h e r e i s a l s o a v a i W i n d c h i l l H e l p C e n t e r u n d e r A d v a n c e d C u s t o m i z a t i o n ▶ ▶ ▶ I n f o * E n g i n e U s e r ’ s G .

T h i s g u i d e a s s u m e s y o u h a v e t h e f o l l o w i n g k n o w

• K n o w l e d g e o f t h e e x i s t i n g s y s t e m d a t a s t r u c t u• K n o w l e d g e o f t h e w e b a r c h i t e c t u r e u s e d a t y o

• K n o w l e d g e o f J a v a S e r v e r P a g e ( J S P ) c a p a b i l i• K n o w l e d g e o f H T M L , X M L , a n d J a v a • U N I X s y s t e m a d m i n i s t r a t i o n s k i l l s ( i f y o u a r e • W i n d o w s s y s t e m a d m i n i s t r a t i o n s k i l l s ( i f y o u

T h e I n f o * E n g i n e U s e r ' s G u i d e i n c l u d e s t h e f o l l o w i n g c h a p t e r s s o t h a t s u c c e s s i v e c h a p t e r s b u i l d o n e a r l i e r c h a p t

I n f o * E n g i n e A r c h i t e c t u r e I n t r o d u c e s t h e I n f o * E n g i n e a r c h i t e c t u r e , d e s c I n f o * E n g i n e s o f t w a r e w o r k i n c o n c e r t t o p r o v i

I n f o * E n g i n e D a t a M a n a g e m e n t D e s c r i b e s h o w I n f o * E n g i n e m a n a g e s d a t a , a n de s s e n t i a l t o I n f o * E n g i n e r e q u e s t s : J a v a S e r v e r g r o u p s , a n d t h e v i r t u a l d a t a b a s e ( V D B ) .

I n f o * E n g i n e J S P P a g e s P r o v i d e s i n s t r u c t i o n s f o r a u t h o r i n g J S P p a g e s w e l l a s a m o r e d e t a i l e d d e s c r i p t i o n o f h o w J S P a n d c u s t o m t a g s .

5



I n f o * E n g i n e T a s k s D e s c r i b e s I n f o * E n g i n e t a s k s , w h i c h c a n b e u s e d t om a n i p u l a t i o n o f i n f o r m a t i o n i n I n f o * E n g i n e . T h i si n s t r u c t i o n s f o r a u t h o r i n g t a s k s a n d u s i n g t h e I n f o *

P a c k a g e s I n t r o d u c e s t h e c o n c e p t o f p a c k a g e s a n d p r o v i d i n g p a c k a g e s , i n c l u d i n g i n s t r u c t i o n s f o r u s i n g t h e p a c k

C r e d e n t i a l s M a p p i n g D e s c r i b e s t h e c r e d e n t i a l s m a p p i n g f u n c t i o n a l i t y , wa u t h e n t i c a t e a n d m a n a g e W i n d c h i l l u s e r s .

C u s t o m T a g L i b r a r i e s D i s c u s s e s t h e p o t e n t i a l b e n e t s o f c r e a t i n g a c u s t o ml i b r a r y i m p l e m e n t e d u s i n g t a s k s a n d t h a t p r o v i d e s

t a g s . T h i s c h a p t e r i n c l u d e s i n s t r u c t i o n a l i n f o r m a t it a g l i b r a r i e s a n d u s i n g e x p r e s s i o n l a n g u a g e ( E L ) .

C u s t o m W e b j e c t s P r o v i d e s r e f e r e n c e i n f o r m a t i o n f o r c u s t o m w e b j e cw r i t e c u s t o m J a v a c o d e f o r u s e w i t h t h e I n f o * E n g i

W e b S e r v i c e s F r a m e w o r k D e s c r i b e s t h e v a r i o u s w a y s t h a t w e b s e r v i c e s t o o l iI n f o * E n g i n e , a n d p r o v i d e s a n i n s t r u c t i o n a l e x a m ps e r v i c e s c l i e n t t h a t e m p l o y s t h e u s e r n a m e a u t h e n t im e c h a n i s m .

S O A P S e r v i c e s D i s c u s s e s l e g a c y S O A P s e r v i c e s a n d w r i t i n g t a s k sS O A P r e q u e s t s w o r k w i t h i n a n I n f o * E n g i n e J a v a E

S e r v e r A c c e s s K i t P r o v i d e s i n f o r m a t i o n f o r u s i n g t h e I n f o * E n g i n e S t o a l l o w J a v a a p p l i c a t i o n s t o e x e c u t e I n f o * E n g i n e t h e m , a n d i n s p e c t t h e i r r e s u l t s .

I n f o * E n g i n e C u s t o m T a g R e f e r e n c e P r o v i d e s r e f e r e n c e i n f o r m a t i o n f o r t h e t a g s i n t h e Ia n d s u p p l i e d t a g l i b r a r i e s . T h i s c h a p t e r a l s o p r o v i dJ S P e l e m e n t t y p e s , i n c l u d i n g t i p s f o r u s i n g e l e m e n

a n d t a s k s . D i s p l a y W e b j e c t R e f e r e n c e

P r o v i d e s r e f e r e n c e i n f o r m a t i o n f o r a l l d i s p l a y a n d w i t h I n f o * E n g i n e .

T a s k W e b j e c t R e f e r e n c e P r o v i d e s r e f e r e n c e i n f o r m a t i o n f o r a l l a d m i n i s t r a tm e s s a g i n g , a n d W e b E v e n t S e r v i c e w e b j e c t s a s s o c




R e l a t e d D o c u m e n t a t i o n T h e f o l l o w i n g d o c u m e n t a t i o n m a y b e h e l p f u l :

• I n f o * E n g i n e c o n g u r a t i o n a n d i m p l e m e n t a t i o I n f o * E n g i n e I m p l e m e n t a t i o n G u i d e

• W i n d c h i l l A d a p t e r G u i d e • J N D I A d a p t e r G u i d e • J D B C A d a p t e r G u i d e • I f t h e P T C a d a p t e r l i b r a r y d o e s n o t c o n t a i n a n

t h e I n f o * E n g i n e J a v a A d a p t e r D e v e l o p m e n t K i t Pd e s c r i b e s h o w t o d e v e l o p y o u r o w n n a t i v e I n f oJ a v a p r o g r a m m i n g l a n g u a g e .

I f b o o k s a r e n o t i n s t a l l e d o n y o u r s y s t e m , s e e y o u

T e c h n i c a l S u p p o r t C o n t a c t P T C T e c h n i c a l S u p p o r t t h r o u g h t h e P T Cf a x i f y o u e n c o u n t e r p r o b l e m s u s i n g t h i s p r o d u c t

F o r c o m p l e t e d e t a i l s , s e e t h e P T C C u s t o m e r S e r v i c e G u i d e . Y o u c a n n d t h i s gu n d e r C o n t a c t i n g T e c h n i c a l S u p p o r t o n t h e P T C T e c h n i c a l S u p p o rh t t p : / / w w w . p t c . c o m / s u p p o r t / i n d e x . h t m

Y o u m u s t h a v e a S e r v i c e C o n t r a c t N u m b e r ( S C N s u p p o r t . I f y o u d o n o t h a v e a n S C N , c o n t a c t t h e Pu s i n g t h e i n s t r u c t i o n s f o u n d i n t h e P T C C u s t o m e r S e r v i c e G u i d e o r o n t h e P T C T e c h n i c a l S u p p o r t p a g e .

D o c u m e n t a t i o n f o r P T C P rY o u c a n a c c e s s P T C d o c u m e n t a t i o n u s i n g t h e f o

• W i n d c h i l l H e l p C e n t e r — T h e W i n d c h i l l H e l p C e n t e r i s a n b a s e t h a t i n c l u d e s a c o m p r e h e n s i v e i n d e x o f a l c a n b r o w s e t h e e n t i r e W i n d c h i l l d o c u m e n t a t i o t o p e r f o r m a k e y w o r d s e a r c h . T o a c c e s s t h e h e l○ C l i c k a n y h e l p i c o n i n W i n d c h i l l ○ S e l e c t H e l p ▶ ▶ ▶ W i n d c h i l l H e l p C e n t e r f r o m t h e Q u i c k L i n k s m e n u a t t h e t o p

r i g h t o f a n y W i n d c h i l l p a g e ○ U s e t h e f o l l o w i n g l i n k t o a c c e s s a l l P T C h e l p

h t t p s : / / w w w . p t c . c o m / a p p s e r v e r / c s / h e l p / h e l• R e f e r e n c e D o c u m e n t s W e b s i t e — T h e R e f e r e n c e D o c u m e n t s w

o f a l l P T C g u i d e s : h t t p : / / w w w . p t c . c o m / a p p s e r v e r / c s / d o c / r e f d o c

A b o u t T h i s G u i d e

http://www.ptc.com/appserver/cs/doc/refdoc.jsp

http://www.ptc.com/support/support.htm


https://www.ptc.com/appserver/cs/help/help.jsp




A S e r v i c e C o n t r a c t N u m b e r ( S C N ) i s r e q u i r e d t o a c cf r o m t h e R e f e r e n c e D o c u m e n t s w e b s i t e . F o r m o r e i nP T C T e c h n i c a l S u p p o r t p a g e : h t t p : / / w w w . p t c . c o m / s u p p o r t / i n d e x . h t m

C o m m e n t s P T C w e l c o m e s y o u r s u g g e s t i o n s a n d c o m m e n t s o n i y o u r f e e d b a c k , y o u c a n :

• S e n d a n e m a i l t o d o c u m e n t a t i o n @ p t c . c o m . I n c l u d e t h e n a m e o f t h e a p p a n d i t s r e l e a s e n u m b e r w i t h y o u r c o m m e n t s . I f y o us p e c i c h e l p t o p i c o r b o o k , i n c l u d e t h e t i t l e .

• C l i c k t h e P T C h e l p c e n t e r f e e d b a c k i c o n i n t h e u H e l p C e n t e r t o p i c a n d c o m p l e t e t h e f e e d b a c k f o r m a u t o m a t i c a l l y i n c l u d e d w i t h y o u r f e e d b a c k .





1 I n f o * E n g i n e A r c

I d e n t i f y i n g t h e I n f o * E n g i n e C o m p o n e n t s . . . . . . . . . . . . . . . . . . . . .I d e n t i f y i n g B a s i c C o n g u r a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I n t e r a c t i n g w i t h I n f o * E n g i n e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . M a n a g i n g t h e E x e c u t i o n o f I n f o * E n g i n e T a s k s . . . . . . . . . . . . .S t a r t i n g a n d L o c a t i n g I n f o * E n g i n e C o m p o n e n t s . . . . . . . . . . S e t t i n g U p C o n n e c t i o n s T h r o u g h A d a p t e r s . . . . . . . . . . . . . . . . . .

T h e f o l l o w i n g t o p i c s p r o v i d e a n o v e r v i e w o f t h e

9



I d e n t i f y i n g t h e I n f o * E n g i n e CT h e f o l l o w i n g c o m p o n e n t s m a k e u p t h e I n f o * E n g i n

I n f o * E n g i n e S e r v l e t s I n f o * E n g i n e s e r v l e t s p r o v i d e a n i n t e r f a c e b e t w e e nI n f o * E n g i n e .

I n f o * E n g i n e S e r v e r T h e I n f o * E n g i n e s e r v e r p r o v i d e s a m e c h a n i s m f o rt h e d a t a t h a t u s e r s o r c u s t o m a p p l i c a t i o n s w a n t t o v

N a m i n g S e r v i c e T h e N a m i n g S e r v i c e i s t h e s o f t w a r e t h a t s u p p o r t s t c o m p o n e n t s . I n t h e I n f o * E n g i n e N a m i n g S e r v i c e ,d i r e c t o r y s e r v e r s w h e r e e n t r i e s f o r t h e n e t w o r k a d d

c o m p o n e n t s a n d e n t r i e s f o r c o n g u r a t i o n p r o p e r t i eI n f o * E n g i n e S e r v i c e A c c e s s K i t ( S A K )

T h e I n f o * E n g i n e S e r v i c e A c c e s s K i t ( S A K ) i s a n a ( A P I ) t h a t f a c i l i t a t e s t h e d e v e l o p m e n t o f J a v a a p p l p a g e s , t h a t d i r e c t l y u t i l i z e t h e f u n c t i o n s a n d f e a t u re x a m p l e , h i g h - l e v e l I n f o * E n g i n e c o m p o n e n t s s u cI n f o * E n g i n e s e r v e r u s e t h e S A K t o i n v o k e t a s k s a n

N a t i v e A d a p t e r s T h e n a t i v e a d a p t e r s p r o v i d e a d i r e c t i n t e r f a c e b e t wi n f o r m a t i o n s y s t e m s .

N o n - N a t i v e A d a p t e r s T h e n o n - n a t i v e a d a p t e r s p r o v i d e a n i n d i r e c t i n t e r f ai n f o r m a t i o n s y s t e m s . T h e s e a d a p t e r s u s e a d i f f e r e nu s e d b y I n f o * E n g i n e a n d t h e r e f o r e c a n n o t c o n n e c t

G a t e w a y s G a t e w a y s p r o v i d e a n i n t e r f a c e b e t w e e n I n f o * E n g i

I n f o * E n g i n e S O A P S e r v l e t s T h e I n f o * E n g i n e S O A P s e r v l e t s c a t c h a n d p r o c e s st h a t a r e m a d e o v e r t h e w e b . S O A P ( S i m p l e O b j e c tl i g h t w e i g h t p r o t o c o l t h a t c a n b e u s e d b y t h i r d - p a r t p r o t o c o l , t h i r d - p a r t y a p p l i c a t i o n s c a n s e n d r e q u e s

c o d e a n d r e t u r n t h e o u t p u t t h a t i s g e n e r a t e d . T h e r e m a i n i n g s e c t i o n s d e s c r i b e t h e r e l a t i o n s h i p s a m

I d e n t i f y i n g B a s i c C o n g u r a t I n f o * E n g i n e c o m p o n e n t s c a n b e u s e d i n m a n y d i f f e rc o n g u r a t i o n s t o m e e t y o u r b u s i n e s s r e q u i r e m e n t s f o p r e s e n t i n g d a t a f r o m d i f f e r e n t i n f o r m a t i o n s y s t e m s .

1 0 I n f o * E n g i n e ® U s e r ’ s G u i d e



S e t t i n g u p y o u r I n f o * E n g i n e e n v i r o n m e n t c a n b e

• E s t a b l i s h i n g i n t e r a c t i o n s w i t h I n f o * E n g i n e .

• M a n a g i n g t h e e x e c u t i o n o f I n f o * E n g i n e t a s k s• S t a r t i n g a n d m a n a g i n g I n f o * E n g i n e c o m p o n e• M a n a g i n g c o n n e c t i o n s t o t h e i n f o r m a t i o n s y s t

r e s i d e s .

I n t e r a c t i n g w i t h I n f o * E n g iI n i t i a t i n g a n i n t e r a c t i o n w i t h I n f o * E n g i n e c a n b em o r e o f t h e f o l l o w i n g :

• J a v a S e r v e r P a g e s ( J S P )

• C u s t o m e x t e r n a l J a v a a p p l i c a t i o n s • S i m p l e O b j e c t A c c e s s P r o t o c o l ( S O A P ) w e b s• J a v a M e s s a g e S e r v i c e ( J M S ) • E x t e r n a l a p p l i c a t i o n s p r o c e s s i n g X M L o v e r H

T h e f o l l o w i n g d i a g r a m s h o w s h o w I n f o * E n g i n e s o f t w a r e c o m p o n e n t s c a n i n t e r a c t t o e x e c u t e I n f

I n f o * E n g i n e A r c h i t e c t u r e 1 1



I n f o * E n g i n e c o d e c o n s i s t s o f J a v a c l a s s e s t h a t a r e a cI n f o * E n g i n e A P I . T h e A P I i s a v a i l a b l e t h r o u g h t h e S p r e d e n e d f u n c t i o n s c a l l e d w e b j e c t s a n d t a s k s . W e b i n s t a n t i a t e d a n d i n v o k e d a s J a v a o b j e c t s f r o m a J a v a o t h e r I n f o * E n g i n e t a s k s ( s t o r e d a s t e x t l e s ) .

T h e f o l l o w i n g s e c t i o n s p r o v i d e m o r e d e t a i l a b o u t h oc o m p o n e n t s w i t h y o u r s o f t w a r e .

J a v a S e r v e r P a g e s T h e i n s t a l l a t i o n p r o c e s s g u i d e s y o u t h r o u g h a p r o c e da s a w e b a p p l i c a t i o n . G o i n g t h r o u g h t h e i n s t a l l a t i o n s e r v e r a n d i t s s e r v l e t e n g i n e t o i d e n t i f y I n f o * E n g i n e r e q u e s t s o n t o I n f o * E n g i n e c o m p o n e n t s f o r p r o c e s s I n f o * E n g i n e e n v i r o n m e n t s o t h a t t h e r e q u e s t s f r o m wa n d H T M L p a g e s a r e p r o c e s s e d c o r r e c t l y .

T h e f o l l o w i n g d i a g r a m s h o w s t h e r e l a t i o n s h i p s a m o w e b b r o w s e r r e q u e s t s f o r J S P p a g e s :

T h i s d i a g r a m s h o w s t h e c o m p o n e n t s t h a t a r e u s e d w t h a t I n f o * E n g i n e e x e c u t e a J S P p a g e . B y d e f a u l t , I n fc o n g u r a t i o n s p e c i e s t h a t J S P p a g e s a r e p r o c e s s e d iT o m c a t s e r v l e t e n g i n e i n s t a l l e d w i t h i n t h e W i n d c h i lJ S P e n g i n e c r e a t e s a n i n s t a n c e o f t h e S A K , w h i c h i s




I n f o * E n g i n e - s p e c i c c o d e o n t h e p a g e . F o r e x a ma U R L i n a b r o w s e r w i n d o w t h a t s e r v e s a s a J S P rI n f o * E n g i n e , t h e J S P e n g i n e a n d t h e S A K w o r k t

T h e S A K p r o c e s s e s t h e r e q u e s t a n d , a s n e e d e d , c oa d a p t e r s t h a t c o m m u n i c a t e w i t h e x t e r n a l a p p l i c aP D M s y s t e m s , v a r i o u s l e g a c y s y s t e m s , a n d E R P i n f o r m a t i o n i s o b t a i n e d f r o m t h e e x t e r n a l a p p l i c a n d u l t i m a t e l y d i s p l a y s i n f o r m a t i o n i n t h e u s e r ’ s

E x t e r n a l C u s t o m J a v a A p p l i c a t i oB y c o d i n g a c u s t o m a p p l i c a t i o n i n J a v a , y o u c a n I n f o * E n g i n e w i t h o u t t h e a d d e d c o m p l e x i t y o f a wd e n e d i n t h e S A K , y o u c a n e x e c u t e I n f o * E n g i n I n f o * E n g i n e c o d e i n t h e J a v a V i r t u a l M a c h i n e ( J VT h e f o l l o w i n g d i a g r a m s h o w s t h e S A K a n d a d a pa p p l i c a t i o n t o a c c e s s d a t a i n a r e m o t e d a t a b a s e .

W i t h i n a J a v a a p p l i c a t i o n , y o u a l s o h a v e t h e e x it a s k s t h a t a r e m a i n t a i n e d o u t s i d e o f t h e a p p l i c a t i o f a s e t o f w e b j e c t s a n d s u r r o u n d i n g c o d e t h a t s u w e b j e c t s . T h e s e t a s k s c a n t h e n b e p r o c e s s e d e i t h s e r v e r o r i n t h e J V M o f t h e a p p l i c a t i o n .




T h e f o l l o w i n g d i a g r a m s h o w s t h e I n f o * E n g i n e c o m pa p p l i c a t i o n e x e c u t e s a t a s k i n a n I n f o * E n g i n e s e r v e r r e q u e s t s t h a t a t a s k b e e x e c u t e d i n t h e s e r v e r t h a t a c c e

S i m p l e O b j e c t A c c e s s P r o t o c o l ( S O B y c o d i n g I n f o * E n g i n e t a s k s a n d r e g i s t e r i n g c o m m au n d e r a c o m m o n t y p e i d e n t i e r , y o u c a n u s e I n f o * E nt h a t c a n b e c o n s u m e d i n a p r o g r a m m i n g l a n g u a g e a g a n d S i m p l e T a s k D i s p a t c h e r s e r v l e t s c o m e p r e - c o n ga r e c a p a b l e o f e x p o s i n g d y n a m i c W S - I c o m p l i a n t w e




a d d i t i o n a l d e p l o y m e n t s t e p s o n y o u r p a r t . T h e s ca r e d i c t a t e d b y t h e s e t o f t a s k s c o m p r i s i n g t h e w e p r o t e c t e d b y w e b s e r v e r a u t h e n t i c a t i o n .

N o t e I f y o u r s i t e i s u s i n g f o r m - b a s e d a u t h e n t i c a t i o n , p a t t e m p t i n g t o a c c e s s t h e R P C o r S i m p l e T a s k D i s p/ p r o t o c o l A u t h U R L p r e x . F o r e x a m p l e :

h t t p : / / < h o s t > / W i n d c h i l l / p r o t o c o l A u t h /h t t p : / / < h o s t > / W i n d c h i l l / p r o t o c o l A u t h /

F o r m o r e i n f o r m a t i o n a b o u t f o r m - b a s e d a u t h e n t i A d v a n c e d D e p l o y m e n t G u i d e .

A l t e r n a t e l y y o u c a n c h o o s e t o g e n e r a t e a n d d e p l ot h a t i s b a s e d o n a s e t o f I n f o * E n g i n e t a s k s a n d t a m e c h a n i s m s e c u r i n g t h a t w e b s e r v i c e . I t i s a l s o ps e r v i c e s t o w r i t e a w e b s e r v i c e p u r e l y i n j a v a c o d I n f o * E n g i n e . I n t h i s s c e n a r i o e a c h w e b s e r v i c e i s

J a v a M e s s a g e S e r v i c e ( J M S ) T h e I n f o * E n g i n e M S G a n d W E S w e b j e c t s c a n b O r i e n t e d M i d d l e w a r e u s i n g t h e J a v a M e s s a g e S et o J M S q u e u e s o r t o p i c s c a n r e s u l t i n t h e e x e c u t i oa n I n f o * E n g i n e J a v a V i r t u a l M a c h i n e . T h e t a s k s

o f t h e s y s t e m s c o n n e c t e d t o t h a t I n f o * E n g i n e s e rs e r v e r i n w h i c h i t i s e m b e d d e d ) . J M S c a n b e a p oe n t e r p r i s e a p p l i c a t i o n i n a m u l t i t u d e o f w a y s a n dc o m m u n i c a t i o n b e t w e e n I n f o * E n g i n e a n d s o m e M e s s a g e O r i e n t e d M i d d l e w a r e s e r v e r .

E x t e r n a l A p p l i c a t i o n s P r o c e s s i n ( o r H T T P S ) I n f o * E n g i n e c o m e s p r e - i n s t a l l e d w i t h t h e I E s e r I n f o * E n g i n e t a s k s d i r e c t l y o v e r H T T P o r H T T P S

t h e I E s e r v l e t t h e I n f o * E n g i n e V i r t u a l D a t a b a s e t h e r e s p o n s e .

A l t e r n a t e l y , I n f o * E n g i n e t a s k s c a n c o n d i t i o n t h e b i n a r y d a t a i n p l a c e o f X M L o r b y t r a n s f o r m i n g ta l t e r n a t e X M L r e p r e s e n t a t i o n o f t h e i r c h o o s i n g .




B y u s i n g t h e I E s e r v l e t s i m p l e H T T P o r H T T P S c l i e na n a p p l i c a t i o n c a n i s s u e r e q u e s t s t o s e n d a n d r e t r i e v e

N o t e I f y o u r s i t e i s u s i n g f o r m - b a s e d a u t h e n t i c a t i o n , p r o g r aa c c e s s t h e I E s e r v l e t m u s t u s e t h e / p r o t o c o l A u t h U R L p r e x . F o r e x a m p l e

h t t p : / / < h o s t > / W i n d c h i l l / p r o t o c o l A u t h / s e r

F o r m o r e i n f o r m a t i o n a b o u t f o r m - b a s e d a u t h e n t i c a t i A d v a n c e d D e p l o y m e n t G u i d e .

M a n a g i n g t h e E x e c u t i o n o f I nT a s k s I n f o * E n g i n e t a s k s c o n t r o l t h e r e t r i e v a l a n d m a n i p u l o f t h e f o l l o w i n g :

• I n v o c a t i o n o f o t h e r I n f o * E n g i n e t a s k s u s i n g n e s t e• O t h e r c u s t o m t a g s , w h i c h c a n b e e i t h e r s u p p l i e d a

c u s t o m i z e d . • E m b e d d e d J a v a s o u r c e c o d e ( s c r i p t l e t s o r m e t h o d

I n f o * E n g i n e t a s k s a r e a l w a y s s t o r e d a s t e x t d o c u m e nr o o t . T h e r e a r e s e v e r a l w a y s t o e x e c u t e t a s k s , i n c l u d

• A s t a n d a r d H T T P r e q u e s t t h r o u g h t h e I E s e r v l e t , m b r o w s e r .

• P r o c e s s i n g a J M S T o p i c o f Q u e u e s u b s c r i p t i o n . • A n e x t e r n a l S i m p l e O b j e c t A c c e s s P r o t o c o l ( S O A • U s i n g J a v a s o u r c e c o d e , t y p i c a l l y e i t h e r f r o m a c u

f r o m a W i n d c h i l l w o r k o w e x p r e s s i o n r o b o t .

T h e d e c i s i o n s a b o u t h o w a n d w h e r e t o e x e c u t e I n f o * s y s t e m r e q u i r e m e n t s . F o r e x a m p l e , i f y o u h a v e a d e ds y s t e m c o n t a i n s b o t h y o u r I n f o * E n g i n e a p p l i c a t i o n ac o m p o n e n t s , a n d t h e t a s k s t o e x e c u t e d o n o t r e q u i r e






○ Q u e u i n g a t a s k f o r e x e c u t i o n . A f t e r y o u q u e u e a f r o m y o u r a p p l i c a t i o n . A n y r e s u l t s a r e q u e u e d f oy o u o r o t h e r s . B y q u e u i n g a t a s k , y o u c a n a l s o g u c o m p l e t e d , e v e n i f i t i s i n t e r r u p t e d d u e t o a s y s t e m

B y p e r f o r m i n g t h e b a s i c W i n d c h i l l i n s t a l l a t i o n , t h e Ir e c e i v e t a s k r e q u e s t s . T o u s e e i t h e r q u e u e s o r e v e n t s i n s t a l l a n d c o n g u r e a d d i t i o n a l M e s s a g e - O r i e n t e d Ma n d t h e n u p d a t e y o u r I n f o * E n g i n e c o n g u r a t i o n .

T h e f o l l o w i n g s e c t i o n s d e s c r i b e t h e a r c h i t e c t u r e o f te x e c u t i n g s t a n d a l o n e t a s k s .

R e q u e s t i n g T a s k E x e c u t i o n t h r o u g C o n n e c t i o n T h e f o l l o w i n g d i a g r a m s h o w s t h e c o m p o n e n t s u s e d a t a s k t h r o u g h a T C P / I P c o n n e c t i o n :

A l l o f t h e s e c o m p o n e n t s c a n b e c o n g u r e d t h r o u g h t hA s s h o w n i n t h e d i a g r a m , r e q u e s t s t o e x e c u t e s t a n d a lc u s t o m J a v a a p p l i c a t i o n s a n d J S P p a g e s . I n a d d i t i o n S O A P r e q u e s t s t h a t c o m e f r o m t h i r d - p a r t y a p p l i c a t i S O A P s e r v l e t s .




I m p l e m e n t i n g E v e n t s T h a t E x e c uT h e f o l l o w i n g d i a g r a m s h o w s t h e c o m p o n e n t s t h

e x e c u t i n g t a s k s t h r o u g h I n f o * E n g i n e e v e n t s :

Y o u c a n t h i n k o f e v e n t s a s i n t e r n e t n e w s g r o u p s , l i k e s i g n i n g u p f o r a n e w s g r o u p , w h e r e t h e n a m e

n e w s g r o u p . W h e n a m e s s a g e i s p o s t e d t o a n e w s r e c e i v e t h e m e s s a g e . I n a s i m i l a r m a n n e r , w h e n at o t h e t o p i c a s s o c i a t e d w i t h t h e e v e n t r e c e i v e a m h a s o c c u r r e d .




T o i m p l e m e n t e x e c u t i n g t a s k s t h r o u g h I n f o * E n g i n e M e s s a g e - O r i e n t e d M i d d l e w a r e ( M O M ) s o f t w a r e p ra n d y o u m u s t c r e a t e t h e r e q u i r e d t o p i c s a n d a t o p i c c oa l s o u s e t h e M O M u t i l i t y t o c r e a t e m a n a g e d o b j e c t e nL D A P d i r e c t o r y s o I n f o * E n g i n e c a n l o c a t e t h e t o p i c

A f t e r t o p i c s a n d a t o p i c c o n n e c t i o n f a c t o r y h a v e b e e y o u c a n u s e a n I n f o * E n g i n e W e b E v e n t S e r v i c e ( W EI n f o * E n g i n e s e r v e r s t o e v e n t s . O n a w e b j e c t p a r a m ee x e c u t e w h e n t h e e v e n t o c c u r s . I n t h e s u b s c r i p t i o n p c o n n e c t i o n w i t h t h e M O M . T h e M O M m a n a g e s t h e t a l l s u b s c r i b e d I n f o * E n g i n e s e r v e r s w h e n t h e e v e n t o s h o w s t h r e e I n f o * E n g i n e s e r v e r s s u b s c r i b e d t o a t o p w h e n t h e e v e n t o c c u r s .

I n f o * E n g i n e a l s o p r o v i d e s a W E S w e b j e c t t h a t y o u co c c u r . T h e w e b j e c t c r e a t e s a m e s s a g e t h a t a d h e r e s t o( J M S ) s p e c i c a t i o n a n d s e n d s t h e m e s s a g e t o a s p e c it h a t t h e e v e n t h a s o c c u r r e d . Y o u c a n a l s o u s e a n y o t h e n v i r o n m e n t t h a t c a n p u b l i s h t o t h e J M S t o p i c t o m a p r e v i o u s d i a g r a m s h o w s e v e n t s c o m i n g f r o m t h r e e d a p p l i c a t i o n , a J a v a a p p l i c a t i o n , a n d a t a s k e x e c u t e d f




Q u e u i n g T a s k s f o r E x e c u t i o n T h e f o l l o w i n g d i a g r a m s h o w s o n e p o s s i b l e s e t o

t o q u e u e t a s k s f o r e x e c u t i o n :

T h i s d i a g r a m s h o w s t w o c o m p o n e n t s ( a n a p p l i c aq u e u i n g t a s k s a n d o n e c o m p o n e n t ( a n I n f o * E n g ic o m p o n e n t s u s e d i n q u e u i n g a n d e x e c u t i n g t a s k i n c l u d e m u l t i p l e c u s t o m a p p l i c a t i o n s , I n f o * E n g y o u t o s c a l e y o u r e n v i r o n m e n t t o a c c o m m o d a t e ao r i g i n a t i n g f r o m v a r i e d l o c a t i o n s . T o s e t u p t h e q u e u e s r e q u i r e d f o r q u e u i n g I n f o * EM e s s a g e - O r i e n t e d M i d d l e w a r e ( M O M ) s o f t w a ra n d c o n g u r e t h e r e q u i r e d q u e u e s a n d a q u e u e c oy o u m u s t u s e t h e M O M u t i l i t y t o c r e a t e m a n a g e dS e r v i c e L D A P d i r e c t o r y s o t h a t I n f o * E n g i n e c a n




A f t e r t h e q u e u e s a n d q u e u e c o n n e c t i o n f a c t o r y a r e s eu s e I n f o * E n g i n e m e s s a g i n g ( M S G ) w e b j e c t s t o q u e uq u e r y f o r t h e r e s u l t s . W h e n I n f o * E n g i n e p r o c e s s e s a b u i l d s a m e s s a g e t h a t a d h e r e s t o t h e J a v a M e s s a g e S es e n d s t h e m e s s a g e t o t h e s p e c i e d e x e c u t i o n q u e u e i n

T h e M O M m a n a g e s t h e q u e u e s a n d t h e r e f o r e c a n i d et h a t h a s s u b s c r i b e d t o t h e q u e u e i n o r d e r t o e x e c u t e t aa r e s e n t t o t h e q u e u e . I f m u l t i p l e I n f o * E n g i n e s e r v e r d e t e r m i n e s w h i c h s e r v e r e x e c u t e s t h e t a s k .

A f t e r a t a s k c o m p l e t e s , t h e I n f o * E n g i n e s e r v e r s e n d q u e u e i n t h e M O M . A t a n y t i m e , y o u c a n b r o w s e t h e ma n d r e t r i e v e r e s u l t s f o r t a s k s t h a t h a v e c o m p l e t e d .

S t a r t i n g a n d L o c a t i n g I n f o * EC o m p o n e n t s T h e N a m i n g S e r v i c e u s e s a n L D A P d i r e c t o r y t o p r o vI n f o * E n g i n e s e r v e r , t h e n a t i v e a d a p t e r s , a n d t h e I n f om e a n s o f l o c a t i n g e a c h o t h e r , a c t i n g a s a t r a f c d i r e c t




I n t h e f o l l o w i n g d i a g r a m , d a s h e d l i n e s r e p r e s e n t N a m i n g S e r v i c e , I n f o * E n g i n e c o m p o n e n t s , a n d b e i n s t a l l e d .

A d d i t i o n a l l y , t h e r e i s a n I n f o * E n g i n e S O A P s e r v

T h e N a m i n g S e r v i c e c a n b e u s e d t o a u t o m a t i c a l lr e s i d i n g o n t h e s a m e h a r d w a r e s y s t e m . D e p e n d i a n d g a t e w a y s , y o u m a y w a n t t o c o n g u r e t h e N a m




S e t t i n g U p C o n n e c t i o n s T h r A d a p t e r s A d a p t e r s p r o v i d e a c o n n e c t i o n b e t w e e n t h e I n f o * E n s y s t e m s . O n e s i d e o f t h e a d a p t e r c o m m u n i c a t e s w i t ht h e o t h e r s i d e c o m m u n i c a t e s w i t h t h e i n f o r m a t i o n s yI n f o * E n g i n e s e r v e r r e q u e s t s i n t o i n f o r m a t i o n s y s t e m

I n f o * E n g i n e p r o v i d e s t w o t y p e s o f a d a p t e r s :

• N a t i v e a d a p t e r s a r e i m p l e m e n t e d i n t h e J a v a l a n g uf o r m a l I n f o * E n g i n e i n t e r f a c e s p e c i c a t i o n . F o r e xa d a p t e r s a r e n a t i v e a d a p t e r s .

• N o n - n a t i v e a d a p t e r s a r e i m p l e m e n t e d i n a n o n - J a vt o t h e f o r m a l I n f o * E n g i n e i n t e r f a c e s p e c i c a t i o n . Bi s d i f f e r e n t f r o m I n f o * E n g i n e , y o u m u s t a l s o d e n n o n - n a t i v e a d a p t e r y o u i n s t a l l . G a t e w a y s t r a n s l a t ea d a p t e r s c a n p r o c e s s t h e m . A f t e r a n a d a p t e r r e c e i vs e n d s i t t o t h e a s s o c i a t e d d a t a b a s e o r d a t a r e p o s i t o ra n y i n f o r m a t i o n o b t a i n e d f r o m t h e d a t a r e p o s i t o r y t r a n s l a t e d a n d p a s s e d b a c k t o t h e I n f o * E n g i n e s e r v

T h e a d a p t e r s y o u u s e a r e d e t e r m i n e d b y t h e i n f o r m a tw a n t t o r e t r i e v e i n f o r m a t i o n . I n f o * E n g i n e p r o v i d e s i n f o r m a t i o n s y s t e m .

N a t i v e a d a p t e r s c a n b e i n s t a l l e d a s f o l l o w s :

• R e s i d i n g i n t h e s a m e J a v a V i r t u a l M a c h i n e a s t h e Ia c c e s s e s t h e a d a p t e r ( k n o w n a s i n - p r o c e s s a d a p t e r• D i s t r i b u t e d i n t h e i r o w n J a v a V i r t u a l M a c h i n e o n t

o n r e m o t e h a r d w a r e s y s t e m s ( k n o w n a s o u t - o f - p r o

H o w t o i n s t a l l n a t i v e a d a p t e r s i s d e t e r m i n e d b y y o u r

• G a t e w a y s u s u a l l y r e s i d e i n t h e s a m e J a v a V i r t u a l Mw e b j e c t s i n c e t h e c o d e f o r g a t e w a y s i s i n s t a l l e d a s p

• N o n - n a t i v e a d a p t e r s a r e a l w a y s d i s t r i b u t e d i n t h e ir u n a s o u t - o f - p r o c e s s a d a p t e r s .

T h e f o l l o w i n g s e c t i o n s e x p a n d o n t h e i n s t a l l a t i o n o p

U s i n g I n - P r o c e s s A d a p t e r s a n d G a tI n - p r o c e s s a d a p t e r s a n d g a t e w a y s a r e i n s t a l l e d a n d r M a c h i n e ( J V M ) a s t h e c a l l i n g w e b j e c t . O n l y n a t i v e ac o n g u r e d t o r u n i n t h e s a m e J V M a s t h e c a l l i n g w e b




w h i c h c l a s s e s a r e r e q u i r e d w h e n p r o c e s s i n g w e bg a t e w a y , a n d i n s t a n t i a t e s t h e c l a s s e s i n t h e J V M . b e t w e e n t h e w e b j e c t a n d t h e a d a p t e r o r g a t e w a y

C o n g u r i n g i n - p r o c e s s a d a p t e r s a n d g a t e w a y s m a n d r e s o u r c e u s a g e ; h o w e v e r , t h e t o t a l r e s o u r c e uI n f o * E n g i n e c o d e m a y b e i n c r e a s e d b e c a u s e o f tt h e a d a p t e r o r g a t e w a y .

W h e n a n a d a p t e r i s c o n g u r e d t o b e a n i n - p r o c e s b e i n s t a n t i a t e d b y a n y S A K t h a t e x e c u t e s a d a p t e rs h o w s a d a p t e r c l a s s e s r e s i d i n g i n t h e J V M o f a c us e r v e r , a n d t h e I n f o * E n g i n e s e r v e r :

A s s h o w n i n t h e d i a g r a m , n o e x t e r n a l c o m m u n i c a n d t h e a d a p t e r w h e n t h e a d a p t e r i s i n t h e s a m e p

R u n n i n g i n - p r o c e s s n a t i v e a d a p t e r s a n d g a t e w a yc o n g u r a t i o n i f t h e r e s o u r c e u s a g e o n a s i n g l e s y s




U s i n g O u t - o f - P r o c e s s A d a p t e r s a n dD i s t r i b u t i n g a d a p t e r s a c r o s s m u l t i p l e h a r d w a r e s y s t

r e s o u r c e u s a g e o n t h e m a c h i n e h o s t i n g t h e I n f o * E n gd o e s i n t r o d u c e s o m e d e l a y a n d r e s o u r c e u s a g e a s s o cc o n n e c t i o n f o r c o m m u n i c a t i n g b e t w e e n I n f o * E n g i n

T h e f o l l o w i n g d i a g r a m s h o w s t h e c o m m u n i c a t i o n l i a d a p t e r s a n d o n e g a t e w a y a r e d i s t r i b u t e d .

D i s t r i b u t e d n a t i v e a d a p t e r s a n d g a t e w a y s a r e i n s t a l l V i r t u a l M a c h i n e ( J V M ) . T h e s e v i r t u a l m a c h i n e s c a ns y s t e m a s t h e I n f o * E n g i n e s e r v e r o r o n a d i f f e r e n t h aa d a p t e r s c a n o n l y b e c o n g u r e d a s o u t - o f - p r o c e s s a d a s s e p a r a t e p r o c e s s e s . A l t h o u g h g a t e w a y s f o r n o n - n c o n g u r e d a s i n - p r o c e s s g a t e w a y s t o m i n i m i z e t h e c d o n o t n e e d t o b e i n t h e s a m e p r o c e s s .

T h e d e p l o y m e n t o f d i s t r i b u t e d a d a p t e r s a t y o u r s i t e m

c o m p a n y p o l i c y t h a t r e q u i r e s t h e a d a p t e r t o b e l o c a t ea c c e s s e s , o r i t m a y b e b a s e d o n a d m i n i s t r a t i v e r e a s o nn a t i v e a d a p t e r i n i t s o w n J a v a V i r t u a l M a c h i n e c o u l dr e s o u r c e u s a g e o f t h e v i r t u a l m a c h i n e .




2 I n f o * E n g i n e D a t a M

A b o u t I n f o * E n g i n e D a t a M a n a g e m e n t . . . . . . . . . . . . . . . . . . . . . . . . M a n a g i n g a n d M a n i p u l a t i n g G r o u p s w i t h I n f o * E n g i n e . .C o n t e x t G r o u p s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .D y n a m i c P a r a m e t e r V a l u e S u b s t i t u t i o n . . . . . . . . . . . . . . . . . . . . . . . U p l o a d i n g a n d D o w n l o a d i n g B L O B s . . . . . . . . . . . . . . . . . . . . . . . . . . E x a m p l e F e d e r a t e d S e a r c h f o r P a r t s . . . . . . . . . . . . . . . . . . . . . . . . . . .

T h e f o l l o w i n g t o p i c s i n t r o d u c e t h e c o n c e p t s o f J a n d b r i e y e x p l a i n s h o w t h e s e d o c u m e n t t y p e s u i n f o r m a t i o n a p p e a r s a n d b e h a v e s . T h e s e t o p i c s a( V D B ) a n d t h e i r r e l a t i o n s h i p t o J S P p a g e s , t a s k s

2 7



A b o u t I n f o * E n g i n e D a t a M a nA l l b a s i c I n f o * E n g i n e s o l u t i o n s t a k e a d v a n t a g e o f v

J S P p a g e s , t a s k s , w e b j e c t s , g r o u p s , a n d t h e v i r t u a l d a p a g e s a n d t a s k s a r e t e x t - b a s e d d o c u m e n t s t h a t d e n e d i s p l a y s o r r e t r i e v e s i n f o r m a t i o n . W e b j e c t s a r e t h e mJ S P p a g e s a n d t a s k s g a t h e r , m a n i p u l a t e , a n d d i s p l a y o f i n f o r m a t i o n g e n e r a t e d a n d m a n i p u l a t e d b y J S P p ad a t a b a s e i s t h e s p e c i a l h o l d i n g a r e a w h e r e g r o u p s a r m a n i p u l a t e d o r p a s s e d a l o n g b y J S P p a g e s a n d t a s k s

N o t e I n e a r l i e r r e l e a s e s , I n f o * E n g i n e H T M L t e m p l a t e s p r o f o r d i s p l a y i n g i n f o r m a t i o n . A l t h o u g h t e m p l a t e s a r e s J S P p a g e s ( o r c u s t o m J a v a a p p l i c a t i o n s ) i s n o w t h e r e d i s p l a y i n g i n f o r m a t i o n .

J S P P a g e s a n d T a s k s T e x t - b a s e d d o c u m e n t s c a l l e d I n f o * E n g i n e J a v a S e r vs t a n d a l o n e t a s k s c o n t r o l t h e i n f o r m a t i o n I n f o * E n g i n

T h e t e c h n o l o g y u s e d i n I n f o * E n g i n e J S P p a g e s i m p lw h i c h i s t h e p r o d u c t o f i n d u s t r y - w i d e c o l l a b o r a t i o n e n t e r p r i s e s o f t w a r e a n d t o o l s m a r k e t s . U s i n g t h i s J S r a p i d l y d e v e l o p a n d e a s i l y m a i n t a i n i n f o r m a t i o n - r i c

l e v e r a g e e x i s t i n g b u s i n e s s s y s t e m s . A s p a r t o f t h e J a e n a b l e s t h e d e v e l o p m e n t o f w e b - b a s e d a p p l i c a t i o n s

J S P t e c h n o l o g y u s e s X M L - l i k e t a g s a n d s c r i p t l e t s w l a n g u a g e t o e n c a p s u l a t e t h e l o g i c t h a t g e n e r a t e s t h e I n f o * E n g i n e J S P p a g e s t y p i c a l l y c o n t a i n :

• S t a t i c H T M L ( H y p e r t e x t M a r k u p L a n g u a g e ) a n d L a n g u a g e ) c o m p o n e n t s .

• J S P t a g s ( s u c h a s e x p r e s s i o n s , d e c l a r a t i o n s , a n d d ic u s t o m t a g s .

• O p t i o n a l l y , s n i p p e t s o f c o d e w r i t t e n i n t h e J a v a p r

s c r i p t l e t s . C o n s e q u e n t l y , y o u c a n c r e a t e a n d m a i n t a i n I n f o * E n gH T M L / X M L t o o l s .

I n f o * E n g i n e s t a n d a l o n e t a s k s a r e X M L - b a s e d d o c u mw a y t o c o n t r o l t h e r e t r i e v a l a n d m a n i p u l a t i o n o f d a t aa p p l i c a t i o n . T h e m a i n d i f f e r e n c e b e t w e e n J S P p a g e sc a n c o n t a i n c o n t e n t t h a t g e n e r a t e s d a t a a n d t h e n d i s pu s e r . T a s k s g e n e r a t e t h e d a t a , b u t t h e y d o n o t p r o v i d e




T h e I n f o * E n g i n e t a s k c o m p i l e r r e c o g n i z e s s t a t i cs c r i p t l e t s , a n d I n f o * E n g i n e c u s t o m t a g s . S o g e n e b e f o r m a t t e d j u s t l i k e y o u r J S P p a g e s , b u t w i t h o uH T M L t a g s . I n f o * E n g i n e p r o v i d e s c u s t o m t a g s t h a t e n c a p s u lt h a t t h e s a m e f u n c t i o n a l i t y c a n b e r e u s e d i n m u l to r I n f o * E n g i n e s t a n d a l o n e t a s k s . U s i n g I n f o * E nn e c e s s i t y t o e m b e d l a r g e a m o u n t s o f J a v a c o d e i nt a s k s , a n d a l l o w s y o u t o q u i c k l y c r e a t e t h e p a g e s y o u r a p p l i c a t i o n . F o r e x a m p l e , t h e w e b j e c t t a g a l l o w s y o u t o e a s i l y e t h e I n f o * E n g i n e w e b j e c t s ( d e s c r i b e d i n t h e n e x t d o c u m e n t s u s e .

B o t h J S P p a g e s a n d t a s k s u s e J S P s p e c i c s y n t a x g u i d e d o e s n o t d e s c r i b e e v e r y t h i n g y o u n e e d t o kd o c u m e n t s . I n s t e a d , i t d e s c r i b e s t h e r u l e s a n d e nl a n g u a g e t h a t a r e i m p o r t a n t t o u n d e r s t a n d w h e n J S P p a g e s a n d t a s k s , a n d i t d o c u m e n t s t h e I n f o * Eu n d e r s t a n d i n g t h e b a s i c a p p e a r a n c e o f J S P p a g e w e b j e c t s , g r o u p s , a n d h o w t h e V D B w o r k s w i t h to f h o w I n f o * E n g i n e m a n a g e s i n f o r m a t i o n . T h e ar u l e s a r e d e s c r i b e d l a t e r i n t h i s g u i d e .

W e b j e c t s A w e b j e c t i s a c o m m a n d t h a t e x e c u t e s a s p e c i c I p r o v i d e d t h r o u g h a n e x t e r n a l w e b j e c t n a m e . T o i o r t a s k , u s e t h e I n f o * E n g i n e w e b j e c t a n d p a r a m et a g s r e q u i r e s n o k n o w l e d g e o f p r o g r a m m i n g b e yT h e I n f o * E n g i n e c u s t o m t a g s a r e u s e d i n t h e s a m h e l p d e t e r m i n e h o w i n f o r m a t i o n a p p e a r s w i t h i n t h a t c a n b e m a n i p u l a t e d b y a p r o g r a m . W e b j e c t s t a s k a n d c a n b e u s e d t o d y n a m i c a l l y o r g a n i z e a n d

T h i n k o f w e b j e c t s a s s p e c i a l i z e d o b j e c t s t h a t d i s ta b s t r a c t o r c o n d e n s e d t e r m s . T h e s e s p e c i a l i z e d or e q u i r i n g c h a n g e s b y a p r o g r a m m e r , a n d e a c h t i md i f f e r e n t r e s u l t s . W h i l e u n d e r s t a n d i n g h o w t o w

s u c c e s s o f a n I n f o * E n g i n e s o l u t i o n , f o r n o w s i m t y p e s o f w e b j e c t s s h o u l d h e l p y o u u n d e r s t a n d h o

T h e f o l l o w i n g t y p e s o f w e b j e c t s a r e a v a i l a b l e :

I n f o * E n g i n e D a t a M a n a g e m e n t 2 9



D i s p l a y D i s p l a y w e b j e c t s t r a n s f o r m I n f o * E n g i n e g r o u p s i n

D i s p l a y w e b j e c t s c a n o n l y b e s p e c i e d i n J S P p a g e I n a d i s p l a y w e b j e c t , y o u n a m e a n e x i s t i n g g r o u p t hf o r d i s p l a y . F o r m o r e i n f o r m a t i o n , s e e D i s p l a y W e b j e c t s f o r H T M L o2 9 0 .

I m a g e I m a g e w e b j e c t s d i s p l a y J P E G i m a g e s b a s e d o n g r od i s p l a y e d i n a g r a p h o r a c h a r t . F o r m o r e i n f o r m a t i I m a g e W e b j e c t s f o r J P E G o n p a g e 3 4 5 .

Q u e r y Q u e r y w e b j e c t s s e a r c h e x t e r n a l d a t a b a s e s f o r o b j e c r i t e r i a . E a c h a d a p t e r s u p p o r t s a u n i q u e s e t o f q u e

a d a p t e r m u s t h a n d l e q u e r i e s d i f f e r e n t l y d u e t o t h e d a t a r e p o s i t o r i e s .

W h e n I n f o * E n g i n e e n c o u n t e r s a q u e r y w e b j e c t , i t a p p r o p r i a t e a d a p t e r . T h e a d a p t e r t h e n p e r f o r m s t h eo f o b j e c t s r e t u r n e d b y a s u c c e s s f u l q u e r y i s s t o r e d m a k i n g t h e r e s u l t s a v a i l a b l e t o o t h e r w e b j e c t s . F o rT a s k W e b j e c t R e f e r e n c e o n p a g e 3 5 7 .

A d m i n i s t r a t i v e A d m i n i s t r a t i v e w e b j e c t s p e r f o r m s p e c i c a d m i n i s g a t h e r i n g s i m p l e s t a t i s t i c s , o r c a u s i n g s e r v i c e p r o pF o r m o r e i n f o r m a t i o n , s e e A d m i n i s t r a t i v e W e b j e c t s o n p a g e 3 5

A c t i o n A c t i o n w e b j e c t s p e r f o r m a c t i o n s s u c h a s c r e a t i n g , a d a p t e r s u p p o r t s a u n i q u e s e t o f a c t i o n w e b j e c t s b ed i r e c t l y t o t h e d a t a r e p o s i t o r y t o w h i c h t h e a d a p t e r

W h e n I n f o * E n g i n e e n c o u n t e r s a n a c t i o n w e b j e c t , a p p r o p r i a t e a d a p t e r . T h e a d a p t e r t h e n p e r f o r m s t h ei n f o r m a t i o n , s e e T a s k W e b j e c t R e f e r e n c e o n p a g e 3 5 7

G r o u p G r o u p w e b j e c t s c o m p a r e , c o m b i n e , o r s o r t o n e o r mt h a t h a v e b e e n g e n e r a t e d a s a r e s u l t o f o t h e r q u e r y ,

F o r m o r e i n f o r m a t i o n , s e e G r o u p W e b j e c t s o n p a g e 3 6 0 . M a n a g e m e n t

M a n a g e m e n t w e b j e c t s p r o v i d e s o m e c o m m o n f u n p r o p e r t i e s , m a p p i n g c r e d e n t i a l s , a n d t h r o w i n g e x cm a n a g i n g y o u r J S P p a g e s o r t a s k s . F o r m o r e i n f o r m a t i o n , s e M a n a g e m e n t W e b j e c t s o n p a g e 4 1 8




M e s s a g e M e s s a g e w e b j e c t s p r o v i d e a s e t o f w e b j e c t s t h aw i t h a t h i r d - p a r t y M O M f o r g e n e r i c m e s s a g i n gf u n c t i o n s . F o r m o r e i n f o r m a t i o n , s e e M e s s a g e W e b j e c t s o n p a g e

W e b E v e n t S e r v i c e W e b E v e n t S e r v i c e w e b j e c t s p r o v i d e s a s e t o f wc o n j u n c t i o n w i t h a t h i r d - p a r t y M O M ( o r J M S s e v e n t s . F o r m o r e i n f o r m a t i o n , s e e W e b E v e n t S e r v i c e W e b j e c t s

Q u e r y , a d m i n i s t r a t i v e , a c t i o n , g r o u p , m a n a g e m S e r v i c e w e b j e c t s c a n b e s p e c i e d i n e i t h e r J S P p aa r e o f t e n r e f e r r e d t o a s “ t a s k ” w e b j e c t s .

Y o u c a n a l s o c r e a t e e x t e r n a l c u s t o m w e b j e c t s b y W i t h c u s t o m w e b j e c t s , y o u h a v e a c c e s s t o a l l i n t

a n d c a n e x t e n d t h e f u n c t i o n a l i t y o f I n f o * E n g i n e d y n a m i c a l l y l o a d e d b y I n f o * E n g i n e a n d c a n b e a

G r o u p s o f O b j e c t s a n d t h e V i r t u a W h e n a w e b j e c t r e t u r n s i n f o r m a t i o n f r o m a d a t a mo t h e r s o u r c e , t h e i n f o r m a t i o n i s r e t u r n e d a s a g r o e a c h g r o u p o f o b j e c t s i n a s p e c i a l h o l d i n g a r e a c a

G r o u p s o f o b j e c t s a r e c r e a t e d w h e n q u e r y , a c t i o na n d W e b E v e n t S e r v i c e w e b j e c t s p e r f o r m t h e i r f u b e c o n t a i n e d w i t h i n a t a s k o r J S P p a g e , e a c h c r e a

t o b e p l a c e d w i t h i n t h e V D B . I n d e n i n g a w e b j e cu s i n g t h e G R O U P _ O U T p a r a m e t e r . I t i s i m p o r t au n i q u e l y s o i t c a n b e i d e n t i e d b y a s u b s e q u e n t w d i s p l a y i n g g r o u p d a t a .

T h e V D B d o e s n o t a l l o w g r o u p s t o h a v e d u p l i c a tg r o u p s w i t h t h e s a m e n a m e a n d b o t h a r e p l a c e d i o v e r w r i t e s t h e r s t . I f a n y g r o u p i s u n n a m e d a n d t h e n e w u n n a m e d g r o u p o v e r w r i t e s t h e p r e v i o u s

E x a m p l e V D B

O b j e c t s w i t h i n a p a r t i c u l a r g r o u p i n t h e V D B c a nA l t h o u g h g r o u p d a t a i s n o t s t o r e d a s a n a c t u a l t a bg r o u p s w i t h i n t h e V D B u s i n g a t a b l e s u c h a s t h e o

e n a m e p h o n e d e p a r t m e n t t i t l e L a w , G r a c i e 8 7 3 - 2 2 0 0 S a l e s S a l e s M a n a g e r B u r t o n , J a c k 8 7 3 - 2 3 0 2 S a l e s S a l e s R e p r e s e n t aL o P a n , D a v i d 8 7 3 - 3 3 1 3 S a l e s A d m i n i s t r a t i v e A s s i




T h i s e x a m p l e t a b l e c o n t a i n s a h e a d i n g r o w a n d t h r e eo f e a c h d a t a r o w a s a n o b j e c t i n t h e V D B g r o u p . T h e rt h e r e a r e t h r e e o b j e c t s i n t h e g r o u p . E a c h o b j e c t c o n sr e p r e s e n t e d b y t h e c o l u m n s i n t h e t a b l e . T h e h e a d i n gt h i s e x a m p l e t h e a t t r i b u t e s o f e a c h o b j e c t a r e “ e n a m e“ p h o n e , ” “ d e p a r t m e n t , ” a n d “ t i t l e . ”

I n a d d i t i o n t o g e n e r a l d a t a g r o u p s l i k e t h e o n e d e s c r iI n f o * E n g i n e m a i n t a i n s s e v e r a l c o n t e x t g r o u p s w h o sa v a i l a b l e t o a l l w e b j e c t s . T h e c o n t e x t g r o u p s c o n t a i nt h e H T T P p r o t o c o l a n d H T M L f o r m d a t a a t t r i b u t e s a I n f o * E n g i n e . F o r m o r e i n f o r m a t i o n , s e e C o n t e x t G r o u p s o n p a g e 3 9 .

B a s i c G r o u p C r e a t i o n a n d D i s p l a y

G r o u p s o f o b j e c t s a r e s t o r e d i n t h e V D B s o t h a t o t h e r i n f o r m a t i o n . T h e f o l l o w i n g s c e n a r i o d e m o n s t r a t e s h p a s s i n f o r m a t i o n f r o m a t a s k w e b j e c t t o a d i s p l a y w e d a t a b a s e q u e r y a n d r e t u r n t h e r e s u l t s t o t h e b r o w s e r .

I n t h i s s c e n a r i o , a s s u m e t h a t t h e f o l l o w i n g s e q u e n c e r e q u i r e d i n t h e s c e n a r i o :

1 . F r o m t h e b r o w s e r , a u s e r e n t e r s a U R L t h a t i d e n t i 2 . A t a s k w e b j e c t o n t h e p a g e e x e c u t e s a q u e r y t o a d 3 . T h e o u t p u t f r o m t h e t a s k w e b j e c t i s f o r m a t t e d b y a

r e t u r n e d t o t h e b r o w s e r .

T o a c c o m p l i s h t h i s s c e n a r i o , s t a r t b y a u t h o r i n g a J S Pf o r i n f o r m a t i o n a b o u t e m p l o y e e s . T h e Q u e r y - O b j e c l o o k l i k e t h i s :

 



T h i s w e b j e c t e x e c u t e s a q u e r y o f t h e s a l e s e m p t a b l e u s i n g t h e a d a p t e r i d e ni n t h e I N S T A N C E p a r a m e t e r . T h e C L A S S p a r a m e t e b e q u e r i e d , a n d b e c a u s e t h e W H E R E p a r a m e t e r d o e a l l o f t h e d a t a i n t h e t a b l e i s r e t u r n e d . T h e S O R T E D pA S C , w h i c h s o r t s t h e d a t a r e t u r n e d f r o m t h e d a t a b a s S O R T B Y p a r a m e t e r n a m e s t h e a t t r i b u t e o n w h i c h s o




t h e e n a m e a t t r i b u t e s e t i n t h e S O R T B Y p a r a m e t e r h o T h e r e f o r e , r a t h e r t h a n s o r t i n g t h e i n f o r m a t i o n b ai t e m i t n d s , s o r t i n g i s b a s e d o n t h e e m p l o y e e n a m

A f t e r a l l o f t h e i n f o r m a t i o n i s g a t h e r e d f r o m t h e g r o u p n a m e d “ e m p l o y e e s ” i n t h e V D B . T h i s g r o o t h e r w e b j e c t s . I f t h e q u e r y r e t u r n s t h e s a m e d a t ae x a m p l e , y o u c a n t h i n k o f t h e “ e m p l o y e e s ” g r o u

e n a m e p h o n e d e p a r t m e n t t i t l e B u r t o n , J a c k 8 7 3 - 2 3 0 2 S a l e s S a l e s R e p r e s e n t a t iL a w , G r a c i e 8 7 3 - 2 2 0 0 S a l e s S a l e s M a n a g e r L o P a n , D a v i d 8 7 3 - 3 3 1 3 S a l e s A d m i n i s t r a t i v e A s

N o t i c e t h a t t h e “ e n a m e ” c o l u m n , w h i c h c o n t a i n ss o r t e d i n a s c e n d i n g o r d e r i n t h e V D B . T o v i e w t h e e m p l o y e e i n f o r m a t i o n t h a t i s s t o r e d ia d d a d i s p l a y w e b j e c t t o t h e J S P p a g e . I n t h e d i s p g r o u p t o f o r m a t a s t h e i n p u t g r o u p . B y d e f a u l t , I nt h e g r o u p w i t h H T M L s o i t c a n b e d i s p l a y e d . A d d i s p l a y t h e i n f o r m a t i o n a s a t a b l e m i g h t l o o k l i k e

 

T h e D i s p l a y - T a b l e w e b j e c t n a m e s t h r e e o f t h e f oa n d s p e c i e s h e a d e r v a l u e s f o r t h e a t t r i b u t e s i n t h p a r a m e t e r s . T h e r e s u l t i n g d i s p l a y i s t h e f o l l o w i na t t r i b u t e s f o r e a c h o b j e c t u n d e r t h e i r c o r r e s p o n d




M a n a g i n g a n d M a n i p u l a t i n g I n f o * E n g i n e U n d e r s t a n d i n g h o w I n f o * E n g i n e o p e r a t e s w i t h m o r d i s p l a y s o f t h o s e q u e r i e s c a n h e l p y o u u s e I n f o * E n g iy o u r s i t e . T h e f o l l o w i n g s c e n a r i o s c a n g i v e y o u a c l ey o u c a n m a n i p u l a t e d a t a u s i n g I n f o * E n g i n e .

M a n i p u l a t i n g S e v e r a l G r o u p s a n d DR e s u l t i n g G r o u p E x p a n d i n g o n t h e e m p l o y e e e x a m p l e d e s c r i b e d p r e vd e m o n s t r a t e s h o w t o o b t a i n a s i n g l e l i s t o f e m p l o y e e

d e p a r t m e n t s . T h e f o l l o w i n g e x a m p l e c o m b i n e s t h e ed e p a r t m e n t a n d t h e d e v e l o p m e n t d e p a r t m e n t o f y o u e a c h d e p a r t m e n t h a s t h e i r e m p l o y e e l i s t s i n d i f f e r e n tt h e c o m p a n y . T h i s s c e n a r i o g e t s e m p l o y e e i n f o r m a tc o m b i n e s i t i n s u c h a w a y t h a t i t l o o k s l i k e o n e l i s t o f

F i r s t , a u t h o r a J S P p a g e t o q u e r y a d a t a b a s e f o r i n f o r mc a n s t a r t w i t h t h e t a s k w e b j e c t s i m i l a r t o t h e o n e s h o w B a s i c G r o u p C r e a t i o n a n d D i s p l a y o n p a g e 3 2 . T h i s t a s k w e b j e c t l o o k s f o r t h o s e ed e n e d i n t h e “ s a l e s e m p ” t a b l e . N o w , y o u c a n a d d a nf o r i n f o r m a t i o n f r o m t h e “ d e v e m p ” t a b l e . F o r e x a m pq u e r y w e b j e c t s s i m i l a r t o t h e f o l l o w i n g :

 



 






T h e r s t Q u e r y - O b j e c t s w e b j e c t a s k s f o r i n f o r m as a l e s e m p l o y e e d a t a b a s e t a b l e ( u s i n g t h e “ s a l e s e p a r a m e t e r ) . S p e c i c a l l y , i t a s k s f o r i n f o r m a t i o n as a l e s d e p a r t m e n t . T h e r e s u l t s o f t h e q u e r y a r e t h ec a l l e d “ s a l e s ” . Y o u c a n t h i n k o f t h e s a l e s g r o u p i n

e n a m e p h o n e d e p a r t m e n t t i t l e B u r t o n , J a c k 8 7 3 - 2 3 0 2 S a l e s S a l e s R e p r e s e n t a L a w , G r a c i e 8 7 3 - 2 2 0 0 S a l e s S a l e s M a n a g e r L o P a n , D a v i d 8 7 3 - 3 3 1 3 S a l e s A d m i n i s t r a t i v e A

T h e s e c o n d Q u e r y - O b j e c t s w e b j e c t a l s o a s k s f o r b u t t h i s t i m e t h e i n f o r m a t i o n c o m e s f r o m t h e d e v t h e “ d e v e m p ” t a b l e n a m e i n t h e C L A S S p a r a m e t

q u e r y a r e t h e n p l a c e d i n t h e V D B i n a g r o u p c a l l eo f t h e d e v e l o p m e n t g r o u p i n t e r m s o f t h e f o l l o w i

e n a m e p h o n e d e p a r t m e n t t i t l e A n d e r s o n , P a t 8 7 3 - 2 4 2 8 D e v e l o p m e n t E n g i n e S t e i n , C h r i s 8 7 3 - 2 6 0 8 D e v e l o p m e n t M a n a g e r W o n g , M a y 8 7 3 - 2 7 4 1 D e v e l o p m e n t E n g i n e

N o w t h e r e a r e t w o g r o u p s i n t h e V D B , o n e c a l l e d“ d e v e l o p m e n t ” . T h e s c e n a r i o i s n o t y e t c o m p l e t et w o g r o u p s i n t o o n e l i s t o f e m p l o y e e s . T o c o m b i f o l l o w i n g M e r g e - G r o u p s w e b j e c t t o t h e J S P p a g

 

T h i s w e b j e c t t a k e s t h e s a l e s a n d d e v e l o p m e n t g r oi n t o o n e l a r g e g r o u p u s i n g t h e e m p l o y e e n a m e f r g u i d e . A l l o f t h e i n f o r m a t i o n i s s o r t e d i n a s c e n d i

n a m e . T h e r e s u l t s o f t h e m e r g e d i n f o r m a t i o n a r e “ e m p l o y e e s ” . T h i s n a l g r o u p i s t h e n p l a c e d i n t h

T o v i e w t h e e m p l o y e e i n f o r m a t i o n t h a t i s s t o r e d c a n u s e a d i s p l a y w e b j e c t t h a t i s s i m i l a r t o t h e s c e B a s i c G r o u p C r e a t i o n a n d D i s p l a y o n p a g e 3 2 :

 




< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " e n a m e , d e p a r t m e n t , p h o n e , t i t l e " d e l i m = " ,



T h e r e s u l t i n g d i s p l a y i s t h e f o l l o w i n g t a b l e t h a t c o n t t h e s a l e s a n d d e v e l o p m e n t d e p a r t m e n t s . T h e d i s p l a ya t t r i b u t e , w h i c h h a d b e e n l e f t o u t i n t h e e a r l i e r s c e n a

M a n i p u l a t i n g a n d D i s p l a y i n g M u l t i pV D B W h e n I n f o * E n g i n e q u e r i e s d a t a b a s e s a n d d a t a r e p o st h e q u e r i e s i n t h e V D B . I n m o s t c a s e s , t h e l a s t g r o u p if o r d i s p l a y i n t h e w e b b r o w s e r . H o w e v e r , a l l g r o u p s a r e a v a i l a b l e t o o t h e r w e b j e c t s o n t h e p a g e , a n d p o s s io n o t h e r p a g e s i n t h e s e s s i o n ( d e p e n d i n g o n t h e s c o p s t a n d a l o n e t a s k s t h a t a r e e x e c u t e d t h r o u g h t h e J S P e n

F o r s t a n d a l o n e t a s k s , I n f o * E n g i n e a l w a y s m a k e s t h it h e t a s k a v a i l a b l e f o r m a n i p u l a t i o n . T h e o t h e r g r o u p t o t h e l a s t g r o u p s t i l l e x i s t i n t h e V D B , b u t a r e n o t a c co f t h e R e t u r n - G r o u p s w e b j e c t :

 



U s i n g a n e x a m p l e s i m i l a r t o t h e e m p l o y e e e x a m p l e df o l l o w i n g s c e n a r i o d e m o n s t r a t e s h o w t o o b t a i n a s e pt h e s a l e s d e p a r t m e n t a n d t h e d e v e l o p m e n t d e p a r t m e u n l i k e t h e p r e v i o u s e x a m p l e , d i s p l a y s e a c h e m p l o y ec o m b i n e d l i s t o f e m p l o y e e s .




T o a c c o m p l i s h t h i s , a u t h o r a n I n f o * E n g i n e t a s k na d a t a b a s e f o r i n f o r m a t i o n a b o u t s a l e s e m p l o y e eT h e t w o Q u e r y - O b j e c t s w e b j e c t s n e c e s s a r y t o r e w e b j e c t s t h a t w e r e u s e d i n t h e p r e v i o u s e x a m p l e

 



 

 

A s b e f o r e , t h e r s t Q u e r y - O b j e c t s w e b j e c t a s k s f of r o m t h e s a l e s e m p l o y e e t a b l e a n d t h e s e c o n d Q ui n f o r m a t i o n f r o m t h e d e v e l o p m e n t e m p l o y e e t a bt h e n p l a c e d i n t h e s a l e s a n d d e v e l o p m e n t g r o u p s

T o e x e c u t e t h e “ l i s t s e p a r a t e ” t a s k a n d t h e n v i e w s t o r e d i n t h e s a l e s a n d d e v e l o p m e n t g r o u p s , y o u p a g e , u s e t h e I n f o * E n g i n e c u s t o m t a s k t a g t o e x e c u t e t h e t a s k a n d i nd i s p l a y w e b j e c t s t o d i s p l a y t h e g r o u p s . B y d e f a u J V M a s t h e J S P e n g i n e t h a t i s p r o c e s s i n g t h e J S P g r o u p s c r e a t e d t h r o u g h t h e t a s k a r e a v a i l a b l e t o tt h e t a s k e x e c u t e s .

T h e t a s k t a g a n d d i s p l a y w e b j e c t s t h a t a r e d e s i g n l o o k l i k e t h i s :



 < i e : p a r a m n a m e = " A T T R I B U T E "

d a t a = " e n a m e , d e p a r t m e n t , p h o n e , t i t l e " d e l i 

 




< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " e n a m e , d e p a r t m e n t , p h o n e , t i t l e " d e l i m = " ,



N o t i c e t h a t t h e t a s k t a g e x e c u t e s t h e “ l i s t s e p a r a t e ” t a b o t h g r o u p s a r e a v a i l a b l e . T h e r s t D i s p l a y - T a b l e w ew h i c h i s s p e c i e d i n i t s G R O U P _ I N p a r a m e t e r . T h e sd i s p l a y s t h e d e v e l o p m e n t g r o u p , w h i c h i s s p e c i e d i T h e r e s u l t i n g t a b l e s a r e s i m i l a r t o t h e f o l l o w i n g :

P u t t i n g t h e t w o Q u e r y - O b j e c t s w e b j e c t s i n a t a s k s e pt h e d i s p l a y a s f a r a s y o u r c o d e i s c o n c e r n e d , b u t i n t h e x e c u t i o n t a k e s p l a c e a s i f t h e Q u e r y - O b j e c t s w e b j e p a g e a s t h e d i s p l a y w e b j e c t s . I f y o u e x e c u t e t h e “ l i s t s e p a r a t e ” t a s k o u t s i d e o f t h e J r e s i d e s , t h e n n o t a l l o f t h e g r o u p s g e n e r a t e d b y t h e t a t o t h e J S P p a g e . O n l y t h e l a s t g r o u p g e n e r a t e d i s a u t oe x p a n d t h e “ l i s t s e p a r a t e ” t a s k s o t h a t i t r e t u r n s m o r e t h e R e t u r n - G r o u p s w e b j e c t a f t e r t h e t w o q u e r y w e b j m u s t e n d i n a R e t u r n - G r o u p s w e b j e c t s o t h a t b o t h g r c a l l i n g t a s k o r J S P . T h e R e t u r n - G r o u p s w e b j e c t m i g h

 

 

I n t h e R e t u r n - G r o u p s w e b j e c t , y o u c a n i n c l u d e m u l t E a c h o f t h e s e p a r a m e t e r s d e n e s a p a r t i c u l a r g r o u p i nh a v e r e t u r n e d f o r f u r t h e r p r o c e s s i n g . A p a r a m e t e r v ai n t h e t a s k ’ s V D B t o b e r e t u r n e d .




T o e x e c u t e t h e “ l i s t s e p a r a t e ” t a s k o u t s i d e o f t h e Js p e c i f y t h e p r o c e s s o r a t t r i b u t e o n t h e t a s k t a g i n t h e J S P p a g e . F o r e x t a s k p r o c e s s o r h a s t h e d e f a u l t n a m e o f “ c o m . m y Cy o u c a n i n c l u d e t h e p r o c e s s o r a t t r i b u t e i n t h e t a s k t a g a s f o l l o w s :



Y o u c a n c h o o s e t o e x e c u t e t a s k s o u t s i d e o f t h e J Vf o r p e r f o r m a n c e r e a s o n s o r f o r s o m e o t h e r r e a s o nd o s p e c i f y t h e p r o c e s s o r , y o u m u s t e n s u r e t h a t t h g r o u p s t h a t a r e n e e d e d b y t h e o t h e r w e b j e c t s o n t

S e n d i n g a n d R e t r i e v i n g D a t a G r o

W h e n y o u a r e w o r k i n g w i t h d a t a t h a t i s t a r g e t e d ft h e d a t a t o t h e a d a p t e r t h a t i n t e r f a c e s w i t h t h e i n f t h e G R O U P _ I N p a r a m e t e r o n a d a p t e r w e b j e c t y os p e c i e d o n t h e G R O U P _ I N p a r a m e t e r a r e d e l i v g r o u p s i n t h e V D B a r e n o t a v a i l a b l e t o t h e a d a p t e

W h e n y o u a r e w o r k i n g w i t h d a t a t h a t i s c o m i n g f t h e g r o u p i n w h i c h t h e d a t a i s r e t u r n e d b y s p e c i f yo n a d a p t e r w e b j e c t y o u w a n t t o u s e . I f f o r s o m e r e b e r e t u r n e d , t h e a d a p t e r i n d i c a t e s t h i s t o I n f o * E ne x c e p t i o n . A f t e r e x e c u t i n g a d a p t e r w e b j e c t s t h a s y s t e m , y o u s h o u l d a l w a y s c h e c k f o r p o s s i b l e e x

C o n t e x t G r o u p s W h e n a t a s k w e b j e c t r e t u r n s i n f o r m a t i o n f r o m a ds o m e o t h e r s o u r c e , t h e i n f o r m a t i o n i s r e t u r n e d a si n t h e V D B . T h e V D B a l s o c o n t a i n s s p e c i a l g r o u g a t h e r e d d u r i n g t h e r e q u e s t p r o c e s s . T h e s e g r o u

C o n t e x t g r o u p s a r e m a i n t a i n e d b y I n f o * E n g i n e aw e b j e c t s . W e b j e c t s c a n b e a u t h o r e d t o i n c l u d e t hs u b s t i t u t e s v a l u e s f r o m t h e c u r r e n t c o n t e x t g r o u pt h e w e b j e c t f o r t h i s e x e c u t i o n .

T h r e e p r e d e n e d g r o u p s a r e a v a i l a b l e w i t h i n t h e @ S E R V E R , @ F O R M , a n d @ C O O K I E . A s h o r tF O R M , a n d C O O K I E ( e x c l u d i n g t h e @ s y m b o l )c r e a t e d a g r o u p c a l l e d S E R V E R , F O R M , o r C O O@ S E R V E R , @ F O R M , a n d @ C O O K I E r e f e r e x pa r e t h e p r e f e r r e d n a m e s f o r t h e g r o u p s .




@ S E R V E R T h e @ S E R V E R g r o u p c o n t a i n s a t t r i b u t e s t h a t a r e u s e d t o c o m m u n i c a t e f r o m t h e w e b b r o w s e r t o t h e a t t r i b u t e s s u c h a s A c c e p t - L a n g u a g e o r A u t h - U s e r . R e f e r t o t h e c u r r e n t w e b - b r o w s e r - t o - w e b - s e r v e r p r o t o c o l s p e c i c a t i o nt h e i n d i v i d u a l a t t r i b u t e s f o u n d i n t h i s g r o u p . T o d e o f t h e c u r r e n t @ S E R V E R g r o u p , y o u c a n e x e c u t e tw e b j e c t .

@ F O R M T h e @ F O R M g r o u p c o n t a i n s a t t r i b u t e s t h a t a r e o b s p e c i c a t i o n d a t a t h a t i s r e c e i v e d w i t h t h e U R L u s ea l s o c o n t a i n s a n y H T M L f o r m d a t a t h a t w a s r e c e i v b r o w s e r P O S T r e q u e s t .

@ C O O K I E T h e @ C O O K I E g r o u p c o n t a i n s o n e e l e m e n t t h a t hc o o k i e t h a t i s p r o c e s s e d d u r i n g t h e c o n n e c t i o n t o t hn a m e i s t h e n a m e o f t h e c o o k i e a n d t h e v a l u e i s t h e v

I n a d d i t i o n t o t h e s e g r o u p s , t h e A u t h - M a p c o n t e x t g r o u p i s c r e a t e d w h e na u t h e n t i c a t i o n t a s k e x e c u t e s . F o r m o r e i n f o r m a t i o n C r e d e n t i a l s M a p p i n g o n p a g e 1 1 9 .

D y n a m i c P a r a m e t e r V a l u e S uA l t h o u g h m o s t s i m p l e W i n d c h i l l i n s t a l l a t i o n s d o n o

p a r a m e t e r v a l u e s m u s t o f t e n b e t a k e n d i r e c t l y f r o m uf o r m o r a s a g r o u p o f u n k n o w n s i z e o r k i n d f r o m a d a p r o v i d e s a m e c h a n i s m c a l l e d “ d y n a m i c p a r a m e t e r v a l u e s u b s t i t u t u s e d i n t h e f o l l o w i n g s i t u a t i o n s :

• W h e n i n f o r m a t i o n c o m e s f r o m a w e b - b a s e d f o r m • W h e n i n f o r m a t i o n c o m e s f r o m t h e d a t a o b j e c t s i n

T h e s u b s t i t u t i o n r e q u i r e d i n a w e b j e c t i s a p p l i e d o n c w e b j e c t i s e x e c u t e d . T h e r e f o r e , t o s u b s t i t u t e v a l u e s t h r o u g h t h e e x e c u t i o n o f a t a s k , y o u m u s t e x e c u t e t h ew e b j e c t t h a t c o n t a i n s t h e s u b s t i t u t i o n e x p r e s s i o n s . Yf r o m w i t h i n t h e w e b j e c t .

Y o u c a n u s e I n f o * E n g i n e s u b s t i t u t i o n e x p r e s s i o n s i np a r a m t a g u s e d i n a n y w e b j e c t s .




G e n e r a l V a l u e S u b s t i t u t i o n S y n t I n f o * E n g i n e s u b s t i t u t i o n e x p r e s s i o n s a r e a l w a y $ (

a n d ) . W i t h i n t h e s e d e l i m i t e r s , s p e c i f y t h e g r o u p a s u b s t i t u t i o n i s m a d e a s f o l l o w s : $ ( g r o u p _ n a m e [ e l e m e n t _ s e l e c t o r ] a t t r i b u t e _ n a m e [ v a l u e _ s e l e ] )

w h e r e :

g r o u p _ n a m e N a m e s a g r o u p t h a t e x i s t s i n t h e V D B . T h i s g r o a s @ F O R M o r a d a t a g r o u p t h a t r e s u l t s f r o m t h

e l e m e n t _ s e l e c t o r I d e n t i e s t h e e l e m e n t s ( r o w s ) w i t h i n t h e g r o u p c a n b e o n e o f t h e f o l l o w i n g :

• A n i n t e g e r , w h i c h i d e n t i e s a n e l e m e n t b y i t sa n i n d e x o f 0 . T h e r e f o r e , i f a g r o u p c o n t a i n s r a n g e f r o m 0 t o 9 .

• T h e l e t t e r N , w h i c h s e l e c t s t h e l a s t e l e m e n t o f t h e g • E m p t y , w h i c h s e l e c t s a l l e l e m e n t s a n d c o n c a

s t r i n g u s i n g n o s e p a r a t o r s . T h e e m p t y s e l e c t oi s o n l y o n e e l e m e n t .

• T h e w o r d M E T A , w h i c h s e l e c t s t h e m e t a d a t a f r o m t h s e l e c t i n g e l e m e n t s .

• T h e a s t e r i s k ( * ) s y m b o l , w h i c h s e l e c t s a l l e l e m e n t s

t o g e t h e r i n t o a s t r i n g . S e m i c o l o n s s e p a r a t e t h• A n a t t r i b u t e a n d v a l u e p a i r s p e c i e d a s a t t r i b u t e = v a l u e . I n f o * E n g i n

s e l e c t s t h e r s t e l e m e n t i t n d s t h a t c o n t a i n s t n a m e d a t t r i b u t e . F o r e x a m p l e , a s s u m e t h a t t h“ n a m e ” a n d “ p h o n e ” a t t r i b u t e s . T o l o c a t e t h en a m e d “ D o y l e , ” u s e t h e f o l l o w i n g s u b s t i t u t i

$ ( g r p 1 [ n a m e = D o y l e ] p h o n e [ ] )




a t t r i b u t e _ n a m e N a m e s a n a t t r i b u t e ( c o l u m n ) t h a t e x i s t s w i t h i n t h e

I f M E T A i s s p e c i e d f o r e l e m e n t _ s e l e c t o r , t h e n o n e o f t h e f o l l o w i n ga t t r i b u t e s c a n b e s p e c i e d f o r a t t r i b u t e _ n a m e :

• C O U N T i s t h e n u m b e r o f e l e m e n t s i n t h e g r o u p . • S T A T U S i s t h e n u m e r i c s t a t u s v a l u e c u r r e n t l y a s s o c i a

s t a t u s o f 0 i n d i c a t e s s u c c e s s . A s t a t u s o f a n y t h i n g• N A M E i s t h e n a m e o f t h e g r o u p . • T Y P E i s t h e t y p e o f g r o u p . T h e g r o u p c r e a t o r m a y s e

T Y P E b u t i s n o t r e q u i r e d t o . V a l i d g r o u p t y p e s i n○ O b j e c t – T h e g r o u p c o n t a i n s d a t a . ○ S t a t u s – T h e g r o u p c o n t a i n s t h e s u c c e s s o r f a i l u r e ○ E x c e p t i o n – T h e g r o u p c o n t a i n s t h e e r r o r i n f o r m a t i o

a n e x c e p t i o n h a s o c c u r r e d . ○ U n k n o w n – T h e g r o u p c r e a t o r d i d n o t s e t t h e T Y P E

t h e g r o u p . • M E S S A G E i s t h e c u r r e n t m e s s a g e a s s o c i a t e d w i t h t h e g

m e s s a g e a s s o c i a t e d w i t h t h e g r o u p , t h e s u b s t i t u t Y o u c a n r e t r i e v e m u l t i p l e m e s s a g e s f r o m t h e M Ee x a m p l e , t o g e t a l l m e s s a g e s a s s o c i a t e d w i t h “ G rf o l l o w i n g s u b s t i t u t i o n e x p r e s s i o n :

$ ( G r p 1 2 3 [ M E T A ] M E S S A G E [ * ] )

I n a d d i t i o n , y o u c a n s p e c i f y a n y m e t a d a t a a t t r i b ua t t r i b u t e _ n a m e .




v a l u e _ s e l e c t o r I d e n t i e s t h e a t t r i b u t e v a l u e s t h a t a r e s e l e c t e d . t h e f o l l o w i n g :

• A n i n t e g e r , w h i c h i d e n t i e s a v a l u e b y i t s i n di n d e x o f 0 . T h e r e f o r e , i f a n a t t r i b u t e c o n t a i n sf r o m 0 t o 4 .

• T h e l e t t e r N , w h i c h s e l e c t s t h e l a s t v a l u e o f t h e a t t r • E m p t y , w h i c h s e l e c t s a l l v a l u e s a n d c o n c a t e

s t r i n g u s i n g n o s e p a r a t o r s . T h e e m p t y s e l e c t oo n l y o n e v a l u e .

• T h e a s t e r i s k ( “ * ” ) s y m b o l , w h i c h s e l e c t s a l l v a l u e s a t o g e t h e r i n t o a s t r i n g . C o m m a s s e p a r a t e t h e v

T h e f o l l o w i n g s u b s t i t u t i o n e x p r e s s i o n s e l e c t s i n t h e @ F O R M g r o u p a n d c o n c a t e n a t e s t h e m tc o m m a t o s e p a r a t e t h e v a l u e s :

$ ( @ F O R M [ ] X Y Z [ * ] )

T h e f o l l o w i n g s u b s t i t u t i o n e x p r e s s i o n s e l e c t s f r o m t h e e l e m e n t i n t h e U S E R S g r o u p :

$ ( U S E R S [ ] N A M E [ 0 ] )

T h e f o l l o w i n g s u b s t i t u t i o n e x p r e s s i o n s e l e c t s m e t a d a t a i n t h e O U T G R P g r o u p :

$ ( O U T G R P [ M E T A ] C O U N T [ ] )

D e f a u l t V a l u e s f o r S u b s t i t u t i o n s

T o c o v e r t h e p o s s i b i l i t y t h a t t h e e v a l u a t i o n o f a s r e t u r n n o v a l u e s , y o u s h o u l d i n c l u d e a d e f a u l t f o r b y i n c l u d i n g t h e f o l l o w i n g d e f a u l t a t t r i b u t e o n t h e p a r a m t a g : d e f a u l t = " v a l u e "

F o r e x a m p l e , t h e f o l l o w i n g p a r a m t a g s e t s t h e d e f a u l t f o r t h e A T T p a r a m e t e r t o t h e s t r i n g " * " :



S u b s t i t u t i o n E x p r e s s i o n s f o r U s eW h e n i n f o r m a t i o n m u s t b e s p e c i e d b y a u s e r r a tt h e s u b s t i t u t i o n e x p r e s s i o n s t h a t a c c e s s t h e @ F Oi n f o r m a t i o n a v a i l a b l e w i t h i n a w e b j e c t e v e n t h o ut h e t i m e t h e t e m p l a t e o r t a s k i s b e i n g d e s i g n e d .

Y o u c a n u s e s u b s t i t u t i o n e x p r e s s i o n s i n a n y d a t a p a r a m t a g .




T o s p e c i f y o n e p a r a m e t e r v a l u e a s i n p u t b y a u s e r i n aU R L , t h e p a r a m e t e r v a l u e c a n b e s i m i l a r t o t h e f o l l o wd a t a = " $ ( @ F O R M [ ] v a r i a b l e [ ] ) "

Y o u u s e @ F O R M [ ] i n t h e s e f o r m a t s b e c a u s e t h e r e i s o n l y o n e @ F O R M c o n t e x t g r o u p . T h e e m p t y v a l u e s e l e c t o r , [ ] , f o r t h e f o r m v a r i a b l e i su s e d b e c a u s e t h e r e i s o n l y o n e v a l u e e q u a t e d t o t h e v

T o s p e c i f y m u l t i p l e p a r a m e t e r v a l u e s a s i n p u t , y o u i nv a l u e s e l e c t o r . T o f o r m a t m u l t i p l e p a r a m e t e r v a l u e s i n c l u d e t h e d e l i m a t t r i b u t e t o i d e n t i f y t h e c o m m a a s t h e s e p a rt h a t i s s u b s t i t u t e d . F o r m u l t i p l e v a l u e s , t h e p a r a m e t et h e f o l l o w i n g : d a t a = " $ ( @ F O R M [ ] v a r i a b l e [ * ] ) " d e l i m = " , "

T h e a s t e r i s k i n t h e v a l u e s e l e c t o r , [ * ] , s e l e c t s a l l v a l u e s a n d c o n c a t e n at o g e t h e r i n t o a s t r i n g u s i n g t h e c o m m a a s a s e p a r a t o r d e l i m a t t r i b u t e t e l l s t h e w e b j e c t t h a t m u l t i p l e v a l u e s i n t h e d a t a a t t r i b u t e a r e s

N o t e I f t h e f o r m y o u u s e i n c l u d e s a n I N P U T e l e m e n t t h a t h l e s e l e c t f o r s e l e c t i n g l e s t o u p l o a d , a l l o f t h e f o r m v a r i a b l e p a r a m e t e r s u b s t i t u t i o n m u s t b e s e t o n t h e f o r m b e f o r e m o r e i n f o r m a t i o n , s e e U p l o a d i n g a n d D o w n l o a d i n g B L O B s o n .

E x a m p l e : D i s p l a y - O b j e c t S u b s t i t u t i o n U s i n g @

T h e f o l l o w i n g v a r i a b l e s s e t u p t h e t a b l e f o r m a t a n d a t t r i b u t e s t h a t a r e vt h e u s e r . T h e v a l u e s f o r t h e v a r i a b l e s a r e a v a i l a b l e i n a n d c a n b e r e t r i e v e d f r o m t h i s g r o u p . b o r d e r = 2 a t t = e n a m e a t t = p h o n e h e a d e r s = N a m e h e a d e r s = T e l e p h o n e

A l s o a s s u m e t h a t t h e f o l l o w i n g D i s p l a y - O b j e c t w e b j

J S P p a g e a n d d i s p l a y s a n e m p l o y e e l i s t u s i n g t h e v a r 

 




A f t e r s u b s t i t u t i o n p r o c e s s i n g b y I n f o * E n g i n e , t hf o l l o w s :

 

E x a m p l e : Q u e r y - O b j e c t s S u b s t i t u t i o n U s i n g

A s s u m e t h a t t h e f o l l o w i n g U R L h a s b e e n s u b m i t

h t t p : / / w e b S e r v e r 1 / W i n d c h i l l / s e r v l e t / I E / t a s k s / Q u e rN A M E & A T T S = E M P N O & A T T S = S A L A R

T h e n , t h e @ F O R M c o n t e x t g r o u p c o n t a i n s t h e f oC L S = E M P L O Y E E S A T T S = N A M E A T T S = E M P N O A T T S = S A L A R Y W H R = N A M E = ' & S M I T H '

A l s o a s s u m e t h a t t h e f o l l o w i n g Q u e r y - O b j e c t s wQ u e r y O b j e c t . x m l t a s k a n d q u e r i e s t h e i n f o r m a t i o n s y s t“ j d b c ” a d a p t e r u s i n g t h e v a r i a b l e s f r o m t h e U R L :

 < i e : p a r a m n a m e = " C L A S S " d a t a = " $ ( @ F O R M [ ] C L S [ 


 < i e : p a r a m n a m e = " C L A S S " d a t a = " E M P L O Y E E S " d e f 




A f t e r a l l p r o c e s s i n g i s c o m p l e t e d b y I n f o * E n g i n e , t ha r e a s f o l l o w s :

 



S u b s t i t u t i o n E x p r e s s i o n s f o r V D B G r o u p - S p e c i e d V a l u e s W h e n i n f o r m a t i o n m u s t c o m e f r o m a V D B g r o u p t h as u b s t i t u t i o n e x p r e s s i o n s t h a t a c c e s s a V D B d a t a g r o ua v a i l a b l e w i t h i n a w e b j e c t e v e n t h o u g h t h e e x a c t v a l ut a s k i s b e i n g d e s i g n e d .

N o t e T h e V D B g r o u p m u s t b e a v a i l a b l e t o t h e w e b j e c t b e f o rc a n n o t e x e c u t e t h e t a s k t h a t c r e a t e s t h e g r o u p f r o m w i

Y o u c a n u s e s u b s t i t u t i o n e x p r e s s i o n s i n a n y d a t a a t t r i b u t e v a l u e o n a p a r a m t a g .

T o s p e c i f y o n e p a r a m e t e r v a l u e t h a t i s s u b s t i t u t e d f r o p a r a m e t e r v a l u e c a n b e s i m i l a r t o t h e f o l l o w i n g : d a t a = $ ( g r p _ n a m e [ ] a t t _ n a m e [ ] )

U s e g r p _ n a m e [ ] i n t h e s e f o r m a t s w h e n t h e r e i s o n l y o n e e l eg r o u p n a m e d “ g r p _ n a m e . ” U s e a t t _ n a m e [ ] i n t h e s e f o r m a t s w h e n t h e r e o n l y o n e v a l u e i n t h e a t t _ n a m e a t t r i b u t e . I f t h e d a t a g r o u p h a s m o r ee l e m e n t , y o u c a n u s e g r p _ n a m e [ 0 ] t o a c c e s s t h e r s t e l e m e n t i n t h e ga n d u s e g r p _ n a m e [ N ] t o a c c e s s t h e l a s t e l e m e n t i n t h e g r o u p . Te l e m e n t s , y o u c a n s p e c i f y t h e i n d e x o f t h e e l e m e n t i ny o u c a n u s e 0 , N , o r o t h e r i n d i c e s i n s i d e t h e b r a c k e t s t o a c c e st h e a t t r i b u t e n a m e d b y a t t _ n a m e [ ] .

T o s p e c i f y m u l t i p l e p a r a m e t e r v a l u e s a s i n p u t , y o u i n * ) a s t h e v a l u e s e l e c t o r . T o f o r m a t m u l t i p l e p a r a m e t e r v a l i n c l u d e t h e d e l i m a t t r i b u t e t o i d e n t i f y t h e c o m m a a s t h e s e p a rt h a t i s s u b s t i t u t e d . F o r m u l t i p l e v a l u e s , t h e p a r a m e t et h e f o l l o w i n g : d a t a = $ ( g r p _ n a m e [ ] a t t _ n a m e [ * ] ) d e l i m = " , "




T h e a s t e r i s k i n t h e v a l u e s e l e c t o r , [ * ] , s e l e c t s a l l v a l u e s a n d c o n c a t o g e t h e r i n t o a s t r i n g u s i n g t h e c o m m a a s a s e p a r a d e l i m a t t r i b u t e t e l l s t w e b j e c t t h a t m u l t i p l e v a l u e s i n t h e d a t a a t t r i b u t e a r e s e p a r a t e d b y a

T h e l a s t s e t o f f o r m a t s a s s u m e s t h a t t h e r e i s o n l y I f t h e d a t a g r o u p h a s m o r e t h a n o n e e l e m e n t , y o u g r p _ n a m e [ 0 ] t o a c c e s s t h e r s t e l e m e n t i n t h e g r o u p a n d u s e g r p _ n a m e [ N ] t o a c c e s s t h e l a s te l e m e n t i n t h e g r o u p . T o a c c e s s o t h e r e l e m e n t s , yt h e e l e m e n t i n s i d e t h e b r a c k e t s .

F o r m o r e i n f o r m a t i o n , s e e G e n e r a l V a l u e S u b s t i t u t i o n S y n t a x .

E x a m p l e : C r e a t e - G r o u p S u b s t i t u t i o n U s i n g

A s s u m e t h a t t h e f o l l o w i n g t a b l e r e p r e s e n t s t h e e lh e a d i n g s ) a n d a t t r i b u t e v a l u e s ( c e l l s i n c o l u m n s )

e n a m e p h o n e B u r t o n , J a c k 8 7 3 - 2 3 0 2 L a w , G r a c i e 8 7 3 - 2 2 0 0 L o P a n , D a v i d 8 7 3 - 3 3 1 3

Y o u c a n c r e a t e a n e w g r o u p c a l l e d “ s a l e s E m p ” b c o l u m n t o t h e “ E M P ” g r o u p u s i n g s u b s t i t u t i o n i nw e b j e c t :

 < i e : p a r a m n a m e = " E L E M E N T " d a t a = " N A M E = $ ( E M P [

T E L E P H O N E = $ ( E M P [ 0 ] p h o n e [ ] ) : D E P T = S a l < i e : p a r a m n a m e = " E L E M E N T " d a t a = " N A M E = $ ( E M P [

T E L E P H O N E = $ ( E M P [ 1 ] p h o n e [ ] ) : D E P T = S a l < i e : p a r a m n a m e = " E L E M E N T " d a t a = " N A M E = $ ( E M P [

T E L E P H O N E = $ ( E M P [ 2 ] p h o n e [ ] ) : D E P T = S a l 


 

E x e c u t i n g t h e C r e a t e - G r o u p w e b j e c t c r e a t e s t h e “ s a

r e p r e s e n t e d b y t h e f o l l o w i n g t a b l e :

N A M E T E L E P H O N E D E P T B u r t o n , J a c k 8 7 3 - 2 3 0 2 S a l e s L a w , G r a c i e 8 7 3 - 2 2 0 0 S a l e s L o P a n , D a v i d 8 7 3 - 3 3 1 3 S a l e s

R e t u r n i n g M u l t i p l e V a l u e s i n S u b s tE x p r e s s i o n s U s i n g t h e a s t e r i s k ( * ) f o r t h e e l e m e n t s e l e c t o r o r f o r s u b s t i t u t i o n e x p r e s s i o n c a n r e t u r n a s t r i n g c o n t a i n i n c a n c o n t a i n :

• M u l t i p l e a t t r i b u t e v a l u e s f r o m a s i n g l e e l e m e n t a n • T h e a t t r i b u t e v a l u e s f r o m m u l t i p l e e l e m e n t s t h a t c

a t t r i b u t e .

T o u n d e r s t a n d h o w t h e s e c o m b i n a t i o n s a r e r e p r e s e n f o l l o w i n g g r a p h i c a l r e p r e s e n t a t i o n o f a g r o u p n a m e d

M u l t i p l e A t t r i b u t e V a l u e s f r o m O n e E l e m e n t

T o r e t u r n a s t r i n g c o n t a i n i n g a l l Y a t t r i b u t e v a l u e s f r o m e l e m e n t 1 ( A a n d A 1 ) , i n c l u d e t h e f o l l o w i n g d a t a a t t r i b u t e :

d a t a = " $ ( t b l [ 0 ] Y [ * ] ) "




T h e s t r i n g r e t u r n e d i s :

" A , A 1 "

N o t i c e t h a t t h e c o m m a s e p a r a t e s t h e v a l u e s . T o s p e c i f y a d i f f e r e n t s e p a r a t o r , y o u m u s t i n c l u d v a l u e S e p a r a t o r a t t r i b u t e . F o r e x a m p l e , t o r e t u r n a c o l o n - s e p a r a t e d l i s t , u s e

d a t a = " $ ( t b l [ 0 ] Y [ * ] ) " v a l u e S e p a r a t o r = " : "

T h e n , t h e s t r i n g r e t u r n e d i s :

" A : A 1 "

F i r s t A t t r i b u t e V a l u e F r o m E a c h E l e m e n t

T o r e t u r n a s t r i n g c o n t a i n i n g t h e r s t Z a t t r i b u t e v a l u e f r o m e a c h e l e 5 6 a n d

7 7 ) , i n c l u d e t h e f o l l o w i n g d a t a a t t r i b u t e : d a t a = " $ ( t b l [ * ] Z [ 0 ] ) "

B y d e f a u l t , t h e s t r i n g r e t u r n e d i s :

" 5 6 ; 7 7 ; "

N o t i c e t h a t t h e s e m i c o l o n s e p a r a t e s v a l u e s f r o m n o v a l u e f o r t h e t h i r d e l e m e n t .

T o s p e c i f y a d i f f e r e n t s e p a r a t o r , y o u m u s t i n c l u d e l e m e n t S e p a r a t o r a t t r i b u t e . F o r e x a m p l e , t o r e t u r n a p e r c e n t - s e p a r a t e d l i s t , u

d a t a = " $ ( t b l [ * ] Y [ 0 ] ) " e l e m e n t S e p a r a t o r = " % "

T h e n , t h e s t r i n g r e t u r n e d i s : " 5 6 % 7 7 % "

M u l t i p l e A t t r i b u t e V a l u e s F r o m A l l E l e m e n t s

T o r e t u r n a s t r i n g c o n t a i n i n g a l l Y a t t r i b u t e v a l u e s f r o m a l l e l e m e A , A 1 , B , B 1 , a n d C ) , i n c l u d e t h e f o l l o w i n g d a t a a t t r i b u t e :

d a t a = " $ ( t b l [ * ] Y [ * ] ) "

B y d e f a u l t , t h e s t r i n g r e t u r n e d i s :

" A , A 1 ; B , B 1 ; C "

N o t i c e t h a t t h e c o m m a s e p a r a t e s t h e v a l u e s i n o n v a l u e s f r o m d i f f e r e n t c e l l s .

T o s p e c i f y d i f f e r e n t s e p a r a t o r s , y o u m u s t i n c l u d v a l u e S e p a r a t o r a n d e l e m e n t S e p a r a t o r a t t r i b u t e s . F o r e x a m p l e , t o r e t u r n a s t r ia n d p e r c e n t s y m b o l s a s s e p a r a t o r s , u s e t h e f o l l o w

d a t a = " $ ( t b l [ * ] Y [ * ] ) " v a l u e S e p a r a t o r = " : " e l e m e n t S




T h e n , t h e s t r i n g r e t u r n e d i s :

" A : A 1 % B : B 1 % C "

S e l e c t i n g a n E l e m e n t b y a n A t t r i b u tS u b s t i t u t i o n E x p r e s s i o n s U s i n g a n a t t r i b u t e – v a l u e p a i r f o r t h e e l e m e n t s e l e c t o p r o v i d e s a w a y t o s e l e c t a n e l e m e n t w i t h o u t k n o w i n ge l e m e n t .

T o u n d e r s t a n d h o w t h e s e l e c t i o n s w o r k s , c o n s i d e r t hr e p r e s e n t a t i o n o f a g r o u p n a m e d “ t b l ” :

E l e m e n t S e l e c t i o n

T o r e t u r n a s t r i n g c o n t a i n i n g a l l Y a t t r i b u t e v a l u e s f r o m t h e e l e m e n t w X = 2 2 1 , i n c l u d e t h e f o l l o w i n g d a t a a t t r i b u t e :

d a t a = " $ ( t b l [ X = 2 2 1 ] Y [ * ] ) "

T h e X a t t r i b u t e v a l u e o f 2 2 1 i s l o c a t e d i n e l e m e n t n u m b e r 2 , t h e r e Y a t t r i b u t e v a l u e s r e t u r n e d i n t h e s t r i n g a r e :

" B , B 1 "

B y d e f a u l t , t h e c o m m a s e p a r a t e s t h e v a l u e s .

U p l o a d i n g a n d D o w n l o a d i n gB L O B s a r e B i n a r y L a r g e O b j e c t s . A B L O B c a n b e a ns u c h a s a W o r d d o c u m e n t , a p i c t u r e , o r s o u n d l e .




Y o u c a n u s e H T M L f o r m s a n d s p e c i a l a d a p t e r w a w e b b r o w s e r t o a d a t a b a s e , a n d d o w n l o a d B L O b r o w s e r . T h e f o l l o w i n g s e c t i o n s d i s c u s s t h e u s e e x a m p l e s f o r u p l o a d i n g a n d d o w n l o a d i n g B L O BF o r a d d i t i o n a l i n f o r m a t i o n o n t h e a d a p t e r w e b j e B L O B s , s e e t h e a p p r o p r i a t e a d a p t e r g u i d e .

F o r a d v a n c e d u s e r s , I n f o * E n g i n e a l s o p r o v i d e s m s e t O u t p u t S t r e a , s e t I n p u t S t r e a m , a n d s e n d C o n t e n t t h a t c a n m a n i p u l a t e B L O B s a l a n g u a g e p r o v i d e s c l a s s e s s u c h a s j a v a . i o . B y t e A r r a y I n p u t S a n d j a v a . i o . B y t e A r r a y O u t p u t S t r e a m t o r e a d o r w r i t e B L O B s t o m e m o r y .

N o t e

T h e f o l l o w i n g e x a m p l e s i n c l u d e J D B C a d a p t e r w T h e s e a r e s i m p l e e x a m p l e s , a n d d o n o t h i n g t o p r e t o p r o t e c t d a t a b a s e c o n t e n t f r o m m a l i c i o u s u s e r s p r e c a u t i o n s t o v a l i d a t e u s e r i n p u t t o p r o t e c t a g a i nS u c h a t t a c k s m a y a t t e m p t t o e x p l o i t t a s k s u s i n g S m a l f o r m e d p a r a m e t e r v a l u e s , w h i c h c a n c a u s e d at o p r o t e c t e d d a t a .

U s i n g F o r m V a r i a b l e s W h e n U p l oT o u p l o a d B L O B s , t h e H T M L f o r m e l e m e n t o n yf o l l o w i n g a t t r i b u t e s : m e t h o d = " P O S T " a c t i o n = " t a s k _ t o _ e x e c u t e " e n c t y p e = " m u l t i p a r t / f o r m - d a t a "

T h e s e a t t r i b u t e s e s t a b l i s h t h e e n v i r o n m e n t r e q u is t o r i n g t h e f o r m v a r i a b l e s .

T o u n d e r s t a n d h o w t o u s e f o r m v a r i a b l e s a n d h o wh e l p f u l t o k n o w h o w t h e w e b b r o w s e r , I n f o * E n g t o t r a n s f e r B L O B d a t a f r o m t h e b r o w s e r t o a d a t a i d e n t i f y t h e m a j o r s t e p s t h a t o c c u r w h e n a f o r m i s

• T h e b r o w s e r s e n d s t h e f o r m v a r i a b l e s a n d l e dt h e w e b s e r v e r t o t h e I n f o * E n g i n e s e r v l e t .

• T o m a i n t a i n t h e o p t i m u m p e r f o r m a n c e , t h e I n I n f o * E n g i n e s e r v e r p r o c e s s t h e s t r e a m a s i t i s r s t o r i n g t h e e n t i r e s t r e a m b e f o r e d o i n g a n y t h i n g

• T h e s e r v l e t r e a d s a n y f o r m v a r i a b l e s s t o r e d a t ta n d s t o r e s t h e m i n t h e @ F O R M c o n t e x t g r o u p e n c o u n t e r e d .




• W h e n a B L O B i s e n c o u n t e r e d , t h e I n f o * E n g i n e s ea n d p a s s e s t h e B L O B d a t a o n t o i t s o u t p u t s t r e a m s oo n t o t h e I n f o * E n g i n e s e r v e r .

• B y e x e c u t i n g t h e t a s k t h a t i s i d e n t i e d i n t h e H T M a c t i o n a t t r i b u t e , t h e I n f o * E n g i n e s e r v e r c o n n e c t s t o a n a d a p t e r a n d t h e a d a p t e r .

• B y e x e c u t i n g t h e w e b j e c t i n t h e t a s k , t h e a d a p t e r t ha n d s e n d s t h e B L O B t o t h e d a t a b a s e .

T h e f o l l o w i n g e x a m p l e c o d e c o n t a i n s e x p l a n a t o r y t e l e t o s t o r e i n t h e c o l u m n o f a d a t a b a s e r o w . T h i s e x a

t o a n I n f o * E n g i n e t a s k u s i n g t h e I n f o * E n g i n e s e r v l e t h e X M L o u t p u t f r o m t a s k e x e c u t i o n u p o n c l i c k i n g “

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " .

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b /< h t m l > < h e a d > < t i t l e > U p l o a d F i l e < / t i t l e > < / h e a d > T h i s p a g e p r o m p t s f o r a " n a m e " a n d " f i l e " t o s t o r e i n a n T h e " n a m e " i s u s e d t o s e l e c t a r o w i n t h e t a b l e . T h e v a l u" n a m e " a n d t h e " f i l e " c o n t e n t s a r e s t o r e d i n c o l u m n s i n T h e t a b l e m u s t b e c r e a t e d b e f o r e t h i s e x a m p l e i s r u n . T hu s i n g a S Q L s t a t e m e n t l i k e ' C R E A T E T A B L E B L O B T E S T ( N< h 2 > U p l o a d F i l e t o O r a c l e B L O B C o l u m n < / h 2 > < f o r m m e t h o d = " P O S T " a c t i o n = " / W i n d c h i l l / s e r v l e t / I E / t a

e n c t y p e = " m u l t i p a r t / f o r m - d a t a " > < T A B L E >

< t r > < t d a l i g n = r i g h t > < F O N T F A C E = a r i a l , h e l v e t i c a > A d a p t e r I n s t a n c e :

< / t d > < t d >

 < / t d >

< / t r > < t r > < t d a l i g n = r i g h t >

 < F O N T F A C E = a r i a l , h e l v e t i c a > N a m e : < / t d > < t d >

 < / t d >


 < F O N T F A C E = a r i a l , h e l v e t i c a > F i l e : < / t d >




< t d > 

< / t d >




< / t r > < / T A B L E > < / f o r m > < / h t m l >

T h e l e s e l e c t c o n t r o l d i s p l a y e d t h r o u g h t h e t h i r dt h e v e h i c l e f r o m w h i c h t h e u s e r s e l e c t s t h e l e t o ui s c r e a t e d , t h e B L O B d a t a i n t h e l e s e l e c t e d i s s t v a r i a b l e s s e t f r o m t h e r s t t w o I N P U T e l e m e n t s .

T h e U p l o a d B l o b . x m l t a s k i d e n t i e d i n t h e a c t i o n a t t r i b u t e o f t h e f o r m i s t h e t a s k t h a t t h e I n f o * E n g i n e s e r v e r e x e c u t e s . t h e n e x t s e c t i o n ) u s e s t h e f o r m v a r i a b l e s t o i d e n t it h e n a m e t h a t c o r r e s p o n d s t o t h e B L O B i n t h e t a b

T o e n s u r e t h a t I n f o * E n g i n e s t o r e s t h e f o r m v a r i a v a r i a b l e s m u s t b e s e t i n I N P U T e l e m e n t s t h a t a r es e l e c t s t h e B L O B l e ( a s i s d o n e t h e p r e v i o u s e x ae l e m e n t s w a s r e v e r s e d i n t h e p r e v i o u s e x a m p l e , t a s k w o u l d n o t b e s t o r e d i n t h e @ F O R M c o n t e x t a p p e a r i n t h e s t r e a m u n t i l a f t e r t h e B L O B d a t a . A a f t e r a B L O B a r e l o s t b e c a u s e t h e s e r v e r d o e s n o t r a n s f e r r i n g i t o n t o t h e a d a p t e r . I n s t e a d , t h e s e r v t o t h e a d a p t e r w i t h o u t r s t b u f f e r i n g t h e e n t i r e t h p e r f o r m a n c e a n d a l l o w s v e r y l a r g e l e s t o b e s e n e n o r m o u s a m o u n t s o f s y s t e m m e m o r y .

C o n t r o l l i n g W h i c h W e b j e c t s G e t W h e n B L O B s a r e u p l o a d e d t o I n f o * E n g i n e f r o m a p p l i c a t i o n , I n f o * E n g i n e c a n n o t d e t e r m i n e w h i t h e B L O B s o r h o w m a n y B L O B s e a c h w e b j e c t s hI n f o * E n g i n e a t t e m p t s t o d e l i v e r a l l a v a i l a b l e B L

( a n y w e b j e c t w i t h a t y p e o f A C T o r O B J ) . S o m e t i m e s , t h e r s t a d a p tn o t a w e b j e c t t h a t c o n s u m e s B L O B s , s o t h e d e f a un o t a l w a y s a p p r o p r i a t e .

T o c o n t r o l h o w B L O B s a r e c o n s u m e d b y w e b j e cB L O B _ C O U N T p a r a m e t e r o n a n y a d a p t e r w e b j m a n y B L O B s s h o u l d b e d e l i v e r e d t o t h e a d a p t e r v a l u e o f 0 w h e n n o B L O B s s h o u l d b e d e l i v e r e d t o t h eB L O B _ C O U N T p a r a m e t e r , a l l r e m a i n i n g B L O B




T h e f o l l o w i n g U p l o a d B l o b . x m l e x a m p l e t a s k c o n t a i n s t h r e e a d a p T h e r s t t w o w e b j e c t s ( D o - S q l ) d e l e t e a n d a d d r o w s tn o t u s e B L O B s . O n t h e s e w e b j e c t s , t h e B L O B _ C O U 0 . T h e t h i r d w e b j e c t ( P u t - B l o b - S t r e a m ) i s t h e w e b j e c t th a s b e e n d e n e d t o a c c e p t o n e B L O B . T h e v a l u e s f o ru s e d i n t h e p a r a m e t e r s f o r t h e w e b j e c t s c a n b e s u p p l if o r m d e s c r i b e d i n t h e p r e v i o u s s e c t i o n .

N o t e Y o u m u s t s e t t h e B L O B _ C O U N T p a r a m e t e r t o 0 f o r e v e r y w e b j e c t e x c e p t f o r w e b j e c t y o u w a n t t h e B L O B S t o b e d e l i v e r e d t o .

T h e e x a m p l e t a s k a s s u m e s t h a t t h e d a t a b a s e t a b l e c o n

• T h e N A M E c o l u m n c o n t a i n s t h e n a m e o f t h e B L O

• T h e F I L E C O N T E N T c o l u m n c o n t a i n s t h e B L O B T h e c o d e f o r t h e e x a m p l e t a s k i s a s f o l l o w s :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % >

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l ip r e f i x = " i e " % >

< ! - - U p l o a d a f i l e f r o m t h e b r o w s e r a n d s a v e i n a n o r a c l e b l o b c o l u m n .

- - / >

 

 



 

 










 



U s i n g F o r m V a r i a b l e s f o r D o w n l o

T h e f o l l o w i n g e x a m p l e c o d e p r o d u c e s e x p l a n a t oa r o w f r o m a d a t a b a s e t a b l e c o n t a i n i n g a B L O B . I n f o * E n g i n e t a s k t h a t s e l e c t s t h e c o r r e s p o n d i n g r e t u r n s t h e B L O B i t c o n t a i n s :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t< h t m l > < h e a d > < t i t l e > S e n d B l o b < / t i t l e > < / h e a d > 

 T h i s p a g e p r o m p t s f o r a " n a m e " o f t h e B L O B f i ld a t a b a s e a n d a " M I M E t y p e " t o a s s o c i a t e w i t h t h e B" n a m e " i s u s e d t o s e l e c t a r o w i n t h e t a b l e w h e r e ts t o r e d . T h e t a b l e m u s t b e c r e a t e d a n d B L O B s u p l o at h e t a b l e b e f o r e t h i s e x a m p l e i s r u n . T h e t a b l e c o u

c r e a t e d u s i n g a S Q L s t a t e m e n t l i k e ' C R E A T E T A B L( N A M E V A R C H A R ( 6 0 ) , F I L E C O N T E N T B L O B ) ' .

< H 2 > D o w n l o a d F i l e f r o m B L O B C o l u m n < / H 2 > T h e M I M E t y p e d e t e r m i n e s w h i c h a p p l i c a t i o n i sr e c e i v e d . T h e M I M E t y p e i s n o t s t o r e d i n t h e t a b l f o l l o w i n g M I M E t y p e s :

 ' t e x t / p l a i n ' ' a p p l i c a t i o n / m s w o r d ' ' a p p l i c a t i o n / m s e x c e l ' ' a p p l i c a t i o n / v n d . m s - e x c e l ' ' i m a g e / g i f ' 

 I n c l u d e t h e s i n g l e q u o t e s i n y o u r M I M E T y p e e

< f o r m m e t h o d = " P O S T " a c t i o n = " / W i n d c h i l l / s e r v l e t




e n c t y p e = " m u l t i p a r t / f o r m - d a t a " > < T A B L E > < t r > < t d a l i g n = r i g h t >

 < F O N T F A C E = a r i a l , h e l v e t i c a > A d a p t e r I n s t a n c e

< / t d > < t d >

 < / t d >


 < F O N T F A C E = a r i a l , h e l v e t i c a > N a m e : < / t d > < t d >

 < / t d >


 < F O N T F A C E = a r i a l , h e l v e t i c a > M i m e T y p e : < / t d > < t d >

 < / t d >




< / t r > < / T A B L E > < / f o r m > < / h t m l >

T h e D o w n l o a d B l o b . x m l t a s k i d e n t i e d i n t h e a c t i o n a t t r i b u t e o f t h e f o r m e l e m e n t i s t h e t a s k t h a t t h e I n f o * E n g i n e s e r v e r e x e c uT h i s t a s k ( w h i c h i s d e s c r i b e d i n t h e n e x t s e c t i o n ) u s et h e a d a p t e r i n s t a n c e , s p e c i f y t h e n a m e t h a t c o r r e s p o nr o w w h e r e t h e B L O B i s s t o r e d , a n d s e t t h e M I M E t y p

E x a m p l e : B L O B D o w n l o a d T a s k

T h e f o l l o w i n g D o w n l o a d B l o b . x m l e x a m p l e t a s k c o n t a i n s o n e a d a p T h i s w e b j e c t d o w n l o a d s o n e B L O B t o t h e w e b b r o w i n t h e M I M E T Y P E p a r a m e t e r i s p a s s e d b a c k t o t h e b a p p l i c a t i o n t h e b r o w s e r l a u n c h e s t o d i s p l a y t h e B L O v a r i a b l e s u s e d i n t h e p a r a m e t e r s f o r t h e w e b j e c t c a n bl i k e t h e f o r m u s e d i n t h e p r e v i o u s s e c t i o n .

T h e e x a m p l e t a s k a s s u m e s t h a t t h e d a t a b a s e t a b l e c o n

• T h e N A M E c o l u m n c o n t a i n s t h e n a m e o f t h e B L O • T h e F I L E C O N T E N T c o l u m n c o n t a i n s t h e B L O B





< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / tp r e f i x = " i e " % >

< ! - - P o s s i b l e M I M E T y p e s

a p p l i c a t i o n / m s w o r d t e x t / p l a i n a p p l i c a t i o n / m s e x c e l a p p l i c a t i o n / v n d . m s - e x c e l

- - / >

< i e : w e b j e c t n a m e = " S e n d - B l o b - S t r e a m " t y p e = " O B J " < i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " F I L E C O N T E N 



E x a m p l e F e d e r a t e d S e a r c hT h i s i s a b a s i c f e d e r a t e d I n f o * E n g i n e a p p l i c a t i o d o a s i m u l t a n e o u s b a s i c s e a r c h f o r p a r t s b y p a r t ni n f o r m a t i o n s y s t e m s ( r e a d - o n l y ) .

T h e f o l l o w i n g a c t i o n s a r e a l l o w e d i n t h i s e x a m p

• Q u e r y — S e a r c h a g i v e n r e p o s i t o r y f o r p a r t s . • F e t c h — F e t c h a s i n g l e p a r t f r o m a g i v e n r e p o s • D o w n l o a d — D o w n l o a d t h e p r i m a r y c o n t e n t o

T h i s e x a m p l e c a n b e l o c a t e d i n y o u r W i n d c h i l l i n< W i n d c h i l l > / p r o g _ e x a m p l e s / f e d e r a t i o n / s e a r

F o r a n i n - d e p t h d e s c r i p t i o n o f t h e e x a m p l e , o p e n R e a d M e l e t h a t i s i n c l u d

w i t h t h i s e x a m p l e i n t h e d o c s u b d i r e c t o r y .






3 I n f o * E n g i n e J S

A u t h o r i n g I n f o * E n g i n e J a v a S e r v e r P a g e s . . . . . . . . . . . . . . . . . . . I n f o * E n g i n e C u s t o m T a g s a n d J S P P a g e s . . . . . . . . . . . . . . . . . . . . A d a p t e r W e b j e c t s a n d J S P P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . T a s k W e b j e c t s a n d J S P P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D i s p l a y W e b j e c t s a n d J S P P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .M u l t i p l e W e b j e c t E x e c u t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .S u c c e s s a n d F a i l u r e P r o c e s s i n g f o r W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . C a t c h i n g E x c e p t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

T h e f o l l o w i n g t o p i c s i n t r o d u c e t h e c o n c e p t o f a nd e s c r i b e h o w t o u s e I n f o * E n g i n e c u s t o m t a g s .

5 9



A u t h o r i n g I n f o * E n g i n e J a v a J a v a S e r v e r P a g e s ( J S P ) i s a c o r e t e c h n o l o g y o f t h e J a

E d i t i o n ( J a v a E E ) a n d s o l u t i o n s b a s e d u p o n E J B ( E nI n f o * E n g i n e s u p p o r t s t h e d e v e l o p m e n t o f e n t e r p r i s e p r o v i d e s a J S P p r o c e s s o r a s a n e x t e n s i o n o f t h e I n f o *J S P p r o c e s s o r d y n a m i c a l l y t r a n s l a t e s J S P p a g e s i n t o

U s u a l l y , a J S P p a g e i s a n H T M L p a g e w i t h s o m e a d d e m b e d d e d J a v a c o d e . H o w e v e r , i n c l u s i o n o f J S P t a gm a n d a t o r y , s o a p a g e c o n t a i n i n g o n l y H T M L i s a l e g

J S P p a g e s t h a t i n t e r a c t w i t h I n f o * E n g i n e u s u a l l y c o J S P t a g s a n d a s e t o f c u s t o m I n f o * E n g i n e t a g s t h a t d ea r e t h e n e x e c u t e d w h e n t h e p a g e i s a c c e s s e d . F o r e x D i s p l a y T a b l e . j s p p a g e c r e a t e s a g r o u p c o n t a i n i n g o n e e l e t h e t a b l e - f o r m a t t e d r e s u l t s :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " I E E r r o r . j s p " % >

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i

< h t m l > < h e a d > < t i t l e > J S P D i s p l a y - T a b l e < / t i t l e > < / h e a d >

 < h 3 > I * E D i s p l a y - T a b l e J S P U s i n g T a g l i b s < h 3 >

 < i e : p a r a m n a m e = " E L E M E N T "

d a t a = " n a m e = m y G r o u p 2 : e m a i l = x x x @ x x x . c o m : a d d r e s s 





 < / h t m l >




C a u t i o n D u e t o t h e u p g r a d e t o t h e l a t e s t J S P s p e c i c a t i o n , s u b s t i t u t i o n s y n t a x c a n n o l o n g e r u s e t h e

$ { . . . } s y n t a x . I n f o * E n g i n e n

s u p p o r t s a n a l t e r n a t e s y n t a x , $ ( . . . ) t h a t m u s t b e u s e d i n s t e a d . A lt a s k s n o w f u n c t i o n w i t h e i t h e r a s y n t a x o f $ ( . . . ) o r $ { . . . } . P r e e x i s t i n g t a s k s c o n t i n u e t o f u n c t i o n a s i s a n d d o n o t h a v e t o m u s t b e u p d a t e d t o u s e t h e n e w $ ( . . . ) s y n t a x o r t h e y f a i l t o c o m p i n o t f u n c t i o n a s e x p e c t e d .

F o r m o r e i n f o r m a t i o n , s e e U s i n g t h e I n f o * E n g i n e T a s k E d i t o .

S t o r i n g I n f o * E n g i n e J S P P a g e s T h e r o o t o f t h e W i n d c h i l l w e b a p p l i c a t i o n i s < W i n d c h i l l > / c o d e b a s e , a n d t h e r e f o r e a l l I n f o * E n g i n e J S P s m u s t b e s t o r e d s od i r e c t o r y . I d e a l l y , y o u s h o u l d c r e a t e a d i r e c t o r y s u c h a s < W i n d c h i l l > / c o d e b a s e / c o m / c o m p a n y / .

A c c e s s i n g I n f o * E n g i n e J S P P a g eT h e i n s t a l l e r a l s o s p e c i e s a n a p p l i c a t i o n U R L t hr e q u e s t i n g I n f o * E n g i n e J S P p a g e s . Y o u c a n p r o r e q u e s t t o e x e c u t e I n f o * E n g i n e J S P p a g e s b y d o i

• I n c l u d e t h e h o s t n a m e a n d p o r t ( i f t h e p o r t i s n a p p l i c a t i o n U R L p r e x s p e c i e d w h e n I n f o * E na p p l i c a t i o n U R L i s “ W i n d c h i l l . ”

• N a m e t h e p a t h f o r t h e J S P p a g e t h a t i s r e l a t i v e c o d e b a s e d i r e c t o r y . • S p e c i f y a n y o p t i o n a l v a l u e s t o p a s s t o t h e p a g e

T h e r e f o r e , t o e x e c u t e t h e c o m / c o m p a n y / D i s p l a y T a b l e . j p a g e u s i n g t h e “ m y S e r v e r ” h o s t n a m e a n d t h e “ W i n d c h i l l ” af o l l o w i n g U R L : h t t p : / / m y S e r v e r / W i n d c h i l l / c o m / c o m p a n

T h e o u t p u t d i s p l a y e d i n t h e b r o w s e r i s s i m i l a r t o

U s u a l l y , a w e b s e r v e r s u p p o r t i n g J S P i s c o n g u r en a m e w i t h t h e . j s p e x t e n s i o n a s a J S P p a g e . W h e n a U R Lo f l e , t h e w e b s e r v e r p a s s e s t h e U R L t o i t s J S P p t h e n c h e c k s t o s e e i f i t a l r e a d y h a s a s e r v l e t f o r t h

I n f o * E n g i n e J S P P a g e s 6 1



t r a n s l a t e s t h e p a g e t o a s e r v l e t a n d t h e n e x e c u t e s t h a to n l y H T M L , t h e g e n e r a t e d s e r v l e t i s t r i v i a l a n d c o n s s t a t e m e n t s t h a t s i m p l y s e n d t h e H T M L t o t h e b r o w s eJ S P p a g e c o n t a i n s s o m e e m b e d d e d J a v a c o d e , t h a t c o d e i s i n c t e d d i r e c t l y i n t o t h e s e r v l e t t h a t i s g e n e r a t e d .

I f t h e J S P p r o c e s s o r d e t e c t s t h a t i t a l r e a d y h a s a s e r v l p a s s e d t o i t , t h e n i t c h e c k s t o s e e i f t h e p a g e h a s b e e n t h a t t h e s e r v l e t w a s g e n e r a t e d . I f i t d e t e c t s t h a t t h e p at h e l a s t s e r v l e t g e n e r a t i o n , i t a u t o m a t i c a l l y r e g e n e r a r e u s e s t h e p r e v i o u s l y g e n e r a t e d s e r v l e t .

C r e a t i n g I n f o * E n g i n e J S P P a g e s E a c h I n f o * E n g i n e J S P p a g e s h o u l d c o n t a i n t h e f o l l o

• T h e s t a n d a r d J S P p a g e d i r e c t i v e , w h i c h d e n e s t h e g e n e r a l pc h a r a c t e r i s t i c s .

• T h e s t a n d a r d J S P t a g l i b d i r e c t i v e , w h i c h i d e n t i e s a t a g l i b r aI n f o * E n g i n e c u s t o m t a g s .

Y o u m u s t p u t t h i s d i r e c t i v e b e f o r e a n y l i n e s t h a t u sl i b r a r y .

• I n f o * E n g i n e c u s t o m t a g s , w h i c h p r o v i d e a c c e s s t oe n c a p s u l a t e r e c u r r i n g f u n c t i o n a l i t y .

T h e c u s t o m t a g s p r o v i d e t h e s y n t a x f o r e x e c u t i n g w

s t r u c t u r e a r o u n d w h i c h y o u c a n b u i l d a J S P . T o b e w e l l - f o r m e d a n d v a l i d , t h e I n f o * E n g i n e J S P p r u l e s :

• F o r I n f o * E n g i n e c u s t o m t a g s a n d J S P t a g s , y o u m e x a m p l e , y o u m u s t s p e c i f y t h e w e b j e c t t a g a s “ w e b j e c t ” a n d n o t “ W E o r “ W e b j e c t ” o r e v e n “ w e b J e c T ” .

• Y o u c a n u s e c o m m e n t s t o d o c u m e n t w h a t i s h a p p ec a u s e t h e c o m p i l e r t o s k i p a s e c t i o n o f t h e p a g e . I f aa c o m m e n t , i t i s n o t e x e c u t e d . C o m m e n t s c a n b e l oe x c e p t w i t h i n t a g s , d e c l a r a t i o n s , o r o t h e r c o m m e n

C o m m e n t s b e g i n w i t h < ! - - a n d e n d w i t h - - > . • E m p t y e l e m e n t s m u s t b e p r o p e r l y c o n s t r u c t e d . T h / > c h a r a c t e r s ( t h e

f o r w a r d s l a s h f o l l o w e d b y t h e r i g h t a n g l e b r a c k e t ) t h a t t h e e l e m e n t i s e m p t y a n d n o m a t c h i n g e n d t a g e x a m p l e , t h e p a r a m c u s t o m t a g s m a k e u s e o f t h e e m p t y e l e m

• A d d i t i o n a l g e n e r a l r u l e s f o r u s i n g s c r i p t l e t s , e x p r d i r e c t i v e s , a n d I n f o * E n g i n e c u s t o m t a g e l e m e n t s I n f o * E n g i n e C u s t o m T a g R e f e r e n c e o n p a g e 2 3 3 .




T h e e x a m p l e D i s p l a y T a b l e . j s p p a g e i n c l u d e s t h e f o l l o w i n g d i r e c t i v e s :

• I E E r r o r . j s p a s t h e s t a n d a r d p a g e d i r e c t i v e . I t c o n t e x a m p l e e r r o r p a g e :


• T h e i e p r e x a s t h e r e q u i r e d p r e x . T h e p r e x i d e nt o t h e c o r e t a g l i b r a r y , w h i c h p r o v i d e s t h e g e n eu s e d i n a J S P p a g e :

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e p r e f i x = " i e " % >

T h e p r e v i o u s D i s p l a y T a b l e . j s p p a g e a l s o i n c l u d e s t h e w e b j e c t a n d p a r a m

c u s t o m t a g s : • T h e w e b j e c t t a g s i d e n t i f y t h e C r e a t e - G r o u p a n d D i s p• T h e p a r a m t a g s s u p p l y w e b j e c t p a r a m e t e r s a n d p a r a

F o r t h e C r e a t e - G r o u p w e b j e c t , t h e p a r a m e t e r s g r o u p a n d t h e a t t r i b u t e s a n d v a l u e s o f e l e m e n t s

A n I n f o * E n g i n e J S P p a g e c a n a l s o c o n t a i n a n y s T h i s g u i d e d o e s n o t d e s c r i b e t h e H T M L a n d J S P t h e s u p p o r t e d t a g s , y o u c a n a c c e s s t h e f o l l o w i n g

h t t p : / / j a v a . s u n . c o m

h t t p : / / w w w . w 3 . o r g /

E x e c u t i n g T a s k s f r o m J S P P a g e sA l t h o u g h y o u c a n i n c l u d e a n y w e b j e c t i n a J S P p t h e w e b j e c t s t h a t g e n e r a t e a n d m a n i p u l a t e d a t a f ri s d o n e b y c r e a t i n g t e x t - b a s e d d o c u m e n t s c a l l e d t a s k s t h r o u g h t h e I n f o * E n g i n e t a s k t a g . T h e u r i a t t r i b u t e o n t h e t a s k t a g n a m e s t h e t a s k t o e x e c u t e .

I n f o * E n g i n e T a s k s o n p a g e 8 1 d e s c r i b e s h o w t o c r e a t e a n d u s e t


http://www.w3.org/

http://java.sun.com/



S p e c i f y i n g U R I s a n d U R L s I n f o * E n g i n e p a r a m e t e r s c a n r e q u i r e t h a t y o u s p e c i f y

T h e f o l l o w i n g s e c t i o n s i d e n t i f y t h e f o r m a t s y o u c a n uN o t e T h e U R I s a n d U R L s s h o w n i n t h i s g u i d e u s e t h e f o r w a( / ) i n l e p a t h s e v e n t h o u g h t h e b a c k s l a s h ( \ ) i s t h e d i r eW i n d o w s s y s t e m s . I n f o * E n g i n e c o r r e c t l y i d e n t i e s a l y o u s p e c i f y t h e f o r w a r d s l a s h . Y o u s h o u l d o n l y u s e a b b a c k s l a s h i s b e i n g u s e d o u t s i d e o f t h e c o n t e x t o f u s e a

F i l e E n t r i e s S o m e c u s t o m t a g s r e q u i r e t h a t y o u e n t e r s p e c i c p a r a l e s a n d s o m e w e b j e c t s r e q u i r e t h a t y o u e n t e r s p e c i c

U R L s t o l e s . I n b o t h c a s e s , y o u a r e e n t e r i n g t h e l o c ad e n e d b y t h e t a g o r w e b j e c t . T h e U R I o r U R L c a n b e

• R e l a t i v e U R I s a n d U R L s r e f e r e n c e l e s t h a t r e s i d ed i r e c t o r y t h a t i s d e n e d f o r t h e l o c a l I n f o * E n g i n e t

• A b s o l u t e U R I s a n d U R L s r e f e r e n c e l e s t h a t r e s i d r e s i d e o n a r e m o t e H T T P s e r v e r , o r a r e r e f e r e n c e d td i r e c t o r y .

A b s o l u t e l e r e f e r e n c e s c a n b e g r o u p e d a s f o l l o w s :

• R e f e r e n c e s s t a r t i n g w i t h f i l e : / / / a r e t o t h e l o c a l l e s y s t e m . W h s p e c i f y i n g d r i v e l e t t e r s , i t i s g o o d p r a c t i c e t o u s e a ld r i v e l e t t e r s . A l t h o u g h W i n d o w s s y s t e m s r e c o g n il o w e r c a s e l e t t e r s a s t h e s a m e d r i v e , I n f o * E n g i n e dr e f e r e n c e s i n w h i c h o n l y t h e c a s e o f t h e d r i v e l e t t e r l e r e f e r e n c e .

• R e f e r e n c e s s t a r t i n g w i t h h t t p : / / i d e n t i f y l e s o n a r e m o t e s y s t e m

• R e f e r e n c e s s t a r t i n g w i t h l d a p : / / i d e n t i f y t a s k s t h a t a r e s t o r e d i n ao f L D A P e n t r i e s .

T h e g e n e r a l f o r m a t o f a n L D A P U R L i s :

l d a p : / / h o s t n a m e : p o r t / s e a r c h _ b a s e ? a t t r i b u tT o s p e c i f y a n L D A P U R L , r e p l a c e e a c h p a r t o f t h e v a l u e : ○ h o s t n a m e : p o r t l o c a t e s t h e L D A P d i r e c t o r y s e r v e r . T h

o m i t t e d w h e n t h e s e r v e r a n s w e r s o n t h e d e f a u l t L3 8 9 .




○ s e a r c h _ b a s e i s t h e d i s t i n g u i s h e d n a m e i d e n t i f y i nr o o t o f t h e s u b t r e e t h a t i s t o b e s e a r c h e d .

○

a t t r i b u t e _ n a m e s i s a c o m m a - s e p a r a t e d l i s t o f t h e ar e t u r n e d f r o m t h e s e l e c t e d d i r e c t o r y e n t r i e s . r e t u r n e d .

○ s c o p e d e t e r m i n e s t h e s c o p e o f t h e s e a r c h . V a l i d

S U B — f o r a s u b t r e e s e a r c h .

O N E — f o r a s i n g l e - l e v e l s e a r c h .

B A S E — t o s e a r c h o n l y t h e e n t r y i d e n t i e d b

B y d e f a u l t , t h e s c o p e i s s e t t o B A S E . ○ f i l t e r d e n e s t h e s e a r c h l t e r . B y d e f a u l t , a l l e n

T o l o c a t e a n L D A P e n t r y c o n t a i n i n g a t a s k , y o u ca t t r i b u t e s f r o m t h e f o r m a t . Y o u s p e c i f y t h e d i s t i nc o n t a i n i n g t h e t a s k a n d t h e a t t r i b u t e n a m e o f t h e i s s t o r e d .

L D A P S e a r c h B a s e E n t r i e s I n o t h e r c a s e s , s u c h a s s o m e o f t h e t a g s i n t h e d i r er e q u i r e d t o e n t e r a n L D A P U R L t h a t i d e n t i e s a st h e f o r m a t l i s t e d a b o v e , t h i s t y p e o f e n t r y u s e s o n s e a r c h _ b a s e a t t r i b u t e :

l d a p : / / h o s t n a m e : p o r t / s e a r c h _ b a s e

E x a m p l e F i l e L o c a t i o n s E x a m p l e U R I l o c a t i o n s o f a t a s k 1 . x m l t a s k l e a r e a s f o l l o w s :

• A s s u m e t h a t t h e l e r e s i d e s i n t h e C : \ p t c \ W i n d c h i l l \ t a s k s \ i n f o e n g i n e \ j d d i r e c t o r y a n d t h aC : \ p t c \ W i n d c h i l l \ t a s k s i s t h e r o o t l e d i r e c t o r y o f t h e p r o c e s s o r . T h e n u s e t h e f o l l o w i n g r e l a t i v e U R

u r i = " i n f o e n g i n e / j d b c / t a s k 1 . x m l "

• A s s u m e t h a t t h e l e r e s i d e s o n t h e l o c a l l e s y D : \ i e \ j d b c d i r e c t o r y . T h e n u s e t h e f o l l o w i n g a b s o l e :

u r i = " f i l e : / / / D : / i e / j d b c / t a s k 1 . x m l "




• A s s u m e t h a t t h e l e r e s i d e s i n t h e o p t / p t c / W i n d c h i l l / i n f o e n g i n e / t a s k s / j d b c d i r e c t o r y o n t h e s v r 2 r e m o t e h o s t . T h e n u s e t h e f o l l o w i n g a b s o l u t e

u r i = " h t t p : / / s v r 2 / o p t / p t c / W i n d c h i l l / i n f o e n g i n e / t a s k

• A s s u m e t h a t t h e t a s k r e s i d e s i n a n L D A P s e r v e r o n t h e c n = I E t a s k s n o d e a n d t h a t t h e n a m e o f t h e a t t r i b u t e w h e r e t h e t a s k i sp t c C o m m a n d D e l e g a t e C o d e . A l s o a s s u m e t h a t t h e s e r v e r h o s ts r v 3 a n d t h e d c a t t r i b u t e s a r e m y H o s t a n d c o m . T h e n u s e t h e f o l l o w i n g a b s o l u t e U R I t o l o c a t e t h e t a s k :

u r i = " l d a p : / / s r v 3 / c n = I E t a s k s , d c = m y H o s t , d c = c o m ? p t c . C o m m a n d D e l e g a t e S o u r c e "

I n f o * E n g i n e C u s t o m T a g s a nI n f o * E n g i n e t a g s p r o v i d e a c c e s s t o a s e t o f c u s t o m I ne n c a p s u l a t e r e c u r r i n g f u n c t i o n a l i t y . U s i n g t h e s e t a g s , y o u c a n e a s i l y c o d e J S P p a g e s t h a t d o t h e s e a c t i o n s .

I n f o * E n g i n e p r o v i d e s y o u w i t h t h e f o l l o w i n g t a g l i b t a g s f o r y o u r u s e :

• T h e c o r e l i b r a r y c o n t a i n s g e n e r a l I n f o * E n g i n e t a gI n f o * E n g i n e J S P p a g e s i m p l e r . F o r m o r e i n f o r m a t C o r e L i b r a r y T a g s o n p a g e 2 4 5 .

• T h e d i r e c t o r y l i b r a r y c o n t a i n s I n f o * E n g i n e t a g s t h u a r e

m a n i p u l a t i n g i n f o r m a t i o n t h a t i s i n a d i r e c t o r y . F o D i r e c t o r y L i b r a r y T a g s o n p a g e 2 7 3 . • T h e s u p p l i e d l i b r a r y c o n t a i n s I n f o * E n g i n e t a g s t h

I n f o * E n g i n e T a s k s . F o r m o r e i n f o r m a t i o n , s e e S u p p l i e d L i b r a r y T a g s ( J So n p a g e 2 7 9 , S u p p l i e d L i b r a r y T a g s ( L o g g i n g ) o n p a g e 2 , a n d S u p p l i e d L i b r a r y T a g s ( X S L ) o n p a g e 2 8 6 .

A s d e s c r i b e d p r e v i o u s l y , b e f o r e u s i n g t h e s e t a g s o n at h e l i b r a r y a n d i t s p r e x u s i n g a J S P t a g l i b d i r e c t i v e . F o r a l l e x a m p l e s s t h i s g u i d e , t h e i e p r e x i s s p e c i e d f o r t h e c o r e t a g l i b r a r y a s

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i p r e f i x = " i e " % >

I n a d d i t i o n , t h e i e d i r p r e x i s s p e c i e d f o r t h e d i r e c t o r y t a g l i b

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i p r e f i x = " i e d i r " % >

F o r d e t a i l s o n t h e s p e c i e d p r e x e s f o r t h e s u p p l i e d t I n f o * E n g i n e C u s t o m T a g R e f e r e n c e o n p a g e 2 3 3 . H o w e v e r , y o u c a n u s e a p ro f y o u r c h o i c e a s l o n g a s i t u n i q u e l y i d e n t i e s t h e t a g




C o m m o n U s e s f o r C u s t o m T a g s

A c t i o n C u s t o m T a g D e n e w e b j e c t s a n d t h e i r p a r a m e t e r s w e b j e c t

p a r a m E x e c u t e I n f o * E n g i n e t a s k s a n d d e n e t h e i r p a r a m t a s k

p a r a m A u t h e n t i c a t e u s e r s w h o a c c e s s t h e J S P p a g e a u t h e n t i c a t e G r o u p a s e q u e n c e o f w e b j e c t s , t a s k s , o r J a v a c o ds o t h a t t h e g r o u p i s e x e c u t e d a s a u n i t a n d o p t i o n i n c l u d e s u c c e s s a n d f a i l u r e p r o c e s s i n g

T h e s e t a g s a r e s u p p o r t e d i n J S P s b u t t h e i r u s e i s s t r o n g l y d i s c o u r a g e d f r o m w i t h i n J S P s d u e t o h ot a g l i b s m u s t b e p r o c e s s e d . I d e a l l y t h e s e t a g s s h oo n l y b e u s e d f r o m I n f o * E n g i n e t a s k s .

u n i t

i n i t

s u c c e s s

f a i l u r e

I t e r a t e t h r o u g h a n e x i s t i n g I n f o * E n g i n e g r o u p oe l e m e n t a t a t i m e a n d r e t r i e v e t h e v a l u e

f o r E a c h

g e t V a l u e C o n c u r r e n t l y e x e c u t e t a s k s o r w e b j e c t s p a r a l l e l

T h e f o l l o w i n g s e c t i o n s i n c l u d e e x a m p l e s t h a t u s e s o m e o f t o m t a g s . I n a d d i t i o n , t h e r e a r e o t h e r t a g s i n t h e I n f o * E n g i n e t o y o u . T h e c o m p l e t e l i s t o f t a g s , t h e i r s y n t a x , a n t h e I n f o * E n g i n e C u s t o m T a g R e f e r e n c e o n p a g e 2 .

F o r t h e g e n e r a l r u l e s t h a t a p p l y t o b o t h J S P p a g e I n f o * E n g i n e C u s t o m T a g R e f e r e n c e o n p a g e 2 3 3 .

A d a p t e r W e b j e c t s a n d J S P A c t i o n a n d q u e r y w e b j e c t s a r e d e n e d f o r t h e I n fa t y o u r s i t e . E a c h a d a p t e r i s d e s i g n e d t o a c c e s s d i n f o r m a t i o n s y s t e m . F o r d e t a i l e d a d a p t e r w e b j e ca d a p t e r g u i d e f o r t h e i n f o r m a t i o n s y s t e m y o u w a

E v e n t h o u g h e a c h a d a p t e r p r o v i d e s a u n i q u e s e t os e t o f p a r a m e t e r s ) , I n f o * E n g i n e h a s s t a n d a r d i z e t h r o u g h e a c h w e b j e c t . T o d o t h i s , I n f o * E n g i n e r I N S T A N C E p a r a m e t e r i n e a c h a d a p t e r w e b j e c t . a d a p t e r t h a t i s t o b e u s e d . A l t h o u g h t h e n a m e u s eo n m a n y d i f f e r e n t f o r m s , t h e m o s t c o m m o n n a m f o r t h e a d a p t e r w h e n i t i s c o n g u r e d .




A c o m m o n w a y t o n a m e a d a p t e r s i s t o i n c l u d e a d o m an a m e s o t h a t t h e a d a p t e r s e r v i c e n a m e i s u n i q u e a c r o e n v i r o n m e n t . F o r e x a m p l e , i f t h e d o m a i n n a m e o f t h s e r v i c e n a m e i s “ m y H o s t . m y C o m p a n y . c o m , ” t h e n a m i g h t b e : c o m . m y C o m p a n y . m y H o s t . j d b c A d a p t e r

Y o u r s i t e c a n a l s o u s e s i m p l e r s e r v i c e n a m e s . F o r e x J D B C a d a p t e r s i n s t a l l e d a t y o u r s i t e , t h e y c a n b e n a m“ J D B C a d a p t e r 2 . ” Y o u r s i t e a d m i n i s t r a t o r d e t e r m i n en a m e s a r e w h e n t h e a d a p t e r s a r e i n s t a l l e d a n d c o n g un a m e s m u s t b e u n i q u e , a n d m a i n t a i n i n g u n i q u e n e s s W i n d c h i l l a d m i n i s t r a t o r .

S p e c i f y t h e I N S T A N C E p a r a m e t e r o n e a c h a d a p t e r w

s p e c i e d o n t h e f o l l o w i n g Q u e r y - O b j e c t s w e b j e c t , w u s i n g t h e J D B C a d a p t e r :



< h t m l > < h e a d > < t i t l e > J S P T a b l e L i s t < / t i t l e > < / h e a d > < h 2 > I * E J S P T e s t - T a b l e L i s t < / h 2 > < %

S t r i n g w h e r e = r e q u e s t . g e t P a r a m e t e r ( " w h e r e " ) ; i f ( w h e r e = = n u l l )

w h e r e = " ( ) " ;

S t r i n g t a b l e = r e q u e s t . g e t P a r a m e t e r ( " t a b l e " ) ; i f ( t a b l e = = n u l l )

t a b l e = " E M P " ;

S t r i n g i n s t a n c e = r e q u e s t . g e t P a r a m e t e r ( " i n s t a n c e " i f ( i n s t a n c e = = n u l l )

i n s t a n c e = " j d b c A d a p t e r " ; % >

 S e a r c h i n g t a b l e < % = t a b l e % > w i t h w h e r e c l a u s e < % = w h 




 

 " / > " / > 

 < / h t m l >

N o t e I n m o s t c a s e s , t h e p r e f e r a b l e a n d s t a n d a r d w a y t o I n f o * E n g i n e s y n t a x . I n s t e a d o f u s i n g H T M L s y n t



Y o u s h o u l d u s e I n f o * E n g i n e s y n t a x :



T h e I N S T A N C E p a r a m e t e r i s j u s t o n e o f t h e r e q ue x a m p l e p a g e , y o u m u s t s p e c i f y t h e f o l l o w i n g i n

• A n a d a p t e r n a m e , s u c h a s “ j d b c A d a p t e r 1 ” • A t a b l e n a m e , s u c h a s “ E M P ” • A w h e r e c l a u s e , s u c h a s w h e r e = D E P T N O = 1 0

Y o u u s e t h i s t o c r e a t e t h e f o l l o w i n g U R L : h t t p : / / l o c a l h o s t / W i n d c h i l l / i n f o e n g i n e

I n t h i s c a s e , j d b c A d a p t e r 1 b e c o m e s t h e v a l u e o f t h e I N S T A p a r a m e t e r , E M P b e c o m e s t h e v a l u e f o r C L A S S , a n d t h e w h e r e c l a u s e i s w h e r e = D E P T N O = 1 0 . T h e o u t p u t d i s p l a y e d i n t h e b r o w s e rt h e f o l l o w i n g :




I f t h e a d a p t e r n a m e d “ j d b c A d a p t e r 1 ” h a d n o t b e e n a v b e e n r e t u r n e d . T o m i n i m i z e t h e e f f e c t o f a n a d a p t e r bs p e c i f y m u l t i p l e a d a p t e r s i f y o u k n o w t h a t t h e r e i s m c a n p r o c e s s a s p e c i c w e b j e c t . T o s p e c i f y m u l t i p l e a d a p t e r s , i n c l u d e m u l t i p l e I N S Tt h e w e b j e c t . I n f o * E n g i n e a t t e m p t s t o c o n n e c t t o t h e ao n t h e w e b j e c t . F o r e x a m p l e , i f y o u k n o w t h a t b o t h a “ j d b c A d a p t e r 2 ” a r e d e n e d i n y o u r I n f o * E n g i n e e n v b o t h i n t h e Q u e r y - O b j e c t s w e b j e c t a s f o l l o w s :

< % S t r i n g w h e r e = r e q u e s t . g e t P a r a m e t e r ( " w h e r e " ) ; i f ( w h e r e = = n u l l )

w h e r e = " ( ) " ;

S t r i n g t a b l e = r e q u e s t . g e t P a r a m e t e r ( " t a b l e " ) ; i f ( t a b l e = = n u l l )

t a b l e = " E M P " ;

S t r i n g i n s t a n c e 1 = r e q u e s t . g e t P a r a m e t e r ( " i n s t a n c e i f ( i n s t a n c e 1 = = n u l l )

i n s t a n c e 1 = " j d b c A d a p t e r 1 " ; S t r i n g i n s t a n c e 2 = r e q u e s t . g e t P a r a m e t e r ( " i n s t a n c e i f ( i n s t a n c e 2 = = n u l l )

i n s t a n c e 2 = " j d b c A d a p t e r 2 " ; % >

 S e a r c h i n g t a b l e < % = t a b l e % > w i t h w h e r e c l a u s e < % = w h 

 " " " / > " / > 



T h e U R L t o e x e c u t e t h e u p d a t e d T a b l e L i s t . j s p p a g e i s a s f o l l o w s : h t t p : / / l o c a l h o s t / W i n d c h i l l / i n f o e n g i n e / c o

I f “ j d b c A d a p t e r 1 ” i s a v a i l a b l e , i t i s u s e d ; i f i t i s n o t a vu s e d . I f n e i t h e r i s a v a i l a b l e , a n e r r o r i s r e t u r n e d .

I n f o * E n g i n e a l s o p r o v i d e s t h e f o l l o w i n g p a r a m e t e r sa d a p t e r w e b j e c t a n d m a y b e u s e f u l w h e n a t t e m p t i n g




C O N N E C T I O N _ A T T E M P T S D e n e s t h e m a x i m u m n u m b e r o f t i m e s t o a t t e ma n a d a p t e r b e f o r e r e t u r n i n g a n e r r o r . I f m u l t i p l a r e s p e c i e d , t h e v a l u e o f C O N N E C T I O N _ A T n u m b e r o f t i m e s t o i t e r a t e t h r o u g h t h e l i s t o f a d

C O N N E C T I O N _ A T T E M P T _ I N T E R V A L D e n e s t h e a m o u n t o f t i m e , i n s e c o n d s , t o d e l a a t t e m p t s . I f m u l t i p l e I N S T A N C E p a r a m e t e r v aC O N N E C T I O N _ A T T E M P T _ I N T E R V A L d e w a i t b e t w e e n t h e a t t e m p t s t o i t e r a t e t h r o u g h t h

F o r e x a m p l e , t h e s e p a r a m e t e r s c o u l d a l s o b e a Q u e r y - O b j e c t s w e b j e c t e x a m p l e a s f o l l o w s :



< i e : p a r a m n a m e = " I N S T A N C E " d a t a = " < % = i n s t a n c< i e : p a r a m n a m e = " I N S T A N C E " d a t a = " < % = i n s t a n c< i e : p a r a m n a m e = " C O N N E C T I O N _ A T T E M P T S " d a t " / > " /

A d d i n g t h e p a r a m e t e r s s e t s u p t h r e e a t t e m p t s t o p r o v i d e s a 3 0 s e c o n d d e l a y a f t e r a t t e m p t i n g b o

t r y i n g a g a i n . F o r a d d i t i o n a l i n f o r m a t i o n a b o u t t h e u s i n g a d a p tf o r t h e a d a p t e r s y o u a r e u s i n g .

T a s k W e b j e c t s a n d J S P P a T h e I n f o * E n g i n e t a s k w e b j e c t s g i v e y o u a q u i c k i n f o r m a t i o n , a s w e l l a s t o m a n a g e y o u r J S P p a g et h e i n f o r m a t i o n t h a t i s g e n e r a t e d i n g r o u p s w i t h iI n f o * E n g i n e D a t a M a n a g e m e n t o n p a g e 2 7 . T a s k w e b j e c t s d o n o t r e t ud i s p l a y a b l e d e v i c e s u c h a s a w e b b r o w s e r . A n y d r e t u r n e d a s a g r o u p t o t h e V D B . U s e t a s k w e b j e c t s a l o n g w i t h d i s p l a y w e b j e c t s t oy o u r s i t e r e q u i r e s . B o t h t a s k a n d d i s p l a y w e b j e c t p a g e t o g e n e r a t e a n d t h e n d i s p l a y d a t a .




I n f o * E n g i n e p r o v i d e s t h e f o l l o w i n g t y p e s o f t a s k w e

T y p e D e s c r i p t i o n G R P G r o u p w e b j e c t s c a n c r e a t e , c o m p a r e , c o m b i n e

m a n i p u l a t e g r o u p s . M G T M a n a g e m e n t w e b j e c t s p r o v i d e c o m m o n f u n c t

m a n a g e y o u r J S P p a g e s o r t a s k s . M S G M e s s a g e w e b j e c t s c a n b e u s e d i n c o n j u n c t i o n w

f o r g e n e r i c m e s s a g i n g f u n c t i o n s a n d t a s k q u e uW E S W e b E v e n t S e r v i c e ( W E S ) w e b j e c t s c a n b e u s e

t h i r d - p a r t y M O M f o r h a n d l i n g I n f o * E n g i n e e vA C T A c t i o n w e b j e c t s a r e p r o v i d e d b y a d a p t e r s t o p e

c r e a t i n g , c o p y i n g , a n d u p d a t i n g d a t a i n a d a t a rA D M A d m i n i s t r a t i v e w e b j e c t p e r f o r m s p e c i c a d m i

s u c h a s g a t h e r i n g s i m p l e s t a t i s t i c s , o r c a u s i n g r e l o a d a t r u n t i m e .

O B J Q u e r y w e b j e c t s a r e p r o v i d e d b y a d a p t e r s t o s e f o r o b j e c t s t h a t m a t c h s p e c i e d c r i t e r i a .

Y o u c a n u s e g r o u p a n d m a n a g e m e n t w e b j e c t s o n a n y j u s t t h e b a s i c I n f o * E n g i n e e n v i r o n m e n t s e t u p . T o u sS e r v i c e w e b j e c t s , y o u r s i t e a d m i n i s t r a t o r m u s t h a v e M O M a n d i m p l e m e n t e d t h e I n f o * E n g i n e f e a t u r e s t h r e q u i r e d b y t h e w e b j e c t s .

I n a d d i t i o n , y o u c a n c r e a t e e x t e r n a l c u s t o m w e b j e c t s E X T t y p e ) t h a t p r o v i d e

c u s t o m s o l u t i o n s i n e i t h e r a J S P p a g e o r a s t a n d a l o n eT h e D i s p l a y T a b l e . j s p p a g e e x a m p l e p r e v i o u s l y p r o v i d e d c of o l l o w i n g g r o u p w e b j e c t :


d a t a = " n a m e = m y G r o u p 2 : e m a i l = x x x @ x x x . c o m : a d d r e s s 



T h e r e s u l t o f e x e c u t i n g t h e C r e a t e - G r o u p w e b j e c t i s w h i c h h a s o n e e l e m e n t ( r o w ) , w i t h t h r e e a t t r i b u t e s ( c

n a m e e m a i l a d d r e s s m y G r o u p 2 x x x @ x x x . c o m P T C

U s e t h e w e b j e c t t a g t o c o d e t a s k w e b j e c t s , a s w e l l a s d i s p l a y e x a m p l e , t h e w e b j e c t t a g s y n t a x i n c l u d e s b o t h t h e b e g i n n i n g a n w e b j e c t t a g s . I n t h e p r e v i o u s d i s p l a y w e b j e c t e x a m p l e , o n l y tT h e e n d i n g w e b j e c t t a g i s n e e d e d h e r e b e c a u s e t h e C r e a t e - G r o p a r a m e t e r s t h a t a r e n e s t e d i n s i d e t h e w e b j e c t t a g : E L E M E N T a n d G R O U PT h e s e p a r a m e t e r s a r e d e n e d u s i n g p a r a m t a g s .




T a s k W e b j e c t R e f e r e n c e o n p a g e 3 5 7 d e s c r i b e s a l l g r o u p , m a n a g e ma n d W e b E v e n t S e r v i c e w e b j e c t s . T h e r e a r e a l s o e x a m p l e s s h o w n t h r o u g h o u t t h e r e m a i n i n g s e c t i

T h e a c t i o n a n d q u e r y w e b j e c t s a v a i l a b l e t o y o u a h a v e b e e n i n s t a l l e d a t y o u r s i t e . F o r m o r e i n f o r m A d a p t e r W e b j e c t sJ S P P a g e s o n p a g e 6 7 .

D i s p l a y W e b j e c t s a n d J S P T h e I n f o * E n g i n e d i s p l a y w e b j e c t s g i v e y o u a q u t h a t h a s b e e n g a t h e r e d a n d m a n i p u l a t e d b y I n f o * w e b j e c t i s s p e c i e d b y D S P i n t h e t y p e a t t r i b u t e o n t h e w e b j e c t t a g . F o r e x a m p t h e D i s p l a y T a b l e . j s p p a g e d e s c r i b e d p r e v i o u s l y c o n t a i

w e b j e c t t a g : 

N o t i c e t h a t t h e t y p e a t t r i b u t e o n t h e w e b j e c t t a g i s s e t t o “ D S P ” , w h i c h i n d i c a t t h a t t h e D i s p l a y - T a b l e w e b j e c t i s a d i s p l a y w e b j er e q u i r e s n o p a r a m e t e r s a n d t h e r e f o r e , t h e w e b j e c t t a g s y n t a x u s e d r e q u i r t h e / > c h a r a c t e r s t o e n d t h e t a g .

T o d i s p l a y i n f o r m a t i o n i n a w e b b r o w s e r , y o u c a nw i t h t h e d i s p l a y w e b j e c t s t h a t a r e s p e c i c a l l y t a i lw e b j e c t s p r o v i d e t h e a b i l i t y t o d i s p l a y g e n e r a t e d

D i s p l a y F o r m a t W e b j e c t H T M L t a b l e s D i s p l a y - T a bH T M L f o r m e l e m e n t s D i s p l a yH T M L e l e m e n t s s u c h a s a c h e c k b o x , r a d i o b u t t ot e x t b o x

D i s p l a y - V a l u e

A u t h o r - s p e c i e d H T M L c o d i n g D i s p l a y - O b j e c t

W h e n c o d i n g w e b j e c t s t h a t u t i l i z e H T M L , y o u s ha n d w e b j e c t s i n s i d e t h e f o l l o w i n g s e t o f H T M L t

< h t m l > 

: :

 < / h t m l >




I n a d d i t i o n t o t h e g e n e r a l d i s p l a y w e b j e c t s l i s t e d i n t hd i s p l a y w e b j e c t s a v a i l a b l e f o r u s e w i t h H T M L t h a t p f o l l o w i n g :

• A p p l y a n X S L s t y l e s h e e t t o d a t a • D i s p l a y d a t a c o d e d i n X M L t a g s • P r o v i d e l o c a l i z e d t e x t

T h e D i s p l a y T a b l e . j s p e x a m p l e p a g e d e s c r i b e d e a r l i e r s h o w D i s p l a y - T a b l e w e b j e c t . D i s p l a y W e b j e c t R e f e r e n c e o n p a g e 2 8 9 d e s c r i b e s a l l d i s p l a y w e b j e c t s . T h e r e a r e a l s o d i s p l a y w e b j e c t s u s t h e f o l l o w i n g s e c t i o n s .

M u l t i p l e W e b j e c t E x e c u t i o n B y u s i n g t h e p a r a l l e l c u s t o m t a g , y o u c a n e x e c u t e m o r e t h a n o ns a m e t i m e .

F o r e x a m p l e , t h e f o l l o w i n g J S P p a g e e x e c u t e s t w o q b o t h q u e r i e s c o m p l e t e , t h e r e s u l t i n g g r o u p s a r e j o i n e

< h t m l > 




 



 



 




 

 



 < / h t m l >

F o r t h e d e t a i l s o n t h e c u s t o m t a g s u s e d , s e e t h e t a I n f o * E n g i n C u s t o m T a g R e f e r e n c e o n p a g e 2 3 3 .

S u c c e s s a n d F a i l u r e P r o c eW e b j e c t s I n f o * E n g i n e p r o v i d e s t h e f o l l o w i n g s e t o f c u s t o m

t h e e x e c u t i o n o f w e b j e c t s a n d p r o v i d e s u c c e s s a n• u n i t • i n i t • s u c c e s s • f a i l u r e

T h e s e t a g s a r e s u p p o r t e d i n J S P s , b u t t h e i r u s e i s J S P s d u e t o h o w a t a g l i b m u s t b e p r o c e s s e d . I d e a l l y t h e s e t a u s e d f r o m I n f o * E n g i n e t a s k s .

F o r e x a m p l e , t h e f o l l o w i n g J S P p a g e h a s t h e m a ig r o u p a n d t h e n e x e c u t e t h r e e q u e r i e s c o n c u r r e n t g r o u p c r e a t e d . I n t h e s u c c e s s b l o c k , i t c r e a t e s a g r o u p n a m e d f a i l u r e b l o c k , i t c r e a t e s a g r o u p n a m e d “ f a i l u r e ” . I d i s p l a y s t h e X M L o f t h e l a s t g r o u p c r e a t e d :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " . . / I E E r r o r . j s p " % >





< % r e s p o n s e . s e t C o n t e n t T y p e ( " t e x t / x m l " ) ; % >



 




 



 

 



 







 < i e : p a r a m n a m e = " E L E M E N T " d a t a = " S U C C E S S = s u c






U s e y o u r e r r o r p a g e b y s p e c i f y i n g i t a s t h e e r r o r p a g e p a g e d i r e c t i v e o n o t h e r p a g e s . F o r e x a m p l e t h e f o l l o w i n g p a g e d i r e c t i v e s e t s t h e e r r o r P a g e a t t r i b u t e t o I E E r r o r . j s p :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " I

A n e r r o r p a g e c a n b e v e r y u s e f u l b e c a u s e i t c a n a c t a se r r o r p r o c e s s i n g t o g i v e a c o n s i s t e n t e x p e r i e n c e w h e c a n a l s o b e w r i t t e n t o d e a l w i t h e x c e p t i o n s b a s e d o n tm e a n i n g f u l i n f o r m a t i o n t o t h e u s e r .

U s i n g t r y / c a t c h B l o c k s Y o u c a n c a t c h e x c e p t i o n s w i t h i n s p e c i c p a r t s o f a J S t r y / c a t c h b l o c k s w i t h i n s c r i p t l e t s . T h i s i s s i m i l a r t o h a n d l i n g e u n i t a n d

f a i l u r e t a g s , b u t a l l o w s y o u t o m o r e p r o g r a m m a t i c a l l y de x a m p l e :

< % t r y { % > < ! - - w e b j e c t o r t a s k i n v o c a t i o n s - - > < % / / c a t c h s t a t e m e n t a p p r o p r i a t e g i v e n t h e c o n t e n t s o f t h i } c a t c h ( A d a p t e r E x c e p t i o n a e ) {

/ / h a n d l e t h e a d a p t e r e x c e p t i o n } c a t c h ( I D P a r t i a l R e s u l t s E x c e p t i o n p a r t i a l ) {

/ / e x t r a c t a n d d i s p l a y t h e p a r t i a l r e s u l t s } / / e t c . % >

U s i n g u n i t T a g s Y o u c a n c a t c h e x c e p t i o n s w i t h i n s p e c i c p a r t s o f a p a u n i t t a g s o n t h e p a g e a n d i n c l u d i n g o n e o r m o r e f a i l u r e b l o c k s w i t h i n t h e u n i t . I n t h e ps e c t i o n , t h e f a i l u r e b l o c k p r o v i d e d w a s f o r a l l f a i l u r e s . I n a da g e n e r a l f a i l u r e b l o c k , y o u c a n h a v e f a i l u r e b l o c k s t h a t c a t c h a s p e c i e x c e p t i o n . T h e f o l l o w i n g f a i l u r e b l o c k s c a t c h f o u r d i f f e r e n t e x c e p

 

 

 








 





 

 

 

 

Y o u c a n a l s o u s e t h e T h r o w - E x c e p t i o n w e b j e c t t r e t h r o w a n e x c e p t i o n f r o m w i t h i n a p a g e o r a t a s kt a s k w e b j e c t e x e c u t i o n a r e a u t o m a t i c a l l y e n t e r e da s t h e a t t r i b u t e s n a m e d e x c e p t i o n - c l a s s a n d e x c e p t i o n - m e s s a g e . T h e r e f o r e , y o c a n u s e t h e T h r o w - E x c e p t i o n w e b j e c t t o r e t h r o w w i t h o u t k n o w i n g w h a t t h e e x c e p t i o n i s .






4 I n f o * E n g i n e

A b o u t I n f o * E n g i n e T a s k s a n d T a s k R u l e s . . . . . . . . . . . . . . . . . . . . A u t h o r i n g I n f o * E n g i n e T a s k s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . U s i n g t h e I n f o * E n g i n e T a s k E d i t o r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . U n d e r s t a n d i n g X M L O u t p u t f o r I n f o * E n g i n e G r o u p s . . . .N e s t i n g T a s k s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

T h e f o l l o w i n g t o p i c s i n t r o d u c e t h e c o n c e p t o f a n

t o c r e a t e a n d u s e t a s k s , a n d d e s c r i b e t h e X M L o u w h e n d i s p l a y i n g g r o u p s .

8 1



A b o u t I n f o * E n g i n e T a s k s a n I n f o * E n g i n e t e x t - b a s e d d o c u m e n t s a r e c a l l e d “ s t a n d

t h e r e t r i e v a l a n d m a n i p u l a t i o n o f d a t a w i t h i n y o u r I nI n s t e a d o f u s i n g a c u s t o m J a v a a p p l i c a t i o n o r J S P p a go n t h e d a t a ( i n c l u d i n g r e t r i e v i n g a n d d i s p l a y i n g y o u rd a t a r e t r i e v a l a n d m a n i p u l a t i o n o p e r a t i o n s f r o m t h e

O n e o f t h e a d v a n t a g e s o f u s i n g t a s k s i s t h a t y o u c a n od a t a o p e r a t i o n s c a n b e d o n e o n c e a n d t h e n u s e d m a n t a s k c o m p i l e r p a r s e s I n f o * E n g i n e t a s k s a n d p r o d u c ef r o m t h e m . T h i s i m p r o v e s t h e p e r f o r m a n c e o f e x e c ue l i m i n a t i n g t h e n e e d t o p a r s e a n d i n t e r p r e t a t a s k e a c f a c i l i t a t e s e m b e d d i n g I n f o * E n g i n e t a s k s i n s t a n d a l o p a g e s .

T h e t a s k c o m p i l e r p r o d u c e s t h e e x e c u t a b l e J a v a c l a s 1 . I t p a r s e s t h e s o u r c e o f a t a s k a n d g e n e r a t e s J a v a s o

t h e t a s k . 2 . I t c a l l s a J a v a c o m p i l e r t o p r o d u c e a n e x e c u t a b l e c

J a v a s o u r c e . 3 . I t c a l l s a c l a s s l o a d e r t o l o a d a n d i n s t a n t i a t e t h e c l a

c o m p i l e r .

A s a p e r f o r m a n c e o p t i m i z a t i o n , t h e t a s k c o m p i l e r r e a c a c h e a n d a v o i d s t h e r s t t w o s t e p s w h e n e v e r i t c a n c l a s s i s u p t o d a t e . A c a c h e d c l a s s i s d i s c a r d e d a n d r e c o m p i l e r d i s c o v e r s t h a t t h e t a s k h a s b e e n u p d a t e d s i nw a s c o m p i l e d .

N o t e D u e t o t h e u p g r a d e t o t h e l a t e s t J S P s p e c i c a t i o n , J S P s u b s t i t u t i o n s y n t a x c a n n o l o n g e r u s e t h e $ { . . . } s y n t a x . I n f o * E n g i n e n o w s u p p o r t s a n a l t e r n a t e s y n t a x , $ ( . . . ) t h a t m u s t b e u s e d i n s t e a d .

A l l I n f o * E n g i n e t a s k s f u n c t i o n w i t h e i t h e r s y n t a x o f $ ( . . . ) o r $ { . . . } . P r e e x i s t i n g t a s k s c o n t i n u e t o f u n c t i o n a s i s a n d d o n o

P r e e x i s t i n g J S P s m u s t b e u p d a t e d t o u s e t h e n e w $ ( . . . ) s y n t a x o r t h e y f a i l t o c o m p i l e a n d d o n o t f u n c t i o n a s e x p e c t e d .

S p e c i c T a s k R u l e s W h e n c r e a t i n g t a s k s , y o u m u s t a d h e r e t o t h e f o l l o w i n

• A n I n f o * E n g i n e t a s k s h o u l d s t a r t w i t h a J S P p a g e d i r e c t i v e s i m i l a r t o t h e f o l l o w i n g :





T h e i m p o r t a t t r i b u t e o n t h e p a g e d i r e c t i v e s h o u l d a l s o b e i n c la d d i t i o n a l c l a s s e s a r e r e q u i r e d .

• T h e t a s k m u s t s p e c i f y t h e c u s t o m t a g l i b r a r y u t h r e e c u s t o m l i b r a r i e s : c o r e , d i r e c t o r y , a n d s u pl i b r a r y a n d t h e s u p p l i e d l i b r a r i e s a r e s u p p o r t e di n c l u d e t a g l i b d i r e c t i v e s s i m i l a r t o t h e f o l l o w i n g :

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / p r e f i x = " i e " % >

N o t e Y o u m u s t s p e c i f y t h e u r i a t t r i b u t e v a l u e e x a c t l y a s i t i s s h o wc h o o s e a d i f f e r e n t p r e x v a l u e . H o w e v e r , y o u m s p e c i f y a s t h e p r e x f o r t h e t a g s f r o m t h e c o r r e s p o

• T h e t a s k m u s t h a v e a t l e a s t o n e t a s k w e b j e c t . Y w e b j e c t a n d p a r a m t a g s t o s p e c i f y t h e w e b j e c t .

• T a s k s c a n n o t c o n t a i n a n y d i s p l a y e l e m e n t s s u ct a g s a r e i n a t a s k , t h e y a r e i g n o r e d .

G e n e r a l T a s k R u l e s T o b e w e l l - f o r m e d a n d v a l i d , t h e I n f o * E n g i n e t a

• F o r I n f o * E n g i n e c u s t o m t a g s a n d J S P t a g s , y o e x a m p l e , y o u m u s t s p e c i f y t h e w e b j e c t t a g a s “ w e b j e c t ” a n d n o t “ o r “ W e b j e c t ” o r e v e n “ w e b J e c T ” .

• Y o u c a n u s e c o m m e n t s t o d o c u m e n t w h a t i s h ac a u s e t h e c o m p l i e r t o s k i p a s e c t i o n o f t h e t a s k .a c o m m e n t , i t i s n o t e x e c u t e d . C o m m e n t s c a n be x c e p t w i t h i n t a g s , d e c l a r a t i o n s , o r o t h e r c o m m

C o m m e n t s b e g i n w i t h < ! – a n d e n d w i t h – > . • E m p t y e l e m e n t s m u s t b e p r o p e r l y c o n s t r u c t e d / > c h a r a c t e r s ( t h

f o r w a r d s l a s h f o l l o w e d b y t h e r i g h t a n g l e b r a c kt o t h e t a s k c o m p i l e r t h a t t h e e l e m e n t i s e m p t y a b e s o u g h t . F o r e x a m p l e , t h e p a r a m c u s t o m t a g s m a k e u s e o f t h ee l e m e n t c o n s t r u c t i o n .

• A d d i t i o n a l g e n e r a l r u l e s f o r u s i n g s c r i p t l e t s , ed i r e c t i v e s , a n d I n f o * E n g i n e c u s t o m t a g e l e m e I n f o * E n g i n e C u s t o m T a g R e f e r e n c e o n p a g e 2 .

I n f o * E n g i n e T a s k s 8 3



A u t h o r i n g I n f o * E n g i n e T a s k B e s t P r a c t i c e

W h e n a u t h o r i n g a n I n f o * E n g i n e t a s k i t i s v e r y i m p o r ti n t e n d t h a t t a s k t o b e i n v o k e d . I n f o * E n g i n e t a s k s m i gd i f f e r e n t w a y s , i n c l u d i n g f r o m o t h e r J a v a c o d e u s i n g tW i n d c h i l l u s e r i n t e r f a c e o r w o r k o w ) , f r o m a S O A P c c l i e n t t h r o u g h t h e I E s e r v l e t . F o r e x a m p l e , i f y o u a r e ai n t e n d e d t o b e c a l l e d f r o m a W i n d c h i l l w o r k o w y o u p f o r s o m e o n e t o b e a b l e t o r u n t h a t t a s k t h r o u g h t h e I E t a s k i s e x e c u t e d , y o u c a n u s e t h e a c c e s s a t t r i b u t e . F o r m o r e i n f o r m a t i o n p a g e D i r e c t i v e o n p a g e 2 3 7 .

A l l w e b j e c t s t h a t d o n o t d i r e c t l y d e a l w i t h t h e d i s p l a yi n I n f o * E n g i n e t a s k s . T h a t i s , a n y w e b j e c t w i t h t h a t h D S P t y p e e x i s t s o n l y

i n a J S P p a g e o r c u s t o m a p p l i c a t i o n . T h e f o l l o w i n g s i n c l u d e d i n I n f o * E n g i n e t a s k s a n d a r e k n o w n a s “ t a s

• T h e G R P t y p e , o r g r o u p w e b j e c t s . • T h e O B J t y p e , o r q u e r y w e b j e c t s . • T h e A C T t y p e , o r a c t i o n w e b j e c t s . • T h e M G T t y p e , o r m a n a g e m e n t w e b j e c t s . • T h e M S G t y p e , o r m e s s a g e w e b j e c t s . • T h e W E S t y p e , o r W e b E v e n t S e r v i c e w e b j e c t s . • T h e A D M t y p e , o r a d m i n i s t r a t i v e w e b j e c t s .

I n a d d i t i o n , y o u c a n c r e a t e e x t e r n a l c u s t o m w e b j e c t ss o l u t i o n s i n e i t h e r a J S P p a g e o r a s t a n d a l o n e t a s k . F C r e a t i n g a n E x t e r n a l C u s t o m W e b j e c t o n p a g e 1 4 0 .

T h i n k o f a t a s k a s a s c r i p t o f c o m m a n d s e x e c u t e d b y Ii n a t a s k i s a w e b j e c t . T h e w e b j e c t s a r e e x e c u t e d i n t ht h e t a s k . B y d e f a u l t , t h e s e q u e n c e i s f r o m t h e t o p t o t hw i t h i n a t a s k p e r f o r m o p e r a t i o n s s u c h a s q u e r y i n g d ai n t e g r a t i n g d a t a i n i n t e r e s t i n g w a y s , p e r f o r m i n g s c h a n d u p d a t i n g d a t a b a s e i n f o r m a t i o n . F o r a t a s k t o b e sl e a s t o n e p r o p e r l y c o n s t r u c t e d w e b j e c t .

T h e f o l l o w i n g C r e a t e G r o u p . x m l t a s k c r e a t e s a g r o u p c o n s i s t i n g o f n s t r e e t a d d r e s s e s , a n d e m a i l a d d r e s s e s :


< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b /

< ! - - C r e a t e a n i n t e r n a l G r o u p - - >








Y o u m u s t p u t t h i s d i r e c t i v e b e f o r e a n y l i n e s t h a t u sl i b r a r y .

• I n f o * E n g i n e c u s t o m t a g s , w h i c h p r o v i d e a c c e s s t oe n c a p s u l a t e r e c u r r i n g f u n c t i o n a l i t y .

T h e c u s t o m t a g s p r o v i d e t h e s y n t a x f o r e x e c u t i n g ws t r u c t u r e a r o u n d w h i c h y o u c a n b u i l d a t a s k .

T h e p r e v i o u s C r e a t e G r o u p . x m l e x a m p l e t a s k i n c l u d e s t h e f o l l o w i n g s t a n d a r d J S P d i r e c t i v e s :


T h i s i s t h e s t a n d a r d p a g e d i r e c t i v e . N o a d d i t i o n a l c l a s s e s a r e r e q

T o i d e n t i f y t h e “ c o r e ” I n f o * E n g i n e t a g l i b r a r y y o u m


T h i s p r o v i d e s t h e g e n e r a l t a g s t h a t c a n b e u s e d i n t h e i e a s t h e r e q u i r e d p r e x t h a t i d e n t i e s t h e t a g a s b e l o n g i n g t o t

T h e p r e v i o u s C r e a t e G r o u p . x m l e x a m p l e t a s k a l s o i n c l u d e s t h e w e b j e c t a n d p a r a m t a g s :

• T h e w e b j e c t t a g i d e n t i e s t h e C r e a t e - G r o u p w e b j e c t . • T h e p a r a m t a g s s u p p l y w e b j e c t p a r a m e t e r s a n d p a r a m e

F o r t h e C r e a t e - G r o u p w e b j e c t , t h e p a r a m e t e r s d e ng r o u p a n d t h e a t t r i b u t e s a n d v a l u e s o f e l e m e n t s i n t

T h e r e a r e m a n y m o r e c u s t o m t a g s t h a t y o u c a n u s e i n a n d s y n t a x o f a l l o f t h e c u s t o m t a g s , s e e I n f o * E n g i n e T a g s o n p a g e 2 4 1 .

I n a d d i t i o n t o d i r e c t i v e s a n d c u s t o m t a g s , y o u c a n i n e x p r e s s i o n s , a n d d e c l a r a t i o n s i n y o u r I n f o * E n g i n e t at h e I n f o * E n g i n e t a s k c o m p i l e r p r o c e s s e s s c r i p t l e t s , es e e t h e i r c o r r e s p o n d i n g d e s c r i p t i o n s i n S c r i p t l e t s o n p a g e 2 3 4 , E x p r e s s i o n s o n p a g e 2 3 5 , a n d D e c l a r a t i o n s o n p a g e 2 3 6 .

T a s k C r e a t i o n

Y o u c a n c r e a t e t a s k l e s u s i n g a n y s t a n d a r d e d i t i n g t oy o u w i t h a G r a p h i c a l U s e r I n t e r f a c e ( G U I ) f o r i n s e r te l e m e n t s i s h e l p f u l , b u t n o t r e q u i r e d .

F o r a d d i t i o n a l i n f o r m a t i o n o n c r e a t i n g t a s k s , s e e U s i n g t h e I n f o * E n g i n e T a sE d i t o r o n p a g e 9 0 .






T h e g r o u p c r e a t e d b y t h e e x a m p l e t a s k i s a u t o m a t i c a e l e m e n t s o n t h e J S P p a g e . T h e s e e l e m e n t s c o u l d f u r tg r o u p o r c o u l d d i s p l a y t h e g r o u p b a c k t o t h e u s e r w h oJ S P p a g e . F o r e x a m p l e , a s s u m e t h a t a u s e r e x e c u t e d t

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " I E E r r o r . j s p % >




 



T h e C r e a t e G r o u p . x m l t a s k e x e c u t e d t h r o u g h t h e t a s k t a g i s t h e s a m e t a s k d e s c r i b e d e a r l i e r . T h e o u t p u t f r o m t h i s t a s k i s t h e “ c ri s t h e n u s e d a s i n p u t t o t h e D i s p l a y - T a b l e w e b j e c t . E t h e f o l l o w i n g d i s p l a y :

E n t e r i n g a W e b B r o w s e r U R L E n t e r i n g a t a s k U R L i n t h e w e b b r o w s e r i s a n e a s y w a p r o v i d i n g t h e a d d i t i o n a l c o d i n g r e q u i r e d t o e x e c u t e o r J S P p a g e .

T h e i n s t a l l e r a l s o s p e c i e s a n a p p l i c a t i o n U R L t h a t i f o r r e q u e s t i n g I n f o * E n g i n e t a s k s . P r o d u c e t h e U R L e x e c u t e I n f o * E n g i n e J S P p a g e s b y d o i n g t h e f o l l o w i

• I n c l u d i n g t h e h o s t n a m e a n d a p p l i c a t i o n U R L p r e w a s i n s t a l l e d . T h e d e f a u l t a p p l i c a t i o n U R L i s W i n d c h i l l .

• I n c l u d i n g t h e / s e r v l e t / I E / t a s k s p r e x , w h i c h d i r e c t s t h e s e r v l t h e t a s k p r o c e s s o r .




• S p e c i f y i n g t h e p a t h f o r t h e t a s k t h a t i s r e l a t i v e t a s k s d i r e c t o r y . • S p e c i f y i n g a n y o p t i o n a l p a r a m e t e r s t o p a s s t o

N o t e I f y o u r s i t e i s u s i n g f o r m - b a s e d a u t h e n t i c a t i o n , p r a c c e s s t h e I E s e r v l e t m u s t u s e t h e / p r o t o c o l A u t h U R L p r e x . F o r e x a m

h t t p : / / < h o s t > / W i n d c h i l l / p r o t o c o l A u t h /

F o r m o r e i n f o r m a t i o n a b o u t f o r m - b a s e d a u t h e n t i A d v a n c e d D e p l o y m e n t G u i d e .

T h e r e f o r e , t o e x e c u t e t h e c o m / c o m p a n y / C r e a t e G r o u p . x t a s k u s i n g t h e m y S e r v e r h o s t n a m e a n d t h e W i n d c h i l l a p p l i c a t i o n U R L , s p e c f o l l o w i n g U R L :

h t t p : / / m y S e r v e r / W i n d c h i l l / s e r v l e t / I E / t a s k s / c o m / c oT h e X M L o u t p u t d i s p l a y e d i n t h e b r o w s e r i s s i m

< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? > < w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m / < E m p l o y e e D a t a N A M E = " c r e a t e d g r o u p " T Y P E = " O b j e

< w c : I N S T A N C E > < N A M E > S a m J o h n s o n < / N A M E > < A D D R E S S > 1 2 3 4 M a i n S t . < / A D D R E S S > < E M A I L > s j o h n s o n @ s o m e w h e r e . c o m < / E M A I L >

< / w c : I N S T A N C E > < w c : I N S T A N C E >

< N A M E > H a r v y A n d e r s o n < / N A M E > < A D D R E S S > 1 2 3 4 A m b e r S t . < / A D D R E S S > < E M A I L > h a n d e r s o n @ s o m e w h e r e . c o m < / E M A I L >


< N A M E > J a m e s O & a p o s ; C o n n o r < / N A M E > < A D D R E S S > 7 7 5 M a i n S t . < / A D D R E S S > < E M A I L > < / E M A I L >


< N A M E > H a r v e y H a m p t o n < / N A M E > < A D D R E S S > 7 7 5 M a i n S t . < / A D D R E S S > < E M A I L > h h a m p t o n @ s o m e w h e r e . c o m < / E M A I L >

< / w c : I N S T A N C E > < / E m p l o y e e D a t a > < / w c : C O L L E C T I O N >




S u b m i t t i n g T a s k s a n d E m i t t i n g E v e n t s I f y o u r I n f o * E n g i n e e n v i r o n m e n t i n c l u d e s t h e i m p l e

t a s k q u e u i n g o r t h e W e b E v e n t S e r v i c e w i t h a M e s s a ( M O M ) s o f t w a r e p r o d u c t s u c h a s I B M M Q S e r i e s , y os p e c i a l i z e d w e b j e c t s t h a t a r e p r o v i d e d f o r t h e s e e n v iw e b j e c t s r e q u i r e s t h e i n s t a l l a t i o n a n d c o n g u r a t i o n o p r o d u c t s a n d a l s o r e q u i r e s a d d i t i o n a l I n f o * E n g i n e c

Y o u r s i t e a d m i n i s t r a t o r s h o u l d k n o w i f y o u r e n v i r o nt h e s e o p t i o n a l f e a t u r e s . F o r i m p l e m e n t a t i o n i n f o r m I n f o * E n g i n e I m p l e m e n t a t i o n G u i d e . F o r m o r e w e b j e c t i n f o r m a t i o n , s e e Q u e u e - T a s k o n p a g e 4 7 7 a n d S u b s c r i b e - E v e n t o n p a g e 4 9 7 .

U s i n g t h e I n f o * E n g i n e T a s k ET h e I n f o * E n g i n e T a s k E d i t o r p r o v i d e s a s t r e a m l i n e dJ S P s w i t h o u t h a v i n g t o d o a l o t o f t y p i n g . B y s e l e c t i n i n t e r f a c e a n d e n t e r i n g i n f o r m a t i o n i n d a t a e l d s , o r e n a m e s , y o u c a n e a s i l y c r e a t e f o r m a t t e d s c r i p t s t h a t t aI n f o * E n g i n e w e b j e c t s .

S t a r t i n g a n d S t o p p i n g t h e T a s k E d i tW i t h W i n d c h i l l r u n n i n g , s t a r t t h e I n f o * E n g i n e T a s k E d i t o r i n o n e o f t h e f o l l o w i n g w a y s :

• F o r W i n d o w s , i f y o u a c c e p t e d t h e d e f a u l t s d u r i n g I n f o E n g i n e T a s k E d i t o r f r o m t h e S t a r t m e n u .

• Y o u c a n a l s o u s e t h e p l a t f o r m - a p p r o p r i a t e s t a r t u p ○ W i n d o w s : < W i n d c h i l l > / t a s k e d i t o r / b i n / m o d e l e r . b a t○ U n i x : < W i n d c h i l l > / t a s k e d i t o r / b i n / m o d e l e r

O n c e s t a r t e d , t h e I n f o * E n g i n e T a s k E d i t o r a t t e m p t s t

I f a n I n f o * E n g i n e S e r v e r a n d N a m i n g S e r v i c e a r e a vr e m o t e l y i n v o k e t a s k s o n a v a i l a b l e t a s k p r o c e s s o r s . t a s k s t o s u p p l y m o r e a d v a n c e d f u n c t i o n a l i t y s u c h a sd a t a b a s e t a b l e s a n d s t o r a g e o f t a s k s o u r c e i n L D A P .

I f m o r e t h a n o n e I n f o * E n g i n e S e r v e r o r N a m i n g S e r p r o m p t e d t o s e l e c t t h e o n e s y o u w a n t t o u s e .

T o s t o p I n f o * E n g i n e T a s k E d i t o r , s i m p l y c l o s e i t s w i




N a v i g a t i n g t h e T a s k E d i t o r T h e f o l l o w i n g s e c t i o n s a r e b r i e f d e s c r i p t i o n s o f

I n f o * E n g i n e T a s k E d i t o r .

P a n e l s T h e I n f o * E n g i n e T a s k E d i t o r c o n s i s t s o f f o u r p a a n d w e b j e c t s .

E d i t o r T h e e d i t o r i s t h e l a r g e p a n e l a t t h e r i g h t , a n d c o t a s k o r J S P . T h e t a b s a l o n g t h e t o p o f t h e p a n e l e i t h e r a t a s k o r J S P . Y o u c a n s w i t c h f r o m o n e e dc o r r e s p o n d i n g t a b . T h e t a b s a t t h e b o t t o m o f t h t h e s o u r c e c o d e o r r u n t h e t a s k o r J S P .

S e r v i c e s

W e b j e c t s T h e s e r v i c e s a n d w e b j e c t p a n e l s a r e t o t h e l e f t os e r v i c e s o n t o p a n d t h e i r c o r r e s p o n d i n g w e b j e c

T h e s e r v i c e s p a n e l d i s p l a y s t h e s e r v i c e s a n d a dc u r r e n t c o n g u r a t i o n y o u c h o s e d u r i n g s e t u p . Sr e c e p t a c l e i c o n . A d a p t e r s a r e l a b e l e d w i t h t h




B r o w s e T h e b r o w s e p a n e l i s l o c a t e d i n t h e l o w e r l e f t , a n d h t a s k s .

N o t e Y o u c a n c u s t o m i z e t h e s i z e a n d a v a i l a b i l i t y o f p a n e l s t h e p a n e l b o r d e r s .

M e n u s T h e f o l l o w i n g m e n u s a p p e a r :

F i l e M e n u

N e w C r e a t e a n e w I n f o * E n g i n e t a s k o r J S P .a p p e a r s i n t h e e d i t o r p a n e l . ( K e y b o a r d C T R L + T f o r a n e w t a s k o r C T R L + J f o

O p e n O p e n a n I n f o * E n g i n e t a s k o r J S P f r o m s y s t e m . T h e l e a p p e a r s i n t h e e d i t o r p as h o r t c u t : p r e s s C T R L + O . )

C l o s e C l o s e t h e I n f o * E n g i n e t a s k o r J S P c u r e d i t e d . ( K e y b o a r d s h o r t c u t : p r e s s C T R

C l o s e a l l C l o s e a l l I n f o * E n g i n e t a s k s o r J S P s c ue d i t e d .

S a v e S a v e t h e I n f o * E n g i n e t a s k o r J S P c u r r e d i t e d t o t h e i r s o u r c e l o c a t i o n . ( K e y b o p r e s s C T R L + S . )

S a v e A l l S a v e a l l I n f o * E n g i n e t a s k s o r J S P s c u re d i t e d t o t h e i r s o u r c e l o c a t i o n . ( K e y b o p r e s s C T R L + S H I F T + S . )

S a v e a s S a v e t h e a c t i v e I n f o * E n g i n e t a s k o r J S p a n e l t o a n e w l o c a t i o n o n t h e l o c a l l e

E x i t E x i t t h e I n f o * E n g i n e T a s k E d i t o r

E d i t M e n u U n d o U n d o t h e l a s t e d i t a c t i o n . ( K e y b o a r d s

C T R L + Z . ) R e d o R e d o t h e l a s t u n d o n e e d i t a c t i o n . ( K e y p r e s s C T R L + Y . )

C u t R e m o v e t h e c u r r e n t l y s e l e c t e d t e x t a n t h e s y s t e m c l i p b o a r d . ( K e y b o a r d s h o rC T R L + X . )

C o p y C o p y t h e c u r r e n t l y s e l e c t e d t e x t t o t h e c l i p b o a r d . ( K e y b o a r d s h o r t c u t : p r e s s C




E d i t M e n u P a s t e P a s t e i n f o r m a t i o n f r o m t h e s y s t e m

a c t i v e I n f o * E n g i n e t a s k o r J S P i n t( K e y b o a r d s h o r t c u t : p r e s s C T R L +

S e l e c t a l l S e l e c t a l l t h e t e x t o f t h e a c t i v e I n f oJ S P i n t h e e d i t o r p a n e l . ( K e y b o a r dC T R L + A . )

F i n d O p e n t h e F i n d / R e p l a c e w i n d o w t o l o c a t e t e x t t h e a c t i v e I n f o * E n g i n e t a s k o r J S P ( K e y b o a r d s h o r t c u t : p r e s s C T R L +

G o t o O p e n a G o T o L i n e w i n d o w t o m o v e t h e c u r s p e c i c l i n e w i t h i n t h e a c t i v e I n f o *J S P i n t h e e d i t o r p a n e l . ( K e y b o a r d

C T R L + G . ) M a t c h b r a c e s I f t h e c u r s o r i s a d j a c e n t t o a b r a c e c

m o v e s t h e c u r s o r t o t h e c o r r e s p o n d b r a c e c h a r a c t e r . ( K e y b o a r d s h o r t c

I f n o c o r r e s p o n d i n g o p e n o r c l o s e ba b e e p s o u n d s . I f t h e c u r s o r i s n o t ac h a r a c t e r , t h e n t h i s a c t i o n d o e s n o ta r e c o n s i d e r e d b r a c e c h a r a c t e r s : ( )

T o o l s M e n u E d i t t a g O p e n t h e E d i t o r w i n d o w f o r t h e t a g i n w h i c

i s p l a c e d i n t h e e d i t o r p a n e l . P r e f e r e n c e s O p e n t h e P r e f e r e n c e s w i n d o w , w h e r e y o u c a n

h o w t e x t a p p e a r s i n t h e e d i t o r a n d c p r e f e r e n c e s .

V i e w M e n u T o o l b a r s S h o w o r h i d e t h e e d i t o r , F i l e , E d i t , o r F i n d t o o l b a r s . S e r v i c e s / W e b j e c t s S h o w o r h i d e t h e s e r v i c e s a n d w e b

H e l p M e n u C o n t e n t s O p e n t h e H e l p w i n d o w . ( K e y b o a r d s h o r t cA b o u t O p e n t h e A b o u t w i n d o w .




T o o l b a r I c o n s

I c o n A c t i o n D e s c r i p t i o n I n s e r t a f o r E a c h b l o c k

C l i c k t h i s i c o n t o i n s e r t a f o r E a c h b l o c k i n t o y o u r I n f o * E n g i n e t a s k o r J S P s o u r cd r o p p i n g a f o r E a c h b l o c k i n t o y o u r s o u r c e ,w i n d o w o p e n s a l l o w i n g y o u t o e n t et h e g r o u p I n a n d g r o u p O u t a t t r i b u t e s .

I n s e r t a p a r a l l e l b l o c k

C l i c k t h i s i c o n t o i n s e r t a p a r a l l e l b l o c k i n t o y o u r I n f o * E n g i n e t a s k o r J S P s o u r c

I n s e r t a t a s k t a g C l i c k t h i s i c o n t o i n s e r t a t a s k t a g i n t o y o u r I n f o * E n g i n e t a s k o r J S P s o u r c e . W a t a s k i n t o y o u r s o u r c e , a w i n d o w o

a l l o w i n g y o u t o e n t e r v a l u e s f o r t h e p r o c e s s o r a t t r i b u t e s . Y o u a r e a l s o a p a r a m e t e r s t o b e s e n t a l o n g w i t h t h e x e c u t e t h e t a s k .

I n s e r t a d e c l a r a t i o n b l o c k

C l i c k t h i s i c o n t o i n s e r t a d e c l a r a t i oy o u r I n f o * E n g i n e t a s k o r J S P s o u r c

I n s e r t a s c r i p t l e t b l o c k

C l i c k t h i s i c o n t o i n s e r t a s c r i p t l e t by o u r I n f o * E n g i n e t a s k o r J S P s o u r c

I n s e r t a J S P

e x p r e s s i o n b l o c k

C l i c k t h i s i c o n t o i n s e r t a n e x p r e s s i

y o u r I n f o * E n g i n e t a s k o r J S P s o u r cI n s e r t J S P t a g l i b d i r e c t i v e

C l i c k t h i s i c o n t o i n s e r t a t a g l i b d i r e c t i v e i n t o y o u r I n f o * E n g i n e t a s k o r J S P s o u r c

I n s e r t J S P p a g e d i r e c t i v e

C l i c k t h i s i c o n a n d t h e n c l i c k i n t h e t o i n s e r t a p a g e d i r e c t i v e i n t o y o u r I n f o * E t a s k o r J S P s o u r c e .

E d i t t a g C l i c k i n g t h e e d i t i c o n w i t h t h e c ut a g d i s p l a y s t h e a s s o c i a t e d t a g e d i t om a k e t h e d e s i r e d c h a n g e s . W h e n nO K t o a p p l y t h e c h a n g e s .

T a g e d i t o r s a r e a v a i l a b l e f o r s e v e r at y p e s o f t a g s , s u c h a s w e b j e c t , t a s k , p a r a m , f o r E a c h , J S P p a g e d i r e c t i v e , a n d J S P t a g l i b d i r e c t i v e .




O p e n i n g a n E x i s t i n g I n f o * E n g i n eY o u c a n u s e t h e I n f o * E n g i n e T a s k E d i t o r t o o p e n

l e s , r e g a r d l e s s o f w h e t h e r t h e y w e r e c r e a t e d w i tU s e t h e b r o w s e p a n e l t o n a v i g a t e t o a n e x i s t i n g t at h e p a n e l b o r d e r s t o v i e w t h e b r o w s i n g t o o l b a r o

A l t e r n a t i v e l y , s e l e c t F i l e ▶ ▶ ▶ O p e n ▶ ▶ ▶ O p e n F i l e . T h e O p e n w i n d o w o p e n s , w h y o u c a n b r o w s e f o r t a s k a n d J S P l e s :

S e l e c t t h e l e y o u w a n t a n d c l i c k O p e n , a n d t h e s e l e c t e d l e a p p e a r s p a n e l .

C r e a t i n g a n I n f o * E n g i n e T a s k o r W i t h t h e I n f o * E n g i n e T a s k E d i t o r , y o u c a n c r e a t ec r i t e r i a a s e x p l a i n e d i n I n f o * E n g i n e J S P P a g e s o n p a g e 5 9 w i t h m i n i m a l c o d e




N e w T a s k T o c r e a t e a n e w t a s k , s e l e c t F i l e ▶ ▶ ▶ N e w ▶ ▶ ▶ N e w t a s k . T h i s o p e n s a n e d i t o r p a n e

n e w t a s k . S c r i p t l e t s f o r p a g e a n d t a g l i b d i r e c t i v e s a r e a l r e a d y a d d e d at o s e t t i n g s c h o s e n i n P r e f e r e n c e s .

Y o u c a n c h a n g e t h e c o n t e n t o f e d i t a b l e t a g s o r d i r e c ta n y w h e r e i n t h e s c r i p t l e t a n d c l i c k i n g t h e e d i t i c o n

F o r e x a m p l e , p l a c i n g t h e c u r s o r i n t h e t a g l i b d i r e c t i v e a n d c l i c k i n g o pt h e t a g l i b w i n d o w :




N e w J S P T o c r e a t e a n e w J S P , s e l e c t F i l e ▶ ▶ ▶ N e w ▶ ▶ ▶ N e w J S P . T h i s o p e n s t h e N e w J S P w i n d o w ,

w i t h e l d s a n d d r o p - d o w n m e n u s f o r y o u t o e n t e r p a g e a n d t a g l i b d i r e c t i v e s :

C l i c k O K a n d t h e a p p r o p r i a t e c o d i n g i s p l a c e d a t t h e t

E n t e r i n g a n d E d i t i n g I n f o * E n g i n T h e I n f o * E n g i n e T a s k E d i t o r a l s o h e l p s y o u t o c I n f o * E n g i n e t a s k s a n d J S P t a g s .






F i l l i n t h e d e s i r e d p a r a m e t e r v a l u e s a n d c l i c k O K t o i n s e r t t h e w e b j e c t i n I n f o * E n g i n e t a s k o r J S P s o u r c e .

T a g a n d W e b j e c t E d i t o r s T h e r e a r e t h r e e w a y s t o o p e n a t a g e d i t o r w i n d o w

• R i g h t - c l i c k a n y w h e r e w i t h i n a t a g , w e b j e c t , o e l e m e n t h a s e d i t i n g f u n c t i o n a l i t y a v a i l a b l e , a n E d i t m e s s a g e a p p e a r s . C m e s s a g e t o o p e n a n e d i t o r w i n d o w .

• C l i c k a n y w h e r e w i t h i n a t a g , w e b j e c t , o r d i r e c T o o l s m e n u . I f t h e s e l e c t e d e l e m e n t h a s e d i t i n g f u n c t E d i t t a g o p t i o n i s c l i c k a b l e a n d o p e n s a n e d i t o r w i n d o w

• C l i c k a n y w h e r e w i t h i n a t a g , w e b j e c t , o r d i r e c

F o r s o m e t a g s a n d w e b j e c t s , t h e r e i s a s e c o n d l e v w o r k i n g w i t h w e b j e c t s , y o u c a n d o u b l e - c l i c k t h ew i n d o w o p e n s , a l l o w i n g y o u t o e d i t s o m e p a r a m

a p a r a m e t e r e d i t o r w h e r e y o u c a n e d i t o t h e r p a r a d e f a u l t , d e l i m , e l e m e n t S e p a r a t o r a n d v a l u e S e p a r a t o r :




S i m i l a r l y , w h e n w o r k i n g w i t h a t a s k t a g e d i t o r w i n d o w , y o u c a n d o u b w i t h i n t h e N a m e e l d a n d a n e w w i n d o w o p e n s t o e d i t p a r a m e

E d i t o r w i n d o w s a r e a v a i l a b l e f o r s e v e r a l d i f f e r e n t t y w e b j e c t , t a s k , p a r a m , f o r E a c h , t h e J S P p a g e d i r e c t i v e , a n d t h e J S P t a g l i b d i r e c t i v e . T h e y a r e a l s o a v a i l a b l e f o r m o s t w e b j e c t s .

1 0 0 I n f o * E n g i n e ® U s e r ’ s G u i d e



T a g I n s i g h t T h e t e x t e d i t o r c a n m a k e s u g g e s t i o n s r e l a t i v e t o t

t y p i n g t h e s t a r t o f a t a g t h a t i t r e c o g n i z e s , i t d i s p l t a g s f r o m w h i c h y o u c a n s e l e c t .

I n f o * E n g i n e T a s k s 1 0 1



B y d e f a u l t , T a g I n s i g h t i s a v a i l a b l e f o r s e v e r a l t y p e s I n f o * E n g i n e c o r e , s u p p l i e d , a n d d i r e c t o r y t a g s . Y o uI n s i g h t o n t h e T a g I n s i g h t t a b o f t h e P r e f e r e n c e s w i n d o w :

U n d e r s t a n d i n g X M L O u t p u t I n f o * E n g i n e G r o u p s I n f o * E n g i n e m a i n t a i n s a l l g e n e r a t e d g r o u p s a s s e r i a o b j e c t s c a n b e e a s i l y m a n i p u l a t e d b y c u s t o m J a v a a p t a s k s . T h e n , w h e n t h e r e i s a r e q u e s t t o d i s p l a y a g r o u X M L d o c u m e n t c o n t a i n i n g t h e g r o u p .

B y d e f a u l t , t h e I n f o * E n g i n e g e n e r a t e d X M L d o c u m p a r t s :

• T h e d o c u m e n t d e c l a r a t i o n a t t h e b e g i n n i n g o f t h e • T h e w c : C O L L E C T I O N e l e m e n t , w h i c h i s t h e d o c u m e n t r o o t

I n f o * E n g i n e g e n e r a t e d X M L d o c u m e n t s . • T h e r o o t g r o u p e l e m e n t , w h i c h i s n a m e d t h r o u g h t

w e b j e c t s t h a t p r o d u c e o u t p u t g r o u p s . F o r e x a m p l e i s s e t t o “ E m p l o y e e s , ” t h e n t h e r o o t g r o u p e l e m e n t




< E m p l o y e e s > . I n a d d i t i o n t o t h e e l e m e n t n a m e , t h e ga l w a y s i n c l u d e s t h e N A M E a t t r i b u t e . T h e v a l uf r o m t h e g r o u p n a m e s p e c i e d o n t h e G R O U P _t h a t c r e a t e d t h e g r o u p .

• T h e w c : I N S T A N C E e l e m e n t s , w h i c h i d e n t i f y I n f o * E n g w i t h i n a g r o u p . E a c h I n f o * E n g i n e o b j e c t c o n t as u b - e l e m e n t s o f a w c : I N S T A N C E e l e m e n t .

T h e s e p a r t s a r e d e s c r i b e d i n d e t a i l i n t h e f o l l o w i nI n f o * E n g i n e X M L o u t p u t , s e e t h e e x a m p l e X M L G r o u p W e b j e c t s o n p a g e 3 6 0 .

I n a d d i t i o n , I n f o * E n g i n e c a n a l s o g e n e r a t e X M Lt h a t i s p a r t o f t h e g r o u p , e l e m e n t , o r a t t r i b u t e d a t

D o c u m e n t D e c l a r a t i o n X M L d o c u m e n t s m u s t b e g i n w i t h a n X M L d e c l a X M L b e i n g u s e d a n d t h e c h a r a c t e r e n c o d i n g f o r tv e r s i o n o f X M L d e n e d b y t h e W 3 C , a n d u s e d b yI n f o * E n g i n e s u p p o r t s U T F 8 f o r t h e c h a r a c t e r e n I n f o * E n g i n e t h e r e f o r e b e g i n s w i t h t h e f o l l o w i n g

< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? >

A n X M L “ n a m e s p a c e ” i s a c o l l e c t i o n o f n a m e s , [ R F C 2 3 9 6 ] , w h i c h a r e u s e d i n X M L d o c u m e n t s a t t r i b u t e n a m e s . A n a m e s p a c e a l l o w s a n X M L a v o c a b u l a r y t o p r e v e n t n a m i n g c o l l i s i o n s . I n f o * Eh t t p : / / w w w . p t c . c o m / i n f o e n g i n e / 1 . 0 , a n d a s s o c i a t e s t h e n a m p r e x w c : t o a l l I n f o * E n g i n e d e n e d e l e m e n t s a n d a t

< w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i

T h e d o c u m e n t e n t i t y , a l s o k n o w n a s t h e d o c u m e e n t i t y t r e e a n d a s t a r t i n g - p o i n t f o r a n X M L p r o c ew c : C O L L E C T I O N e l e m e n t a s t h e d o c u m e n t r o o t f o r a l l I nX M L d o c u m e n t s .

I n f o * E n g i n e G r o u p s T h e s e r i a l i z a b l e o b j e c t s u s e d f o r m a n i p u l a t i n g I nv a l u e s o f t h e w e b j e c t C L A S S a n d G R O U P _ O U Tw h e n t h e g r o u p w a s c r e a t e d . T h e v a l u e o f t h e C L t h e e l e m e n t n a m e f o r t h e r o o t e l e m e n t o f t h e g r o uG R O U P _ O U T p a r a m e t e r i s u s e d a s t h e N A M E a




e x a m p l e , i f a C L A S S p a r a m e t e r i s s e t t o “ D e m o G r p ” p a r a m e t e r i s s e t t o “ s a l e s G r p , ” t h e n I n f o * E n g i n e g e nd o c u m e n t e l e m e n t s :

< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? > < w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o< D e m o G r p N A M E = " s a l e s G r p " T Y P E = " O b j e c t " S T A T U S = " < / D e m o G r p > < / w c : C O L L E C T I O N >

I f t h e w e b j e c t C L A S S p a r a m e t e r i s u n d e n e d o r o m i t“ U n k n o w n - C l a s s - N a m e ” a s t h e e l e m e n t n a m e . T h o ut o o m i t t h e C L A S S p a r a m e t e r , t h e t a s k w r i t e r s h o u l d p a r a m e t e r . O m i t t i n g t h e C L A S S p a r a m e t e r m a k e s t hF o r e x a m p l e t h e f o l l o w i n g X M L e l e m e n t s d e n e t w o“ e m p l o y e e s ” a n d a n u n n a m e d g r o u p . I n t h e e x a m p l eu n d e r s t a n d w h a t d a t a t h e u n n a m e d g r o u p r e p r e s e n t s

< w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o e< E m p l o y e e s N A M E = " g r o u p 1 " T Y P E = " O b j e c t " S T A T U S = " < / E m p l o y e e s > < / w c : C O L L E C T I O N >

T h e g r o u p e l e m e n t c o n t a i n s t w o o t h e r a t t r i b u t e s : T Y a t t r i b u t e i n d i c a t e s t h e g r o u p t y p e . F o r d a t a g r o u p s , t h O b j e c t . T h e S T A T U S a t t r i b u t e i n d i c a t e s t h e c o m p l e t i o n s t a t

g r o u p . A s t a t u s o f z e r o ( 0 ) i n d i c a t e s t h a t n o e r r o r s o c i n d i c a t e s t h a t d a t a i s i n c o m p l e t e d u e t o s o m e e r r o r . Ag r o u p s n o l o n g e r n e e d t o b e c h e c k e d , t h e S T A T U S a tc o m p a t i b i l i t y . I n f o * E n g i n e c u r r e n t l y t h r o w s a n e x c c a n n o t g e n e r a t e t h e r e q u e s t e d g r o u p .

I n f o * E n g i n e O b j e c t s A n I n f o * E n g i n e g r o u p c a n c o n t a i n o n e o r m o r e o b j ed o c u m e n t , e a c h o b j e c t i s i d e n t i e d b y t h e < w c : I N S T A N C E > s t a r t t a g a n d < / w c : I N S T A N C E > e n d t a g . O b j e c t s c a n c o n t a i n z e r o o r m o r ee a c h a t t r i b u t e c a n c o n t a i n d a t a . E a c h I n f o * E n g i n e a ts u b - e l e m e n t t h a t a p p e a r s w i t h i n t h e w c : I N S T A N C E e l e m e n t .

F o r e x a m p l e , a s s u m e t h a t t h e f o l l o w i n g X M L d o c u mI n f o * E n g i n e g r o u p d e l i m i t e d b y t h e < E M P > a n d < / E M P > t a g s , w h i c h c o n t a i n s a s i n g l e o b j e c t . T h e o b j e c t i s d e l i m i t e d b y t h e < w c : I N S T A N C E > a n d < / w c : I N S T A N C E > t a g s :

< w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o e< E M P N A M E = " e m p G r p " T Y P E = " O b j e c t " S T A T U S = " 0 " >




< w c : I N S T A N C E > < E M P N O > 7 9 3 4 < / E M P N O > < E N A M E > M I L L E R < / E N A M E >

< J O B > C L E R K < / J O B > < M G R > 7 7 8 2 < / M G R > < H I R E D A T E > 1 9 8 2 - 0 1 - 2 3 0 0 : 0 0 : 0 0 . 0 < / H I R E D A T E > < S A L > 1 3 0 0 < / S A L > < C O M M / > < D E P T N O > 1 0 < / D E P T N O > < / w c : I N S T A N C E > < / E M P > < / w c : C O L L E C T I O N " >

I n t h e e x a m p l e , y o u c a n s e e t h e s u b - e l e m e n t t a g sa n d c a n d e t e r m i n e t h a t t h e o b j e c t h a s t h e f o l l o w i

E M P N O E N A M E J O B M G R H I R E D A T E S A L C O M M D E P T N O

M e t a d a t a i n X M L O u t p u t M e t a d a t a i s i n f o r m a t i o n a b o u t n o r m a l a p p l i c a t i oe l e m e n t , o r a t t r i b u t e . F o r e x a m p l e , m e t a d a t a c a ni n f o r m a t i o n s u c h a s d a t a t y p e i n f o r m a t i o n . I t c o ua b o u t r e l a t i o n s h i p s b e t w e e n t h e e l e m e n t s i n a g r i n a n e l e m e n t .

S o f t w a r e t h a t i n t e r f a c e s w i t h W i n d c h i l l c a n g e n eW i n d c h i l l a t t r i b u t e t y p e i n f o r m a t i o n i s s t o r e d a sa u t o m a t i c a l l y p a s s e d a l o n g w i t h t h e I n f o * E n g i n a d d i t i o n , y o u c a n s e t m e t a d a t a u s i n g t h e S e t - M e t

B y d e f a u l t , m e t a d a t a i s n o t i n c l u d e d w h e n X M L D i s p l a y - X M L w e b j e c t . T o i n c l u d e m e t a d a t a i n yF U L L m o d e o n t h i s w e b j e c t .

I n t h e X M L o u t p u t t h a t i n c l u d e s m e t a d a t a , m e t a < w c : M e t a > s t a r t t a g s a n d < / w c : M e t a > e n d t a g s .




N e s t i n g T a s k s A l t h o u g h a n y n u m b e r o f w e b j e c t s c a n b e i n c l u d e d w

w h e n r e p e t i t i v e t a s k s a r e p e r f o r m e d . C a n d i d a t e s f o rg e n e r a l t a s k t h a t m i g h t b e u s e d u n d e r m u l t i p l e c o n d is u b s t i t u t i o n ( w h i c h i s d e s c r i b e d i n D y n a m i c P a r a m e t e r V a l u e S u b s t i t4 0 ) , y o u c a n e a s i l y c o n s t r u c t t a s k s t h a t c a n b e u s e d m u

Y o u c a n n e s t t a s k s b y s p e c i f y i n g t h e I n f o * E n g i n e c u t a s k t a g w i t h i n a t a s k .

t a s k T a g R u l e s f o r N e s t i n g T a s k s W h e n w o r k i n g w i t h t h e I n f o * E n g i n e t a s k t a g , t h e f o l l o w i n g r u l e s a p p l y :

• Y o u c a n n e s t a n y n u m b e r o f t a s k s w i t h i n a n o t h e r t c o n t a i n o t h e r n e s t e d t a s k s .

• T h e t a s k l e b e i n g r e f e r e n c e d c a n a l s o c o n t a i n a n ya n y o f t h e c u s t o m t a g s t h a t a r e a v a i l a b l e t o t a s k s .

• Y o u s h o u l d a l w a y s p r o v i d e e x c e p t i o n p r o c e s s i n g e r r o r s w h e n n e s t e d t a s k s f a i l .

T h e s y n t a x a n d c o m p l e t e d e s c r i p t i o n o f t h e t a s k t a g i s d e s c r i b e d i n t a s k T a g o n p a g e 2 6 5 .

S i m p l e N e s t e d T a s k E x a m p l e T h e f o l l o w i n g t a s k i n c l u d e s a t a s k t a g t h a t e x e c u t e s a n o t h e r t a s k n a mQ u e r y T a s k . x m l :





< i e : t a s k u r i = " i n f o e n g i n e / e x a m p l e s / Q u e r y T a s k . x m l " /

< ! - - I f t a s k f a i l s , p r i n t m e s s a g e t o s t d e r r a n d t h r o w e x c e p t i o n - - >

 < % S y s t e m . e r r . p r i n t l n ( " F A I L U R E w h e n c a l l i n g Q u e r y T a % > 










A s s u m e t h e Q u e r y T a s k . x m l l e c o n t a i n s t h e f o l l o w i n g :



 



F o r a d d i t i o n a l e x a m p l e s o f w e b j e c t s t h a t c a n b e u D y n a m i c P a r a m e t e r V a l u e S u b s t i t u t i o n o n p a g e 4 0 .






5 P a c k a g e

A b o u t P a c k a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P r o v i d i n g L D A P D i r e c t o r y I n f o r m a t i o n . . . . . . . . . . . . . . . . . . . . . . . U s i n g t h e P a c k a g e M a n a g e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

T h e f o l l o w i n g t o p i c s d i s c u s s c r e a t i n g , i n s t a l l i n g o r g a n i z e y o u r L D A P d i r e c t o r y , a s w e l l a s h o w t o p a c k a g e s .

1 0 9



A b o u t P a c k a g e s A p a c k a g e i s a s e t o f l e s t o b e d e l i v e r e d i n t o y o u r t a s

a s s o c i a t e d L D A P i n f r a s t r u c t u r e e n t r i e s r e q u i r e d f o r U t i l i z i n g p a c k a g e s a l l o w s t h e s e l e s a n d d i r e c t o r y e na n d u n i n s t a l l e d f r o m a s y s t e m i n s e t s r a t h e r t h a n i n d ia l s o g r e a t l y s i m p l i e s t h e i n s t a l l a t i o n a n d m a i n t e n a nr e q u i r i n g u p d a t e s t o t h e L D A P .

T a s k p a c k a g e s m a y c o n t a i n a n y l e s t o b e d e l i v e r e d ic o m m o n l y X M L t a s k s , X S L s t y l e s h e e t s , a n d t a g l i b p a c k a g e l e n a m e s e n d w i t h t h e e x t e n s i o n . p t c t a r .

P r o v i d i n g L D A P D i r e c t o r y I nS o m e I n f o * E n g i n e - b a s e d a p p l i c a t i o n s l i k e w e b s e r va p p l i c a t i o n s , o r o t h e r f e d e r a t e d a p p l i c a t i o n s m a y r e qW h i l e t h i s k i n d o f i n f o r m a t i o n c a n b e p r o v i d e d u s i n gm a y g e t v e r y c o m p l i c a t e d a n d m u s t b e m a i n t a i n e d a ne x p a n d s o r c h a n g e s .

W i t h p a c k a g e s , t h i s L D A P i n f o r m a t i o n c a n b e p r o v i p r o p e r t i e s e i t h e r d i r e c t l y i n t h e t a s k s o u r c e o r w i t h i n . d e l e g a t e I n f o p r o p e r t i e s

l e s .

P r o p e r t y D e n i t i o n s T h e f o l l o w i n g p r o p e r t i e s c a n b e s p e c i e d i n e i t h e r a . d e l e g a t e I n f o p r o p e r t i e s l e o r a t a s k . F o r d e t a i l s o n t h e s p e c i c a t i o n f o r m a t f o

t h e a p p r o p r i a t e s e c t i o n b e l o w :

r e p o s i t o r y T y p e S p e c i e s t h e r e p o s i t o r y t y p e t h a t t y p e i d e n t i e r s a nu n d e r . T h i s p r o p e r t y s h o u l d n o t b e s p e c i e d u n l e s sa p r o d u c t t h a t h a s d e n e d a r e p o s i t o r y t y p e o t h e r t hI n s t a l l a t i o n t o o l s d e t e r m i n e t h e a p p r o p r i a t e r e p o s ir e p o s i t o r y t h e p a c k a g e i s b e i n g i n s t a l l e d u n d e r . I n sr e p o s i t o r y t y p e o f “ c o m . p t c . w i n d c h i l l . ”

t y p e I d S p e c i e s t h e t y p e i d e n t i e r u n d e r w h i c h d e l e g a t e s p r o p e r t y i s n o t s p e c i e d , t h e n t h e i n s t a l l a t i o n t o o l i d e n t i e r b y t h e t a s k d i r e c t o r y h i e r a r c h y . F o r e x a mt h e “ o r g / m y O r g / P e r s o n ” d i r e c t o r y i s a s s u m e d t o h “ o r g . m y O r g . P e r s o n . ”




d e l e g a t e N a m e S p e c i e s t h e n a m e o f a t a s k d e l e g a t e . T h i s p r o pa t a s k , a n d t h e n o n l y i f t h e t a s k l e n a m e ( m i n u s . x m l e x t e n s i o n ) d i f f ef r o m t h e n a m e o f t h e c o m m a n d d e l e g a t e b e i n g

i n s t a l l D e l e g a t e S p e c i e s w h e t h e r a s i n g l e d e l e g a t e o r g r o u p o f t h e L D A P d i r e c t o r y . T h e v a l u e o f t h i s p r o p e r t yu s e f u l f o r u t i l i t y t a s k s t h a t a r e n e v e r d i r e c t l y c ar e q u i r e s n o d e l e g a t e e n t r y i n t h e L D A P d i r e c t of o r a t a s k t h a t i s n e v e r e x t e r n a l l y i n v o k e d d o e s s t r u c t u r e , a v o i d i n g t h e c r e a t i o n o f s u c h d e l e g a c o n t e n t s c l e a n e r . S p e c i f y F A L S E t o p r e v e n t d e l e g a t e s f r o m b e T h e d e f a u l t f o r t h i s p r o p e r t y i s T R U E .

P r o p e r t y D e n i t i o n s i n a P r o p e r t iP r o p e r t i e s c a n b e d e n e d i n a s p e c i a l J a v a p r o p e. d e l e g a t e I n f o . A n y p r o p e r t i e s s p e c i e d i n a . d e l e g a t e I n f o l e a r e i n h e r i t e d b y a l l e n t r i e s b e l o w t h a t l e v e l i n t h e d i r a l s o h a v e t h e i r o w n . d e l e g a t e I n f o l e s t h a t w o u l d s u p e r s e d e t hs p e c i e d i n a h i g h e r l e v e l d i r e c t o r y .

P r o p e r t i e s c a n b e s p e c i e d i n t h e . d e l e g a t e I n f o l e a s i n a n y s t a n d a r d p r o p e r t i e s l e . F o r e x a m p l e : t y p e I d = W C T Y P E | w t . p a r t . W T P a r t

P r o p e r t y D e n i t i o n s i n a T a s k P r o p e r t i e s d e n e d w i t h i n a t a s k s u p e r s e d e p r o p e T a s k s w i t h t h e s e d e n e d p r o p e r t i e s a r e s o m e t i m et a s k s .

S i n c e I n f o * E n g i n e t a s k s a r e n o t J a v a p r o p e r t i e s s p e c i e d i n a d i f f e r e n t m a n n e r :

• P r o p e r t i e s w i t h i n I n f o * E n g i n e t a s k s m u s t b e sc o m m e n t s e c t i o n t h a t b e g i n s w i t h t h e c o m . i n f o e n g i n e . d e l e g i d e n t i e r . T h i s i d e n t i e r i n f o r m s t h e P a c k a g e M

t h a t p r o p e r t i e s a r e s p e c i e d . • E a c h p r o p e r t y d e n i t i o n m u s t b e p r e c e d e d b y a @ ) . A n y l i n e s i n

t h e c o m m e n t s e c t i o n t h a t d o n o t b e g i n w i t h @ a r e r e g i s t e r e d a s a c o m u s e d i n t h e d e s c r i p t i o n o f a n i n s t a l l e d d e l e g a t e

• T h e p r o p e r t y n a m e a n d v a l u e m u s t b e s e p a r a t ef o l l o w i n g i s a n e x a m p l e o f a s e l f - d e s c r i b i n g t a

< ! - - c o m . i n f o e n g i n e . d e l e g a t e . d e f t h i s i s t h e d e l e g a t e d e s c r i p t i o n

P a c k a g e s 1 1 1



@ d e l e g a t e N a m e g e t - n a m e - - >

U s i n g t h e P a c k a g e M a n a g e r T h e P a c k a g e M a n a g e r u t i l i t y i s a s i m p l e J a v a a p p l i c aa n d u n i n s t a l l s t a s k p a c k a g e s . T h e m a i n J a v a c l a s s f o c o m . i n f o e n g i n e . a d m i n i s t r a t i o n . p a c k a g i n g . T h e P a c k a g e M a n a g e r c a n b e s t a r t e d f r o m a w i n d c h i l l s h e l l . F o r e

w i n d c h i l l " - - j a v a a r g s = - D p r o p F i l e = < W i n d c h i l l > / c o d e b a s e / w t . p r o p e r t i e s " c o m . i n f o e n g i n e . a d m i n i s t r a t i o n . p a c k a g i n g . U I

T h e c l a s s p a t h c a n b e s p e c i e d e i t h e r a s t h e C L A S S P Ao r o n t h e J a v a c o m m a n d l i n e . A n e x a m p l e o f t h e c l a sc o m m a n d l i n e i s : j a v a - c l a s s p a t h c l a s s p a t h c o m . i n f o e n g i n e . a d m i n i s t r a t i o n . p a c k a g i

w h e r e c l a s s p a t h i s t h e c l a s s p a t h n o t e d a b o v e .

S t a r t i n g t h e P a c k a g e M a n a g e r T o s t a r t t h e P a c k a g e M a n a g e r , u s e t h e f o l l o w i n g p r o

1 . E x e c u t e o n e o f t h e f o l l o w i n g c o m m a n d s : j a v a c o m . i n f o e n g i n e . a d m i n i s t r a t i o n . p a c k a g i n g . U I

o r j a v a - D p r o p F i l e = ( < W i n d c h i l l > ) / c o d e b a s e / w t . p r o p e r t i e s c o m . i n f o e n g i n e . a d m i n i s t r a t i o n . p a c k a g i n g . U I




T h e P r o p e r t i e s w i n d o w o p e n s .

N o t e S p e c i f y i n g t h e p r o p F i l e p r o p e r t y o n t h e c o m m a n d l i n e a v t o b r o w s e t o t h e l o c a t i o n o f y o u r p r o p e r t y l e i n t

2 . V e r i f y o r e n t e r t h e i n f o r m a t i o n i n t h e P r o p e r t i e s w i n d o w e l d s a s n e e d

• P r o p e r t y F i l e — I f y o u d i d n o t s p e c i f y t h e p r o p F i l e p r o p e r t y o n t h e c o m m a n d l i n e , c l i c k B r o w s e a n d b r o w s e t o y o u r p r o p e r t i e s

• N a m i n g S e r v i c e N a m e — T h e r u n t i m e s e r v i c e n a m e o f y o

T h i s s e r v i c e m u s t e x i s t i n t h e L D A P d i r e c t o rc o n g u r e d .

• V M N a m e — T h e n a m e o f y o u r W i n d c h i l l v i r t u a l m b e t h e r u n t i m e s e r v i c e n a m e o f y o u r W i n d c h

• R e p o s i t o r y — T h e n a m e o f y o u r i n s t a l l a t i o n r e p o s m u s t e x i s t i n o u r d i r e c t o r y r e l a t i v e t o y o u r n aT y p i c a l l y t h i s v a l u e i s y o u r f u l l y q u a l i e d h o

3 . C l i c k O K .

I f t h e r e i s a p r o b l e m w i t h a n y o f t h e v a l u e s , t h e P r o p e r t i e s w i n d o w i s p r e s e a g a i n w i t h t h e p r o b l e m v a l u e d i s p l a y e d i n r e d .

I f a l l s u p p l i e d v a l u e s a r e a c c e p t a b l e , t h e P a c k a

N a v i g a t i n g t h e P a c k a g e M a n a g e T h e P a c k a g e M a n a g e r p r o v i d e s a s i m p l e i n t e r f a ct h a t a r e p a r t o f t h e p a c k a g e , a n d t o s u p p l y b a s i c p

P a c k a g e s 1 1 3



T h e P a c k a g e M a n a g e r w i n d o w c o n s i s t s o f a t o o l b a r a n d t h r e e p a

T h e p a n e l s l i s t t h e f o l l o w i n g i n f o r m a t i o n : • P a c k a g e s — D i s p l a y s a n y p a c k a g e s i n s t a l l e d o n y o u r s y

c u r s o r o v e r t h e p a c k a g e n a m e d i s p l a y s t h e p a c k a g a v a i l a b l e ) .

• F i l e s — D i s p l a y s a l l l e s i n s t a l l e d a s a p a r t o f t h e s e l e cn a m e s i n t h i s l i s t a r e a b s o l u t e .

• E n t r i e s — D i s p l a y s a l l o f t h e L D A P d i r e c t o r y e n t r i e s c p a c k a g e i n s t a l l a t i o n .

T y p i c a l l y , t h e r s t t i m e y o u s t a r t t h e P a c k a g e M a n a g a s n o p a c k a g e s h a v e b e e n i n s t a l l e d .

T h e i c o n s o n t h e t o o l b a r i n c l u d e : • I n s t a l l P a c k a g e

• U n i n s t a l l P a c k a g e

N o t e I f y o u h a v e n o t s e l e c t e d a n i n s t a l l e d p a c k a g e f r o m t h P a c k a g e s l i s t , t h e n t h e u n i n s t a l l p a c k a g e i c o n i s n o t e n a b l e d .

• N e w T a s k P a c k a g e




C r e a t i n g P a c k a g e s T o c r e a t e a p a c k a g e , u s e t h e f o l l o w i n g p r o c e d u r e

1 . S t a r t t h e p a c k a g e m a n a g e r . F o r m o r e i n f o r m a S t a r t i n g t h e P a c k aM a n a g e r o n p a g e 1 1 2 .

2 . T o c r e a t e a t a s k p a c k a g e , c l i c k N e w T a s k P a c k a g e

T h e N e w T a s k P a c k a g e : S e l e c t T a s k s w i n d o w o p e n s .

T h e N e w T a s k P a c k a g e : S e l e c t T a s k s w i n d o w c o n t a i n s t h r e e p a n

• T h e u p p e r l e f t p a n e l l i s t s a l l d i r e c t o r i e s t h a t r o o t o f t h e a p p r o p r i a t e l e s y s t e m ( e i t h e r t h e c o n g u r a t i o n s p e c i c a t i o n h i e r a r c h y ) .

• T h e l o w e r l e f t p a n e l l i s t s l e s t h a t c a n b e f o u s e l e c t e d i n t h e u p p e r l e f t l i s t .

• T h e p a n e l o n t h e r i g h t l i s t s t h e l e s o r d i r e c t o

P a c k a g e s 1 1 5



3 . S e l e c t t h e d i r e c t o r i e s o r l e s t o b e p a c k a g e d :

• T o p a c k a g e a n e n t i r e d i r e c t o r y a n d i t s c o n t e n t s , s

l i s t o n t h e u p p e r l e f t a n d c l i c k t h e a d d b u t t o n tn a m e t o t h e l i s t o n t h e r i g h t .

• T o p a c k a g e a s p e c i c l e a n d n o t a n e n t i r e d i r e c t od i r e c t o r y i n t h e l i s t o n t h e u p p e r l e f t , t h e n s e l e c t t

t h e l i s t o n t h e l o w e r l e f t . C l i c k t h e a d d b u t t o n t h e l i s t o n t h e r i g h t .

• I f y o u h a v e s e l e c t e d a l e o r d i r e c t o r y t h a t y o u d o

s e l e c t i t i n t h e l i s t o n t h e r i g h t , a n d c l i c k t h e r e m or e m o v e i t f r o m t h e p a c k a g e l i s t .

4 . C l i c k N e x t t o o p e n t h e N e w T a s k P a c k a g e : P a c k a g e I n f o r m a t i o n w i n d o w .

5 . I n t h e N e w T a s k P a c k a g e : P a c k a g e I n f o r m a t i o n w i n d o w , s p e c i f y t h e i d e n t i c a t i o n a n d l o c a t i o n i n f o r m a t i o n f o r t h e p a c k

• I n t h e P a c k a g e N a m e e l d , e n t e r t h e p a c k a g e n a m e . T h e p a s h o u l d b e d e s c r i p t i v e , a n d c a n c o n t a i n s p a c e s a n v a l u e e n t e r e d i n t h i s e l d i s u s e d f o r t h e i n s t a l l e d a s d i s p l a y e d i n t h e P a c k a g e M a n a g e r , a n d , i n a c f o r t h e p a c k a g e l e n a m e . F o r t h e l e n a m e , a n y c n o n - a l p h a n u m e r i c a r e r e m o v e d . F o r e x a m p l e , i fv a l u e i n t h e P a c k a g e N a m e e l d w h e n c r e a t i n g a t a s k p a c k a g e M y C o m p a n y ’ s W e b S e r v i c e




t h e n t h e p a c k a g e l e n a m e i s : m y C o m p a n y s W e b S e r v i c e . p t c t a r

• I n t h e D e s c r i p t i o n e l d , e n t e r a d e s c r i p t i o n o f t h e p a c ke n t e r e d i n t h i s e l d d i s p l a y s w h e n y o u h o v e r p a c k a g e n a m e o n t h e P a c k a g e M a n a g e r .

• N e x t t o t h e S a v e T o D i r e c t o r y e l d , c l i c k B r o w s e t o s e l e c t t h e d i r e c t ow h e r e t h e p a c k a g e i s t o b e s a v e d .

6 . C l i c k F i n i s h t o c r e a t e t h e p a c k a g e .

I n s t a l l i n g P a c k a g e s T o i n s t a l l a p a c k a g e , u s e t h e f o l l o w i n g p r o c e d u r

1 . S t a r t t h e P a c k a g e M a n a g e r . F o r m o r e i n f o r m a S t a r t i n g t h e P a c k aM a n a g e r o n p a g e 1 1 2 .

2 . C l i c k I n s t a l l P a c k a g e .

T h e O p e n w i n d o w o p e n s .

3 . B r o w s e t o t h e p a c k a g e y o u w a n t t o i n s t a l l . 4 . S e l e c t t h e p a c k a g e a n d c l i c k O p e n .

P a c k a g e s 1 1 7



T h e I n s t a l l w i n d o w o p e n s , r e p o r t i n g o n t h e p r o g r e s s o f t p r o b l e m s t h a t o c c u r d u r i n g i n s t a l l a t i o n a r e r e g i s t e

5 . W h e n t h e i n s t a l l a t i o n i s c o m p l e t e , c l i c k O K .

U n i n s t a l l i n g P a c k a g e s T o u n i n s t a l l a p a c k a g e , u s e t h e f o l l o w i n g p r o c e d u r e

1 . S t a r t t h e P a c k a g e M a n a g e r . F o r m o r e i n f o r m a t i o n S t a r t i n g t h e P a c k a g e M a n a g e r o n p a g e 1 1 2 .

2 . C l i c k U n i n s t a l l P a c k a g e .

T h e U n i n s t a l l w i n d o w o p e n s , r e p o r t i n g o n t h e p r o g r e s s o fo r f a i l u r e o f t h e u n i n s t a l l i s i n d i c a t e d i n t h e p r o g r e i s n o t s u c c e s s f u l l y u n i n s t a l l e d , t h e n t h e p a c k a g e n aP a c k a g e M a n a g e r a n d c o n t a i n s o n l y t h e c o n t e n t s t h a t c o u l d

r e m o v e d f r o m t h e s y s t e m . 3 . W h e n t h e u n i n s t a l l i s c o m p l e t e , c l i c k O K .




6 C r e d e n t i a l s M

A u t h e n t i c a t i o n t h r o u g h C r e d e n t i a l s M a p p i n g . . . . . . . . . . . . . . .C r e d e n t i a l s M a p p i n g f o r A d a p t e r s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C r e d e n t i a l s M a p p i n g f o r M O M s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

T h e f o l l o w i n g t o p i c s d e s c r i b e h o w t o u s e t h e c r e a u t h e n t i c a t e a n d t h e n m a n a g e u s e r s .

1 1 9



A u t h e n t i c a t i o n t h r o u g h C r e dM a p p i n g C r e d e n t i a l s m a p p i n g ( a l s o k n o w n a s a u t h e n t i c a t i o n t h a t t h e w e b s e r v e r o r s e r v l e t h a s a u t h e n t i c a t e d t h e u a u t h e n t i c a t e d u s e r n a m e , I n f o * E n g i n e o b t a i n s a m a p c r e d e n t i a l s t h a t a r e t o b e s e n t t o a d a p t e r s o r s e n t t o t h ea t y o u r s i t e ) o n b e h a l f o f t h e a u t h e n t i c a t e d u s e r .

W i t h a c r e d e n t i a l s m a p p i n g m e c h a n i s m i n p l a c e , I n f a d d a u t h e n t i c a t i o n p a r a m e t e r s t o t h e s e w e b j e c t s t h r om a p p i n g t a s k o r a s e t o f c r e d e n t i a l s l e s .

T h e f o l l o w i n g r u l e s a p p l y t o c r e d e n t i a l s m a p p i n g :

• I f t h e a u t h o r o f a t a s k o r J S P p a g e e x p l i c i t l y s p e c i p a r a m e t e r s o n a w e b j e c t , t h o s e p a r a m e t e r s t a k e p r ea u t h e n t i c a t i o n i n f o r m a t i o n t h a t m i g h t b e a v a i l a b l e

• I f D B U S E R a n d P A S S W D p a r a m e t e r s a r e n o t e x p a t t e m p t s t o p r o v i d e v a l u e s f o r t h e m f r o m t h e c r e d e

I f n o c r e d e n t i a l s m a p p i n g i n f o r m a t i o n i s a v a i l a b l e , od o e s n o t p r o v i d e v a l i d D B U S E R a n d P A S S W D v a l ut h e a d a p t e r t o w h i c h a w e b j e c t i s b e i n g r o u t e d , I n f o * D B U S E R o r P A S S W D v a l u e s . I n t h i s c a s e , t h e a d a p ti t s c o n g u r a t i o n p r o p e r t i e s , a n d t h e I n f o * E n g i n e m e E v e n t S e r v i c e o b t a i n s d e f a u l t v a l u e s f r o m t h e i r c o n d e f a u l t v a l u e s a r e s e t , I n f o * E n g i n e a t t e m p t s a n o n y m

C r e d e n t i a l s M a p p i n g f o r A d aC r e d e n t i a l s m a p p i n g f o r a d a p t e r s w o r k s u s i n g t h e f o

• W i n d c h i l l i s p r e - c o n g u r e d t o i n c l u d e a c r e d e n t i aT h i s t a s k i s c o n g u r e d t h r o u g h t h e W i n d c h i l l a d a pw t . f e d e r a t i o n . t a s k . m a p C r e d e n t i a l s p r o p e r t y v a l u e , w h i c h i s t o / w t / f e d e r a t i o n / M a p C r e d e n t i a l s . x m l . T h e c o n t e n t s o f t h i s t a sa r e d y n a m i c a l l y g e n e r a t e d , s t a r t i n g w i t h t h e f o l l o w< W i n d c h i l l > / t a s k s / w t / f e d e r a t i o n / M a p C r e d e n t

u s i n g t h e p r o p e r t y v a l u e s f o u n d i n s i t e . x c o n f .

W i n d c h i l l ’ s L D A P a c c e s s f o r u s e r a n d g r o u p i n f o rt h i s c r e d e n t i a l s m a p p i n g t a s k , a n d c a n p r o v i d e c r e b a s e d o n w h e t h e r t h e c u r r e n t u s e r i s a n a d m i n i s t r a u s e r . I f y o u w o u l d l i k e t o m o d i f y m a p p e d c r e d e n t p r o p e r t i e s i n s i t e . x c o n f . F o r m o r e i n f o r m a t i o n , r e a d t h e c o n




M a p C r e d e n t i a l s . x m l . t e m p l a t e a n d s e e M a n a g i n g t h e C r e d e T a s k o n p a g e 1 2 3 .

N o t e I f y o u n e e d t o c u s t o m i z e t h i s t a s k y o u s h o u l d d oM a p C r e d e n t i a l s . x m l . t e m p l a t e l e . Y o u s h o u l d a l s o k e e p c o p y , b e c a u s e p a t c h o r m a i n t e n a n c e r e l e a s e i n sc u s t o m i z a t i o n .

• Y o u r I n f o * E n g i n e a d m i n i s t r a t o r s e t s t h e c o n . c r e d e n t i a l s M a p p e r ( w h i c h d e n e s t h e m a p p i n g t a s k c r e d e n t i a l s m a p p i n g ) , a n d o p t i o n a l l y s e t s t h e . c r e d e n t i a l s T i m e T a n d . c r e d e n t i a l s F i l e s p r o p e r t i e s ( w h i c h i n d i c a t e h o wi n f o r m a t i o n s h o u l d r e m a i n c a c h e d a n d i f t h e r e m a p p i n g i n f o r m a t i o n i n t h e m ) .

• W h e n I n f o * E n g i n e i s c a l l e d t o p a r s e a n d e x e c a c c e s s e s a n a d a p t e r , i t c h e c k s t o s e e i f a c r e d e n d e n e d . I f i t d i s c o v e r s t h a t o n e h a s b e e n d e n e t a s k b e f o r e e x e c u t i n g t h e J S P p a g e o r t a s k o r i g g r o u p p r o d u c e d b y t h e c r e d e n t i a l s m a p p i n g t a sn a m e d A u t h - M a p .

• W h e n I n f o * E n g i n e e n c o u n t e r s a w e b j e c t t h a t mi t c h e c k s t h e w e b j e c t t o s e e i f D B U S E R a n d P A b e e n e x p l i c i t l y s p e c i e d . I f t h e y h a v e n o t b e e n t h e w e b j e c t I N S T A N C E p a r a m e t e r a s a k e y t o v a l u e s i n t h e A u t h - M a p c o n t e x t g r o u p . I f v a l u e s a r e f o u n d

t h e w e b j e c t a s i f t h e y h a d b e e n s p e c i e d e x p l i c O t h e r w i s e , t h e w e b j e c t i s r o u t e d t o t h e a d a p t e r

C r e a t i n g a C r e d e n t i a l s M a p p i n g TE a c h e l e m e n t o f t h e A u t h - M a p c o n t e x t g r o u p p r o d u c e d a s t h e ot h e c r e d e n t i a l s m a p p i n g t a s k m u s t c o n t a i n t h r e e D B U S E R , a n d P A S S W D . T h e v a l u e o f I N S T A Nw h i c h t h e e l e m e n t a p p l i e s . T h e v a l u e s o f D B U S a u t h e n t i c a t i o n i n f o r m a t i o n t o b e p a s s e d t o t h e a dD B U S E R a n d P A S S W D p a r a m e t e r s a r e n o t s p e c

W h e n a c r e d e n t i a l s m a p p i n g t a s k e x e c u t e s , a l l n a v a i l a b l e t o i t . F o r e x a m p l e , t h e S E R V E R c o n t e xs e n t b y a b r o w s e r t o I n f o * E n g i n e h a s b e e n a u t h e t h e n t h e S E R V E R g r o u p c o n t a i n s a n a t t r i b u t e n a A u t h - U s e r . T h i s a t t r i b u t e s p e c i e s t h e u s e r n a m e t h a t w a s a u t h e n t i c a t e d b y m a p p i n g t a s k c a n u s e t h a t u s e r n a m e a s a k e y t o o bi n f o r m a t i o n f r o m o n e o r m o r e a d a p t e r - a c c e s s i b l c r e a t e a n o u t p u t g r o u p f r o m t h a t a u t h e n t i c a t i o n i

C r e d e n t i a l s M a p p i n g 1 2 1



T h e f o l l o w i n g c r e d e n t i a l s m a p p i n g t a s k e x a m p l e c r ev a l i d u s e r n a m e a n d I N S T A N C E n a m e c o m b i n a t i o n sa n d P A S S W D v a l u e s . F r o m t h i s g r o u p , i t t h e n s e l e c tc o n t a i n t h e a u t h e n t i c a t e d u s e r n a m e . T h e s e e l e m e n t s A u t h - M a p g r o u p :



< ! - - C r e a t e a g r o u p f r o m s p e c i f i e d p a r a m e t e r s - - >

 

< ! - - S e l e c t s u b s e t f o r a c t u a l A u t h - M a p g r o u p b a s e d o n a

 



I f t h i s t a s k r u n s w h e n t h e a u t h e n t i c a t e d u s e r i s “ a b c , ”t h e A u t h - M a p g r o u p w o u l d b e :

U S E R N A M E I N S T A N C E D B U S E R a b c c o m . m y H o s t . j d b c S c o t t s c o t t t i g e r a b c c o m . m y H o s t . j d b c A d a p t e r a b c a b c 1 2 3

T h e n , u s i n g t h e w e b j e c t I N S T A N C E p a r a m e t e r , I n f oD B U S E R a n d P A S S W D p a r a m e t e r v a l u e s t o a d d .




C r e a t i n g C r e d e n t i a l M a p p i n g F i l C r e d e n t i a l m a p p i n g l e s p r o v i d e a w a y o f s e t t i n g

p a r a m e t e r f o r i n d i v i d u a l u s e r s . E a c h l e n a m e i s a s p e c i c u s e r , e n t e r o n e o r m o r e l i n e s , w h e r e e a ci n s t a n c e : d b u s e r : p a s s w d

w h e r e : i n s t a n c e s p e c i e s t h e n a m e o f a n I n f o * E n g i n e a d a pd b u s e r s p e c i e s t h e u s e r n a m e t o b e s e t i n t h e D B U w e b j e c t . p a s s w d s p e c i e s t h e p a s s w o r d t h a t c o r r e s p o n d s w i tv a l u e t o b e s e t i n t h e P A S S W D p a r a m e t e r o f t h e w

T h e r e s u l t i n g l e c o n t a i n s t h e u s e r n a m e s a n d p a si n f o r m a t i o n s y s t e m s . T h e p a t h t o a d i r e c t o r y c o n t a i n i n g c r e d e n t i a l s l ew t . p r o p e r t y o f w t . f e d e r a t i o n . m a p C r e d e n t i a l s . . I f t h i s p r o p e r t y i s n o t s e t , c r e d e n t i a l s m a p p i n g l e s a r e n

T o a c t i v a t e c r e d e n t i a l s m a p p i n g t h r o u g h c r e d e n v a l i d a t e t h e r e q u e s t i n f o r m a t i o n b y s e t t i n g a s e c . s e c r e t . t e x t o r . s e c r e t . t e x t 2 p r o p e r t y .

I f b o t h t h e w t . f e d e r a t i o n . m a p C r e d e n t i a l s . f i l a n d t h e w t . f e d e r a t i o n . t a s k . m a p C r e d e n t i a l s p r o p e r t i e s a r e s e t , l e - bm a p p i n g i s p e r f o r m e d r s t , t h e n t h e c r e d e n t i a l s m

a l l o w s s o m e b a s e o r d e f a u l t m a p p i n g i n f o r m a t i o a u g m e n t e d o r o v e r r i d d e n b y t h e t a s k .

M a n a g i n g t h e C r e d e n t i a l s T a s k T h e M a p C r e d e n t i a l s . x m l l e i s u s e d t o s p e c i f y a u s e r n a m ef o r a s p e c i c I n f o * E n g i n e a d a p t e r . T h i s l e i s u p dx c o n f m a n a g e r u t i l i t y , a n d s h o u l d n o t b e m a n u a l lt h e p r o p a g a t i o n o p e r a t i o n i s p e r f o r m e d t h e x c o n u s i n g v a l u e s o b t a i n e d f r o m t h e s i t e . x c o n f l e . F o r m o r e i n f o r m a t i ot h e x c o n f m a n a g e r u t i l i t y , s e e t h e W i n d c h i l l S p e c i a l i z e d A d m i n i s .

T h e r e a r e t w o v a r i a t i o n s o f t h e p r o p e r t y u s e d t o p a s s w o r d c r e d e n t i a l s . T h e m a p c r e d e n t i a l s . a d m i n . a d a p p r o p e r t y i s u s e d w h e n W i n d c h i l l a c c e s s e s t h e a dW i n d c h i l l a d m i n i s t r a t o r ( a u s e r w i t h a d m i n i s t r a m a p c r e d e n t i a l s . n o n p r i v i l e g e d . a d a p t e r s i s u s e d w h e n W i n d ca c c e s s e s a n a d a p t e r o n b e h a l f o f a u s e r w h o d o e s n




U s i n g t h e x c o n f m a n a g e r u t i l i t y , y o u c a n c o m m a n d s t h e s e p r o p e r t i e s :

x c o n f m a n a g e r - p - s " m a p c r e d e n t i a l s . a d m i n . a d a p t e r s = < a d ^ < p r i v i l e g e d u s e r p a s s w o r d- t " c o d e b a s e / W E B - I N F / m a p C r e d e n t i a l s . t x t "

T o s e t c r e d e n t i a l s f o r a W i n d c h i l l a d m i n i s t r a t o r , u s e

m a p c r e d e n t i a l s . a d m i n . a d a p t e r s = < u n i q u e n a m e o f t h e a d a

T o s e t c r e d e n t i a l s f o r a u s e r w i t h o u t W i n d c h i l l a d m i nf o l l o w i n g c o m m a n d :

m a p c r e d e n t i a l s . n o n p r i v i l e g e d . a d a p t e r s = < u n i q u e n a m e o

B o t h v a r i a t i o n s o f t h i s p r o p e r t y a r e m u l t i v a l u e d , a n dt h e - a d d c o m m a n d i n t h e x c o n f m a n a g e r t o a d d a d d i t i o n a n d u s e — s e t t o r e m o v e t h e m . F o r e x a m p l e , d u r i n g i n s t a l l a t i o n t h e f o l l o w i n g x c o n e x e c u t e d t o d e n e t h e c r e d e n t i a l s f o r t h e v a r i o u s J N D

x c o n f m a n a g e r - p - - s e t " m a p c r e d e n t i a l s . a d m i n . a d a p t e r s = 0 = p t c ^ a d m i n "

- t " c o d e b a s e / W E B - I N F / m a p C r e d e n t i a l s . t x t "

x c o n f m a n a g e r - p - - a d d " m a p c r e d e n t i a l s . a d m i n . a d a p t e r s =c n = m a n a g e r ^ a d m i n "


x c o n f m a n a g e r - p - - a d d " m a p c r e d e n t i a l s . a d m i n . a d a p t e r s =c n = m a n a g e r ^ a d m i n "


T o a d d n o n - p r i v i l e g e d a d a p t e r s :

x c o n f m a n a g e r - p - - s e t " m a p c r e d e n t i a l s . n o n p r i v i l e g e d . a c n = n o n p r i v u s e r 1 , o = p t c ^ p a s s w o r d 1 "


T o r e m o v e a n a d a p t e r :

x c o n f m a n a g e r - p - - r e m o v e " m a p c r e d e n t i a l s . n o n p r i v i l e g e

c n = n o n p r i v u s e r 1 , o = p t c ^ e n c r y p t e d . e n t e r p r i s e A d a p- t " c o d e b a s e / W E B - I N F / m a p C r e d e n t i a l s . t x t "

T o r e s e t t h e M a p C r e d e n t i a l s t a s k , c l e a r i n g a l l d e n i t i o n s o f a s p e c

x c o n f m a n a g e r - p - - r e s e t " m a p c r e d e n t i a l s . n o n p r i v i l e g e d - t " c o d e b a s e / W E B - I N F / m a p C r e d e n t i a l s . t x t "

x c o n f m a n a g e r - p - - r e s e t " m a p c r e d e n t i a l s . a d m i n . a d a p t e r - t " c o d e b a s e / W E B - I N F / m a p C r e d e n t i a l s . t x t "




C r e d e n t i a l s M a p p i n g f o r M I f y o u r s i t e h a s i n s t a l l e d a n d c o n g u r e d o n e o r m

m a p p i n g t h a t i s s e t u p f o r a c c e s s i n g i n f o r m a t i o n a c c e s s i n g M O M s . H o w e v e r , t h e m e s s a g e a n d W a c c e s s t h e M O M d o n o t u s e I N S T A N C E p a r a m e p a r a m e t e r i s s u p p l i e d o n a w e b j e c t , i t s v a l u e i s u s A u t h - M a p g r o u p . I f y o u h a v e c o n g u r e d a d e f a u l t M O M , t hf o l l o w i n g a s s u b s t i t u t e I N S T A N C E p a r a m e t e r v

P s e u d o I N S T A N C E D e s c r i p t i o n c o m . i n f o e n g i n e . m s g V a l u e f o r m e s s a g e w e b j e c t s ( tc o m . i n f o e n g i n e . w e s V a l u e f o r W e b E v e n t S e r v i c e

( t y p e = W E S )

c o m . i n f o e n g i n e . j m s V a l u e f o r e i t h e r m e s s a g e o r WS e r v i c e w e b j e c t s

B y s e t t i n g u p t h r e e p s e u d o I N S T A N C E p a r a m e ty o u r s i t e t h e e x i b i l i t y o f s e t t i n g u p t h e f o l l o w i n gc r e d e n t i a l s m a p p i n g :

• U s e t h e c o m . i n f o e n g i n e . j m s p s e u d o I N S T A N C E p a r a m ea u s e r n a m e a n d p a s s w o r d f o r g e n e r a l a c c e s s t o

• U s e t h e c o m . i n f o e n g i n e . m s g a n d c o m . i n f o e n g i n e . w e s p s e u d o I N S T A N C E p a r a m e t e r v a l u e s t o o v e r r i d e t h e gt h r o u g h e i t h e r m e s s a g e o r W e b E v e n t S e r v i c e w

A s i s a l s o t r u e w i t h t h e a d a p t e r w e b j e c t s , s p e c i f y p a r a m e t e r v a l u e s o n m e s s a g e a n d W e b E v e n t S e s e t t i n g s p r o v i d e d t h r o u g h c r e d e n t i a l s m a p p i n g od e f a u l t u s e r n a m e s a n d p a s s w o r d s .

I f a u s e r n a m e a n d p a s s w o r d i s n o t p r o v i d e d o n a d e t e r m i n e d t h r o u g h t h e c r e d e n t i a l s m a p p i n g s e t v a l u e s t h a t c a n b e s e t i n M S G a n d W E S p r o p e r t i ei s a t t e m p t e d .

T h e f o l l o w i n g e x a m p l e c r e d e n t i a l s m a p p i n g t a s kt a s k t o c r e a t e a g r o u p t h a t c o n t a i n s a l l v a l i d u s e r nc o m b i n a t i o n s , i n c l u d i n g o n e p s e u d o I N S T A N C F r o m t h i s g r o u p , i t s e l e c t s o n l y t h o s e e l e m e n t s t hu s e r n a m e . T h e s e e l e m e n t s t h e n m a k e u p t h e A u t h - M a p g r o u p .


< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g

< ! - - C r e a t e a g r o u p f r o m s p e c i f i e d p a r a m e t e r s - - >




 

< ! - - S e l e c t s u b s e t f o r a c t u a l A u t h - M a p g r o u p b a s e d o n a

 



I f t h i s t a s k r u n s w h e n t h e a u t h e n t i c a t e d u s e r i s “ a b c , ”t h e A u t h - M a p g r o u p w o u l d b e :

U S E R N A M E I N S T A N C E D B U S E R P Aa b c c o m . m y H o s t . j d b c S c o t t s c o t t t i g e r a b c c o m . m y H o s t . j d b c A d a p t e r a b c a b c 1 2 3 a b c c o m . i n f o e n g i n e . j m s m o m 1 g e n 4 5 6

T h e n , u s e r “ a b c ” h a s t h e u s e r n a m e “ m o m 1 ” a n d p a s a c c e s s t o t h e M O M w h e n e v e r t h e u s e r t r i e s e x e c u t i n S e r v i c e w e b j e c t .






A b o u t t h e C u s t o m T a g L i b r a T h e I n f o * E n g i n e t a s k c o m p i l e r s u p p o r t s t h e c o n c e p

C u s t o m t a g l i b r a r i e s f o r I n f o * E n g i n e t a s k s a r e s i m i l W h e n y o u i m p l e m e n t a c u s t o m t a g l i b r a r y , y o u a r e u t a s k s , w h i c h c a n b e o r g a n i z e d i n t w o w a y s : e i t h e r w io r o r g a n i z e d a s f e d e r a t e d t a s k d e l e g a t e s a s s o c i a t e d wa l l o w s y o u t o e a s i l y w r i t e r e u s a b l e t a g f u n c t i o n a l i t y o r c o m p i l e J a v a c o d e . I f m o r e a d v a n c e d f u n c t i o n a l i ti m p l e m e n t y o u r c u s t o m t a g l i b r a r y a s a s e t o f J a v a c l c l a s s e s a r e d e s c r i b e d b y a n X M L d o c u m e n t c a l l e d a Tw h i c h a s s o c i a t e s t h e c l a s s e s w i t h t h e a p p r o p r i a t e t a g

B o t h t a s k a n d J a v a t a g l i b r a r y i m p l e m e n t a t i o n s a l l o wa t t r i b u t e i s r e q u i r e d , a n d w h e t h e r o r n o t a g i v e n a t t r i b

n o t . I t i s i m p o r t a n t t o c o n s i d e r w h a t i s a p p r o p r i a t e f ow h e n w r i t i n g a t a g l i b r a r y . I f a n a t t r i b u t e i s m a r k e d a r e q u i r e d , t h e n y o u r t a g i m p l e m e n t a t i o n d o e s n o t n e e d t o s p e n d t i m e v a l i d a t id o e s n o t c o m p i l e a t a s k t h a t u s e s a t a g w h i c h d o e s n o v a l u e .

I f a n a t t r i b u t e s u p p o r t s e x p r e s s i o n s , t h e v a l u e s u p p l it h a n n u l l . M o r e i m p o r t a n t l y , h o w e v e r , i s w h e t h e r o r e m b e d d e d e x p r e s s i o n s . W h i l e e x p r e s s i o n e v a l u a t i o l o g i c a l l y y o u s h o u l d m a r k a t t r i b u t e s t h a t a r e h a r d - c o E v e n w h e r e a n a t t r i b u t e i s m a r k e d a s s u p p o r t i n g e x p c o m p i l e r e x a m i n e s t h e a t t r i b u t e v a l u e t o d e c i d e w h e

e x p r e s s i o n s a t r u n t i m e t o a v o i d u n n e c e s s a r y o v e r h e aE x p r e s s i o n L a n g u a g e S u p p o r t o n p a g e 1 3 3 .

T a s k - B a s e d T a g L i b r a r y I m p T a g l i b r a r i e s c a n b e w r i t t e n u s i n g r u l e s a n d p r o c e d u ra u t h o r i n g I n f o * E n g i n e t a s k s . E a c h t a s k ( o r c o m m a n t y p e i d e n t i e r ) c a n b e e x p o s e d a s a s i n g l e t a g . T h e p a t h e t a s k d o c c o m m e n t s o f a t a s k a r e e x p o s e d a s t h e a t to n e a c h p a r a m e t e r c a n b e u s e d t o c o n t r o l w h e t h e r a g w h e t h e r o r n o t i t s u p p o r t s e x p r e s s i o n s . B y d e f a u l t , a

a n d a r e n o t r e q u i r e d . P a r a m e t e r s t h a t o v e r r i d e t h e d e < ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f T h i s i s t h e t a g d e s c r i p t i o n .

@ p a r a m b o o l e a n h a r d C o d e d N o E x p r e s s i o n s { r t e x p : f a l s e }@ p a r a m s t r i n g r e q u i r e d I s r e q u i r e d { r e q u i r e d : t r u e } @ r e t u r n I N F O E N G I N E _ G R O U P $ { o u t p u t } - - >




I n t h i s e x a m p l e , m e t a d a t a o n t a s k c o m m e n t s i s s u { } ) , a n d t h e n a m e i s s e p a r a t e d f r o m t h e v a l u e b y a c o l @ r e t u r n c o m m e n t i s n o t u s e d e x p l i c i t l y , b u t s h o u l d b e i n ce n h a n c e t h e u s e f u l n e s s o f t h e t a s k . S p e c i f y i n g a p a r a m e t e r w i t h a t y p e o f I N F O E N Gf r o m t h e V D B o f t h e p a r e n t t a s k t o t h e V D B o f t ha c c e s s t o t h e c o n t e n t s o f t h e c a l l i n g t a s k ’ s V D B , i t t h a t a r e e x p l i c i t l y r e q u i r e d . A r r a y i n p u t i s a d d ea s a m u l t i v a l u e d p a r a m e t e r . U p o n i n p u t , t h e t a g i@ S E R V E R a n d @ A U T H - M A P c o n t e x t i n f o r m at a g i n v o c a t i o n , t h e t a g ’ s V D B i s m e r g e d b a c k i n t

T h e c a l l i n g t a s k ’ s i n p u t a n d o u t p u t s t r e a m s a r e a li t c a l l s , s o i t i s p o s s i b l e f o r a t a s k - b a s e d t a g t o c o n

A c a l l i n g t a s k a n d t h e t a g s i t c a l l s c a n s h a r e o t h e r c o n t e x t . ” T h e t a s k l e t c o n t e x t r e f e r s t o a p a i r o f m g e t s i t s o w n l o c a l m a p t o s t o r e v a r i a b l e d a t a , a n d I e C o n t e x t o b j e c t o f t h e o v e r a r c h i n g r e q u e s t . E a c h I n fh a s i t s o w n i n s t a n c e o f I e C o n t e x t ( c o m . i n f o e n g i n e . u t i l . I e C ) t h a t c a n h o l d c o n t e x t u a l i n f o r m a t i o n s p e c i c t o al o c a l l y - s c o p e d v a r i a b l e s i n t h e c o n t e x t a r e o n l y va r e d e n e d . S h a r i n g i n f o r m a t i o n b e t w e e n t a s k s (s a m e s c o p e r e q u i r e s r e q u e s t - s c o p e d v a r i a b l e s . F c o n t e x t , s e e E x p r e s s i o n L a n g u a g e S u p p o r t o n p a g e 1 3 .

F o r e x a m p l e :

< c : s e t v a r = “ s h a r e d ” v a l u e = “ $ { v a l u e } ” r e q u e s t S c o p e = “ t r u e ” / >

E a c h t a g b a s e d o n a n I n f o * E n g i n e t a s k i m p l i c i t l ys a m e p r e x , i s n a m e d “ p a r a m , ” a n d h a s n a m e a n d d a t a a t t r i b u t e s . T h i s t a g b e u s e d t o s u p p l y u n d o c u m e n t e d p a r a m e t e r s t o a p a r a m e t e r f o r a s u p p o r t i n g a d a p t e r t o a n e x i s t i n g e x c e p t i o n t o t h i s r u l e w o u l d b e a s i t u a t i o n i n w h i a l r e a d y c o n t a i n a t a g n a m e d “ p a r a m ” . I n t h i s s i t u p a r a m t a s k t a k e s p r e c e d e n c e , a n d n e s t e d p a r a m t a g s a r e n o t a l l o w e d w i t h i n t h a t t

T a g L i b r a r y O r g a n i z a t i o n i n t h e T a s k R o o t

T h e r e a r e t w o p r i m a r y w a y s t o o r g a n i z e a t a s k - b as i m p l y c r e a t e a s u b d i r e c t o r y w i t h i n t h e t a s k r o o ts p e c i f y t h e p a t h o f t h a t d i r e c t o r y ( r e l a t i v e t o t h e ty o u r t a g l i b r a r y . F o r e x a m p l e :

< % @ t a g l i b u r i = " / e x t / m y o r g / t a g s " p r e f i x = " m y " % >

. . . < m y : m y T a g h a r d C o d e d = " t r u e " r e q u i r e d = " $ { e x p r e s s i o n } " / > . . .

C u s t o m T a g L i b r a r i e s 1 2 9



E a c h t a g w i t h i n t h e s u b d i r e c t o r y i s a v a i l a b l e a s i t s o w p a r a m e t e r s a r e e x p o s e d a s i t s a t t r i b u t e s .

T a g L i b r a r y O r g a n i z a t i o n U s i n g a F e d e r a t e d T y pT h e s e c o n d m e t h o d o f o r g a n i z i n g a n I n f o * E n g i n e t a f e d e r a t e d t y p e i d e n t i e r . I n t h i s s i t u a t i o n , t h e v a l u e ya t t r i b u t e i s t h e t y p e i d e n t i e r w i t h w h i c h y o u r t a g s a r o r g a n i z a t i o n h a s t h e a d v a n t a g e o f a l l o w i n g t a g s t o s uc l i m b i n g . I f y o u c h o o s e t o u s e h i e r a r c h y c l i m b i n g , a c a n m a p t o m u l t i p l e t a s k s , d e p e n d i n g o n t h e i n p u t g i vu s i n g t h i s m e c h a n i s m , e v e r y t a g i m p l i c i t l y s u p p o r t s i n p u t a t t r i b u t e t h a t a l l o w s t h e c a l l e r t o s u p p l y t h e i n p u t g r o u p u s e d t o d r i v e t a s k b e i n g t a g s t h a t a l r e a d y e x p l i c i t l y d e n e a n i n p u t a t t r i b u t e ) . B o t h t h e u n i q u ef e d e r a t i o n i d e n t i e r ( U F I D ) a n d f e d e r a t e d t y p e i d e n t

i m p l i c i t l y q u a l i e d i f n o t e x p l i c i t l y s u p p l i e d . I f n e c e s s a r y , y o u c a n o v e r r i d e t h e t y p e h i e r a r c h y c l i my o u r t a s k ’ s c o n t e x t . P r i o r t o t a s k d e l e g a t i o n , y o u c a n . ” w i t h “ _ ” i n t h e f e d e r a t e d t y p e i d e n t i e r , a p p e n d i n g _ c l i m b e r ( f o r e x a m p l e , w t _ f c _ P e r s i s t a b l e _ c l i m b e r ) , a n d b y p l a c i n g t h e c l i m b e r c l a s t h e t a s k l e t c o n t e x t . A s a r e s u l t , t h e n e w v a l u e f o r t h e d i s c o v e r e d i n t h e t a s k l e t c o n t e x t a n d t h e n u s e d d u r i n i s t o u s e a W i n d c h i l l t y p e h i e r a r c h y c l i m b e r , w h i c h s m a j o r i t y o f u s a g e s . F o r a n e x a m p l e , s e e D i s p a t c h - T a s k s o n p a g e 4 1 8 .

A s a n e x a m p l e , i f y o u w r o t e a c r e a t e m e t h o d a s s o c i a t e d w i t h w t . p a r t . W T P a r t , i t c o u l d b e c a l l e d a s f o l l o w s :

< % @ t a g l i b u r i = " w t . p a r t . W T P a r t " u r i = " p r t " % > . . . . . .

A s p r e v i o u s l y m e n t i o n e d , h o w e v e r , t h i s m e c h a n i s m w i t h t y p e h i e r a r c h i e s , w h i c h w o u l d a l l o w f o r n o t o n la p p r o p r i a t e d e l e g a t e f o r a t a s k , b u t a l s o r o u t i n g t o a ne x a m p l e :

< % @ p a g e l a n g u a g e = " j a v a " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b /

< % @ t a g l i b u r i = " / o r g / m y o r g / u t i l / " p r e f i x = " u t i l " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b / < % @ t a g l i b u r i = " / c o m / i n f o e n g i n e / t l d s / i e j s t l . t l d " p r e f i x< % @ t a g l i b u r i = " W C T Y P E | w t . f c . P e r s i s t a b l e " p r e f i x = " o b j. . . < ! - - c r e a t e a d o c u m e n t i n t w o s y s t e m s ( a s s u m e d t a g i m p l< u t i l : q u e r y t y p e = " w t . o r g . W T P r i n c i p a l "

w h e r e = " u i d = ' $ { @ S E R V E R [ 0 ] a u t h - u s e r [ 0 ] } ' " a t t r i b u t e = " n a m e , c a b i n e t R e f " g r o u p O u t = " m e " / >




< ! - - c r e a t e t h e t a s k d e l e g a t e i n p u t - - > 



 



< ! - - c r e a t e t h e d o c u m e n t i n t h i s s y s t e m - - > < l o g : d e b u g m e s s a g e = ” c r e a t i n g d o c u m e n t $ { d o c [ 0 ] n a < o b j : C r e a t e i n p u t = ” $ { d o c } ” / > < ! - - c r e a t e t h e d o c u m e n t i n a n o t h e r s y s t e m - - > < l o g : d e b u g m e s s a g e = ” c r e a t i n g d o c u m e n t $ { d o c [ 0 ] n a < c : s e t v a r = ” $ { d o c [ 0 ] o b i d } ” v a l u e = ” @ o t h e r d o m a i n . m< o b j : C r e a t e i n p u t = ” $ { d o c } ” / > . . .

N o t e S o m e o f t h e t a g s a b o v e d o n o t a c t u a l l y e x i s t , b u t a p u r p o s e s o n l y .

J a v a - B a s e d T a g L i b r a r y I m I n s o m e c a s e s , w r i t i n g a J a v a - b a s e d t a g l i b r a r y i si f y o u n e e d t o i n t e g r a t e w i t h o t h e r J a v a - b a s e d A Pt h r o u g h I n f o * E n g i n e , a n d a s a r e s u l t w o u l d r e q u w i t h i n y o u r t a s k s ( o r t a s k - b a s e d t a g s ) . W h e n w r i m p l e m e n t a t i o n , t h e r e i s a s e t o f i n t e r f a c e s a n d s ui m p l e m e n t , a n d w h i c h c a n t h e n b e r e u s e d a s t a g s t o t h e c o m . i n f o e n g i n e . t a s k . t a g e x t p a c k a g e w i t h ii n s t a l l a t i o n ( / c o d e b a s e / i n f o e n g i n e / d o c s / a p i d o c ) t o u n d e r s t a n d t c l a s s e s a n d i n t e r f a c e s .

I n t h i s c a s e , t a g s a r e s i m p l e e v e n t - d r i v e n J a v a c l a

i n t o l i b r a r i e s o f t a g s . Y o u c a n d o t h i s u s i n g a s i m pa T a g L i b r a r y D e s c r i p t o r ( T L D ) t h a t d e n e s t h e l w h a t a t t r i b u t e s e a c h t a g s u p p o r t s , a n d i n f o r m a t i a t t r i b u t e s . A T L D c o n s i s t s o f a r o o t t a g l i b n o d e , a n o p t i o n a l d e s c r i p t i o n n o d e , a n d a n a r b i t r a r y n u m b e r o f c h i l d t a g n o d e s . E a c h t a g n o d e d e n e s a t a w i t h i n y o u r t a g l i b r a r y a n d a s s o c i a t e s t h a t t a g w i t a g n o d e m u s t c o n t a i n t h e n a m e a n d t a g c l a s s c h i l d n o d e s ( s p e c i f y i nn a m e a n d t a g i m p l e m e n t a t i o n c l a s s , r e s p e c t i v e l yd e s c r i p t i o n n o d e a n d s e v e r a l a t t r i b u t e n o d e s .




I f a d d e d , a n y a t t r i b u t e n o d e s s p e c i f y t h e a t t r i b u t e s a t a g s u p p o r n o t a n a t t r i b u t e i s r e q u i r e d , a n d i f i t s v a l u e s c a n b et h e s e p u r p o s e s a n a t t r i b u t e n o d e m u s t h a v e n a m e , r e q u i r e d , a n d r t e x p r v a l u e c h i l d n o d e s t o s u p p l y t h i s i n f o r m a t i o n . A f r m i g h t l o o k l i k e t h e f o l l o w i n g :

< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " I S O - 8 8 5 9 - 1 " ? > < t a g l i b >

< d e s c r i p t i o n > M y t a g l i b r a r y . < / d e s c r i p t i o n > < t a g >

< n a m e > m y T a g < / n a m e > < d e s c r i p t i o n > w h a t t h i s t a g l i b r a r y d o e s < / d e s c r i p t i o n >< t a g c l a s s > o r g . m y o r g . t a g s . M y T a g < / t a g c l a s s > < a t t r i b u t e >

< n a m e > m y A t t r i b u t e < n a m e >

< r e q u i r e d > t r u e < / r e q u i r e d > < r t e x p r v a l u e > t r u e < / r t e x p r v a l u e >

< / a t t r i b u t e > < / t a g >

. . . < / t a g l i b >

I n t h i s c a s e , t h e t a g l i b r a r y c o n t a i n s a t a g n a m e d “ m y b y t h e “ o r g . m y o r g . t a g s . M y T a g ” c l a s s . T h e t a g r e q u i“ m y A t t r i b u t e , ” w h i c h c a n b e a n e x p r e s s i o n . T o i n c l I n f o * E n g i n e t a s k r e q u i r e s t h a t y o u s p e c i f y a n @ t a g l i b d i r e c t i v e i n y o u r t a s k

t h a t d e n e s a p r e x f o r u s e w i t h y o u r t a g s w i t h i n t h e tl o c a t i o n o f y o u r T L D l e ( l o c a t e d i n t h e I n f o * E n g i n et a g c o u l d b e u s e d w i t h i n a n I n f o * E n g i n e t a s k a s f o l l o

< % @ t a g l i b u r i = ” / o r g / m y o r g / m y T a g s . t l d ” u r i = ” p f x ” % > . . . < p f x : m y T a g m y A t t r i b u t e = ” $ { @ F O R M [ ] m y A t t r i b u t e V a l u e [

T a g a t t r i b u t e s a r e s u p p l i e d t o y o u r t a g u s i n g s t a n d a r a c c e s s o r m e t h o d s . W h e n l o a d i n g a t a g l i b r a r y , I n f o * i m p l e m e n t a t i o n d e t a i l s . A n e r r o r i s p r o d u c e d i f y o u r b e c a u s e o f a n i m p l e m e n t a t i o n d e t a i l , s u c h a s a m i s s i a t t r i b u t e . I n t h e e x a m p l e a b o v e , t h e t a g m i g h t h a v e a

p u b l i c v o i d s e t M y A t t r i b u t e ( S t r i n g v a l u e ) {

/ / p e r h a p s s e t a n i n s t a n c e v a r i a b l e o r o t h e r w o r k / / r e l a t e d t o t h e a t t r i b u t e v a l u e s p e c i f i e d i n t h e v a l u e / / p a r a m e t e r .

}




T a g a t t r i b u t e s c a n h a v e a r b i t r a r y d a t a t y p e s , a n d c o e r c e d , i f n e c e s s a r y . T h e s u p p o r t e d d a t a t y p e s oS t r i n g i n t

b o o l e a n o a t

c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . G r o u p O b j e c t

C o e r c i o n i s o n l y s u p p o r t e d t o t h e p r i m i t i v e t y p e S t r i n g , i n t , b o o l e a n , a n d o a t . B e c a u s e O b j e c t i s i n c l u d e d , y o u c a n u s e a t t r i b u t e s o f

h o w e v e r i n t h i s c a s e y o u r s e t t e r m e t h o d m u s t s u po r c o e r c i o n o f t h e a t t r i b u t e v a l u e .

I n d i v i d u a l t a g s ( i m p l e m e n t a t i o n s o f “ c o m . i n f o ec a n b e s i m p l e , o r t h e y c a n c o n t a i n c h i l d e l e m e n t“ c o m . i n f o e n g i n e . t a s k . t a g e x t . B o d y T a g ” ) . I n s t a n B o d y T a g c a n a l s o s u p p o ri t e r a t i o n . A T a g o r B o d y T a g a l s o h a v e t h e o p t i o n t o i m p l e m e n T r y C a t c h F i n a la s a m e a n s t o h a n d l e e x c e p t i o n s .

T y p i c a l l y a t a g e x t e n d s e i t h e r t h e T a g S u p p o r t o r B o d y T a g S u p p o r t b a s e c l a s s e s a n d c o m p l e t e s t h e i m p l e m e n t a t i o n t o a d d a t t r i b ut h e n e c e s s a r y d o * T a g m e t h o d s .

I n a d d i t i o n , t a g s c a n b e d e s i g n e d t o i m p l i c i t l y s e r e u s e f r o m s c r i p l e t c o d e o r f r o m e x p r e s s i o n l a n g i m p l e m e n t i n g t h e f o l l o w i n g m e t h o d d e n e d o n “

T a g . V a r i a b l e I n f o [ ] g e t V a r i a b l e I n f o ( M a p < S t r i n g , S

T h i s m e t h o d i s o n l y c a l l e d a t t a s k c o m p i l a t i o n t i mi m p l i c i t v a r i a b l e s n e e d t o b e d e n e d i n t h e c o m p if o r a c o m p l e t e d e s c r i p t i o n o f t h e g e t V a r i a b l e I n f o m e t h o d a n d h o w t o u s f u n c t i o n a l i t y .

A t r u n t i m e , t a g s a r e p o o l e d t o a v o i d p e r f o r m a n c l a r g e n u m b e r s o f s h o r t - l i v e d o b j e c t s , w h i c h m a y T h e r e f o r e , y o u m u s t b e c a r e f u l t h a t y o u r t a g u s e sa t t r i b u t e v a l u e s i n i n s t a n c e v a r i a b l e s . Y o u s h o u l d o E n d T a g m e t h o d a n d r e i n i t i a l i z e i n s t a n c e v a r i a b l e s w i t h i n f i n a l l y b l o c k . I f t h i s i s nd o n e , s u b s e q u e n t u s a g e s o f y o u r t a g m a y n o t p e ri n s t a n c e v a r i a b l e v a l u e s f r o m p r e v i o u s u s e s .

E x p r e s s i o n L a n g u a g e S u p E x p r e s s i o n l a n g u a g e ( E L ) i s a m e c h a n i s m f o r d ec o n t e n t f r o m s e v e r a l p o s s i b l e s o u r c e s u s i n g a s i m b e u s e d w i t h i n c u s t o m t a g s , a n d c a n n o t b e u s e d w




w e b j e c t , p a r a m , a n d t a s k . F u r t h e r m o r e , t h e E L s y n t a x d i s c u s s e du s e d w i t h J S P p a g e s . H o w e v e r , i t i s s i m i l a r t o t h e E L 2 . 0 , w h i c h c a n b e u s e d f r o m w i t h i n J S P p a g e s .

N o t e F o r p e r f o r m a n c e r e a s o n s , c u s t o m t a g a t t r i b u t e s t h a t dl a n g u a g e s h o u l d a v o i d s u p p o r t i n g i t .

U s i n g c u s t o m t a g a t t r i b u t e s t h a t s u p p o r t E L , t a s k a u tt h a t a r e e v a l u a t e d a t r u n t i m e a g a i n s t t h e f o l l o w i n g :

• T h e V D B • T h e c o n t e x t c o l l e c t i o n , s u c h a s @ F O R M a n d @ S E• T h e t a s k l e t c o n t e x t • T h e I e C o n t e x t o b j e c t f o r t h e c u r r e n t r e q u e s t ( w h i c h h o l d s

c o n t e x t v a r i a b l e s )

T h e s e l o c a t i o n s p r o v i d e t h e s o u r c e s o f t h e i n f o r m a t ia l l o w i n g t h e d e s i r e d i n f o r m a t i o n t o b e f u r t h e r r e n e d

A n e x p r e s s i o n c a n a l s o s u p p o r t a c c e s s o r s , w h i c h a l l o [ ] ) t o i n d e x i n f o r m a t i o n i n t o a r r a y s , l i s t s , a n d m a p s a s w . c h a r a c t e r t o d e r e f e r e n c e J a v a b e a n p r o p e r t i e s . F o r e x a m p l e , a i n t o a l i s t m i g h t b e w r i t t e n a s $ { l i s t N a m e [ 1 ] } , w h i c h f e t c h e s t h e s e c o n de l e m e n t i n t h e l i s t n a m e d “ l i s t N a m e . ” I n d e x i n g i n t o $ { m a p N a m e [ ' k e y ' ] } . F e t c h i n g a p r o p e r t y f r o m a J a v a b e a n ma s $ { e m p l o y e e . n a m e } , w h i c h r e t u r n s t h e r e s u l t o f i n v o k i n g t h g e t N a m e ( )

m e t h o d o n t h e b e a n r e f e r e n c e d b y “ e m p l o y e e . ” E x p r e s s i o n s c a n a l s o b e a r b i t r a r i l y c o m p l e x , f o r e x a

$ { e m p l o y e e s [ ' 1 2 3 ' ] . n a m e }

f e t c h e s a b e a n f r o m a m a p u s i n g t h e k e y “ 1 2 3 , ” a n d t p r o p e r t y f r o m t h a t b e a n b y i n v o k i n g t h e g e t N a m e ( ) m e t h o d o n t h e b e a n . M o re x a m p l e s a r e p r o v i d e d t h r o u g h o u t t h i s s e c t i o n .

S i n c e i t i s c o m m o n t o u s e t h e . c h a r a c t e r , i t i s s p e c i a l - c a s e d w i t h i n d a t a s t r u c t u r e a t t r i b u t e v a l u e s , s p e c i c a l l y w h e n t h e b e i n g e v a l u a t e d i s a n I n f o * E n g i n e e l e m e n t o b j e c t . I nt h e e x p r e s s i o n b e i n g e v a l u a t e d s p e c i e s a n a t t r i b u t e f o l l o w i n g e x p r e s s i o n : $ { d o c u m e n t [ 0 ] t h e P e r s i s t I n f o . c r e a t e S t a m p [ 0 ] }

i f d o c u m e n t [ 0 ] r e s o l v e s t o t h e r s t e l e m e n t i n a g r o u p n a m et h e . c h a r a c t e r f o u n d w i t h i n “ t h e P e r s i s t I n f o . c r e a t e S t at o a v o i d b r e a k i n g t h e i n t e n t o f t h e e x p r e s s i o n . I n o t h . c h a r a c t e r s p e c i c a l l y d e r e f e r e n c e s a J a v a b e a n p r o p




e x p r e s s i o n . O t h e r c h a r a c t e r s , s u c h a s t h e s i n g l e q ‘ ) a n d t h e b r a c e c h a r( { } ) , a l s o h a v e s p e c i a l m e a n i n g a n d m a y n e e d t o bc h a r a c t e r s w i t h a b a c k s l a s h ( \ ) e s c a p e s t h e m .

A s i d e f r o m f e t c h i n g d a t a f r o m t h e V D B a n d c o n e v a l u a t i o n r e s o l v e s v a r i a b l e v a l u e s t h e t a s k l e t c oo f m a p s c o n t a i n i n g d a t a . E a c h t a s k h a s a u n i q u e d a t a , a n d t h a t m a p i s b a c k e d b y t h e I e C o n t e x t o b j e c t o f t h e o v e r a r c h i nr e q u e s t . E a c h I n f o * E n g i n e - b a s e d r e q u e s t h a s i t s I e C o n t e x t ( c o m . i n f o e n g i n e . u t i l . I e C o n t e x t ) , w h i c h a r e a b l e t o h o l d c i n f o r m a t i o n s p e c i c t o a g i v e n r e q u e s t . F o r e x a mi n f o r m a t i o n t h a t n e e d s t o b e s h a r e d b y d i s j o i n t e d

A t a s k l e t c o n t e x t o p e r a t e s s i m i l a r t o t h e I e C o n t e x t , b u t i s s p e c i c t o a s i n t a s k a n d h a s a l i f e s p a n t h a t c a r r i e s o n l y t h r o u g h tH o w e v e r , i f y o u w a n t a t a s k t o c a l l a s u b - t a s k a n d p l a c e a r e q u e s t - s c o p e d v a r i a b l e i n t h e I e C o n t e x t , w h i c h i s v i s i b l e t o a l l oc o d e r u n n i n g w i t h i n t h e s a m e r e q u e s t . T h e s e t t a g s u p p l i e d a s p a r t o f t h/ c o m / i n f o e n g i n e / t l d s / i e j s t l . t l d t a g l i b r a r y h a s a n a r g u m r e q u e s t S c o p e , w h i c h y o u c a n u s e t o d i f f e r e n t i a t e b e t w e a n d r e q u e s t - s c o p e d v a r i a b l e s . D u r i n g e x p r e s s i o c o n t e x t i s l o c a t e d , a n d i f t h e v a r i a b l e i s n o t f o u n d I e C o n t e x t i s c o n s u l t e d . T m e a n s t h a t l o c a l v a r i a b l e d a t a o v e r r i d e s r e q u e s t -i n f o r m a t i o n , s e e s e t T a g o n p a g e 2 8 2 .

N o t e S i n c e y o u c a n n o t d i f f e r e n t i a t e E L f r o m s t a n d a r d I

s y n t a x , E L i s n o t s u p p o r t e d w i t h i n c o r e I n f o * E n g i n e t a g s ( s u c h a s t h e i e : p a r a m d a t a a t t r i b u t e ) . H o w e v e r , y o u c a n p r o g r a m e x p r e s s i o n s i n a t t r i b u t e s u s i n g s t a n d a r d J S P - l i k e< % = e v a l u a t e E x p r e s s i o n ( " $ { x } " ) % > .


< c : s e t v a r = ” a ” v a l u e = ” $ { a r r a y [ 0 ] } ” / > < c : s e t v a r = ” a ” v a l u e = ” $ { m a p [ ‘ a ’ ] } ” / >

a n d

< i e : p a r a m n a m e = ” C O U N T ” d a t a = ” < % = e v a l u a t e E x p r e s

A n e x p r e s s i o n c a n h a v e v a r y i n g d e g r e e s o f c o m p p a r t s c o r r e s p o n d u p o n e v a l u a t i o n o f t h e e x p r e s s i

< ! - - f e t c h t h e f i r s t e l e m e n t w i t h i n t h e v a r i a b l e ‘ l i si s a l i s t o f M a p o b j e c t s a n d t h e n f e t c h t h e v a l u e w i t h i n t h a t M a p . - - >

< c : s e t v a r = ” a ” v a l u e = ” $ { l i s t [ 0 ] [ ‘ a ’ ] } ” / > < ! - - I h a v e a g r o u p w i t h e l e m e n t s c o n t a i n i n g a n a t t r

‘ m a p A t t ’ w h i c h i s a m a p t h a t I c a n i n d e x i n t o - - >




< c : s e t v a r = ” a ” v a l u e = ” $ { m y G r o u p [ 0 ] m a p A t t [ 0 ] [ ‘ a ’ ] } ” / >

E x p r e s s i o n s c a n i n v o k e n o - a r g g e t t e r s o n v a r i a b l e o b

l i k e J a v a b e a n p r o p e r t i e s . F o r e x a m p l e : < ! - - p o p u l a t e t h e e C o u n t v a r i a b l e w i t h t h e n u m b e r o f e l e

i n “ m y G r o u p ” - - > < c : s e t v a r = ” e C o u n t ” v a l u e = ” $ { m y G r o u p . e l e m e n t C o u n t } ”

A s t r i n g c a n h a v e m u l t i p l e a r b i t r a r y e x p r e s s i o n s e m b

< c : i f t e s t = ” $ { m y G r o u p = = n u l l | | m y G r o u p . e l e m e n t C o u n t ! < c : c h o o s e >

< c : w h e n t e s t = ” $ { m y G r o u p = = n u l l } ” > < c : s e t v a r = ” e r r ” v a l u e = ” G r o u p m y G r o u p i s n u l l ” / >

< / c : w h e n > < c : o t h e r w i s e >

< c : s e t v a r = ” e r r ” v a l u e = ” G r o u p m y G r o u p m u s t h a v e 1 0 e l e m e n t s b u

h a s $ { m y G r o u p . e l e m e n t C o u n t } ” / > < / c : o t h e r w i s e >

< / c : c h o o s e > 



< / c : i f >

U n l i k e J S P e x p r e s s i o n s , I n f o * E n g i n e E L i s i n t e g r a t ec o n c e p t s . D u r i n g t h e e x p r e s s i o n e v a l u a t i o n , t h e t a s ka r e c o n s u l t e d b e f o r e t h e t a s k l e t a n d r e q u e s t c o n t e x t .

< c : s e t v a r = ” a ” v a l u e = ” $ { @ F O R M [ ] a [ ] } ” / > < c : f o r E a c h v a r = ” e l m ” l i s t = ” $ { m y G r o u p } ” >

< ! - - e x e c u t e s o n c e f o r e a c h e l e m e n t i n m y G r o u p - - > < / c : f o r E a c h > < c : f o r E a c h v a r = ” a ” l i s t = ” $ { m y G r o u p [ 0 ] a [ * ] } ” >

< ! - - e x e c u t e s o n c e f o r e a c h v a l u e o f t h e a a t t r i b u t e w i t h i n t h e f i r s t e l e m e n t o f m y G r o u p - - >

< / c : f o r E a c h >

U n l i k e J S P , I n f o * E n g i n e E L d o e s n o t s u p p o r t t h e u s e x p r e s s i o n s . T h e c o r e c u s t o m t a g l i b r a r y e x t e n d s E Ls p e c i c a l l y w i t h t h e c : s e t , c : i f / c : w h e n t a g s . T h e s e t a g s i n t e r n a l l y u s e tt a s k l e t . e v a l u a t e E x p r e s s i o n ( S t r i n g ) m e t h o d ( d i s c u s s e d b r i e y b e l o w ) t o e x t e n d E L t o a c h i e v e t h e i r g o a l s . F o r e x a m

< ! - - t h e t e s t a t t r i b u t e i s b r o k e n i n t o s e p a r a t e e x p r e s s i ot h a t a r e e v a l u a t e d i n d e p e n d e n t l y i n o r d e r b a s e d o n t hc o n d i t i o n a l e x p r e s s i o n t o b e e v a l u a t e d . i n t h i s c a s e $ { @ F O R M [ ] d o S o m e t h i n g [ ] } $ { m y G r o u p } a




$ { m y G r o u p . e l e m e n t C o u n t } . - - > < c : i f t e s t = ” $ { @ F O R M [ ] d o S o m e t h i n g [ ] = = t r u e & a m p ; &

m y G r o u p . e l e m e n t C o u n t > 0 } ” >

< c : s e t v a r = ” i d x ” v a l u e = ” 0 ” / > < c : f o r E a c h v a r = ” e l m ” l i s t = ” $ { m y G r o u p } ” >

< c : s e t v a r = ” m o d ” v a l u e = ” $ { i d x % 2 } ” > < c : c h o o s e >

< c : w h e n t e s t = ” $ { m o d = = 0 } ” > < ! - - e v e n - - > / c : w h e n< c : o t h e r w i s e > ! < - - o d d - - > / c : w h e n >

< / c : c h o o s e > < ! - - s i m i l a r t o i f / w h e n s e t m a y e v a l u a t e e x p r e s s i

a s n e c e s s a r y , i n t h i s c a s e $ { i d x } t o g e t w h a t t < c : s e t v a r = ” i d x ” v a l u e = ” $ { i d x + 1 } ” / >

< c : f o r E a c h > < / c : i f >

T o s u p p o r t c o m b i n i n g E L w i t h J a v a s c r i p l e t s , c o m . i n f o e n g i n e . S A K . T a s k l e t h a s m e t h o d s d e n e d o n i t t o i n t e r a c t i o n w i t h c o n t e x t v a r i a b l e s a n d t o a l l o w f oe x p r e s s i o n s ( f o r r e u s e f r o m w i t h i n c u s t o m t a g l i b

F o r e x a m p l e , t h e f o l l o w i n g s e t s a v a r i a b l e w i t h i ns c o p e : p u b l i c f i n a l v o i d s e t C o n t e x t V a l u e ( S t r i n g n a m e , O b

T h e f o l l o w i n g s e t s a v a r i a b l e w i t h i n t h e t a s k l e t c s c o p e . I f r e q u e s t i s s e t t o t r u e , t h e n t h e v a r i a b l e i s a v a i l a b l e w i t h i n t h e s a m e r e q u e s t : p u b l i c f i n a l v o i d s e t C o n t e x t V a l u e ( S t r i n g n a m e , O b

T h e f o l l o w i n g f e t c h e s t h e n a m e s o f a l l v a r i a b l e s r e q u e s t c o n t e x t :

p u b l i c f i n a l S e t < S t r i n g > g e t C o n t e x t K e y s ( ) ;

T h e f o l l o w i n g f e t c h e s a v a r i a b l e b y n a m e f r o m t h

p u b l i c f i n a l O b j e c t g e t C o n t e x t V a l u e ( S t r i n g v a l u e

T h e f o l l o w i n g e v a l u a t e s a n e x p r e s s i o n a n d r e t u r E x c e p t i o n s r e l a t e d t o s y n t a x p r o b l e m s w i t h i n t h eo f t h e e x p r e s s i o n a r e t h r o w n :

p u b l i c O b j e c t e v a l u a t e E x p r e s s i o n ( f i n a l S t r i n g e x p


< % / / p r o g r a m m a t i c a l l y s e t s a c o n t e x t v a r i a b l e t h a t i s s e t C o n t e x t V a l u e ( “ m y A r r a y ” , n e w S t r i n g [ ] { “ a ” , “/ / f e t c h e s a g r o u p n a m e d m y G r o u p f r o m t h e V D B / / O N L Y f o r i l l u s t r a t i o n




G r o u p g = ( G r o u p ) e v a l u a t e E x p r e s s i o n ( “ $ { m y G r o u p } ” ) ;/ / w o u l d n ’ t d o t h i s b u t f e t c h e s t h e a b o v e p r o g r a m m a t i c a / / m y A r r a y v a r i a b l e

S t r i n g [ ] m y A r r a y = ( S t r i n g [ ] ) g e t C o n t e x t V a l u e ( “ m y A r % > < c : f o r E a c h v a r = ” o n e ” l i s t = ” m y A r r a y ” >

< ! - - w i l l r u n t h r e e t i m e s , a , b a n d c - - > < c : s e t v a r = ” m e s s a g e ” v a l u e = ” o n e i s $ { o n e } ” / >

< / c : f o r E a c h >






R e q u i r e d A t t r i b u t e s f o r C u s tT h e f o l l o w i n g a t t r i b u t e s a n d a t t r i b u t e v a l u e s m u s t b

c u s t o m d i s p l a y a n d g r o u p w e b j e c t s :

A t t r i b u t e D e s c r i p t i o n T Y P E = E X T I n d i c a t e s t h a t a u s e r - d e n e d c l a s s i s t o b eU S E = C l a s s N a m e I d e n t i e s t h e u s e r - d e n e d c l a s s ( i n c l u d i n

w h i c h t h e m e t h o d i m p l e m e n t i n g t h e w e b

C r e a t i n g a n E x t e r n a l C u s t o m Y o u c a n c r e a t e I n f o * E n g i n e e x t e r n a l c u s t o m w e b j e c

w i t h i n a u n i q u e J a v a p a c k a g e . T h e c l a s s n a m e m u s t bt h e s t a n d a r d J a v a n a m i n g r u l e s .

T h e I n f o * E n g i n e w e b j e c t n a m e i s d e r i v e d f r o m t h e ce a c h w o r d i n t h e n a m e w i t h a h y p h e n . F o r e x a m p l e , “ a v e r a g e C o l u m n ” t h e n t h e w e b j e c t n a m e i s “ A v e r a g

W e b j e c t n a m e s a r e n o t c a s e s e n s i t i v e .

Y o u m u s t c o d e t h e c l a s s s o t h e c u s t o m w e b j e c t s i n t h

• A r e i m p l e m e n t e d a s s t a t i c m e t h o d s . • T a k e a c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . T a s k o b j e c t a s t h e i r o n l y

a r g u m e n t . • R e t u r n a c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . T a s k o b j e c t . • T h r o w I E E x c e p t i o n o n e r r o r .

F o r e x a m p l e , t h e s i g n a t u r e f o r t h e m e t h o d t h a t i m p l ec u s t o m w e b j e c t i s t h e f o l l o w i n g :

i m p o r t c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . T a s k ; p u b l i c s t a t i c T a s k a v e r a g e C o l u m n ( T a s k t a s k ) t h r o w s I

: : T a s k r e s p o n s e = n e w T a s k ( ) ;

r e s p o n s e . a d d V d b ( g r o u p _ o u t ) ;

r e t u r n r e s p o n s e ; : :

}

Y o u c a n p u t t h e c o d e f o r m u l t i p l e c u s t o m w e b j e c t s i ni f y o u h a v e p r i v a t e m e t h o d s t h a t a r e u s e d b y m u l t i p l e p r i v a t e m e t h o d s a n d t h e c u s t o m w e b j e c t m e t h o d s c a




W h e n c o m p i l i n g t h e N u m e r i c C o l u m n W e b j e c t s . j a v a l e , y o u m u s t a d di e W e b . j a r a n d s e r v l e t . j a r l e s t o t h e c l a s s p a t h . T o m a k e c l a s s l e s a u t o m a t i c a l l y a v a i l a b l e t o I n f o * E n g i n p u t t h e l e s i n t h e W E B - I N F / c l a s s e s d i r e c t o r y w h e r e I n f o * E n g iI f t h i s d i r e c t o r y d o e s n o t e x i s t y o u c a n c r e a t e i t .

E x t e r n a l C u s t o m W e b j e c t E x a m pT h e f o l l o w i n g s e c t i o n s i n c l u d e :

• S o u r c e c o d e f o r t h e N u m e r i c C o l u m n W e b j e c t s c l a s s . • A n e x a m p l e J S P p a g e t h a t u s e s t h e e x t e r n a l c u

Y o u c a n n d t h e s o u r c e c o d e a n d J S P p a g e i n t hp r o g _ e x a m p l e s / c u s t o m w e b j e c t s d i r e c t o r y w h e r e I n f o * E n g

i n s t a l l e d .

N u m e r i c C o l u m n W e b j e c t s C l a s s

T h e f o l l o w i n g e x a m p l e p a c k a g e c o n t a i n s t h e N u m e r i c C o l u m n W e b j e c c l a s s . T h i s c l a s s c o n t a i n s t h e f o l l o w i n g m e t h o d s :

• g e t C o l u m n E l e m e n t s — A p r i v a t e m e t h o d u s e d b y t h e p ug e t t h e e l e m e n t s i n a c o l u m n .

• a v e r a g e C o l u m n — A v e r a g e s t h e e l e m e n t s i n a n u m e r i• t o t a l C o l u m n — C o m p u t e s a t o t a l u s i n g t h e e l e m e n t s

o f d a t a .

p a c k a g e e x a m p l e s . c u s t o m w e b j e c t s ;

i m p o r t c o m . i n f o e n g i n e . u t i l . I E E x c e p t i o n ; i m p o r t c o m . i n f o e n g i n e . e x c e p t i o n . f a t a l . I E I n t e r n a l S i m p o r t c o m . i n f o e n g i n e . p r o c u n i t . w e b j e c t . G r o u p W e b ji m p o r t c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . * ;

i m p o r t j a v a . u t i l . E n u m e r a t i o n ; i m p o r t j a v a . u t i l . V e c t o r ;

/ * *

* N u m e r i c C o l u m n W e b j e c t s * * s u p p l i e s i m p l e m e n t a t i o n f o r t w o s i m p l e w e b j e c t s :* < l i > t o t a l C o l u m n - r e t u r n t h e n u m e r i c t o t a* < l i > a v e r a g e C o l u m n - r e t u r n t h e n u m e r i c a* T h e i m p l e m e n t a t i o n i s s i m p l e m i n d e d u s i n g a ' d o u * t o t a l s a n d a v e r a g e s . N o f o r m a t i n g o f t h e r e s u l t s * * E x a m p l e : 

C u s t o m W e b j e c t s 1 4 1



* * * 

* * * * * * * * * * * * * * * /

p u b l i c c l a s s N u m e r i c C o l u m n W e b j e c t s {

/ * *

* r e t u r n a l i s t o f c o l u m n e l e m e n t s * * @ r e t u r n V e c t o r * @ e x c e p t i o n I E E x c e p t i o n i f r e q u i r e d v a l u e s a r e n ' t f

t h e w e b j e c t * * /

p r i v a t e s t a t i c V e c t o r g e t C o l u m n E l e m e n t s ( T a s k t a s k E x c e p t i o n {

W e b j e c t w = t a s k . g e t W e b j e c t ( ) ; S t r i n g g r p _ o u t = n u l l ; S t r i n g c o l u m n = n u l l ; S t r i n g g r p _ i n = n u l l ; G r o u p g r o u p _ i n = n u l l ;

/ / g e t t h e c o l u m n n a m e t o r e t r i e v e P a r a m p a r a m = w . g e t P a r a m ( " C O L U M N " ) ; i f ( p a r a m = = n u l l )

t h r o w n e w G r o u p W e b j e c t E x c e p t i o n ( " N u m e r i c C o l un o C O L U M N " ) ;




c o l u m n = p a r a m . g e t D a t a ( ) ;

/ / i f G R O U P _ I N n o t s u p p l i e d t a k e t h e d e f a u l t g p a r a m = w . g e t P a r a m ( " G R O U P _ I N " ) ; i f ( p a r a m = = n u l l )

g r o u p _ i n = t a s k . g e t G r o u p I n ( ) ; e l s e

g r o u p _ i n = t a s k . g e t V d b ( p a r a m . g e t D a t a ( ) ) ; i f ( g r o u p _ i n = = n u l l )

t h r o w n e w G r o u p W e b j e c t E x c e p t i o n ( " N u m e r i c C o l u m n W e b j e c t s : n o G R O U P

/ / b u i l d t h e V e c t o r o f c o l u m n c o n t e n t s

i n t e l e m e n t _ c o u n t = g r o u p _ i n . g e t E l e m e n t C o u n tV e c t o r e l e m e n t s = n e w V e c t o r ( ) ; f o r ( i n t i = 0 ; i < e l e m e n t _ c o u n t ; i + + ) {

E l e m e n t e = g r o u p _ i n . g e t E l e m e n t A t ( i ) ;

V e c t o r e v = e . g e t V a l u e s ( c o l u m n , t r u e ) ;

i f ( e v = = n u l l ) c o n t i n u e ;

f o r ( i n t j = 0 ; j < e v . s i z e ( ) ; + + j ) e l e m e n t s . a d d E l e m e n t ( e v . e l e m e n t A t ( j

} i f ( ! ( e l e m e n t s . s i z e ( ) > 0 ) )

t h r o w n e w G r o u p W e b j e c t E x c e p t i o n ( " N u m e r i c C o l u m n W e b j e c t s : n o C O L U M

\ " " ) ;

r e t u r n e l e m e n t s ; }

/ * * * g i v e n a i n p u t g r o u p , c o l u m n n a m e , a n d g r o u p o u* g e n e r a t e t h e n u m e r i c a v e r a g e o f t h e c o l u m n ' s c * r e t u r n t h e v a l u e i n a g r o u p . * * @ r e t u r n T a s k - r e s p o n s e * @ e x c e p t i o n I E E x c e p t i o n - i f r e q u i r e d p a r a m e t e

m i s s i n g o r c o l u m n * i s n o t n u m e r i c . * * /

p u b l i c s t a t i c T a s k a v e r a g e C o l u m n ( T a s k t a s k ) t h




E x c e p t i o n { t r y {

S t r i n g g r p _ o u t = n u l l ;

S t r i n g c o l u m n = n u l l ; W e b j e c t w = t a s k . g e t W e b j e c t ( ) ; / / g e t t h e n a m e o f t h e g r o u p t o c r e a t e P a r a m p a r a m = w . g e t P a r a m ( " G R O U P _ O U T " ) ; i f ( p a r a m = = n u l l )

t h r o w n e w G r o u p W e b j e c t E x c e p t i o n ( " N u m e r i c C o l u m n W e b j e c t s : n o G R O U P _ O

g r p _ o u t = p a r a m . g e t D a t a ( ) ; / / g e t t h e n a m e o f t h e c o l u m n t o a v e r a g e p a r a m = w . g e t P a r a m ( " C O L U M N " ) ; i f ( p a r a m = = n u l l )

t h r o w n e w G r o u p W e b j e c t E x c e p t i o n ( " N u m e r i c C o l u m n W e b j e c t s : n o C O L U M N "


V e c t o r e l e m e n t s = g e t C o l u m n E l e m e n t s ( t a s k ) ;

/ / t o t a l t h e v a l u e s O b j e c t v a l ; D o u b l e d v a l ; d o u b l e a v e r a g e = 0 ; f o r ( E n u m e r a t i o n e n = e l e m e n t s . e l e m e n t s ( ) ;

e n . h a s M o r e E l e m e n t s ( ) ; ) { v a l = e n . n e x t E l e m e n t ( ) ; d v a l = n e w D o u b l e ( v a l . t o S t r i n g ( ) ) ; a v e r a g e + = d v a l . d o u b l e V a l u e ( ) ;

} / / c a l c u l a t e t h e a v e r a g e a v e r a g e = a v e r a g e / e l e m e n t s . s i z e ( ) ;

E l e m e n t e l e m = n e w E l e m e n t ( ) ; A t t a t t = n e w A t t ( c o l u m n + " a v e r a g e " ) ; a t t . a d d V a l u e ( " " + a v e r a g e ) ; e l e m . a d d A t t ( a t t ) ; G r o u p g r o u p _ o u t = n e w G r o u p ( g r p _ o u t ) ; g r o u p _ o u t . s e t E l e m e n t ( e l e m ) ;

T a s k r e s p o n s e = n e w T a s k ( ) ; r e s p o n s e . a d d V d b ( g r o u p _ o u t ) ;

r e t u r n r e s p o n s e ; } c a t c h ( E x c e p t i o n e x c ) {




e x c . p r i n t S t a c k T r a c e ( S y s t e m . e r r ) ; i f ( e x c i n s t a n c e o f I E E x c e p t i o n )

t h r o w ( I E E x c e p t i o n ) e x c ;

t h r o w n e w I E I n t e r n a l S e r v i c e E x c e p t i o n ( e x c }

} / * *

* g i v e n a i n p u t g r o u p , c o l u m n n a m e , a n d g r o u p o u* g e n e r a t e t h e n u m e r i c t o t a l o f t h e c o l u m n ' s c o n t* r e t u r n t h e v a l u e i n a g r o u p . * * @ r e t u r n T a s k - r e s p o n s e * @ e x c e p t i o n I E E x c e p t i o n - i f r e q u i r e d p a r a m e t e

m i s s i n g o r c o l u m n * i s n o t n u m e r i c . * * /

p u b l i c s t a t i c T a s k t o t a l C o l u m n ( T a s k t a s k ) t h r o E x c e p t i o n {

t r y { S t r i n g g r p _ o u t = n u l l ; S t r i n g c o l u m n = n u l l ;

W e b j e c t w = t a s k . g e t W e b j e c t ( ) ;

/ / g e t t h e n a m e o f t h e g r o u p t o c r e a t e

P a r a m p a r a m = w . g e t P a r a m ( " G R O U P _ O U T " ) ;i f ( p a r a m = = n u l l )

t h r o w n e w G r o u p W e b j e c t E x c e p t i o n ( " N u m e r i c C o l u m n W e b j e c t s : n o G R O U

g r p _ o u t = p a r a m . g e t D a t a ( ) ;

/ / g e t t h e n a m e o f t h e c o l u m n t o t o t a l p a r a m = w . g e t P a r a m ( " C O L U M N " ) ; i f ( p a r a m = = n u l l )

t h r o w n e w G r o u p W e b j e c t E x c e p t i o n ( " N u m e r i c C o l u m n W e b j e c t s : n o C O L U


V e c t o r e l e m e n t s = g e t C o l u m n E l e m e n t s ( t a s k

/ / c a l c u l a t e t h e t o t a l O b j e c t v a l ; D o u b l e d v a l ;




d o u b l e t o t a l = 0 ; f o r ( E n u m e r a t i o n e n = e l e m e n t s . e l e m e n t s ( ) ;

e n . h a s M o r e E l e m e n t s ( ) ; ) {

v a l = e n . n e x t E l e m e n t ( ) ; d v a l = n e w D o u b l e ( v a l . t o S t r i n g ( ) ) ; t o t a l + = d v a l . d o u b l e V a l u e ( ) ;

}

/ / b u i l d G R O U P _ O U T a n d r e s p o n s e E l e m e n t e l e m = n e w E l e m e n t ( ) ; A t t a t t = n e w A t t ( c o l u m n + " t o t a l " ) ; a t t . a d d V a l u e ( " " + t o t a l ) ; e l e m . a d d A t t ( a t t ) ; G r o u p g r o u p _ o u t = n e w G r o u p ( g r p _ o u t ) ; g r o u p _ o u t . s e t E l e m e n t ( e l e m ) ;

T a s k r e s p o n s e = n e w T a s k ( ) ; r e s p o n s e . a d d V d b ( g r o u p _ o u t ) ;

r e t u r n r e s p o n s e ; } c a t c h ( E x c e p t i o n e x c ) {

e x c . p r i n t S t a c k T r a c e ( S y s t e m . e r r ) ; i f ( e x c i n s t a n c e o f I E E x c e p t i o n )

t h r o w ( I E E x c e p t i o n ) e x c ; t h r o w n e w I E I n t e r n a l S e r v i c e E x c e p t i o n ( e x c ) ;

}

} }

Y o u c a n e x e c u t e t h e a v e r a g e C o l u m n a n d t o t a l C o l u m n m e t h o d s u s i n g t h e A v e r a g e - C o l u m n a n d T o t a l - C o l u m n e x t e r n a l w e b j e

E x a m p l e A v e r a g e - C o l u m n a n d T o t a l - C o l u m n E

T h e f o l l o w i n g N u m e r i c C o l u m n W e b j e c t s . j s p e x e c u t e s a Q u e r y - O b j e c tw e b j e c t t h a t c r e a t e s t h e “ e m p l o y e e s ” g r o u p , w h i c h iA v e r a g e - C o l u m n a n d T o t a l - C o l u m n e x t e r n a l w e b j e

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " I


< ! - - C r e a t e s t h e e m p l o y e e s g r o u p t o b e u s e d b y A v e r a g e -T o t a l - C o l u m n e x t e n d e d w e b j e c t s - - >

 




 

< ! - - T h i s c u s t o m w e b j e c t c o m p u t e s t h e t o t a l o f t h e S

 

< ! - - T h i s c u s t o m w e b j e c t c o m p u t e s t h e a v e r a g e o f t h



 

 

 






9 W e b S e r v i c e s F r a

A b o u t W e b S e r v i c e I m p l e m e n t a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . .U s i n g I n f o * E n g i n e W e b S e r v i c e s T o o l i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . U n d e r s t a n d i n g t h e S e c u r i t y R e q u i r e m e n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . W r i t i n g a n I n f o * E n g i n e - b a s e d W e b S e r v i c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . .W r i t i n g a J a v a - b a s e d W e b S e r v i c e C l i e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . W r i t i n g a J a v a - b a s e d W e b S e r v i c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .U s i n g t h e W e b S e r v i c e D e p l o y m e n t B u i l d S c r i p t . . . . . . . . . . . . . . . . . . . . .U s i n g S O A P A t t a c h m e n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .C o n s u m i n g E x t e r n a l S e r v i c e s f r o m W i n d c h i l l . . . . . . . . . . . . . . . . . . . . . . . . . W e b S e r v i c e E x a m p l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .U s e r n a m e A u t h e n t i c a t i o n w i t h S y m m e t r i c K e y s E x a m p l e . . . . . . . .

T h e f o l l o w i n g t o p i c s d e s c r i b e t h e w e b s e r v i c e s t a n d p r o v i d e e x a m p l e s o f h o w t o w r i t e a n d d e p l o W i n d c h i l l .

1 4 9



A b o u t W e b S e r v i c e I m p l e m e W i n d c h i l l o f f e r s a t o o l s e t t h a t f a c i l i t a t e s d e p l o y m e n t

w e b s e r v i c e t h a t l e v e r a g e s J A X - W S ( J a v a A P I f o r X t o h a n d l e t h e S O A P / X M L a n d s e c u r i t y - r e l a t e d w e b i s a v a i l a b l e i n a d d i t i o n t o t h e I n f o * E n g i n e - b a s e d w e b y t h e S i m p l e T a s k D i s p a t c h e r s e r v l e t . T h e w e b s e r v i s b a s e d o n I n f o * E n g i n e t a s k s a n d t a s k d e l e g a t i o n , r eH o w e v e r , t h e X M L r e p r e s e n t a t i o n o f t h e c o r r e s p o n d b a s e d u p o n t h e m a n n e r i n w h i c h J A X - W S u s e s J A X X M L B i n d i n g ) t o b i n d J a v a o b j e c t s a n d I n f o * E n g i n eF o r b a c k w a r d c o m p a t i b i l i t y , a c c e s s t o t h e s a m e s e r v S i m p l e T a s k D i s p a t c h e r .

A s i d e f r o m l e v e r a g i n g J A X - W S f o r t h e S O A P - r e l a t

t o u s i n g t h i s f r a m e w o r k i s t h e a d d i t i o n o f c o n g u r a b L e g a c y I n f o * E n g i n e w e b s e r v i c e s r e l y s o l e l y u p o n wf o r s e c u r i t y . T h i s m e a n s t h a t S O A P c l i e n t s m u s t h a vu s e r c r e d e n t i a l s , a n d m u s t s u p p l y t h o s e c r e d e n t i a l s ta u t h e n t i c a t i o n r e q u i r e m e n t s ( t y p i c a l l y H T T P B a s i c p r e s e n t s a f a i r l y s i g n i c a n t r o a d b l o c k t o d e v e l o p i n g S S O ( S i n g l e S i g n O n ) . T h i s i s w h e n a s e p a r a t e a p p l i ch a s i n d e p e n d e n t l y a u t h e n t i c a t e d a u s e r , a n d a t r u s t r ec l i e n t a n d W i n d c h i l l . R e l y i n g s o l e l y u p o n w e b s e r v eS S O a p p l i c a t i o n o r a p p l i c a t i o n s e r v e r m u s t h a v e a c c r e a u t h e n t i c a t e t h a t u s e r w i t h i n a n I n f o * E n g i n e w e b s

A d o w n s i d e t o l e v e r a g i n g m o r e a d v a n c e d s e c u r i t y p om e c h a n i s m s i n v o l v e d . T h e w e b s e r v i c e c l i e n t m u s t bt h e c o n g u r e d s e c u r i t y p o l i c y , w h i c h o f t e n i n v o l v e s X M L r e p r e s e n t a t i o n o f t h e s e c u r i t y i n f o r m a t i o n e m bI f t h e c l i e n t i n q u e s t i o n i s J a v a , t h e n t h e t o o l i n g s u p p t h e s e c o m p l e x i t i e s s o t h a t y o u c a n w r i t e y o u r c l i e n t ws e c u r i t y p u r p o s e s . I f y o u u s e a s e p a r a t e t h i r d - p a r t y S W i n d c h i l l w e b s e r v i c e s , t h e n i t i s t h a t c l i e n t ’ s r e s p o ns e c u r i t y p o l i c y c h o s e n f o r a g i v e n w e b s e r v i c e .

W i t h w e b s e r v i c e s e c u r i t y s u p p o r t i n W i n d c h i l l , y o ur e l a t i o n s h i p b e t w e e n a n a p p l i c a t i o n ( s u c h a s a p o r t a lw e b s e r v i c e b y e x c h a n g i n g p u b l i c k e y i n f o r m a t i o n , re x c h a n g e s b e p r o p e r l y s i g n e d a n d e n c r y p t e d , a n d r e v a l i d u s e r n a m e t o k e n t h a t t h e w e b s e r v i c e s h o u l d t r u S O A P m e s s a g e m e e t s t h e s e c u r i t y r e q u i r e m e n t s a n d p u b l i c k e y f o u n d i n t h e s e r v e r ’ s t r u s t s t o r e , t h e w e b s et h a t h a s b e e n a u t h e n t i c a t e d w i t h t h e u s e r n a m e . S i m ir e q u i r e m e n t s o f t h e s e c u r i t y p o l i c y i n u s e , t h e c l i e n t a c c e s s t o t h e s e r v e r ’ s p u b l i c k e y t o d e c r y p t r e s p o n s e




E a c h w e b s e r v i c e e n d p o i n t i s r e p r e s e n t e d b y a n ir e s u l t , a J A X - W S - b a s e d I n f o * E n g i n e w e b s e r v i ci f e a c h t i m e t h e w e b s e r v i c e i s s e c u r e d b y a d i f f e ru n i q u e s e r v l e t n a m e f o r e a c h d e p l o y m e n t . O p t i o n a l l y , g i v e n a d d i t i o n a l c o n g u r a t i o n , i t i s pI n f o * E n g i n e w e b s e r v i c e b e h i n d w e b s e r v e r a u t c r y p t o g r a p h y - r e l a t e d r e q u i r e m e n t s o f s e l e c t i n g

N o t e T h i s i s t h e d e f a u l t s e c u r i t y p o l i c y f o r J A X - W S - b a W i n d c h i l l .

U s i n g I n f o * E n g i n e W e b S eT h i s i s a b a s i c o v e r v i e w o f h o w t h e I n f o * E n g i n e o r g a n i z e d . A f t e r r e v i e w i n g t h i s s e c t i o n , y o u s h o u n d e r s t a n d t h e i r p u r p o s e . T h e a c t u a l u s e o f t h e t ol a t e r .

T h e s u p p l i e d t o o l i n g i s e n a b l e d u s i n g A p a c h e A n< W i n d c h i l l > / a n t ( w h e r e < W i n d c h i l l > i s t h e I n f o * E n g i n e i n s t a l l a t i o n d i r e c t o

T h e t o o l i n g i s i n t e n d e d t o b e r u n f r o m a w i n d c h i l a n t c o m m a n d i s a l r e a d y i n y o u r p a t h .

T h e d i r e c t o r y t h a t c o n t a i n s t h e A p a c h e A n t b u i l di s l o c a t e d i n < W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c a n d c o n t a i n st h e f o l l o w i n g :

• b u i l d . x m l

T h e p r i m a r y A p a c h e A n t b u i l d s c r i p t u s e d t o d et h o s e s e r v i c e s w i t h s e c u r i t y p o l i c i e s .

• s e c u r i t y . p r o p e r t i e s

A p r o p e r t i e s l e c o n t a i n i n g t h e s e c u r i t y - r e l a t e u s e d w h e n d e p l o y i n g a w e b s e r v i c e . T h i s l e c ou s e , t h e s e r v e r - s i d e t r u s t s t o r e a n d k e y s t o r e c o n p o l i c y - s p e c i c c o n g u r a t i o n ( i f n e c e s s a r y ) t h a t i m e .

• n e w - p r o j e c t . x m l

A n A p a c h e A n t b u i l d s c r i p t u s e d t o g e n e r a t e n ea r e t h e n u s e d t o b u i l d o r d e p l o y n e w w e b s e r v i c

• x s l t /

W e b S e r v i c e s F r a m e w o r k



A s u b d i r e c t o r y c o n t a i n i n g X S L d o c u m e n t s u s e d d d e p l o y m e n t b y b u i l d . x m l .

• c l i e n t /

A s u b d i r e c t o r y c o n t a i n i n g c l i e n t - s i d e s e c u r i t y c o n• c l i e n t / s e c u r i t y . p r o p e r t i e s

T h e c l i e n t - s i d e s e c u r i t y c o n g u r a t i o n ( t r u s t s t o r e a i n f o r m a t i o n ) .

N o t e T h e p a t h s s p e c i e d t o t h e t r u s t s t o r e a n d k e y s t o r e m uc o r r e s p o n d i n g l o c a t i o n w h e r e t h o s e l e s r e s i d e o n t p a t h s a r e i n c l u d e d i n s e c u r i t y d e p l o y m e n t d e s c r i p t o

• c o m m o n /

A s u b d i r e c t o r y c o n t a i n i n g t h e c o m m o n A p a c h e A s e r v i c e p r o j e c t s .

O f t h e s e b u i l d t o o l s , y o u s h o u l d e d i t t h e s e c u r i t y . p r o p e r t i e s l e s t o s p e c i f y y o u r s e c u r i t y c o n g u r a t i o n f o r c l i e n t a n d s e r c o p i e s o f t h e s e l e s f o r e a c h c l i e n t / s e r v e r p a i r y o u d e

T o i d e n t i f y t h e c h a n g e s n e e d e d , y o u c a n u s e t h e e x a t h e < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s d i r e c t o r y , t h e r o o t o f t h e w e b s e r v i c e e x a m p l e p r o j e c t s . E a c h p r o j e c t i s g e n e ru s i n g t h e n e w - p r o j e c t . x m l s c r i p t . T h i s d i r e c t o r y a l s o c o n t a i n sj w s - s t o r e s . x m l A p a c h e A n t b u i l d s c r i p t t h a t c a n b e u s e d c l i e n t / s e r v e r k e y s t o r e a n d t r u s t s t o r e p a i r s . T h e j w s - s t o r e s . x m l s c r i p t u s e s O p e n S S O t o g e n e r a t e s e l f - s i g n e d c e r t i c a t e s f o r t h e i n t e n d e d a s a n e x a m p l e o f h o w y o u c a n b u i l d y o u r o w

N o t e Y o u s h o u l d u s e y o u r o w n c e r t i c a t e s r a t h e r t h a n t h e gc e r t i c a t e s .

P r e r e q u i s i t e s

W i n d c h i l l r e l e a s e s J a v a l i b r a r i e s t h a t a r e d u p l i c a t e d t h o s e p a c k a g e d w i t h J a v a . T h i s p r e s e n t s n o r u n t i m e it h e w e b s e r v i c e t o o l i n g t o g e n e r a t e a n d d e p l o y n e w su p d a t e y o u r J a v a i n s t a l l a t i o n t o i n c l u d e t h e n e c e s s a r

T o d o t h i s , c o p y t h e f o l l o w i n g J A R l e : < W i n d c h i l l > / s r c l i b / w e b s e r v i c e s - a p i . j a r t o

$ { J A V A _ H O M E } / j r e / l i b / e n d o r s e d




W h e r e $ { J A V A _ H O M E } i s t h e l o c a t i o n o f t h e J a v a u s e d b y W i n s t a l l a t i o n o f J a v a d o e s n o t a l r e a d y h a v e t h e e n d o r s e d d i r e c t o r y , t h e n y o m u s t c r e a t e i t .

N o t e I n s o m e c a s e s , i t m a y b e n e c e s s a r y t o a p p l y t h e s a mi n s t a l l a t i o n a s w e l l .

U n d e r s t a n d i n g t h e S e c u r i tT h i s s e c t i o n e x p l a i n s t h e s e c u r i t y p o l i c i e s a v a i l at h e s e c u r i t y p r o p e r t i e s , t r u s t s t o r e s , a n d k e y s t o r e

S e c u r i t y P o l i c i e s P r i o r t o d e p l o y i n g a w e b s e r v i c e , y o u m u s t d e c i d s e c u r e d . T h e f o l l o w i n g a r e a l l s u p p o r t e d s e c u r i t

S A M L S e n d e r V o u c h e r s w i t h C e r t i c a t e s

T h i s m e c h a n i s m p r o t e c t s m e s s a g e s w i t h m u t u a l c o n d e n t i a l i t y , a s w e l l a s w i t h a S e n d e r V o u c h e r

W h e n u s i n g t h i s s e c u r i t y p o l i c y , t h e S O A P c l i e n ( w i t h i n a n S A M L A s s e r t i o n ) c o n t a i n i n g t h e n a m u s e r n a m e t h e s e r v e r s h o u l d r u n t h e r e q u e s t a s . I n

i s s i g n e d a n d e n c r y p t e d , b e c a u s e t h e c l i e n t a n d s r e l a t i o n s h i p u s i n g t h e c o n t e n t s o f t h e i r r e s p e c t i v

I n t h i s s i t u a t i o n , t h e s e r v e r o n l y v e r i e s t h a t t h e s t o h a n d l i n g t h e r e q u e s t .

T h i s p o l i c y r e q u i r e s t h a t t h e c l i e n t h a v e b o t h a k c o r r e s p o n d i n g t o t h e s e r v e r ’ s . I n a d d i t i o n , J a v a ct h a t p r o v i d e s t h e S A M L A s s e r t i o n c o n t a i n i n g t h t r u s t .

N o t e I t i s e x t r e m e l y i m p o r t a n t t o u n d e r s t a n d t h a t w h e n “ v o u c h i n g ” f o r t h e u s e r n a m e a s s o c i a t e d w i t h t h e i s , i n e s s e n c e , i m p e r s o n a t i n g a g i v e n u s e r o r u s e r sc o r r e s p o n d i n g p a s s w o r d s . T h i s m e c h a n i s m i s r e a( S i n g l e S i g n O n ) t y p e s c e n a r i o , i n w h i c h y o u a r e ch a s a p p r o p r i a t e l y a u t h e n t i c a t e d t h e u s e r s , a n d y o t h a t c l i e n t u s i n g c e r t i c a t e e x c h a n g e i n t h e k e y s t o




U s e r n a m e A u t h e n t i c a t i o n w i t h S y m m e t r i c K e y s

T h e u s e r n a m e a u t h e n t i c a t i o n w i t h s y m m e t r i c k e y s m

i n t e r a c t i o n s f o r b o t h i n t e g r i t y a n d c o n d e n t i a l i t y . S yr e l i e s o n a s i n g l e , s h a r e d s e c r e t k e y t h a t i s u s e d t o b o t S y m m e t r i c k e y s a r e u s u a l l y f a s t e r t h a n p u b l i c k e y c r

F o r t h i s m e c h a n i s m t h e c l i e n t d o e s n o t p o s s e s s a n y c b u t i n s t e a d s e n d s i t s u s e r n a m e a n d p a s s w o r d f o r a u t hs e r v e r s h a r e a s e c r e t k e y . T h i s s h a r e d , s y m m e t r i c k e ye n c r y p t e d u s i n g t h e s e r v i c e ’ s c e r t i c a t e . T h e c l i e n t mt r u s t s t o r e b y i d e n t i f y i n g t h e s e r v e r ’ s c e r t i c a t e a l i a s

I n t h i s s i t u a t i o n , t h e s e r v e r a u t h e n t i c a t e s t h e g i v e n uc o r r e s p o n d i n g s u p p l i e d p a s s w o r d .

T h i s p o l i c y r e q u i r e s t h a t t h e c l i e n t h a v e a t r u s t s t o r e cc o n g u r a t i o n . I n a d d i t i o n , J a v a c l i e n t s r e q u i r e c a l l b au s e r n a m e a n d p a s s w o r d t o s e n d a l o n g w i t h t h e r e q u eF o r a n e x a m p l e o f t h i s m e c h a n i s m , s e e U s e r n a m e A u t h e n t i c a t i o n w i t h K e y s E x a m p l e o n p a g e 1 7 7 .

X . 5 0 9 C e r t i c a t e A u t h e n t i c a t i o n O v e r S S L

T h i s s e c u r i t y p o l i c y u s e s S S L ( h t t p s ) f o r c o n d e n t i a l i t y a n d a n X . 5 0 c e r t i c a t e t o a u t h e n t i c a t e t h e u s e r . T h e u s e r ’ s c e r t i ct h e s e r v e r , a n d t h e u s e r n a m e t h a t i s v a l i d a t e d w i t h W f r o m t h e c e r t i c a t e . B y d e f a u l t , t h e u s e r n a m e i s e x t r at h e c e r t i c a t e ( s t r i p p i n g a n y p r e c e d i n g C N = f r o m t h e p a r t i c i p a n t ) . S i n c e b a s i c m a p p i n g o f t h e c e r t i c a t e t o a W i n d c h i l l u s e r n at h e l o g i c u s e d t o e x t r a c t t h e u s e r n a m e i s c o n g u r a b l et h e c o m . p t c . j w s . s e c u r i t y . S u b j e c t T o U i d H a n d i n t e r f a c e a n d c o n g u r e y o u r s e r v l e t i m p l e m e n t a t i o n u s i n g t h e f o l l

w t . p r o p e r t y c o m . p t c . j w s . s e c u r i t y . x 5 0 9 S S L . < S e r v l e t N a m e > . S u b j e c t T o U i d H a n d l e r C l a s s

w h i c h s p e c i e s y o u r i m p l e m e n t a t i o n .

< S e r v l e t N a m e > w i t h i n t h e p r o p e r t y n a m e r e f e r s t o t h e s e r vS u b j e c t T o U i d H a n d l e r i m p l e m e n t a t i o n s h o u l d b e u s e d .

N o t e W h e n w r i t i n g a J a v a c l i e n t t o a s e r v i c e p r o t e c t e d b y Sh t t p s U R L o f t h e W S D L f o r y o u r s e r v i c e t o t h e j a v a x . x m l . w s . S e r v i c ec o n s t r u c t o r a r g u m e n t a s a n i n s t a n c e o f j a v a . n e t . U R L . Y o u r H T T P s e r v e r ’ s S c e r t i c a t e m u s t e i t h e r b e s i g n e d b y a c e r t i c a t e a u t h o r it h e c l i e n t ’ s < J A V A _ H O M E > / j r e / l i b / s e c u r i t y / j s s e c c e r t i c a t e s t o r e .




T h e s e c u r i t y . p r o p e r t i e s F i l e T h e A p a c h e A n t b u i l d t o o l i n g r e q u i r e s a s e c u r i t y

t h a t s p e c i e s t h e s e c u r i t y p o l i c y t o u s e , a s w e l l a sc o n g u r a t i o n s . Y o u m u s t e d i t t h e s e c u r i t y . p r o p e r t i e s l e t o s p e c i f y t h i n f o r m a t i o n b e f o r e d e p l o y i n g a w e b s e r v i c e .

T h e s e r v e r s e c u r i t y . p r o p e r t i e s l e i s f o u n d a t :

< W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s / s e c u r i t y . p r o p e

I t c o n t a i n s c o m m e n t s d e s c r i b i n g i t s c o n t e n t s .

F o r w r i t i n g o r t e s t i n g J a v a c l i e n t s , t h e r e i s a p a r a l

< W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s / c l i e n t / s e c u r i t

I t c o n t a i n s s i m i l a r c o m m e n t s d e s c r i b i n g i t s c o n t

N o t e B o t h l e s , a s r e l e a s e d , c o n t a i n a c o n g u r a t i o n t h a a n d s e r v e r t r u s t s t o r e a n d k e y s t o r e p a i r s , w h i c h c aw e b s e r v i c e e x a m p l e s d i s c u s s e d l a t e r i n “ T r u s t s t p o s s i b l e t o u s e t h e s e g e n e r a t e d t r u s t s t o r e s a n d k e i s r e c o m m e n d e d t h a t y o u a c q u i r e y o u r o w n c e r t i t r u s t s t o r e s a n d k e y s t o r e s f o r y o u r a p p l i c a t i o n s .

T r u s t s t o r e s a n d K e y s t o r e s U n l e s s y o u a r e m a n u a l l y c o n g u r i n g y o u r w e b ss e r v e r a u t h e n t i c a t i o n , y o u a r e r e q u i r e d t o s e c u r eX 5 0 9 v 3 c e r t i c a t e s . N o t e t h a t t h e s e c u r i t y m e c hS u b j e c t K e y I d e n t i f i e r e x t e n s i o n . T h e k e y t o o l u t i l i t y r e d o e s n o t g e n e r a t e t h i s e x t e n s i o n .

T h e A p a c h e A n t b u i l d s c r i p t i s l o c a t e d a t :

< W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / j w s - s t o r e s . x m l

T h i s b u i l d s c r i p t c a n g e n e r a t e c l i e n t o r s e r v e r k e yu s e b y I n f o * E n g i n e w e b s e r v i c e e x a m p l e s . Y o u d e v e l o p m e n t p u r p o s e s . T h e A p a c h e A n t b u i l d s cc l i e n t a n d s e r v e r c e r t i c a t e s , a n d t h e n u s e s t h e J a

c e r t i c a t e s i n t o c l i e n t o r s e r v e r k e y s t o r e a n d t r u s Y o u c a n u s e t h e j w s - s t o r e s . x m l b u i l d s c r i p t a s a n i l l u s t r a t i o n y o u r o w n c e r t i c a t e t o c r e a t e t r u s t s t o r e s a n d k e y sc l i e n t s . T h i s s c r i p t o n l y g e n e r a t e s a s i n g l e s e r v e ri m p o r t s t h o s e c e r t i c a t e s i n t o t h e i r c o r r e s p o n d i nt h e t r u s t s t o r e s f o r t h e c l i e n t a n d s e r v e r .




T o g e n e r a t e t h e s e l e s , r u n t h e f o l l o w i n g s c r i p t f r o m

% c d < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s

% a n t - f j w s - s t o r e s . x m l W h i l e t h e s c r i p t i s r u n n i n g , y o u a r e p r o m p t e d s e v e r ac a n c h o o s e t o e i t h e r a c c e p t t h e d e f a u l t s ( p r e s e n t e d s ul i k e [ w s - s e r v e r ] ) b y s i m p l y p r e s s i n g E n t e r w h e n p r o m p t e d , o r s u p p l y y o u r o w n i n p u t . I f y o u c h o o s e t h e d e f a u l t i n p u t , t h e n t h e r e l e a s e d c o n s e c u r i t y . p r o p e r t i e s l e s s h o u l d c o n t a i n t h e p r o p e r c o n g uI f y o u d e c i d e t o s u p p l y o t h e r i n p u t w h e n r u n n i n g t h et o u p d a t e t h e c o r r e s p o n d i n g s e c u r i t y . p r o p e r t i e s c o n g u r a t i o n a c c o r d i n g l y . W h e n t h e s c r i p t h a s n i s h e d r u n n i n g , < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / s t o r e s d i r e c t o r y i s c r e a t e d . T h id i r e c t o r y c o n t a i n s t h e f o l l o w i n g l e s :

• s e r v e r - k e y s t o r e . j k s • s e r v e r - t r u s t s t o r e . j k s • c l i e n t - k e y s t o r e . j k s • c l i e n t - t r u s t s t o r e . j k s • s e r v e r . p 1 2 • c l i e n t . p 1 2 • s e r v e r . c e r • c l i e n t . c e r

N o t e T h e . p 1 2 ( P K C S # 1 2 P e r s o n a l I n f o r m a t i o n E x c h a n g e ) l p o p u l a t e a W i n d o w s c e r t i c a t e s t o r e f o r . N E T c l i e n t a T h e . c e r l e s a r e t h e c e r t i c a t e s u s e d t o p o p u l a t e t h e t r u s t

W r i t i n g a n I n f o * E n g i n e - b a s eT h e m e t h o d s f o r w r i t i n g a n I n f o * E n g i n e - b a s e d w e b w e b s e r v i c e s w e r e r s t s u p p o r t e d w i t h I n f o * E n g i n e rw h i c h J A X - W S - b a s e d w e b s e r v i c e s a r e n o w d i f f e r e na t t a c h m e n t s . F o r m o r e i n f o r m a t i o n , s e e U s i n g S O A P A t t a c h m e n t s o n p a .

I n a d d i t i o n t o w r i t i n g a n I n f o * E n g i n e - b a s e d w e b s e rJ a v a - b a s e d w e b s e r v i c e . T h i s i s i l l u s t r a t e d w i t h r e l e < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s , w h i c h i s d i s c u s s e d i n T r u s t s t o r e s a n d K e y s t o r e s o n p a g e 1 5 5 .

A n I n f o * E n g i n e w e b s e r v i c e c o n s i s t s o f a s e t o f I n f or e p r e s e n t i n g a w e b s e r v i c e m e t h o d t h a t i s a s s o c i a t e d c a s e o f a w e b s e r v i c e , t h e t y p e i d e n t i e r i s u s e d s i m p l




a s e t o f I n f o * E n g i n e t a s k s t o g e t h e r t o f o r m a w e ba n a l o g o u s t o a J a v a c l a s s t h a t e x p o s e s o n l y s t a t i c I n f o * E n g i n e t a s k s u p p o r t i n g t h e c o r r e s p o n d i n g

A t r u n t i m e , I n f o * E n g i n e r e q u i r e s t h a t t h e t y p e i dI n f o * E n g i n e t a s k s b e r e g i s t e r e d w i t h t h e I n f o * E Y o u c a n d o t h i s m a n u a l l y , b u t s i n c e t h e p r o c e s s c e r r o r p r o n e , I n f o * E n g i n e i s r e l e a s e d w i t h A p a c h i n s t a l l s t h e I n f o * E n g i n e t a s k s b a c k i n g y o u r w e b i n t e g r a t e d w i t h t h e A p a c h e A n t f r a m e w o r k .

T h i s s e c t i o n w a l k s y o u t h r o u g h w r i t i n g a s i m p l e s e r v i c e a n d c l i e n t u s i n g t h e f o l l o w i n g s t e p s :

1 . C r e a t e a p r o j e c t ( t h i s i s a s i m p l e d i r e c t o r y s t r ut a s k s a n d c l i e n t s o u r c e .

2 . W r i t e a f e w v e r y b a s i c t a s k s .

3 . S e c u r e a n d d e p l o y y o u r J A X - W S w e b s e r v i c ey o u r I n f o * E n g i n e t a s k s a n d c o r r e s p o n d i n g s e r

B e f o r e Y o u B e g i n

B e f o r e y o u c a n c o m p l e t e t h e s t e p s i n t h i s s e c t i o n p r e r e q u i s i t e s :

• A l l c o m m a n d s a r e a s s u m e d t o b e r u n f r o m a w • I t i s a s s u m e d t h a t y o u h a v e r u n t h e A p a c h e A n

T r u s t s t o r e s a n d K e y s t o r e s o n p a g e 1 5 5 . • T h e e x a m p l e c o m m a n d s a s s u m e a U n i x e n v i r o

e n v i r o n m e n t , t h e n y o u m u s t a l t e r t h e o p e r a t i n gs u i t y o u r e n v i r o n m e n t ( f o r e x a m p l e , u s i n g \ r a t

C r e a t e a P r o j e c t R e l e a s e d w i t h t h e w e b s e r v i c e f r a m e w o r k a r e t o ow e b s e r v i c e s a n d c l i e n t s .

T h i s p r o j e c t e x a m p l e c r e a t e s a s i m p l e w e b s e r v i co p e r a t i o n s .

N o t e T h i s s e r v i c e i s f o r i l l u s t r a t i o n p u r p o s e s o n l y a n d it y p i c a l l y u s e I n f o * E n g i n e t o a c c o m p l i s h .




C r e a t e y o u r p r o j e c t u s i n g t h e < W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s / n e w - A p a c h e A n t b u i l d s c r i p t . T h i s s c r i p t c a n b e u s e d t o c r e a t e a cs e r v i c e p r o j e c t , o r b o t h : % c d < W i n d c h i l l > % m k d i r p r o g _ e x a m p l e s / j w s / M y P r o j e c t % a n t - D p r o j e c t . d i r = < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e c t - D s e - D s e c u r i t y . p o l i c y = u s e r N a m e A u t h S y m m e t r i c K e y s - D s e r v i- D m a i n . c l a s s = o r g . m y o r g . M a t h C l i e n t - f b i n / a d m i n T o o l s / W e b S e r v i c e s / n e w - p r o j e c t . x m l c r e a t e

N o t e T h e p r o j e c t . d i r p r o p e r t y i s a n a b s o l u t e p a t h s o t h a t t h e p r oi n t h e a p p r o p r i a t e l o c a t i o n . T o s e e w h a t i n p u t o p t i o n s

n e w - p r o j e c t . x m l b u i l d s c r i p t , y o u s h o u l d r u n i t w i t h n o a r ge x a m p l e :

a n t - f b i n / a d m i n T o o l s / W e b S e r v i c e s / n e w - p r o j e c t . x m l

T h i s c r e a t e s t h e f o l l o w i n g s t r u c t u r e w i t h i n t h e p r o g _ e x a m p l e s / j w s / M y P r o j e c t d i r e c t o r y :

• s r c /

T h e b a s e d i r e c t o r y f o r y o u r w e b s e r v i c e ( s e r v e r - s i d• s r c / b u i l d . x m l

T h e b u i l d s c r i p t u s e d t o b u i l d a n d d e p l o y y o u r w e b

• s r c / t a s k s / o r g / m y o r g / M a t h S e r v i c e A s u b d i r e c t o r y w h e r e y o u c a n c r e a t e y o u r I n f o * E ns u g g e s t i o n ; y o u c a n c r e a t e a n o t h e r d i r e c t o r y h i e r a d e s i r e d . T h e t o o l s p a c k a g e y o u r s e r v i c e u s i n g t h e to n t h e s e r v i c e . t y p e . i d p r o p e r t y w h e n c r e a t i n g t h e p r o j e c t

• s r c _ c l i e n t /

T h e b a s e d i r e c t o r y f o r y o u r w e b s e r v i c e c l i e n t . • s r c _ c l i e n t / b u i l d . x m l

T h e b u i l d s c r i p t u s e d t o b u i l d y o u r w e b s e r v i c e c l i e• s r c _ c l i e n t / o r g / m y o r g / M a t h C l i e n t . j a v a

T h e b e g i n n i n g s o f y o u r w e b s e r v i c e c l i e n t .

R e v i e w t h e c o n t e n t s o f t h e t w o g e n e r a t e d b u i l d . x m l s c r i p t s t o g a i n s o m e u n d e r s t a n d i n g o n h o w t h e y w o r k .

T o f u r t h e r f a m i l i a r i z e y o u r s e l f w i t h t h e f r a m e w o r k f s r c a n d s r c _ c l i e n t d i r e c t o r i e s , r u n t h e f o l l o w i n g a n t c o m m a n d s :

% a n t - p % a n t u s a g e




T h e r s t c o m m a n d d i s p l a y s t h e p u b l i c t a r g e t s f o rt h e i r d e s c r i p t i o n s . T h e s e c o n d c o m m a n d p r o v i d y o u c a n t a i l o r y o u r b u i l d s c r i p t i f y o u n d i t n e c e s p r o j e c t s t h i s s h o u l d n o t b e n e c e s s a r y .

W r i t e t h e I n f o * E n g i n e T a s k s f o r YT h i s s t e p c r e a t e s f o u r s i m p l e t a s k s ( A d d . x m l , D i v i d e . x m l , M u l t i p l y . x m , S u b t r a c t . x m l ) i n t h e f o l l o w i n g l o c a t i o n s w i t h t h e g i vt h e s e t a s k s a r e v e r y s i m p l e a n d p r i m a r i l y c o n t a i n

A d d . x m l

S o u r c e : < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e / t a s k s / o r g / m y o r g / M a t h S e r v i c e / A d d . x m l

< % @ p a g e l a n g u a g e = " j a v a " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a < % @ t a g l i b u r i = " / c o m / i n f o e n g i n e / t l d s / i e j s t l . t l d " p r

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f G e n e r a t e s t h e s u m o f t w o i n t e g e r s . S u p p l y t w o i n t e g e r s , a a n d b . Y o u c a n s u b t r a c t i n t e g e r s u s i n g t h e { @ l i n k S u b t r a c t } m e t h o d .

@ p a r a m i n t a T h e f i r s t i n t e g e r . @ p a r a m i n t b T h e s e c o n d i n t e g e r .

@ r e t u r n i n t $ { o u t p u t [ 0 ] r e s u l t [ 0 ] } T h e s u m o f a a n d @ s e e M u l t i p l y @ s e e D i v i d e @ s e e S u b t r a c t - - > 

 < ! - - j u s t s o n o n - w e b s e r v i c e c l i e n t s c o u l d c a l l t h i s

c o e r c e a t o a n i n t , i n c a s e i t i s n ’ t a l r e a d y - - > < c : s e t v a r = " A " v a l u e = " $ { 0 + @ F O R M [ 0 ] a [ 0 ] } " / > < c : s e t v a r = " $ { o u t p u t [ 0 ] r e s u l t } " v a l u e = " $ { A + @ F O R M

D i v i d e . x m l

S o u r c e : < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e / t a s k s / o r g / m y o r g / M a t h S e r v i c e / D i v i d e .





< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f G e n e r a t e s t h e r e s u l t o f d i v i d i n g t w o i n t e g e r s .

 S u p p l y t w o i n t e g e r s , a a n d b . Y o u c a n m u l t i p l y i n t e g e r s u s i n g t h e { @ l i n k M u l t i p l y } m e t h o d .

@ p a r a m i n t a T h e f i r s t i n t e g e r . @ p a r a m i n t b T h e s e c o n d i n t e g e r . @ r e t u r n f l o a t $ { o u t p u t [ 0 ] r e s u l t [ 0 ] } T h e s u m o f a a n d b . @ s e e M u l t i p l y @ s e e D i v i d e @ s e e S u b t r a c t - - > 

 < ! - - j u s t s o n o n - w e b s e r v i c e c l i e n t s c o u l d c a l l t h i s t a s k

c o e r c e a t o a n f l o a t , i n c a s e i t i s n ’ t a l r e a d y - - > < c : s e t v a r = " A " v a l u e = " $ { 0 . 0 + @ F O R M [ 0 ] a [ 0 ] } " / > < c : s e t v a r = " $ { o u t p u t [ 0 ] r e s u l t } " v a l u e = " $ { A / @ F O R M [ 0 ] b

M u l t i p l y . x m l

S o u r c e : < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e c t / / t a s k s / o r g / m y o r g / M a t h S e r v i c e / M u l t i p l y . x

< % @ p a g e l a n g u a g e = " j a v a " % >

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b /< % @ t a g l i b u r i = " / c o m / i n f o e n g i n e / t l d s / i e j s t l . t l d " p r e f i x

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f G e n e r a t e s t h e p r o d u c t o f t w o i n t e g e r s . S u p p l y t w o i n t e g e r s , a a n d b . Y o u c a n d i v i d e i n t e g e r s u s i n g t h e { @ l i n k D i v i d e } m e t h o d .

@ p a r a m i n t a T h e f i r s t i n t e g e r . @ p a r a m i n t b T h e s e c o n d i n t e g e r . @ r e t u r n i n t $ { o u t p u t [ 0 ] r e s u l t [ 0 ] } T h e s u m o f a a n d b . @ s e e M u l t i p l y @ s e e D i v i d e @ s e e S u b t r a c t - - > 

 < ! - - j u s t s o n o n - w e b s e r v i c e c l i e n t s c o u l d c a l l t h i s t a s k

c o e r c e a t o a n i n t , i n c a s e i t i s n ' t a l r e a d y - - >




< c : s e t v a r = " A " v a l u e = " $ { 0 + @ F O R M [ 0 ] a [ 0 ] } " / > < c : s e t v a r = " $ { o u t p u t [ 0 ] r e s u l t } " v a l u e = " $ { A * @ F O R M

S u b t r a c t . x m l S o u r c e : < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e t a s k s / o r g / m y o r g / M a t h S e r v i c e / S u b t r a c t


< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f G e n e r a t e s t h e d i f f e r e n c e o f t w o i n t e g e r s . S u p p l y t w o i n t e g e r s , a a n d b . Y o u c a n a d d i n t e g e r s u s i n g t h e { @ l i n k A d d } m e t h o d .

@ p a r a m i n t a T h e f i r s t i n t e g e r . @ p a r a m i n t b T h e s e c o n d i n t e g e r . @ r e t u r n i n t $ { o u t p u t [ 0 ] r e s u l t [ 0 ] } T h e s u m o f a a n d @ s e e M u l t i p l y @ s e e D i v i d e @ s e e S u b t r a c t - - > 

 

< ! - - j u s t s o n o n - w e b s e r v i c e c l i e n t s c o u l d c a l l t h i s c o e r c e a t o a n i n t , i n c a s e i t i s n ' t a l r e a d y - - >

< c : s e t v a r = " A " v a l u e = " $ { 0 + @ F O R M [ 0 ] a [ 0 ] } " / > < c : s e t v a r = " $ { o u t p u t [ 0 ] r e s u l t } " v a l u e = " $ { A - @ F O R M

D e p l o y Y o u r W e b S e r v i c e W h e n t h i s p r o j e c t w a s c r e a t e d , a p a r a m e t e r n a m e s e c u r i t y . p o l i c y w a s s u p p l i e d , f o r w h i c h t h e v a l u e o f u s e r N a m e A u t h S y m m e t r i c K w a s e x p l i c i t l y p a s s e d . T h e r e f o r e , f o r t h i s e x a m p l e y oa n d a p a s s w o r d t o y o u r w e b s e r v i c e c l i e n t .

T o g e n e r a t e a n d d e p l o y y o u r w e b s e r v i c e , r u n t h e

N o t e W i n d c h i l l d o e s n o t n e e d t o b e a c t i v e t o r u n t h e A p

% c d < W i n d c h i l l > / p r o g _ e x a m p l e s / M y P r o j e c t / s r c % a n t

A t t h i s p o i n t s t a r t ( o r r e s t a r t ) W i n d c h i l l t o n i s h d




W h e n r u n w i t h n o a r g u m e n t s , t h e A p a c h e A n t s c r i p t d e p l o y s y o u r w e b s e r v i c e :

• T h e s e r v i c e i s p a c k a g e d , c o m p i l e d , a n d i n s t a l l e d i I n f o * E n g i n e t a s k - b a s e d s e r v i c e , y o u r t a s k s a r e p a ca n d i n s t a l l e d . I n t h i s e x a m p l e , t h e r e s u l t i n g P T C T A

< W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e c t / d i s t _ s e r v e r / m a t

I f y o u r w e b s e r v i c e r e q u i r e s J a v a o b j e c t s , t h e n y o uc r e a t e t h e p a c k a g e h i e r a r c h y a n d s o u r c e f o r t h o s e s r c d i r e c t o r y . T h e s c r i p t a u t o m a t i c a l l y c o m p i l e s a nc l a s s e s f o r y o u . C l a s s e s a s s o c i a t e d w i t h y o u r w e b < W i n d c h i l l > / c o d e b a s e / W E B - I N F / l i b w i t h i n a J A R l e t h a t r e e t h e s e r v l e t n a m e o f y o u r s e r v i c e .

• T h e < W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s / b u i s c r i p t i s t h e n r u n t o g e n e r a t e a n d c o m p i l e t h e s e r v e r - s i d e a n d d e p l o y t h e w e b s e r v i c e . T h i s b u i l d s c r i p t c a n ad e p e n d i n g o n y o u r n e e d s . F o r m o r e i n f o r m a t i o n , s e e U s i n g t h e W e b S e r v i c eD e p l o y m e n t B u i l d S c r i p t o n p a g e 1 7 3 .

N o t e I f y o u u s e t h e A p a c h e A n t f r a m e w o r k y o u s h o u l d n o s c r i p t m a n u a l l y . T h e A p a c h e A n t f r a m e w o r k c a n a l e x i s t i n g l e g a c y w e b s e r v i c e t h a t i s a l r e a d y i n s t a l l e d t h e s r c d i r e c t o r y c o n t a i n s o n l y t h e b u i l d . x m l s c r i p t a n d n o t a s k s o u r c e

N o w t h a t y o u r s e r v i c e i s d e p l o y e d a n d W i n d c h i l l i s r w e b s e r v i c e W S D L b y v i s i t i n g a U R L s i m i l a r t o t h e fh t t p : / / < h o s t > / W i n d c h i l l / s e r v l e t / M a t h S e r v i c e ? w

I f y o u a r e w r i t i n g a J a v a c l i e n t , a s d e s c r i b e d i n W r i t i n g a J a v a - b a s e d W e b S e r v i C l i e n t o n p a g e 1 6 3 , t h e n y o u d o n o t n e e d t o k n o w h o w t o a c c e S D L . H o w e v e r , y o u m u s t a c c e s s i t i f y o u p l a n t o i n t e g r a t e w e b s e r v i c e c l i e n t .

U n d e p l o y Y o u r W e b S e r v i c e I f y o u w a n t t o u n d e p l o y y o u r w e b s e r v i c e f r o m y o u r u n d e p l o y t a r g e t f o r t h e s r c / b u i l d . x m l s c r i p t o f y o u r p r o j e c t . F o r e x % c d < W i n d c h i l l > / p r o g _ e x a m p l e s / M y P r o j e c t / s r c % a n t u n d e p l o y

T h e u n d e p l o y t a r g e t c o m p l e t e s t h e f o l l o w i n g a c t i o n s :

• R e m o v e s t h e s e r v l e t c o n g u r a t i o n f r o m w e b . x m l • R e m o v e s t h e w e b s e r v i c e c o n g u r a t i o n f r o m s u n - j a x w s . x m l • R e m o v e s t h e s e c u r i t y p o l i c y c o n g u r a t i o n l e




• R e m o v e s t h e J A R l e s u p p o r t i n g y o u r w e b s e r• U n i n s t a l l s t h e I n f o * E n g i n e t a s k s ( i f y o u r s e r v i

I n f o * E n g i n e W e b S e r v i c e P a r a m D o c u m e n t a t i o n Y o u s h o u l d f a m i l i a r i z e y o u r s e l f w i t h t h e p r o c e s I n f o * E n g i n e t a s k s . V i s i t t h e d o c u m e n t a t i o n f o r yt h e f o l l o w i n g U R L : h t t p : / / < h o s t > / W i n d c h i l l / i n f o e n g i n e / j s p / t o o

N o t e T h i s u t i l i t y p r o v i d e s d o c u m e n t a t i o n f o r s e v e r a l i n

t y p e i d e n t i e r s . M o s t o f t h e s e t a s k s a r e n o t w r i t t e na n d s h o u l d n o t b e u s e d a s s u c h .

F r o m t h e R e p o s i t o r y T y p e s p a n e i n y o u r w e b b r o w s e r , s e l e c t c o m . p t c . w i n d c h i l . F r o m t h e C l a s s e s p a n e , s e l e c t y o u r o r g . m y o r g . M a t h S e r v i c e s e r v i c e t y p e i d e n tT h e d o c u m e n t a t i o n t h a t a p p e a r s i s b a s e d o n t h e c o n t e n t s o f t h e t a s k s y oF o r m o r e i n f o r m a t i o n o n w r i t i n g t a s k d o c u m e n t ah t t p : / / < h o s t > / W i n d c h i l l / i n f o e n g i n e / j s p / t o o

F o r m o r e i n f o r m a t i o n o n w r i t i n g S O A P t a s k s , s e S O A P S e r v i c e s o n p a g .

W r i t i n g a J a v a - b a s e d W e b T h e p r o j e c t d i r e c t o r y ( s r c _ c l i e n t ) a n d t h e e x a m p l e J a v a s o u r cs r c _ c l i e n t / o r g / m y o r g / M a t h C l i e n t . j a v a w e r e c r e a t e d i n t h e sC r e a t e a P r o j e c t o n p a g e 1 5 7 .

T h e M a t h C l i e n t . j a v a s o u r c e l e i s d e p e n d e n t u p o n s o u r ca r e g e n e r a t e d f r o m y o u r d e p l o y e d w e b s e r v i c e . Bc o m p l e t e y o u r c l i e n t s o u r c e , y o u m u s t g e n e r a t e ag e n e r a t e d , M a t h C l i e n t . j a v a c o m p i l e s , b u t d o e s n o t h i n g u n ti n v o k e a w e b s e r v i c e m e t h o d .

I n o r d e r t o g e t t h e s e a r t i f a c t s , y o u m u s t c o m p i l e f o l l o w i n g c o m m a n d s :

% c d < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e c t / s r c _ c l i e n t% a n t

T h e A p a c h e A n t s c r i p t a l s o g e n e r a t e s a n e x e c u t a

< W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e c t / d i s t _ c l i e n t / M




H o w e v e r , s i n c e y o u r m a i n c l a s s d o e s n o t h i n g , t h e n e n o t h i n g . R u n n i n g t h e p r e v i o u s a n t c o m m a n d p r o c e s s e s t h e W S D L f os e r v i c e a n d g e n e r a t e s J a v a s o u r c e a r t i f a c t s t o t h e f o l l< W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e c t / g e n

T h i s c r e a t e s J a v a s o u r c e c o d e w i t h i n t h e c o m . p t c . j w s . s e r v i c e . o r g . m y o r g . m a t h s e r v i c e p a c k a gg e n e r a t e d i n t o a p a c k a g e w i t h a n a m e d e r i v e d f r o m t c a n u s e t h e j a x w s . p a c k a g e p r o p e r t y w i t h i n t h e b u i l d . x m l l e t o e x p l i c i t l y d e n e w h i c h p a c k a g e y o u w a n t t h e s o u r c e c o d e g e n e

E d i t t h e c l i e n t s o u r c e c o d e t o c o m p l e t e y o u r c l i e n t :

1 . I n a t e x t e d i t o r , o p e n t h e f o l l o w i n g l e :

< W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y P r o j e c t / s r c _ c l i e n t / o r g /

T h e s o u r c e l o o k s s o m e t h i n g l i k e : p a c k a g e o r g . m y o r g ;

/ / i m p o r t t h e c l a s s e s g e n e r a t e d w h e n c o m p i l i n g y o u r c / / i m p o r t c o m . p t c . j w s . s e r v i c e . ? . * ; i m p o r t c o m . p t c . j w s . c l i e n t . h a n d l e r . * ;

p u b l i c c l a s s M a t h C l i e n t {

p u b l i c s t a t i c v o i d m a i n ( S t r i n g [ ] a r g s ) t h r o w s j a v{

/ / d e p e n d i n g o n y o u r s e c u r i t y r e q u i r e m e n t s y o u m a y n e/ / f r o n t , o r o n t h e c o m m a n d - l i n e w h e r e m o s t p o l i c i e s w/ / C r e d e n t i a l s . s e t U s e r n a m e ( " d e m o " ) ; / / C r e d e n t i a l s . s e t P a s s w o r d ( " d e m o " ) ; / / T O D O i m p l e m e n t y o u r c l i e n t / *

M a t h S e r v i c e I m p l S e r v i c e s e r v i c e = n e w M a t h S e r v iM a t h S e r v i c e I m p l p o r t = s e r v i c e . g e t M a t h S e r v i c e I / / i n v o k e a n a c t i o n / / p o r t . m e t h o d N a m e ( < a r g u m e n t s > ) ; * /

} }

2 . U p d a t e t h e s o u r c e t o i m p o r t t h e s e r v e r - s i d e w e b s a m e t h o d a s f o l l o w s :

p a c k a g e o r g . m y o r g ;

/ / i m p o r t t h e c l a s s e s g e n e r a t e d w h e n c o m p i l i n g y o u r c i m p o r t c o m . p t c . j w s . s e r v i c e . o r g . m y o r g . m a t h s e r v i c e . * ;




p u b l i c c l a s s M a t h C l i e n t {

p u b l i c s t a t i c v o i d m a i n ( S t r i n g [ ] a r g s ) t h r o w

{ i n t a = a r g s . l e n g t h > 0 ? I n t e g e r . p a r s e I n t ( a i n t b = a r g s . l e n g t h > 1 ? I n t e g e r . p a r s e I n t ( a

M a t h S e r v i c e I m p l S e r v i c e s e r v i c e = n e w M a t h S M a t h S e r v i c e I m p l p o r t = s e r v i c e . g e t M a t h S e r v i c e I m p l P o r t ( ) S y s t e m . o u t . p r i n t f ( " a + b = % d \ n " , p o r t . a d d ( a , b ) ) ; S y s t e m . o u t . p r i n t f ( " a - b = % d \ n " , p o r t . s u b t r a S y s t e m . o u t . p r i n t f ( " a * b = % d \ n " , p o r t . m u l t i p S y s t e m . o u t . p r i n t f ( " a / b = % f \ n " , p o r t . d i v i d e

} }

3 . R e c o m p i l e y o u r c l i e n t a n d u p d a t e y o u r e x e c u c l a s s e s :

% a n t c o m p i l e % a n t d i s t

4 . R u n y o u r n e w w e b s e r v i c e c l i e n t f r o m t h e c o m

% j a v a - j a r . . / d i s t _ c l i e n t / M a t h S e r v i c e C l i e n t . j a r 1 0 2 0 U s e r n a m e : P a s s w o r d : a + b = 3 0 a - b = - 1 0 a * b = 2 0 0 a / b = 0 . 5 0 0 0 0 0

W h e r e i s t h e u s e r n a m e a n d i s t h e p a s s w o r d y oh a v e s u p p l i e d . W h e n r u n n i n g y o u r c l i e n t , y o u l i n e f o r c r e d e n t i a l s .

C l i e n t C a l l b a c k H a n d l e r s W h e n c r e a t i n g t h e w e b s e r v i c e p r o j e c t , t h e

- D s e c u r i t y . p o l i c y = u s e r n a m e A u t h S y m m e p r o p e r t y w a s

s u p p l i e d . T h i s i n s t r u c t e d t h e f r a m e w o r k t o e x p l iw i t h t h e s e c u r i t y p o l i c y , w h i c h i s d e s c r i b e d i n U s e r n a m e A u t h e n t i c a t iw i t h S y m m e t r i c K e y s o n p a g e 1 5 3 . I f t h i s p r o p e r t y h a d n o t b e e ne x p l i c i t l y p r o v i d e d , t h e n t h e s e c u r i t y p o l i c y w o ut h e v a l u e o f t h e s e c u r i t y . p o l i c y p r o p e r t y a s c o n g u r e d i n < W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s / s e .




W h e n g e n e r a t i n g t h e c l i e n t p o r t i o n o f t h e p r o j e c t , t h ic l i e n t - s i d e c a l l b a c k h a n d l e r c o n g u r a t i o n t o b e u s e d h a n d l e r . c o n f i g p r o p e r t y o f t h e s r c _ c l i e n t / b u i l d . x m l b u i l d s c r i p t . T o v i e w t h e f o r m a t o f t h e h a n d l e r . c o n f i g p r o p e r t y , r u n t h e a n t u s a g e c o m m a n d f r o m w i t h i n t h e s r c _ c l i e n t d i r e c t o r y .

T h e c o m . p t c . j w s . c l i e n t . h a n d l e r p a c k a g e a l s o c o n t a i nf o r y o u r w e b s e r v i c e c l i e n t t o u s e f o r t h e s u p p o r t e d s ec l a s s e s a r e a u t o m a t i c a l l y p a c k a g e d f o r y o u w h e n y o c a n c h o o s e t o u s e t h e s e c l a s s e s t o p r o v i d e s e c u r i t y i ns e r v i c e c l i e n t s , o r y o u c a n c h o o s e t o a u t h o r y o u r o w ni m p l e m e n t s j a v a x . s e c u r i t y . a u t h . c a l l b a c k . C a l l b a a n d t h e n p r o v i d i n g t h a t c l a s s a s p a r t o f t h e h a n d l e r . c o n f i g p r o p e r t y .

T h e d e f a u l t c a l l b a c k h a n d l e r s u p p l i e d f o r u s e r n a m e A u t h S y m m e t r i c K p r o m p t s f o r c r e d e n t i a l s o n t h e c o m m a n d l i n e . I t c a n t h e u s e r f o r c r e d e n t i a l s u s i n g s w i n g d i a l o g s o r t o f e t cs y s t e m p r o p e r t i e s . I t o n l y p r o m p t s f o r c r e d e n t i a l s o nc r e d e n t i a l s u n t i l y o u p r o g r a m a t i c a l l y c l e a r t h e m .

I f y o u w a n t t o p r o g r a m m a g i c a l l y p r o v i d e c r e d e n t i a lt h e c o m . p t c . j w s . c l i e n t . h a n d l e r . C r e d e n t i a l s c l a s s u s i n g t h e s e t U s e r n a m e a n d s e t P a s s w o r d m e t h o d s .

T h e w e b s e r v i c e s f r a m e w o r k m a k e s u s e o f t w o s e p a r

• T h e W S I T ( W e b S e r v i c e s I n t e r o p e r a b i l i t y T e c h n ot h e j a v a x . s e c u r i t y . a u t h . c a l l b a c k . C a l l b a c k i m p l e m e n t a t i o n s .

T h e s e h a n d l e r s a r e u s e d f o r s e c u r i t y p o l i c i e s o t h e w e b S e r v e r A u t h e n t i c a t e d t o g a t h e r t h e c r e d e n t i a l s o r s e c u r i t y t o k e n s t h a t a r e p a s s e d t o t h e w e b s e r v i c e . d o n o t m e e t t h e n e e d s o f y o u r a p p l i c a t i o n , y o u c a n s u p p l y t h e m u s i n g t h e h a n d l e r . c o n f i g p r o p e r t y i n t h e b u i l d . x m l l e .

• T h e J A X - W S h a n d l e r c h a i n i s e s s e n t i a l l y a l i s t o f i m p l e m e n t i n g t h e f o l l o w i n g :

j a v a x . x m l . w s . h a n d l e r . s o a p . S O A P H a n d l e r < j a v a x . x m l . w

I n s t e a d o f i m p l e m e n t i n g t h e c l i e n t c o d e , t h e s e h a n g e n e r i c f u n c t i o n a l i t y a n d c o n d i t i o n i n g f o r S O A P is e r v i c e s f r a m e w o r k p r o v i d e s s o m e b a s i c h a n d l e r s s u p p l y i n g t h e U R L t o y o u r w e b s e r v i c e a n d a d d i n gw h e n w e b s e r v e r a u t h e n t i c a t i o n i s u s e d .

T h e s e h a n d l e r s c a n a l s o b e w r i t t e n t o p e r f o r m a d d ia d d h e a d e r s t o S O A P r e q u e s t s o r h a n d l e f a u l t s i n a c a n t a i l o r t h e h a n d l e r c h a i n o f y o u c l i e n t b y c h a n g ih a n d l e r . c h a i n p r o p e r t i e s i n t h e b u i l d . x m l l e . T h e s e p r o p e r t i e s a r ed e s c r i b e d i n g r e a t e r d e t a i l w i t h i n t h e b u i l d . x m l l e .




P o r t a b l e W e b S e r v i c e C l i e n t s T h e r e a r e c e r t a i n i s s u e s t h a t m u s t b e a d d r e s s e d t o

r u n o n a c l i e n t m a c h i n e p r o p e r l y o r t o i n t e r a c t w ih o s t s o n s e p a r a t e W i n d c h i l l i n s t a n c e s . S e c u r i t y ph a r d - c o d e d a t c o m p i l e t i m e , r e q u i r i n g a n e w c l i ec l i e n t h o s t . S i m i l a r l y , t h e a d d r e s s o f t h e w e b s e r vt h e r e f o r e w r i t i n g a c l i e n t t h a t i n t e r a c t s w i t h s e p a s e r v i c e e n d p o i n t t o b e p r o v i d e d p r o g r a m a t i c a l l y s e r v i c e c l i e n t s , t h e W e b S e r v i c e s F r a m e w o r k u s ea l l o w s c l i e n t J A R l e s t o b e r e c o n g u r e d a s n e e d

U s i n g S e c u r i t y P o l i c i e s W h e n s e c u r i n g a w e b s e r v i c e w i t h o n e o f t h e s u p t h a n w e b s e r v e r a u t h e n t i c a t i o n ) , a J a v a c l i e n t n e et r u s t s t o r e . P a t h s t o t h e s e l e s ( k e y s t o r e a n d t r u s t s t o r e ) a r e c o n g ut h e b u i l d f r a m e w o r k i n t h e f o l l o w i n g :

< W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s / c l i e n t / s e c u r i t

T h e p a t h s t o t h e k e y s t o r e a n d t r u s t s t o r e a r e a b s o ld e p l o y m e n t d e s c r i p t o r s p a c k a g e d w i t h y o u r c l i ed i r e c t o r y .

I f y o u c o m p i l e a w e b s e r v i c e c l i e n t f r o m t h e s a m w i t h t h e s t a n d a r d c o n g u r a t i o n , t h e n t h e s e l e s a o n l y o n t h a t h o s t . B e f o r e r e d i s t r i b u t i n g y o u r w e b

y o u m u s t d o o n e o f t h e f o l l o w i n g : • U p d a t e t h e c l i e n t / s e c u r i t y . p r o p e r t i e s l e ( o r m a k e a c o p y o

i n y o u r s r c _ c l i e n t d i r e c t o r y a n d t h e n u p d a t e i t ) t o c o nl o c a t i o n w h e r e t h e s e l e s e x i s t o n t h e n e w c l i e nc l i e n t .

• R e c o n g u r e t h e c l i e n t J A R l e f o r e v e r y h o s t f ri n f o r m a t i o n , s e e R e c o n g u r i n g t h e C l i e n t J A R F i l e o n p .

• C o m p i l e a c o p y o f t h e c l i e n t f o r e v e r y h o s t o n w i t h e a c h c o n t a i n i n g t h e a p p r o p r i a t e p a t h s f o r i n f o r m a t i o n , s e e C o m p i l i n g a C o p y o f Y o u r C l i e n t f o r E .

R e c o n g u r i n g t h e C l i e n t J A R F i l e A f t e r c o m p i l i n g a n d p a c k a g i n g y o u r c l i e n t , t h e d i s t _ c l i e n t d i r e c t o r y o f y o p r o j e c t i n c l u d e s t w o J A R l e s : o n e c o n t a i n i n g y ow e b s e r v i c e s - s u p p o r t . j a r l e . T h i s J A R l e i s e x e c u t a b l e t o r e c o n g u r e y o u r c l i e n t a s f o l l o w s :

% j a v a - j a r w e b s e r v i c e s - s u p p o r t . j a r - c l i e n t J a r < j a r f i l e > [ - t a r g e t J a r < j a r f i l e > ] [ - s e c u r i t y P r o p e r t i e s ] [ - w s d l < s e r v i c e w s d l > ]




I f - t a r g e t J a r i s n o t s p e c i e d , t h e n - c l i e n t J a r i s o v e r w r i t t e n . Y o u m u s

a l s o s p e c i f y - w s d l o r - s e c u r i t y P r o p e r t i e s , o r b o t h . T o r e c o n g u r e t h e p a t h s t o t h e t r u s t s t o r e a n d k e y s t o r c o p y t h e s e c u r i t y . p r o p e r t i e s l e t o t h e c l i e n t h o s t a n d r u n t h e ut h e - s e c u r i t y P r o p e r t i e s a r g u m e n t . T h i s c a n a l s o b e u s e d t o rt h e d e f a u l t U R L t o y o u r w e b s e r v i c e . A l t e r n a t i v e l y , y o u r w e b s e r v i c e u s i n g a s y s t e m p r o p e r t y , o r w r i t e y o p r o v i d e t h e U R L .

N o t e T h e l e p a t h s t o t h e t r u s t s t o r e a n d k e y s t o r e l o c a t i o n s wb e a b s o l u t e a n d c a n n o t c o n t a i n o t h e r p r o p e r t y r e f e r e n

W h e n r e c o n g u r i n g a c l i e n t J A R i n t h i s w a y , y o u a l s i n f o r m a t i o n a b o u t w h a t c a l l b a c k h a n d l e r s y o u r c l i e nn o t s u p p l y t h i s i n f o r m a t i o n , t h e n y o u r r e c o n g u r e d ci t i s p r o g r a m m a t i c a l l y s u p p l y i n g t h e i n f o r m a t i o n n o h a n d l e r s . S p e c i c a l l y , t h i s i n c l u d e s t h e c l a s s e s r e q u io r p e r f o r m o t h e r g e n e r a l p r o c e s s i n g t h r o u g h t h e J A X

A d d i t i o n a l p r o p e r t i e s y o u m i g h t w a n t t o s e t a r e : h a n d l e r . c o n f i g h a n d l e r . c h a i n . a u t h e n t i c a t i o n h a n d l e r . c h a i n . e x t r a s

h a n d l e r . c h a i n . u r l h a n d l e r . c h a i n . a u t h e n t i c a t i o n

N o t e F o r d e s c r i p t i o n s o f t h e s e p r o p e r t i e s , r u n t h e a n t u s a g e c o m m a n d f r o m w i t h i n y o u r s r c _ c l i e n t p r o j e c t d i r e c t o r y .

F o r a n e x i s t i n g c l i e n t J A R , t h e c o n g u r a t i o n i s s u p ps e c u r i t y . p r o p e r t i e s l e . A t b u i l d t i m e t h i s c o n g u r a t i o n i sf o u n d w i t h i n y o u r s r c _ c l i e n t / b u i l d . x m l A n t s c r i p t .

I f y o u a r e r e c o n g u r i n g o n l y t h e p a t h s t o t r u s t s t o r e s

t h e n y o u s h o u l d c h e c k t h e v a l u e o f t h e h a n d l e r . c o n f i g p r o p e r t y i n y o u r s r c _ c l i e n t / b u i l d . x m l s c r i p t . S u p p l y t h i s p r o p e r t y i n t h es e c u r i t y . p r o p e r t i e s l e w h e n r e c o n g u r i n g y o u r c l i e n t J A

I f y o u a r e r e c o n g u r i n g y o u r c l i e n t J A R b e c a u s e y o u h a s c h a n g e d , t h e n y o u m i g h t n e e d t o c h a n g e t h e h a n dc l i e n t . F o r e x a m p l e :

# w e b s e r v i c e s e c u r i t y . p o l i c y = u s e r N a m e A u t h S y m m e t r i c K h a n d l e r . c o n f i g = u s e r n a m e H a n d l e r : c o m . p t c . j w s . c l i e n t . h a






Y o u r c l i e n t c a n u s e t h e w t . w e b s e r v i c e . u r l s y s t e m p r o p e r t y t o o v e r r i dt h e w e b s e r v e r U R L , o r y o u c a n s u p p l y t h e U R L p r o t h e s e t W e b S e r v i c e U R L ( j a v a . n e t . U R L u r l ) m e t h o d o n t h e c o m . p t c . j w s . c l i e n t . h a n d l e r . W e b S e r v i c e U R c l a s s . A l t e r n a t i v e l y , y o u c a n o v e r r i d e t h e h a n d l e r . c h a i n . u r l p r o p e r t y w i t h y o u r o w n i m p l e m e n t a t i o n t o s u p p l y t h i s U R L . D o i n g t h i s j a v a x . x m l . w s . B i n d i n g P r o v i d e r . E N D P O I N T _w i t h i n t h e i n s t a n c e o f j a v a x . x m l . w s . h a n d l e r . s o a p . S O A P M e s s a g e C g i v e n t o y o u r h a n d l e r i m p l e m e n t a t i o n .

W e b S e r v e r A u t h e n t i c a t e d S e r v i c e sU s i n g t h e s t a n d a r d s e c u r i t y p o l i c i e s ( s u c h a s S A M L A u t h e n t i c a t i o n w i t h S y m m e t r i c K e y s ) m e a n s t h a t y od e p l o y e d i n a m a n n e r t h a t i s u n p r o t e c t e d b y w e b s e r vc a s e s i t i s t h e r e s p o n s i b i l i t y o f t h e w e b s e r v i c e , n o t t ha u t h e n t i c a t i o n .

Y o u c a n a l s o d e p l o y y o u r s e r v l e t b e h i n d w e b s e r v e r t o d o t h i s , u s e t h e w e b S e r v e r A u t h e n t i c a t e d s e c u r i t y p o l i c y w h e n d e p l o y a s d o c u m e n t e d i n : < W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s / s e c u

T h e t o o l i n g a u t o m a t i c a l l y u p d a t e s t h e p r o t e c t e d r e s o< W i n d c h i l l > / a p a c h e C o n f ( p r o v i d e d y o u a r e u s i n g a p r o j e c t t o

d e p l o y t h e s e r v i c e ) . I f r u n n i n g , t h e s e c h a n g e s a r e p r oc o n g u r a t i o n , w h i c h s h o u l d s i m p l y b e r e s t a r t e d . I f y o t h e r t h a n A p a c h e , o r y o u r A p a c h e i s n o t l o c a t e d o n y o u m u s t p r o p a g a t e t h e s e c h a n g e s m a n u a l l y t o y o u r

B y d e f a u l t , t h e J A X - W S h a n d l e r c h a i n i s c o n g u r e d i m p l e m e n t a t i o n t o i m p o s e u s e r c r e d e n t i a l s i n o u t g o is e r v i c e c l i e n t . T h e s e c r e d e n t i a l s c a n b e s u p p l i e d p r os e t U s e r n a m e ( S t r i n g u s e r ) a n d s e t P a s s w o r d ( S t r i n g p a s s wm e t h o d s o n t h e c o m . p t c . j w s . c l i e n t . h a n d l e r . C r e d e n c l a s s . A l t e r n a t i v e l y , c r e d e n t i a l s c a n b e s u p p l i e d o n t h e w t . w e b s e r v i c e . u s e r a n d w t . w e b s e r v i c e . p a s s w o r d s y s t e m p r o p e r t i e s .

Y o u c a n a l s o o v e r r i d e t h e h a n d l e r i m p l e m e n t a t i o n uh a n d l e r . c h a i n . a u t h e n t i c a t i o n p r o p e r t y w i t h i n y o u r b u i l d . x m l l e . I f y o u i m p l e m e n t y o u r o w n h a n d l e r , y o u j a v a x . x m l . w s . B i n d i n g P r o v i d e r . U S E R N A M E




j a v a x . x m l . w s . B i n d i n g P r o v i d e r . P A S S W O p r o p e r t i e s w i t h i n t h e j a v a x . x m l . w s . h a n d l e r . s o a p . S O A P Mo b j e c t s u p p l i e d t o y o u r h a n d l e r i m p l e m e n t a t i o n .

N o t e I f y o u u n d e p l o y a w e b s e r v i c e t h a t i s p r o t e c t e d b y t o o l i n g d o e s n o t a u t o m a t i c a l l y u p d a t e y o u r w e b s p r e v i o u s l y p r o t e c t e d r e s o u r c e . Y o u m u s t r e c o n g

W r i t i n g a J a v a - b a s e d W e b Y o u a l s o h a v e t h e o p t i o n o f m a n u a l l y i m p l e m e n tI n t h i s c a s e , y o u c a n g e n e r a t e a w e b s e r v i c e p r o j eA n t s c r i p t :

< W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s / n e w - p r o j e c t . x mw i t h a s e r v i c e . t y p e o f j a v a . T h e n , i n p l a c e o f s p e c i f y i n g s e r v i c e . t y p e . i d p r o p e r t y , i n s t e a d s p e c i f y t h e c l a s s t o t h e s e r v i c e . c l a s s p r o p e r t y .


% c d < W i n d c h i l l > % m k d i r p r o g _ e x a m p l e s / j w s / M y J a v a P r o j e c t % a n t - D p r o j e c t . d i r = < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y J a v a P r o j e- D s e r v l e t . n a m e = M y J a v a S e r v i c e - D s e c u r i t y . p o l i c y = u s e r N a m e A u t h S y m m e t r i c K e y s - D m

- D s e r v i c e . t y p e = j a v a - D s e r v i c e . c l a s s = o r g . m y o r g . M y - f b i n / a d m i n T o o l s / W e b S e r v i c e s / n e w - p r o j e c t . x m l c r

C r e a t i n g t h e n e w p r o j e c t g e n e r a t e s a b a s e c l a s s f oc a n b e f o u n d a t :

< W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y J a v a P r o j e c t / s r c / o r g / m

T h i s c o n t a i n s s o u r c e c o d e t h a t l o o k s s o m e t h i n g l

p a c k a g e o r g . m y o r g ;

i m p o r t j a v a x . j w s . W e b M e t h o d ; i m p o r t j a v a x . j w s . W e b P a r a m ; i m p o r t j a v a x . j w s . W e b S e r v i c e ; i m p o r t c o m . p t c . j w s . s e r v l e t . J a x W s W e b S e r v i c e ;

@ W e b S e r v i c e ( ) p u b l i c c l a s s M y J a v a S e r v i c e e x t e n d s J a x W s W e b S e r v i c{

@ W e b M e t h o d ( o p e r a t i o n N a m e = " a d d " ) p u b l i c i n t a d d ( i n t a , i n t b )




{ r e t u r n a + b ;

}

}

Y o u c a n a l s o s i m p l y r e p l a c e t h e e x a m p l e a d d m e t h o d w i t h y o u r o w n w e b sm e t h o d . Y o u c a n a l s o a d d o t h e r w e b s e r v i c e m e t h o d s a n d a n y r e q u i r e d s u p p o r t i nc l a s s e s w i t h i n t h e s r c d i r e c t o r y o f y o u r p r o j e c t . T h e n c o m p i l e d e p l o y y o u r n e w s e r v i c e a s f o l l o w s :

% c d < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / M y J a v a S e r v i c e / s r c / % a n t

T h i s c o m p i l e s y o u r w e b s e r v i c e a n d p a c k a g e s i t i n a Jn a m e w i t h i n < W i n d c h i l l > / c o d e b a s e / W E B - I N F / l i b . T h i s a l s o d e p l o y s

t h e s e r v i c e , w h i c h i s s e c u r e d u s i n g t h e s e c u r i t y p o l i c y o u r p r o j e c t . T h e n y o u c a n i m p l e m e n t y o u r w e b s e r va s d e s c r i b e d i n W r i t i n g a J a v a - b a s e d W e b S e r v i c e C l i e n t o n .

I f y o u c h o o s e t o g e n e r a t e t h e c l i e n t p o r t i o n o f y o u r w s o u r c e c o d e e x a m p l e m i g h t n o t c o m p i l e p r o p e r l y i f u n c o m m e n t e d ( i t i so u t i n t h e m a i n m e t h o d o f y o u r w e b s e r v i c e c l i e n t ) . Ts o u r c e c o d e a s s u m e s t h e w e b s e r v i c e i n q u e s t i o n i s I t h e r e f o r e g e n e r a t e s s o u r c e c o d e b a s e d u p o n t h a t a s s uc o m p i l e y o u r c l i e n t , e x a m i n e t h e c l i e n t s i d e s o u r c e cg e n s r c _ c l i e n t d i r e c t o r y , a n d t h e n a d j u s t y o u r c l i e n t s o u r F i n a l l y , y o u m u s t t h e n r e r u n t h e a n t c o m p i l e a n d a n t d i s t c o m m a n d s

t o r e c o m p i l e a n d p a c k a g e y o u r c l i e n t . C o n s u l t t h e s t a n d a r d J a v a j a v a d o c f o r t h e j a v a x . j w s , j a v a x . x m l . w s , a p a c k a g e s t o l e a r n m o r e a b o u t w r i t i n g a J a v a w e b s e r va t h t t p : / / j a v a . s u n . c o m .

N o t e t h a t i n t h e g e n e r a t e d s o u r c e c o d e e x a m p l e y o u re x t e n d s c o m . p t c . j w s . s e r v l e t . J a x W s S e r v i c e . T h i s i s n o t a n a b s o l u t er e q u i r e m e n t , b u t i t i s s t r o n g l y s u g g e s t e d a n d p r o v i d ec o n v e n i e n c e s , s u c h a s :

• A c c e s s t o a n i m p l i c i t l y i n s t a n t i a t e d l o g 4 j l o g g e r i n $ l o g i n s t a n c e v a r i a b l e , t h e l o g g e r n a m e o f w h i c h i s b a s e d o n y o u r w e b s e r v

Y o u c a n l o g m e s s a g e s b y s i m p l y i n v o k i n g m e t h o d $ l o g . d e b u g ( “ m y m e s s a g e ” ) ;

C o n s u l t t h e l o g 4 j d o c u m e n t a t i o n f o r m o r e i n f o r m af o u n d a t h t t p : / / l o g g i n g . a p a c h e . o r g / l o g 4 j / .

• A c c e s s t o t h e j a v a x . x m l . w s . W e b S e r v i c e C o n t e x t a s s o c i a t e d w i t h a w e b s e r v i c e r e q u e s t i n t h e $ w s c i n s t a n c e v a r i a b l e .


http://logging.apache.org/log4j/


http://logging.apache.org/log4j/




• A c c e s s t o t h e j a v a x . x m l . w s . h a n d l e r . M e s s a g e C a s s o c i a t e d w i t h a w e b s e r v i c e r e q u e s t u s i n g t h e g e t M e s s a g e C o n t e x t ( ) m e t h o d .

• A c c e s s t o t h e a s s o c i a t e d j a v a x . s e r v l e t . h t t p . H t t p S e r v l e t R e q u e s o b j e c t u s i n g t h e g e t S e r v l e t R e q u e s t ( ) m e t h o d . T h i s i s i m p o r t a n t b e c a u s e o n l y H t t p S e r v l e t R e q u e s t o b j e c t t h a t h a s b e e n p r o p e r l y c o na u t h e n t i c a t e d u s e r n a m e u s e d t o a c c e s s y o u r s e

N o t e S t a n d a r d J a v a w e b s e r v i c e s p r o v i d e a c c e s s t o t h e H t t p S e r v l e t R e q u e s t o b j e c t t h r o u g h t h e M e s s a g e C o n t e x t o b j e c t s t o r e d u n d e r t h e M e s s a g e C o n t e x t . S E R V L E T _ R E Q U E S T k e y . Y o u s h o u l d N O T u s et h i s s e r v l e t r e q u e s t o b j e c t , b u t r a t h e r u s e t h e o n e g e t S e r v l e t R e q u e s t ( ) m e t h o d o f y o u r w e b s e r v i c e . U s i n g t h e H t t p S e r v l e t R e q u

o b j e c t w o u l d c r e a t e a c o n i c t , a s t h e s e c u r i t y l a y e r e q u e s t s e x t r a c t s a n d v a l i d a t e s t h e s e c u r i t y c r e d er e q u e s t s b a s e d o n y o u r s e c u r i t y p o l i c y , a n d t h e n i a j a v a x . s e r v l e t . h t t p . H t t p S e r v l e t R e q u e s o b j e c t . T h e M e s s a g e C o n t e x t k e y S E R V L E T _ R E Q U E S T i s a n i m m s o t h e s e c u r i t y l a y e r m u s t s t o r e i t s v e r s i o n o f t h e H t t p S e r v l e t R e q u e s t o b j e c t u n d e r a n o t h e r k e y w i t h i n t h e M e s s a g e C o n t e x t . T h i s o b j e c t h a s t h e v a l i du s e r n a m e i m p o s e d i n t h e g e t R e m o t e U s e r ( ) a n d g e t U s e r P r i n c i p a l ( ) m e t h o d s o f t h i s H t t p S e r v l e t R e q u e s t o b j e c t .

U s i n g t h e W e b S e r v i c e D e pS c r i p t R e l e a s e d w i t h W i n d c h i l l i s a n A p a c h e A n t b u i l t sg e n e r a t e a n d d e p l o y a w e b s e r v i c e . I f y o u a r e m a a n d a r e m a k i n g u s e o f t h e p r o j e c t s u p p o r t p r o v i d ec a l l e d f o r y o u . T h i s m e a n s t h a t y o u d o n o t n e e d t d i r e c t l y ( a s i d e f r o m t h e s e c u r i t y . p r o p e r t i e s c o n g u r a t i o n ) . I f , h o y o u h a v e a l e g a c y w e b s e r v i c e a l r e a d y i n s t a l l e d ta n d d e p l o y ( f o r e x a m p l e t h e c o m . p t c . w i n d c h i l l . ww i t h W i n d c h i l l ) , t h e n y o u c a n c h o o s e t o r u n t h i s a l s o b e a c h i e v e d u s i n g t h e s u p p l i e d A p a c h e A n t w i t h o u t a n y i n p u t p r o p e r t i e s o n l y d i s p l a y s i t s r e qm u s t s u p p l y t h e s e r v l e t . n a m e a n d t y p e . i d o r w e b s e r v i c e . c l a s s p r o p e r t i e s a s i n p u t . O n t h e c o m m a n d l i n e y o u c a o v e r r i d e p r o p e r t i e s i n c l u d e d f r o m s e c u r i t y . p r o p e r t i e s b y a d d i n g - D = a r g u m e n t s . A n e x a m p ls p e c i f y i n g a s e c u r i t y . p o l i c y p r o p e r t y v a l u e t h a t d i f f e r s f r o v a l u e s y o u h a v e c o n g u r e d .




Y o u c a n a l s o c h o o s e t o r e d e p l o y t h e c o m . p t c . w i n d c h b e e n s e c u r e d u s i n g S A M L S e n d e r V o u c h e s . T o r e d e “ G e n e r i c W e b S e r v i c e ” r u n t h e f o l l o w i n g c o m m a n d s

% c d < W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s % a n t - D s e r v l e t . n a m e = G e n e r i c W e b S e r v i c e - D t y p e . i d = c o m- D s e c u r i t y . p o l i c y = s a m l s v g e n e r a t e

F o r e x a m p l e , y o u c o u l d c h o o s e t o e x p l i c i t l y s p e c i f y s e c u r i t y . p o l i c y p r o p e r t y o n t h e c o m m a n d l i n e . I f y o u s i m p l y w a n t t oc o n g u r a t i o n i n t h e s e c u r i t y . p r o p e r t i e s l e , t h e n t h i s p r o p e r t y i s n o n e c e s s a r y .

R u n n i n g t h e a b o v e c o m m a n d l i n e p e r f o r m s t h e f o l l o

1 . G e n e r a t e s a J A X - W S b a s e d w e b s e r v i c e t h a t e x p oI n f o * E n g i n e - b a s e d w e b s e r v i c e .

2 . U s e s t h e w s g e n u t i l i t y t o g e n e r a t e t h e r e q u i r e d J a vo f t h e w e b s e r v i c e d e p l o y m e n t .

3 . C o m p i l e s t h e p r e v i o u s l y g e n e r a t e d s o u r c e . 4 . B a s e d o n t h e c o n g u r e d s e c u r i t y p o l i c y , i t a p p l i e s

p o l i c y i n f o r m a t i o n f o r u s e b y t h e s e r v i c e . F o r m o s ti n < W i n d c h i l l > / c o d e b a s e / W E B - I N F n a m e d < w s i t - c l a s s > . x m l , w h i c h c o n t a i n s t h e s e c u r i t y p o l i c y i n s t r u c t i o n s f o r

5 . J A R t h e c o m p i l e d w e b s e r v i c e c l a s s e s f o r u s e b y W6 . A d d s s e r v l e t a n d s e r v l e t - m a p p i n g d e p l o y m e n t i n

s e r v i c e s e r v l e t t o : < W i n d c h i l l > / c o d e b a s e / W E B - I N F / w e b . x m l

7 . C r e a t e s o r u p d a t e s < W i n d c h i l l > / c o d e b a s e / W E B - I N F / s u n - j a x w s . x m t o d e p l o y t h e w e b s e r v i c e , a n d a s s o c i a t e s t h e s e r v e r - r e s p o n s i b l e f o r e x t r a c t i n g s e c u r i t y i n f o r m a t i o n f r oc o r r e s p o n d i n g t o t h e c o n g u r e d s e c u r i t y p o l i c y .

I t i s n o t n e c e s s a r y f o r W i n d c h i l l t o b e r u n n i n g t o d e p y o u s h o u l d r e s t a r t W i n d c h i l l a f t e r r u n n i n g t h e s c r i p t s e r v i c e .

U s i n g S O A P A t t a c h m e n t s J A X - W S w e b s e r v i c e s s u p p o r t t h e a b i l i t y t o i n c l u d e f a s h i o n i n y o u r S O A P r e q u e s t s .

J u s t a s w i t h l e g a c y w e b s e r v i c e s , t o u p l o a d b i n a r y d as t r e a m o f y o u r I n f o * E n g i n e t a s k ) , s i m p l y a d d a p a r a mo f j a v a x . a c t i v a t i o n . D a t a S o u r c e .




U n l i k e l e g a c y I n f o * E n g i n e w e b s e r v i c e s , w h i c h a t t a c h m e n t s , J A X - W S w e b s e r v i c e s u s e a t t a c h m d a t a a p p e a r a s i n l i n e w e b s e r v i c e p a r a m e t e r s . H oi m p l i c i t l y a l l o w s a S O A P c l i e n t t o i n c l u d e a s s o c o r c o n t e n t t y p e w i t h t h e a t t a c h m e n t u s i n g t h e C o n t e n t - D i s p o s i t i o n M I M E h e a d e r . A s a r e s u l t , I n f o * E n g i n e w e b s e r v i c e s n os p e c i e d a s a s e p a r a t e p a r a m e t e r a s s o c i a t e d w i t h p a r a m e t e r i s n o t u s e d t o s p e c i f y a n a t t a c h m e n t l d e f a u l t l e n a m e o f “ u n k n o w n . ”

Y o u c a n a l s o e x p l i c i t l y s p e c i f y t h e c o n t e n t t y p e oo n l y a l t e r s t h e c o n t e n t t y p e t h a t i s e x p o s e d t o I n f i n c o m i n g d a t a . I f n o t s p e c i e d , t h e n t h e d e f a u l t vt y p e i s a p p l i c a t i o n / o c t e t - s t r e a m .


@ p a r a m s t r i n g f i l e N a m e T h e f i l e n a m e @ p a r a m j a v a x . a c t i v a t i o n . D a t a S o u r c e f i l e T h e f i l e t

{ c o n t e n t T y p e : i m a g e / j p e g }

I n t h e p r e v i o u s e x a m p l e , y o u r t a s k r e c e i v e s a B L o f t h e a t t a c h m e n t i s s p e c i e d b y t h e a c c o m p a n y i f i l e N a m e p a r a m e t e r v a l u T h e C o n t e n t - T y p e o f t h a t a t t a c h m e n t i s e x p o s e d t o t h e I n i m a g e / j p e g . I t i s i m p o r t a n t t o n o t e t h a t t h i s d o e s n o t hv a l u e f o r t h e C o n t e n t - T y p e o f t h e i n c o m i n g a t t a c h m e n t . I t d o s e r v i c e c l i e n t t o c o m p l y w i t h t h a t C o n t e n t - T y p e w h e n s u p p l y i n g t h e d a

A s w i t h l e g a c y w e b s e r v i c e s , r e t u r n a n a t t a c h m e ni t s r e t u r n t y p e a s j a v a . i o . I n p u t S t r e a m . I n b o t h t h e u p l o a d a n d ds c e n a r i o , a J a v a w e b c l i e n t i s p r e s e n t e d w i t h a p a t y p e o f j a v a x . a c t i v a t i o n . D a t a H a n d l e r .

I n b o t h t h e u p l o a d a n d d o w n l o a d s c e n a r i o s , a n I nd a t a b e t w e e n y o u r t a s k a n d t h e w e b s e r v i c e c l i e n f r o m W i n d c h i l l . A n e f c i e n t u p l o a d , h o w e v e r , i st h e c l i e n t s u p p l i e s t h e d a t a . S m a l l a m o u n t s o f d a t b u t c l i e n t s s h o u l d c h u n k t h e M I M E d a t a w h e n s e a J a v a - b a s e d c l i e n t y o u m u s t e x p l i c i t l y i n s t r u c t t ht h e s e r v e r o r y o u r c l i e n t w i l l l i k e l y d i e w i t h a n O u t O f M e m o r y E r r o r . Y o u s h o u l d

a d d t h e H T T P _ C L I E N T _ S T R E A M I N G _ C H U Nc o n t e x t p r i o r t o u p l o a d i n g a n a t t a c h m e n t t o W i n dt o n o t e t h a t i f y o u d o n o t d o t h i s , i t i s l i k e l y t h a t y os t r e s s o n t h e m e m o r y r e s o u r c e s o f t h e s e r v e r o n w


i m p o r t j a v a . i o . F i l e ; i m p o r t j a v a x . a c t i v a t i o n . F i l e D a t a S o u r c e ; i m p o r t j a v a x . a c t i v a t i o n . D a t a H a n d l e r ;




i m p o r t j a v a x . x m l . w s . B i n d i n g P r o v i d e r ; i m p o r t c o m . s u n . x m l . w s . d e v e l o p e r . J A X W S P r o p e r t i e s ; . . .

( ( B i n d i n g P r o v i d e r ) p o r t ) . g e t R e q u e s t C o n t e x t ( ) . p u t ( J A XH T T P _ C L I E N T _ S T R E A M I N G _ C H U N K _ S I Z E , 8 1 9 2 ) ;

F i l e f = n e w F i l e ( p a t h ) ; D a t a H a n d l e r f i l e = n e w D a t a H a n d l e r ( n e w F i l e D a t a S o u r cp o r t . u p l o a d ( f . g e t N a m e ( ) , f i l e ) ;

I n a d d i t i o n , w h e n p e r f o r m i n g d o w n l o a d s i t i s i m p o r D a t a H a n d l e r t o s e e i f i t i s a n i n s t a n c e o f S t r e a m i n g D a t a H a n d l e r . W h e n d o w n l o a d i n g l a r g e a m o u n t s o f d a t a , t h e S u n cd a t a i n a t e m p o r a r y l e . I f y o u d o n o t e x p l i c i t l y c l o s S t r e a m i n g D a t a H a n d l e r , t h e n t h i s t e m p o r a r y l e r e m a i n s o n y o uo c c u p y i n g d i s k s p a c e .


i m p o r t j a v a x . a c t i v a t i o n . D a t a H a n d l e r ; i m p o r t c o m . s u n . x m l . w s . d e v e l o p e r . S t r e a m i n g D a t a H a n d l e . . . D a t a H a n d l e r f i l e = n u l l ; t r y {

f i l e = p o r t . d o w n l o a d ( . . . ) ; . . / / t r a n s f e r t h e d a t a t o a n o t h e r s t r e a m / f i l e , e t c . f i l e . w r i t e T o ( . . . ) ;

} f i n a l l y {

i f ( f i l e i n s t a n c e o f S t r e a m i n g D a t a H a n d l e r ) ( ( S t r e a m i n g D a t a H a n d l e r ) f i l e ) . c l o s e ( ) ; / / r e m o v e a n y

}

C o n s u m i n g E x t e r n a l S e r v i c eW i n d c h i l l I t i s p o s s i b l e t o w r i t e w e b s e r v i c e c l i e n t s t h a t c a n b e W i n d c h i l l . I f d o n e , y o u m u s t u s e t h e j a x w s . p a c k a g e p r o p e r t y o f y o u r c l i e n tb u i l d . x m l l e . T o f a c i l i t a t e i t s i n t e r a c t i o n s , e a c h c l i e n t m p a c k a g e n a m e f o r t h e g e n e r a t e d r e s o u r c e s . E a c h c l i e p a c k a g e d i n i t s o w n J A R l e , b e c a u s e t h e r e a r e s e v e r w i t h i n t h e M E T A - I N F d i r e c t o r y o f a c l i e n t ’ s J A R t h a t o v e r l a p ww e b s e r v i c e c l i e n t s .




I f t h e c l i e n t i s a t h i r d - p a r t y s e r v i c e , y o u c a n u s e t h w s d l . u r l p r o p e r t y t o s p e ct h e l o c a t i o n o f t h e r e m o t e s e r v i c e ’ s W S D L . I f t h ei n t e r a c t i o n s , t h e n y o u m u s t s e t t h e a n o n y m o u s . s e r v i c e p r o p e r t y .

W e b S e r v i c e E x a m p l e s T h e r e a r e s e v e r a l w e b s e r v i c e e x a m p l e s r e l e a s e d b a s i c s o n h o w t o w r i t e a w e b s e r v i c e a n d c l i e n t s . < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s .

F o r e a c h , r e v i e w t h e s e r v i c e s o u r c e c o n t a i n e d i n s r c d i r e c t o r y a n d t h e c s o u r c e c o n t a i n e d i n t h e s r c _ c l i e n t d i r e c t o r y .

E a c h e x a m p l e w a s d e v e l o p e d u s i n g t h e n e w - p r o j e c t . x m l s c r i p t , a n d a r e t h e r e f o r e o r g a n i z e d i n a m a n n e r c o n s i s t e n t w i t h e a c h e x a m p l e , e n t e r t h e f o l l o w i n g c o m m a n d s : % c d < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / < E x a m p l e D i r > / s r c % a n t

T h i s c o m p i l e s , p a c k a g e s , a n d d e p l o y s t h e w e b s es t a r t W i n d c h i l l , o r r e s t a r t i t i f i t i s a l r e a d y r u n n i n c o m m a n d s :

% c d < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / < E x a m p l e D i r > / s r c _ c l i e n t % a n t

T h i s g e n e r a t e s , c o m p i l e s , a n d b u i l d s t h e d i s t r i b ue x a m p l e c l i e n t s t a k e o p t i o n a l p a r a m e t e r s . R e a d s r c _ c l i e n t d i r e c t o r y t o s e e w h a t p a r a m e t e r s , i f a n y , T o r u n t h e c l i e n t f r o m t h e s r c _ c l i e n t d i r e c t o r y , e n t e r t h e f o l l o w i

% j a v a - j a r . . / d i s t _ c l i e n t / < C l i e n t J a r F i l e >

R u n n i n g a n t c l o b b e r f r o m b o t h t h e s r c a n d s r c _ c l i e n t d i r e c t o r i e s r e m o v e s a l l g e n e r a t e d a n d c o m p i l e d l e s , w h i c h b a c k t o i t s o r i g i n a l s t a t e .

A f t e r y o u a r e d o n e r e v i e w i n g a p a r t i c u l a r e x a m p t h e s e r v i c e u s i n g t h e f o l l o w i n g :

% c d < W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / < E x a m p l e D i r > / s r c

% a n t u n d e p l o y

U s e r n a m e A u t h e n t i c a t i o n K e y s E x a m p l e T h i s e x a m p l e i l l u s t r a t e s h o w t o a u t h o r a C # W e b i t s r e q u e s t s a n d e m b e d s c r e d e n t i a l s u s e d f o r a u t h




T h i s e x a m p l e c l i e n t w a s a u t h o r e d o n a W i n d o w s 2 0 0V i s u a l S t u d i o 2 0 0 8 .

1 . G e n e r a t e t h e C l i e n t / S e r v e r a n d T r u s t s t o r e / K eI n o r d e r f o r a s e r v e r a n d a c l i e n t t o c o m m u n i c a t e u s i nr e q u e s t s , t h e c l i e n t a n d s e r v e r a r e r e q u i r e d t o t r u s t o n e a n o t h e r e r t i c a t e i n f o r m a t i o n . A n e x a m p l e u t i l i t y i s p r o v i d e d w i t h W t o g e n e r a t e c e r t i c a t e s , J a v a k e y s t o r e s , a n d t r u s t s t o r w i n d c h i l l s h e l l t o i n v o k e t h e f o l l o w i n g :

% c d < w i n d c h i l l > / p r o g _ e x a m p l e s / j w s % a n t - f j w s - s t o r e s . x m l

D u r i n g i n v o c a t i o n o f t h i s s c r i p t y o u a r e p r o m p t e d t o a l i a s e s , s u b j e c t s , a n d p a s s w o r d s . T h e d e f a u l t v a l u e s

a l t e r a n y o f t h e s e v a l u e s w h i l e r u n n i n g t h i s s c r i p t y o ut h o s e d i f f e r e n c e s l a t e r .

O f p a r t i c u l a r i m p o r t a n c e i s t h e k e y s t o r e a l i a s f o r t h e p r e s e n t e d b y t h e s c r i p t a b o v e i s t h e v a l u e o f w t . r m i . s e r v e r . h o s t n a m e f r o m y o u r w t . p r o p e r t i e s l e . I f t h i s i s n o t t h e h o s t n a m e w h e r e y o r u n n i n g , t h e n y o u c a n c h a n g e t h i s v a l u e . F r o m a J a v a b e a n y b a s i c s t r i n g i d e n t i e r , b u t . N E T p r e f e r s t h a t t h n a m e s t h a t c a n b e r e s o l v e d t h r o u g h D N S . I f y o u d e c in o t r e e c t y o u r s e r v e r ’ s h o s t n a m e t h e n y o u m u s t u s e o n t h e c l i e n t s i d e .

I f y o u d o n o t a c c e p t t h e d e f a u l t v a l u e s w h e n r u n n i n g r e v i e w t h e c o n t e n t s o f t h e s e c u r i t y . p r o p e r t i e s l e t o m a k e s u r e i t m a t c ht h e i n f o r m a t i o n p r o v i d e d w h e n r u n n i n g t h e s c r i p t . T < W i n d c h i l l > / b i n / a d m i n T o o l s / W e b S e r v i c e s / s e c u

W h e n t h i s s c r i p t h a s c o m p l e t e d r u n n i n g , a d i r e c t o r y< W i n d c h i l l > / p r o g _ e x a m p l e s / j w s / s t o r e s i s c r e a t e d , w h i c h c o n t a i n s a l e n a m e d s e r v e r . p 1 2 ( a p e r s o n a l i n f o r m a t i o n e x c h a n g t h e s e r v e r ’ s p u b l i c k e y , w h i c h i s u s e d l a t e r i n t h i s p r o

T h e j w s - s t o r e s . x m l a n t s c r i p t g e n e r a t e s b o t h s e r v e r a n d c l i ee x a m p l e , h o w e v e r , o n l y r e q u i r e s t h e s e r v e r ’ s p u b l i c

2 . D e p l o y t h e W e b S e r v i c e O n c e y o u h a v e r u n t h e j w s - s t o r e s . x m l s c r i p t y o u c a n c r e a t e a n d d e p y o u r w e b s e r v i c e . H e r e t h e s i m p l e J a v a w e b s e r v i c e W i n d c h i l l i s u s e d , a n d w h i c h p e r f o r m s b a s i c a d d i t i o n b e s e c u r e d u s i n g u s e r a u t h e n t i c a t i o n w i t h s y m m e t r i cs e e U n d e r s t a n d i n g t h e S e c u r i t y R e q u i r e m e n t s o n p a g e .






E n t e r a n a m e f o r y o u r a p p l i c a t i o n ( “ W c C l i e n t ” i s u

3 . O n c e y o u r p r o j e c t i s c r e a t e d , t h e b a s e . c s l e o p e n s i n t h e m a i n e d i t o r w i n d o w . I n t h e S o l u t i o n E x p l o r e r p a n e , r i g h t - c l i c k t h e R e f e r e n c e s f o l d e r a n d s e l e c t A d d S e r v i c e R e f e r e n c e :

4 . I n t h e A d d S e r v i c e R e f e r e n c e w i n d o w , e n t e r t h e U R L o f t h e s e r v i t h e A d d r e s s e l d , a n d c l i c k G o t o f e t c h t h e W S D L d o c u m e n t .




5 . E n t e r a N a m e s p a c e ( “ E x a m p l e S e r v i c e ” i s u s e d i n t h i s e x O K :

6 . I n t h e S o l u t i o n E x p l o r e r p a n e , r i g h t - c l i c k a g a i n o n t h e R e f e r e n c e s f o l d e r , a n d t h i s t i m e s e l e c t A d d R e f e r e n c e .

7 . I n t h e w i n d o w t h a t o p e n s , s c r o l l d o w n a n d a d S y s t e m . N e t r e f e r e n c e . R e p e a t t h i s p r o c e s s t o a d d t h e S y s t e m . S e c u r i t y r e f e r e n c e .

8 . N o w y o u m u s t w r i t e t h e c l i e n t s o u r c e c o d e t o

e x a m p l e : u s i n g S y s t e m ; u s i n g S y s t e m . C o l l e c t i o n s . G e n e r i c ; u s i n g S y s t e m . L i n q ; u s i n g S y s t e m . T e x t ; u s i n g S y s t e m . S e c u r i t y . C r y p t o g r a p h y . X 5 0 9 C e r t i f i

n a m e s p a c e W c C l i e n t {

c l a s s P r o g r a m {

s t a t i c v o i d M a i n ( s t r i n g [ ] a r g s ) {

E x a m p l e S e r v i c e . J a v a S e r v i c e C l i e n t c l i e n t J a v a S e r v i c e C l i e n t ( ) ;

c l i e n t . C l i e n t C r e d e n t i a l s . U s e r N a m e . U s e r N c l i e n t . C l i e n t C r e d e n t i a l s . U s e r N a m e . P a s s w c l i e n t . C l i e n t C r e d e n t i a l s . S e r v i c e C e r t i f i c a

S t o r e L o c a t i o n . C u r r e n t U s e r , S t o r e N a m e . T r u s t e d P e o p l e ,




X 5 0 9 F i n d T y p e . F i n d B y S u b j e c t N a m e , " h o s t . c o m p a n y . c o m " ) ;

C o n s o l e . W r i t e L i n e ( " 1 + 2 = " + c l i e n t . a d d ( 1 , 2 ) )

} }

}

9 . U p d a t e t h e s u b j e c t n a m e w h e n f e t c h i n g t h e X 5 0 9 h o s t n a m e ( i n t h e e x a m p l e a b o v e i t ’ s w r i t t e n a s “ h o s t . c o m p a n y . c o m ” ) .

1 0 . S e l e c t B u i l d ▶ ▶ ▶ B u i l d S o l u t i o n o r p r e s s F 6 t o b u i l d y o u r c l i e n t . 1 1 . T e s t y o u r c l i e n t b y p r e s s i n g C t r l + F 5 o r b y s e l e c t i B u i l d ▶ ▶ ▶ D e b u g ▶ ▶ ▶ S t a r t

W i t h o u t D e b u g g i n g .

5 . U s e a C e r t i c a t e A l i a s t h a t D o e s N o t R e e c t t hS e r v e r

A s m e n t i o n e d p r e v i o u s l y , . N E T p r e f e r s t h a t t h e c e r t h o s t n a m e w h e r e y o u r s e r v i c e r e s i d e s . I f f o r s o m e r e m a t c h y o u r s e r v e r ’ s h o s t n a m e a n d y o u a t t e m p t t o r u nD N S - r e l a t e d e r r o r . Y o u c a n w o r k a r o u n d t h i s p r o b l ea p p . c o n f i g l e b y a d d i n g a D N S a l i a s t o y o u r s e r v i c e r e f i f y o u r c e r t i c a t e a l i a s i s “ w s - s e r v e r ” y o u m i g h t u p d a a p p . c o n f i g t o m a k e “ w s - s e r v e r ” a n a l i a s f o r y o u r w e b s e r v i c e e n d p o i n t :

< e n d p o i n t a d d r e s s = " h t t p : / / h o s t . c o m p a n y . c o m / W i n d c h i l lb i n d i n g = " c u s t o m B i n d i n g " b i n d i n g C o n f i g u r a t i oc o n t r a c t = " E x a m p l e S e r v i c e . J a v a S e r v i c e " n a m e =

 < d n s v a l u e = " w s - s e r v e r " / >

 < / e n d p o i n t >




1 0 S O A P S e r v

L e g a c y S e r v i c e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .I n f o * E n g i n e T a s k I n v o c a t i o n w i t h S O A P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I n f o * E n g i n e J a v a E E C o n n e c t o r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E x a m p l e S t a n d a l o n e J a v a S O A P C l i e n t . . . . . . . . . . . . . . . . . . . . . .

S O A P ( S i m p l e O b j e c t A c c e s s P r o t o c o l ) i s a l i g h f o r e x c h a n g i n g i n f o r m a t i o n a n d m a k i n g r e m o t e

d e c e n t r a l i z e d e n v i r o n m e n t . F o r g e n e r a l i n f o r m a t i o n a b o u t S O A P , u s e t h e f o l l o w i n g h t t p : / / w w w . w 3 . o r g / T R / S O A P T h e f o l l o w i n g t o p i c s d i s c u s s l e g a c y S O A P s e r v iw r i t i n g t a s k s w i t h S O A P , a n d e x p l a i n h o w S O A I n f o * E n g i n e J a v a P l a t f o r m , E n t e r p r i s e E d i t i o n ( e x a m p l e o n h o w t o a w r i t e a J a v a S O A P c l i e n t i s

1 8 3

http://www.w3.org/TR/SOAP

http://www.w3.org/TR/SOAP



L e g a c y S e r v i c e s W h e n r u n n i n g W i n d c h i l l , i t i s r e c o m m e n d e d t h a t y o u

s e r v l e t r a t h e r t h a n t h e R P C s e r v l e t . T h e t w o s e r v l e t s b u t i n t h e c a s e o f a W i n d c h i l l i n s t a l l a t i o n , t h e S i m p l ed i r e c t l y t o t h e S i m p l e T a s k D i s p a t c h e r s e r v i c e r u n n i nr e s u l t , t h i s s e r v l e t p e r f o r m s b e t t e r t h a n t h e s t a n d a l o n e I n f o * E n g i n e R P C

I n t h e f o l l o w i n g t o p i c s , w h e r e v e r t h e r e i s a r e f e r e n c e d d r e s s , y o u c a n s i m p l y r e p l a c e “ R P C ” w i t h “ S i m p l e T a s k D i

F o r e x a m p l e : h t t p : / / < h o s t > / W i n d c h i l l / s e r v l e t / R P C c a n b e r e p l a c e d w i t h

h t t p : / / < h o s t > / W i n d c h i l l / s e r v l e t / S i m p l e T a s k D i s p a t c h e r

N o t e I f y o u r s i t e i s u s i n g f o r m - b a s e d a u t h e n t i c a t i o n , p r o g ra t t e m p t i n g t o a c c e s s t h e R P C o r S i m p l e T a s k D i s p a t c h/ p r o t o c o l A u t h U R L p r e x . F o r e x a m p l e :


o r


F o r m o r e i n f o r m a t i o n a b o u t f o r m - b a s e d a u t h e n t i c a t i A d v a n c e d D e p l o y m e n t G u i d e .

S O A P R P C S e r v l e t I n f o * E n g i n e p r o v i d e s a S O A P R e m o t e P r o c e d u r e C S O A P r e q u e s t s f r o m a S O A P c l i e n t a n d s e n d s r e s p o ns e r v l e t g a t h e r s t h e i n f o r m a t i o n s e n t f r o m t h e c l i e n t ( e x e c u t e a n d o t h e r r e q u e s t i n f o r m a t i o n ) a n d p r o c e s s et a s k s t h a t p e o p l e a t y o u r s i t e h a v e c r e a t e d e x p l i c i t l y c l i e n t . T h e s e t a s k s a r e u s e d t o e x e c u t e t a s k w e b j e c t s S O A P c l i e n t s t o i n v o k e t h e s e s p e c i a l l y - w r i t t e n I n f o *m o r e i n f o r m a t i o n a b o u t t h e r e q u i r e d S O A P t a s k f o r m I n f o * E n g i n e T a s k I n v o c a t i o n w i t h S O A P o n p a g e 1 8 8 .

T h e I n f o * E n g i n e S O A P R P C s e r v l e t c a n b e u s e d t o pc l i e n t t h a t h a s b e e n d e v e l o p e d u s i n g t h e I n f o * E n g i n o t h e r t h i r d - p a r t y S O A P c l i e n t . F o r m o r e i n f o r m a t i o n I n f o * E n g i n e J a v a E E C o n n e c t o r o n p a g e 2 0 1 .

T h e S O A P R P C s e r v l e t a u t o m a t i c a l l y g e n e r a t e s W e b( W S D L ) f o r a g i v e n S O A P s e r v i c e w h e n i t r e c e i v e s ae x a m p l e , w h e n u s i n g a s t a n d a r d w e b b r o w s e r t o a c c e




i s s u i n g a G E T r e q u e s t t o t h e R P C s e r v l e t , y o u m ua r g u m e n t , a n d c a n o p t i o n a l l y s u p p l y t h e V E R S I OT h e C L A S S q u e r y a r g u m e n t s p e c i e s t h e C L A S w h i c h y o u w o u l d l i k e W S D L g e n e r a t e d . T h e V Ea r e u s e d t o d e c i d e w h a t t y p e o f W S D L y o u w o u l m o r e i n f o r m a t i o n a b o u t t h e S T Y L E a n d V E R S I Od e s c r i p t i o n i n G e n e r a t e - W S D L o n p a g e 4 2 5 .

F o r e x a m p l e , i f y o u g e n e r a t e t h e d e f a u l t W S D L ft h a t y o u a u t h o r e d u n d e r t h e f o l l o w i n g t y p e i d e n t

c o m . m y C o m p a n y . m y S e r v i c e

Y o u m i g h t r e q u e s t t h e W S D L a s f o l l o w s :

h t t p : / / < h o s t > / W i n d c h i l l / s e r v l e t / R P C ? C L A S S = c o m . m y C o m p

I f y o u a r e a t t e m p t i n g t o i n t e g r a t e y o u r S O A P s e rO r i e n t e d A r c h i t e c t u r e ( S O A ) p l a t f o r m f o r t h e t a S O A P m e t h o d s f r o m w i t h i n a B u s i n e s s P r o c e s s Eo r c h e s t r a t i o n , y o u w o u l d w a n t I n f o * E n g i n e t o b e h a v e i n a W S - I c o m p l i a n t t o e a s e i n t e g r a t i o n . I n s u c h a s i t u a t i o n y o u w o u l df o l l o w s :

h t t p : / / < h o s t > / W i n d c h i l l / s e r v l e t / R P C ? C L A S S = c o m . m y C o m p& V E R S I O N = 1 . 1 & S T Y L E = d o c u m e n t

T h e I n f o * E n g i n e J a v a P l a t f o r m , E n t e r p r i s e E d i tu s e s W S D L t o g e n e r a t e c l i e n t - s i d e s o u r c e c o d e tI n f o * E n g i n e .

T h e M i c r o s o f t S O A P T o o l k i t u s e s W S D L t o d e r e m o t e c l a s s e s a n d m e t h o d s t h a t c l i e n t s c a n c a l l , b y e a c h m e t h o d , a n d t h e k i n d s o f r e s u l t s t h a t a r e ra n d t o d o w n l o a d t h e M i c r o s o f t S O A P T o o l k i t , u sh t t p : / / w w w . m i c r o s o f t . c o m / d o w n l o a d s

O t h e r t h i r d - p a r t y c l i e n t s c a n a l s o u s e W S D L t o gi n t e r a c t i o n s w i t h I n f o * E n g i n e .

S O A P S e r v i c e s 1

http://www.microsoft.com/downloads

http://www.microsoft.com/downloads



T h e f o l l o w i n g d i a g r a m i l l u s t r a t e s h o w a S O A P c l i e n

W h e n a S O A P r e q u e s t i s m a d e , t h e w e b s e r v e r p r o c e d i r e c t s i t t o t h e S O A P R P C s e r v l e t . T h e S O A P R P C s

r e p o s i t o r y i n y o u r W i n d c h i l l D i r e c t o r y S e r v e r t o i d e e x e c u t e d . I n t h e L D A P d i r e c t o r y , y o u h a v e c r e a t e d t t a s k s t h a t a r e t o b e e x e c u t e d f o r t h e m e t h o d s t h e S O AS O A P R P C s e r v l e t p a s s e s t h e n a m e o f t h e t a s k a n d t ho n t o a n I n f o * E n g i n e s e r v e r , w h i c h e x e c u t e s t h e t a s k

A f t e r t h e I n f o * E n g i n e s e r v e r e x e c u t e s t h e t a s k , a n a pt o t h e S O A P c l i e n t . T h e r e s p o n s e s e n t t o t h e S O A P c r e t u r n e d b y t h e I n f o * E n g i n e t a s k . A t a s k a u t h o r e d f oc l i e n t c a n r e t u r n t h e f o l l o w i n g :

• A p r i m i t i v e v a l u e , f o r e x a m p l e i n t , o a t , d a t e , a n d s o o n . • A J a v a b e a n . • A n a r r a y o f p r i m i t i v e v a l u e s . • A n a r r a y o f J a v a b e a n s . • A n I n f o * E n g i n e c o l l e c t i o n , g r o u p , e l e m e n t , a t t r i b

I f a n I n f o * E n g i n e g r o u p i s r e t u r n e d a n d t h e S O A P t a i t s r e t u r n t y p e , t h e g r o u p i s r e t u r n e d t o t h e S O A P c l i ec o n t a i n s t h e I n f o * E n g i n e X M L r e p r e s e n t a t i o n o f t h ai n p u t $ ( @ F O R M [ ] g r o u p _ o u t [ 0 ] ) .






R e p o s i t o r y t y p e s r e p r e s e n t t y p e s o f i n f o r m a t i o n s y s tt y p e s t h e y c a n a c t u p o n . R e p o s i t o r y t y p e s c o n t a i n t y i s s t o r e d i n t h e W i n d c h i l l D i r e c t o r y S e r v e r t h a t i s u s ei n f o r m a t i o n o n r e p o s i t o r i e s , r e p o s i t o r y t y p e s , t y p e i ds e e t h e o n l i n e h e l p a v a i l a b l e t h r o u g h t h e T a s k D e l e g

I n f o * E n g i n e T a s k I n v o c a t i o nF o r a n I n f o * E n g i n e t a s k t o b e i n v o k e d t h r o u g h a S O Ar e q u i r e m e n t s m u s t b e m e t :

• T h e t a s k s h o u l d b e l o c a t e d i n a d i r e c t o r y p a t h u n d et h a t c o r r e s p o n d s w i t h t h e l o g i c a l C L A S S a r g u m e nm e t h o d s ) s u p p o r t e d b y t h e c l a s s l o g i c a l l y a n d h i e r

t a s k c a n b e l o c a t e d a n y w h e r e w i t h i n t h e t a s k r o o t , at a s k d e l e g a t e e n t r y p r o p e r l y r e f e r e n c e s t h e t a s k . T aw i t h i n t h e t a s k h i e r a r c h y .

• T h e t a s k m u s t b e r e g i s t e r e d a s a t a s k d e l e g a t e w i t h n a m e r e e c t s t h e C L A S S u s e d w i t h i n t h e S O A P r e c a n b e m a n u a l l y c r e a t e d , e i t h e r u s i n g t h e D e l e g a t e u s i n g s u p p l i e d t o o l s .

• T h e t a s k m u s t i n c l u d e s p e c i a l S O A P c o m m e n t s l i nc o m m e n t i f t h e t a s k r e q u i r e s i n p u t p a r a m e t e r s o r r ea n I n f o * E n g i n e g r o u p . F o r m o r e i n f o r m a t i o n , s e e I n s e r t i n g S O A P C o m m eo n p a g e 1 9 0 .

N o t e D e s p i t e t h e f a c t t h a t l e a v i n g t h e @ r e t u r n c o m m e n t c o m m e n t p r o d u c e t h e s a m e r e s u l t s i n t h e c l i e n t , P T i n c l u d e a c o m m e n t s u c h a s t h e f o l l o w i n g :

@ r e t u r n I N F O E N G I N E _ G R O U P $ ( o u t p u t )

N o t s p e c i f y i n g a n @ r e t u r n c o m m e n t m e a n s t h e d a t at u n n e l e d i n t h e r e s p o n s e a s a s t r i n g , r e q u i r i n g t h e c S O A P a n d p r o c e s s t h e i n t e r n a l X M L . W h e n r e t u r n i s p e c i f y i n g t h e @ r e t u r n l i n e i s s u g g e s t e d s i n c e d o i n u s e f u l i n t e r f a c e a n d p e r f o r m s b e t t e r .

S u p p o r t e d D a t a T y p e s T h e I n f o * E n g i n e S O A P R P C s e r v l e t s u p p o r t s t h e f o i n c l u d e p r i m i t i v e t y p e s , J a v a c l a s s e s , a n d s p e c i a l I n f

• b o o l e a n , j a v a . l a n g . B o o l e a n • d o u b l e , j a v a . l a n g . D o u b l e




• l o n g , j a v a . l a n g . L o n g • o a t , j a v a . l a n g . F l o a t

• i n t , j a v a . l a n g . I n t e g e r • s h o r t , j a v a . l a n g . S h o r t • b y t e , j a v a . l a n g . B y t e • s t r i n g , j a v a . l a n g . S t r i n g • d a t e T i m e , j a v a . u t i l . D a t e • j a v a . m a t h . B i g D e c i m a l

T h e f o l l o w i n g I n f o * E n g i n e - s p e c i c d a t a t y p e s a t r a n s f e r r i n g I n f o * E n g i n e d a t a s t r u c t u r e s a s e m b e

• I N F O E N G I N E _ C O L L E C T I O N

• I N F O E N G I N E _ G R O U P • I N F O E N G I N E _ E L E M E N T • I N F O E N G I N E _ A T T R I B U T E

P a r a m e t e r s o f e a c h o f t h e s e t y p e s a r e p r o v i d e d t oe q u i v a l e n t J a v a c l a s s . S i n g l e v a l u e s o f e a c h o f t h p a r a m e t e r s o r a s a n o u t p u t v a l u e .

N o t e I n o r d e r f o r t h e S O A P s e r v i c e t o s u p p l y s t r o n g l y - t c l i e n t m u s t s u p p l y a s t r o n g l y - t y p e d S O A P r e q u e s a s M i c r o s o f t ’ s S O A P T o o l k i t , d o n o t d o t h i s a n d a a r e s u p p l i e d t o t h e t a s k a s s t r i n g s .

I n a d d i t i o n t o b a s i c d a t a t y p e s a n d a r r a y s o f b a s i ca l s o s u p p o r t s c o m p l e x t y p e s i n t h e f o r m o f J a v a ba r r a y s . I n d e x e d p r o p e r t i e s a n d n e s t e d b e a n s a r e a b e a n s r e q u i r e s g e n e r a t i o n o f c o m p l e x I n f o * E n g im u s t b e c r e a t e d m a n u a l l y a s I n f o * E n g i n e w e b j e c o m p l e x n e s t e d g r o u p s .

T h e c l a s s o f a J a v a b e a n m u s t b e f o u n d i n t h e I n f oR P C s e r v l e t C L A S S P A T H s o t h a t t h e b e a n c a n b m a n i p u l a t e d a t r u n t i m e . S i m i l a r l y , i f t h e c l i e n t s i

u s e s I n f o * E n g i n e c l a s s e s , s u c h a s t h e I n f o * E n g i b e a n c l a s s m u s t a l s o b e a v a i l a b l e i n t h e c l i e n t C L o n t h e I n f o * E n g i n e J a v a E E c o n n e c t o r , s e e I n f o * E n g i n e J a v a E E C o n p a g e 2 0 1 .




S O A P C o m m e n t s A n I n f o * E n g i n e S O A P t a s k m u s t c o n t a i n a c o m m e n

i n p u t p a r a m e t e r s a n d r e s p o n s e t y p e . T h i s S O A P c o mI n f o * E n g i n e t o g e n e r a t e a W S D L t h a t d e s c r i b e s t h e t a s k e x p o s e s t o e x t e r n a l S O A P c l i e n t s . T h e g e n e r a t e b y t h i r d - p a r t y s o f t w a r e t o v e r i f y i n p u t p a r a m e t e r s a nt o g e n e r a t e c l i e n t - s i d e s o u r c e c o d e u s e d t o i n t e r a c t ws e r v i c e . C e r t a i n t o o l s s u p p l i e d w i t h I n f o * E n g i n e m ag e n e r a t e c l i e n t s i d e d a t a a c c e s s o b j e c t s ( D A O s ) t h a t I n f o * E n g i n e t a s k s a n d a b s t r a c t a l l o f t h e d e t a i l s i n v o c o m m u n i c a t i o n p r o t o c o l . F o r m o r e i n f o r m a t i o n , s e e G e n e r a t i n g D A O s o n p a g2 1 0 .

T h e S O A P c o m m e n t s e c t i o n c a n a l s o b e u s e d t o g e n d o c u m e n t a t i o n f o r t a s k s . F o r i n s t r u c t i o n s o n g e n e r a a n d a l i n k t o t h e g e n e r a t i n g t o o l , s e e t h e d o c u m e n t a vf o l l o w i n g U R L : h t t p : / / < h o s t > / < s e r v l e t > / i n f o e n g i n e / j s p / t o o l s / d o c / h

w h e r e < s e r v l e t > i s t h e a p p l i c a t i o n U R L d e n e d f o r t h e S O A P

N o t e T h i s c o m m e n t s e c t i o n s h o u l d b e i n c l u d e d i n a l l S O A i n c l u d e s n o i n p u t p a r a m e t e r s a n d r e t u r n s t h e d e f a u l t r e s p o n s e .

T h e c o m m e n t s e c t i o n i s a s f o l l o w s :

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f d e s c r i p t i o n s p e c i a l _ c o m m e n t s - - >

w h e r e d e s c r i p t i o n i s a n o p t i o n a l t a s k d e s c r i p t i o n , a n d s p e c i a l _ c o m m e n t s a r e t h e s p e c i a l S O A P c o m m e n t l i n e s .

S p e c i a l S O A P c o m m e n t l i n e s c a n b e i n c l u d e d i n t h e i n p u t p a r a m e t e r s a n d o u t p u t v a l u e s . T h e s e s p e c i a l c ot h e n e x t t w o s e c t i o n s .

@ p a r a m T h e @ p a r a m c o m m e n t l i n e i s u s e d t o s p e c i f y i n p u t p l i n e i s s p e c i e d i n t h e f o l l o w i n g f o r m a t :

@ p a r a m t y p e [ ] n a m e c o m m e n t






w h e r e :

• t y p e i s t h e d a t a t y p e o f t h e r e s p o n s e .

• [ ] i n d i c a t e s a n a r r a y o f v a l u e s . T h e r e i s n o w h i t e s p t y p e a n d [ ] . • s u b s t i t u t i o n i s a f o r m s i m i l a r t o t h e s t a n d a r d I n f o * E n g

s y n t a x :

$ ( g r o u p N a m e [ e l e m e n t I n d e x ] a t t r i b u t e N a m e [ a t t r i b u t e I n d e x ] )

w h e r e : ○ g r o u p N a m e i s t h e n a m e o f t h e o u t p u t g r o u p . ○ e l e m e n t I n d e x i s t h e p o s i t i o n o f t h e e l e m e n t . I f n o t s p e

e l e m e n t I n d e x v a l u e d e f a u l t s t o 0 , t h e r s t e l e m e n t . ○

a t t r i b u t e N a m e i s t h e n a m e o f t h e a t t r i b u t e .

○ a t t r i b u t e I n d e x i s t h e p o s i t i o n o f t h e a t t r i b u t e o n t h e e s p e c i e d , t h e a t t r i b u t e I n d e x v a l u e d e f a u l t s t o 0 , t h e r s t a t t r

T o p o p u l a t e a r e t u r n a r r a y , t h e a s t e r i s k c h a r a c t e r “ * ” m u s t b e p r e s e n t i n e i t h t h e e l e m e n t I n d e x o r a t t r i b u t e I n d e x p o r t i o n o f t h e s u b s t i t u t i o n s y n t a x , b u t n o t b o t h , a s t w o d i m e n s i o n a l a r r a y s a r e * ” i s s p e c i e d a s t h e a t t r i b u t e I n d e x , t h e n t h e a r r a y i s g e n e r a t e d f r om u l t i - v a l u e d a t t r i b u t e f r o m w i t h i n a s i n g l e e l e m e n * ” i s s p e c i e d a s t h e e l e m e n t I n d e x , t h e n t h e a r r a y i s g e n e r a t e d u s i nv a l u e o f e a c h a t t r i b u t e N a m e f r o m e a c h e l e m e n t o f t h e o u t p u t g

W h e n r e t u r n i n g a J a v a b e a n , t h e @ r e t u r n c o m m e n t l it h e f o l l o w i n g t w o e x c e p t i o n s : • T h e a t t r i b u t e N a m e [ a t t r i b u t e I n d e x ] p o r t i o n o f t h e s u b s t i t u t i o

s y n t a x i s n o t p r e s e n t . • T o r e t u r n a n a r r a y o f J a v a b e a n s , t h e “ * ” c h a r a c t e r m u s t b e i n t h e

e l e m e n t I n d e x l o c a t i o n o f t h e s u b s t i t u t i o n s y n t a x .

T h e J a v a b e a n ( o r a r r a y o f J a v a b e a n s ) a r e p o p u l a t e d i n r e f e r e n c e d e l e m e n t s o f t h e o u t p u t g r o u p . A t t r i b u t g r o u p c o r r e s p o n d d i r e c t l y t o t h e p r o p e r t i e s o f t h e J a vi n t h e r e s p o n s e g r o u p m i g h t n e e d t o b e m a n i p u l a t e d t h e C h a n g e - G r o u p w e b j e c t ) t o f o r c e t h e g r o u p a t t r i b

c o r r e s p o n d i n g p r o p e r t i e s o f t h e J a v a b e a n . W h e n r e t u r n i n g I n f o * E n g i n e d a t a u s i n g t h e I n f o * E nf o r m a t f o r t h e @ r e t u r n p a r a m e t e r i s a s f o l l o w s :

@ r e t u r n I N F O E N G I N E _ C O L L E C T I O N @ r e t u r n I N F O E N G I N E _ G R O U P $ ( g r o u p _ N a m e ) @ r e t u r n I N F O E N G I N E _ E L E M E N T $ ( g r o u p N a m e [ e l e m e n t I n d e x ] ) @ r e t u r n I N F O E N G I N E _ A T T R I B U T E $ ( g r o u p N a m e [ ] a t t r i b u t e N a m e )




w h e r e :

• g r o u p N a m e i s t h e n a m e o f t h e o u t p u t g r o u p .

• e l e m e n t I n d e x i s t h e p o s i t i o n o f t h e e l e m e n t . I f n o t se l e m e n t I n d e x v a l u e d e f a u l t s t o 0 , t h e r s t e l e m e n t . • a t t r i b u t e N a m e i s t h e n a m e o f t h e a t t r i b u t e .

S i m p l e D a t a T y p e E x a m p l e s

T h e f o l l o w i n g e x a m p l e s d o n o t r e p r e s e n t t h e t y p t a s k s s h o u l d b e w r i t t e n t o p e r f o r m . R a t h e r , t h e y ao f h o w i n p u t a n d o u t p u t p a r a m e t e r s f u n c t i o n .

N o t e B e c a u s e t h e s e t a s k s c o n t a i n s c r i p t l e t c o d e t h a t a s p a r a m e t e r s , t h e y t h e r e f o r e c a n n o t b e c a l l e d d i r e c t h e I n f o * E n g i n e s e r v l e t b e c a u s e t h e @ F O R M d a tT h e s e s p e c i a l S O A P t a s k s c a n b e s u c c e s s f u l l y c a l g e n e r a t e s t r o n g l y - t y p e d S O A P r e q u e s t s . I f t h e r e qC l a s s C a s t E x c e p t i o n o c c u r s .

T h e f o l l o w i n g e x a m p l e s p e c i e s t w o i n t e g e r s a s t h e i r s u m :


< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a p r e f i x = " i e " % >

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f

t h i s t a s k t a k e s t w o i n t e g e r s a n d a d d s t h e m t o g e t h e r

@ p a r a m i n t x @ p a r a m i n t y

@ r e t u r n i n t $ ( o u t p u t [ ] s u m [ ] ) - - > < %

I n t e g e r x = ( I n t e g e r ) g e t P a r a m ( " x " ) ; I n t e g e r y = ( I n t e g e r ) g e t P a r a m ( " y " ) ; S t r i n g e l e m e n t = " s u m = " + ( x . i n t V a l u e ( ) + y . i n t V a l u e

% >

 "




 

T h e f o l l o w i n g e x a m p l e r e t u r n s t h e s u m o f a n a r r a y o < % @ p a g e l a n g u a g e = " j a v a " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b /p r e f i x = " i e " % >

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f t h i s t a s k s u m s a n a r r a y o f f l o a t s

@ p a r a m f l o a t [ ] t o S u m

@ r e t u r n f l o a t $ ( o u t p u t [ 0 ] s u m [ 0 ] ) - - > < %

j a v a . u t i l . V e c t o r f l o a t s = g e t P a r a m s ( " t o S u m " ) ; F l o a t [ ] t o S u m = n e w F l o a t [ f l o a t s . s i z e ( ) ] ; f l o a t s . c o p y I n t o ( t o S u m ) ;

f l o a t s u m = 0 . 0 ; f o r ( i n t i = 0 ; t o S u m ! = n u l l & & i < t o S u m . l e n g t h ; i + + ) s u m + = t o S u m [ i ] . f l o a t V a l u e ( ) ;

S t r i n g e l e m e n t = " s u m = " + s u m ;

% >

 " / > 



T h e f o l l o w i n g e x a m p l e q u e r i e s a n e m p l o y e e d a t a b a a l l e m p l o y e e n u m b e r s :

< % @ p a g e l a n g u a g e = " j a v a " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b /p r e f i x = " i e " % >

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f t h i s t a s k q u e r i e s a n e m p l o y e e d a t a b a s e a n d r e t u r n s a n a re m p l o y e e n u m b e r s @ r e t u r n s t r i n g [ ] $ ( o u t p u t [ * ] e m p n o [ ] ) - - >





 

 

J a v a B e a n E x a m p l e s

N o t e T h e s e J a v a b e a n e x a m p l e s a r e u s i n g a J N D I a d a p L D A P d i r e c t o r y . T h e s e u s e r o b j e c t s s h o u l d n o t b t h a t a W i n d c h i l l c a n u s e .

T h e e x a m p l e s i n t h i s s e c t i o n u s e t h e f o l l o w i n g J a

p a c k a g e m y . o r g ;

/ / e x p o s e s p r o p e r t i e s : / / c n , s n , d n , u i d a n d i n d e x e d p r o p e r t y m a i l / / p r o p e r t i e s c o u l d b e a n y p r i m i t i v e t y p e s o r j a v a b / / b u t f o r t h e s a k e o f a n L D A P e x a m p l e t h i n g s a r e j u

i m p o r t j a v a . u t i l . V e c t o r ;

p u b l i c c l a s s P e r s o n { p r i v a t e S t r i n g c n ; p r i v a t e S t r i n g s n ; p r i v a t e S t r i n g d n ; p r i v a t e S t r i n g u i d ; p r i v a t e V e c t o r m a i l s = n e w V e c t o r ( 1 ) ;

p u b l i c v o i d s e t C n ( S t r i n g n ) { c n = n ; } p u b l i c S t r i n g g e t C n ( ) { r e t u r n c n ; }

p u b l i c v o i d s e t S n ( S t r i n g n ) { s n = n ; } p u b l i c S t r i n g g e t S n ( ) { r e t u r n s n ; }

p u b l i c v o i d s e t D n ( S t r i n g n ) { d n = n ; } p u b l i c S t r i n g g e t D n ( ) { r e t u r n d n ; }

p u b l i c v o i d s e t U i d ( S t r i n g n ) { u i d = n ; } p u b l i c S t r i n g g e t U i d ( ) { r e t u r n u i d ; }

p u b l i c v o i d s e t M a i l ( i n t i n d e x , S t r i n g m ) { i f ( i n d e x = = m a i l s . s i z e ( ) )

m a i l s . a d d E l e m e n t ( m ) ; e l s e

m a i l s . s e t E l e m e n t A t ( m , i n d e x ) ;




}

p u b l i c S t r i n g g e t M a i l ( i n t i n d e x ) {

r e t u r n ( S t r i n g ) m a i l s . e l e m e n t A t ( i n d e x ) ; }

p u b l i c v o i d s e t M a i l ( S t r i n g v a l s [ ] ) { m a i l s . c l e a r ( ) ; f o r ( i n t i = 0 ; v a l s ! = n u l l & & i < v a l s . l e n g t h ; i + + )

m a i l s . a d d E l e m e n t ( v a l s [ i ] ) ; }

p u b l i c S t r i n g [ ] g e t M a i l ( ) { i f ( m a i l s . i s E m p t y ( ) ) r e t u r n n u l l ;

S t r i n g a r r [ ] = n e w S t r i n g [ m a i l s . s i z e ( ) ] ; m a i l s . c o p y I n t o ( a r r ) ; r e t u r n a r r ;

} }

T h e f o l l o w i n g e x a m p l e l o o k s u p a u s e r e n t r y b y u s e r u i d ) :


< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f l o o k s u p a u s e r e n t r y b y u i d

@ p a r a m s t r i n g u i d

@ r e t u r n m y . o r g . P e r s o n $ ( o u t p u t [ 0 ] ) - - >

 < i e : p a r a m n a m e = " I N S T A N C E " d a t a = " c o m . m y C o m p a n y . m y 



 






T h e f o l l o w i n g e x a m p l e s e a r c h e s f o r a l i s t o f u s e r


< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f s e a r c h e s f o r a l i s t o f u s e r s b y a n L D A P s e a r c h f i l t e r@ p a r a m s t r i n g f i l t e r

@ r e t u r n m y . o r g . P e r s o n [ ] $ ( o u t p u t [ * ] ) - - >

 < i e : p a r a m n a m e = " I N S T A N C E " d a t a = " c o m . m y C o m p a n 



 



T h e f o l l o w i n g e x a m p l e c r e a t e s a u s e r i n a n L D A

r e t u r n e d i n I n f o * E n g i n e X M L f o r m a t , a s t h e r e i s< % @ p a g e l a n g u a g e = " j a v a " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f c r e a t e s a u s e r i n L D A P . r e t u r n s I * E X M L .

@ p a r a m s t r i n g d b u s e r @ p a r a m s t r i n g p a s s w d @ p a r a m m y . o r g . P e r s o n t o C r e a t e - - >

< % m y . o r g . P e r s o n t o C r e a t e = ( m y . o r g . P e r s o n ) g e t P a r a m S t r i n g d n = t o C r e a t e . g e t D n ( ) ; S t r i n g u i d = " u i d = " + t o C r e a t e . g e t U i d ( ) ; S t r i n g c n = " c n = " + t o C r e a t e . g e t C n ( ) ; S t r i n g s n = " s n = " + t o C r e a t e . g e t S n ( ) ;

S t r i n g [ ] m a i l s = t o C r e a t e . g e t M a i l ( ) ; S t r i n g B u f f e r s b = n e w S t r i n g B u f f e r ( ) ;




f o r ( i n t i = 0 ; m a i l s ! = n u l l & & i < m a i l s . l e n g t h ; i + + ) s b . a p p e n d ( " m a i l = " )

. a p p e n d ( m a i l s [ i ] )

. a p p e n d ( ( i < ( m a i l s . l e n g t h - 1 ) ) ? " ; " : " " ) ; % >

 < i e : p a r a m n a m e = " I N S T A N C E " d a t a = " c o m . m y C o m p a n y . m y< i e : p a r a m n a m e = " D B U S E R " d a t a = " $ ( @ F O R M [ ] d b u s e r [ ] ) " " / > " / > " / > " / > " d 



B L O B A t t a c h m e n t s o n S O A P R e q u A t t a c h m e n t s c a n b e u s e d w i t h S O A P r e q u e s t s t o u p l a m o u n t s o f b i n a r y d a t a .

N o t e O n l y r e l a t i v e l y s m a l l a m o u n t s o f b i n a r y d a t a s h o u l d b F o r i n f o r m a t i o n o n u p l o a d i n g a n d d o w n l o a d i n g l a r g U p l o a d i n g a n d D o w n l o a d i n g B L O B s o n p a g e 5 0 .

T w o s p e c i a l d a t a t y p e s a r e u s e d w h e n a t t a c h i n g d a t aj a v a x . a c t i v a t i o n . D a t a S o u r c e a n d j a v a . i o . I n p u t S t r e a m . T h e s e s p e c i a l d a t a t y p e s s u p p o r t a s p e c i a l l y f o r m a t t e d S O At h e b i n a r y c o n t e n t t y p e . S p e c i f y i n g t h e c o n t e n t t y p e g e n e r a t e d W S D L , i n c l u d i n g w h a t t y p e o f c o n t e n t d a A n y v a l i d c o n t e n t t y p e c a n b e s p e c i e d , f o r e x a m p l e

• i m a g e / . g i f

• i m a g e / . j p e g • a p p l i c a t i o n / o c t e t - s t r e a m

I f n o c o n t e n t t y p e i s s p e c i e d , t h e n t h e d e f a u l t a p p l i c a t i o n / o c t e t - s t r e i s u s e d .




j a v a x . a c t i v a t i o n . D a t a S o u r c e I n d i c a t e s t h a t t h e c l i e n t i s a t t a c h i n g b i n a r y d a t aa n @ p a r a m S O A P c o m m e n t .

U s e t h e f o l l o w i n g f o r m a t :

@ p a r a m j a v a x . a c t i v a t i o n . D a t a S o u r c e f i l e { c o n t e n c o n t e n t _ t y p e }

w h e r e c o n t e n t _ t y p e i s t h e c o n t e n t t y p e o f t h e b i n a r y d a

j a v a . i o . I n p u t S t r e a m I n d i c a t e s t h a t t h e t a s k r e s p o n d s w i t h b i n a r y d a S O A P c o m m e n t .

U s e t h e f o l l o w i n g f o r m a t :

@ r e t u r n j a v a . i o . I n p u t S t r e a m { c o n t e n t T y p e : c o n t e n t _ t y p e }

w h e r e c o n t e n t _ t y p e i s t h e c o n t e n t t y p e o f t h e b i n a r y d r e s p o n s e i s a n a t t a c h m e n t , n o s u b s t i t u t i o n s y n t

I n f o * E n g i n e d o e s n o t s u p p o r t r e t u r n i n g b o t h a n a p r o d u c e s a B L O B f o r S O A P , t h e S O A P r e s p o n s ee l e m e n t .

E x a m p l e B L O B U p l o a d

T h e f o l l o w i n g t a s k a d d s a B L O B t o a d a t a b a s e r o


< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a gp r e f i x = " i e " % >

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f u p l o a d a b l o b

@ p a r a m s t r i n g f i l e n a m e - t h e f i l e n a m e t o s t o r e @ p a r a m j a v a x . a c t i v a t i o n . D a t a S o u r c e f i l e - t h e f i l e ( s h o u l d b e g i f o r j p e g ) - - >

 

< i e : p a r a m n a m e = " I N S T A N C E " d a t a = " s o a p J D B C A d a 








 

 < i e : p a r a m n a m e = " I N S T A N C E " d a t a = " s o a p J D B C A d a p t e r " / 

 < i e : p a r a m n a m e = " W H E R E " d a t a = " ( N A M E = ' $ ( @ F O R M [ ] f i l 

E x a m p l e B L O B D o w n l o a d

T h e f o l l o w i n g t a s k r e t r i e v e s a B L O B f r o m a d a t a b a s

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b /

p r e f i x = " i e " % >

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f d o w n l o a d a b l o b

@ p a r a m s t r i n g f i l e n a m e - t h e f i l e n a m e o f t h e b l o b / i m a g d o w n l o a d ( v a l u e f r o m L i s t B l o b s c a l l ) @ r e t u r n j a v a . i o . I n p u t S t r e a m a s t r e a m t h a t c o n t a i n s t h e - - >

 < i e : p a r a m n a m e = " M I M E T Y P E " d a t a = " ' a p p l i c a t i o n / o c t e t 




I n f o * E n g i n e J a v a E E C o n nT h e I n f o * E n g i n e J a v a P l a t f o r m , E n t e r p r i s e E d i t

I n f o * E n g i n e ’ s i m p l e m e n t a t i o n o f J a v a E E C o n n 1 . 0 . J C A w a s d e s i g n e d t o s u p p l y s t a n d a r d i m p l e mJ a v a E E a p p l i c a t i o n s e r v e r s a n d e n t e r p r i s e i n f o r mI n f o * E n g i n e .

T h e c o n n e c t o r i s a l o w l e v e l s o f t w a r e d r i v e r t h a t f r o m a J a v a E E a p p l i c a t i o n s e r v e r e n v i r o n m e n t (a s t a n d a l o n e J a v a c l i e n t ( c o m m a n d - l i n e o r s w i n gJ a v a E E c o n n e c t o r u s e s S O A P a s i t s c o m m u n i c a s i m i l a r t o a J D B C d r i v e r , i n t h a t t h e c o n n e c t o r u no f c o n n e c t i n g t o a n d i n t e r a c t i n g w i t h I n f o * E n g i nc o n n e c t s t o a n d i n t e r a c t s w i t h a r e l a t i o n a l d a t a b a

F o r m o r e i n f o r m a t i o n o n c o n g u r i n g y o u r a p p l i cu s e w i t h t h e I n f o * E n g i n e J a v a E E c o n n e c t o r , s e ef o r y o u r e n v i r o n m e n t ( S u n O N E o r J B o s s ) . T h e st h e W i n d c h i l l I n f o * E n g i n e p a g e o f t h e R e f e r e n c w e b s i t e a t t h e f o l l o w i n g U R L : w w w . p t c . c o m / a p p s e r v e r / c s / d o c / r e f d o c . j s p

T h e I n f o * E n g i n e J a v a E E c o n n e c t o r c o m m u n i c aS O A P . S O A P i s a s t a n d a r d r e q u e s t / r e s p o n s e p r o s e r v i c e u s i n g X M L . I n f o * E n g i n e i n c l u d e s t h e S OI n f o * E n g i n e t a s k s t o b e e x p o s e d t o a c l i e n t u s i n g

I n f o * E n g i n e c a n d e s c r i b e a S O A P s e r v i c e t o a c l

D e n i t i o n L a n g u a g e ( W S D L ) . D e l i v e r e d a l o n g wt o o l s t h a t u s e W S D L m e t a d a t a i n f o r m a t i o n t o g e c a n b e u s e d t o s i m p l i f y i n t e r a c t i o n s w i t h I n f o * E g e n e r a t e D a t a A c c e s s O b j e c t s ( D A O s ) a n d E n t e re x p o s e s t a n d a r d J a v a m e t h o d s t h a t d r i v e i n t e r a c t







I e M a n a g e d C o n n e c t i o n T h e I e M a n a g e d C o n n e c t i o n c l a s s r e p r e s e n t s a p h y s i c a l c o n nA s a n a p p l i c a t i o n d e v e l o p e r y o u d o n o t n e e d t ow i t h t h i s c l a s s .

I e M a n a g e d C o n n e c t i o n M e t a D a t a T h e I e M a n a g e d C o n n e c t i o n M e t a D a t a c l a s s c a n b e u s e d t o g e t g e n e r a l i n f o r m a t i o n a b o u t a p h y s i c a l c o n n e c t iI n f o * E n g i n e c o n n e c t o r h a s m e r g e d t h i s c l a s s i j a v a x . r e s o u r c e . c c i . C o n n e c t i o n M e t a D a a s p a r t o f t h e C C I i m p l e m e n t a t i o n . F o r m o r e i n f o r m a t i o n , s e e C o m m o n C l i e n t I n t e r f a o n p a g e 2 0 4 .

F o r e x a m p l e , a c l i e n t c o u l d a s k f o r m e t a d a t a a bf o l l o w i n g m a n n e r :

C o n n e c t i o n c x = c x F a c t o r y . g e t C o n n e c t i o n ( ) ; C o n n e c t i o n M e t a D a t a m e t a = c x . g e t M e t a D a t a ( ) ;

I e C o n n e c t i o n M a n a g e r T h e I e C o n n e c t i o n M a n a g e r c l a s s i s r e q u i r e d f o r m a n a g i n g cw h e n a c o n n e c t o r i s u s e d o u t s i d e o f a J a v a E E aa s t a n d a l o n e J a v a S O A P c l i e n t . A n a p p l i c a t i o nt h i s c l a s s i n c o r p o r a t e s f u n c t i o n s s u c h a s c o n n et r a n s a c t i o n m a n a g e m e n t . T h e I n f o * E n g i n e J a vo f t h i s c l a s s s u p p l i e s s u p p o r t f o r s i m p l e c o n n e s u p p o r t a u t o m a t e d t r a n s a c t i o n m a n a g e m e n t . Ta v a i l a b l e w h e n t h e I n f o * E n g i n e J a v a E E c o n n W i n d c h i l l s y s t e m . W h e n t h e c o n n e c t o r i s u s e d a p p l i c a t i o n m u s t m a n a g e t r a n s a c t i o n d e m a r c a d e v e l o p e r , y o u n e v e r n e e d t o i n s t a n t i a t e o r i n t em o r e i n f o r m a t i o n , s e e E x a m p l e S t a n d a l o n e J a v a S O A P C .

T r a n s a c t i o n C o n t r a c t T h e I n f o * E n g i n e J a v a E E c o n n e c t o r c o n t a i n s L o c a l T r a n s a c t i o n s u p p o r t o n l y . T r a n s a c t i o n s a r e o n l y s u p p o r t e d i f t h e c o n n e c t o rW h e n u s i n g t h e I n f o * E n g i n e J a v a E E c o n n e c t o r f r o m a J a v a E E i s p o s s i b l e t o h a v e t h e a p p l i c a t i o n s e r v e r m a n a g e f o r y o u . W h e n d e p l o y e d , e a c h E J B m e t h o d c a n d e c l a r e i t s t r a n s






T h e C C I s i m p l i e s t h e p r o b l e m o f w r i t i n g c o d e t oE I S ’ s d a t a s t o r e . T h e E I S v e n d o r c a n u s e t h e C C Ii t s p r o d u c t . W i t h t h i s o n e i n t e r f a c e , t h e p r o d u c t wE E c o m p l i a n t p l a t f o r m . L i k e w i s e , a p p l i c a t i o n d u s e o n e s e t o f A P I c a l l s t o c o n n e c t t h e i r c l i e n t t o ah a v i n g t o l e a r n a d i f f e r e n t A P I f o r e a c h E I S .

T h e f o l l o w i n g c l a s s e s a r e u s e d b y t h e C C I :

• c o m . i n f o e n g i n e . c o n n e c t o r . I e C o n n e c t i• c o m . i n f o e n g i n e . c o n n e c t o r . I e I n t e r a c t • c o m . i n f o e n g i n e . c o n n e c t o r . I e I n t e r a c t

c o m . i n f o e n g i n e . c o n n e c t o r . I e C o n n e c t i o n S p e c T h e c o m . i n f o e n g i n e . c o n n e c t o r . I e C o n n e c c l a s s a l l o w s

c r e d e n t i a l s t o b e p a s s e d d u r i n g c o n n e c t i o n c r e t h e s t a n d a r d U s e r N a m e a n d P a s s w o r d p r o p e r t i e s . I n a d d i t i o n , t h s u p p o r t s a l o c a l e p r o p e r t y t h a t a l l o w s I n f o * E n i n r e s p o n s e , a n d a n a u t h U s e r p r o p e r t y t h a t c a n b e u s e d i n S i n( S S O ) s c e n a r i o s . T h e a u t h U s e r p r o p e r t y i s o n l y a c c e p t e d b y It h e c o n n e c t o r i s c o n g u r e d t o d i g i t a l l y s i g n o u tr e s i d e s o n a h o s t t h a t i s t r u s t e d .

c o m . i n f o e n g i n e . c o n n e c t o r . I e I n t e r a c t i o n S p e c T h e c o m . i n f o e n g i n e . c o n n e c t o r . I e I n t e r a c l a s s d r i v e s i n t e r a c t i o n s w i t h I n f o * E n g i n e . T h e s t a n F u n c t i o n N a m e p r o p e r t y s p e c i e s t h e m e t h o d o f f u n c t i o n t o i n v o k e . T h in a m e o f t h e t a s k d e l e g a t e t o i n v o k e . T h e a d d i t i C l a s s N a m e p r o p e r t y s p e c i e s t h e c l a s s t h e t a s k d e l e g a t e b e l o n g s t o . t y p e i d e n t i e r t h a t c o n t a i n s t h e t a s k d e l e g a t e t o




c o m . i n f o e n g i n e . c o n n e c t o r . I e I n t e r a c t i o n R e s u l t T h e j a v a x . r e s o u r c e . c c i . I n t e r a c t i o n i m p l e m e n t a t i o n s u p p o r te x e c u t i n g w i t h i n p u t r e c o r d o n l y . I t d o e s n o t s u p p oa n d o u t p u t r e c o r d . T h e i n t e r a c t i o n i m p l e m e n t a t i o i n s t a n c e o f c o m . i n f o e n g i n e . c o n n e c t o r . I e I n t e r a c( i m p l e m e n t s j a v a x . r e s o u r c e . c c i . R e c o r d ) . T h e I e I n t e r a c t i o n R e s u l t c l a s s i s a s i m p l e w r a p p e r f o r t h e S O A P r e s p o n s e . Tr e t r i e v e d u s i n g t h e g e t R e s u l t ( ) m e t h o d . A n i n t e r a c t i o n a c c e p t s a sM a p p e d R e c o r d o r I n d e x e d R e c o r d .

I n t h e c a s e w h e r e M a p p e d R e c o r d i s p a s s e d , t h e k e y s i n t h e m a p a r en a m e s a n d t h e v a l u e s a r e p a r a m e t e r v a l u e s . I n t h e c I n d e x e d R e c o r d i s p a s s e d , e a c h v a l u e m u s t b e a n a m e = v a l u e p a i r o f p a r a m e t e r s t o b e p aI d e a l l y , M a p p e d R e c o r d s h o u l d b e u s e d , a s t h e u s e o f n a m e = v a l u e s t r i n g s

d o e s n o t a l l o w f o r a n y d a t a t y p e o t h e r t h a n j a v a . l a n g . S t r i n g t o b e p a s s e d . T h e f o l l o w i n g i s a n e x a m p l e i n t e r a c t i o n w i t h I n f o *C o n n e c t i o n F a c t o r y c x f = g e t L D A P F a c t o r y ( ) ; / / l o o k u

C o n n e c t i o n c x = n u l l ; t r y {

/ / g e t c o n n e c t i o n w i t h c r e d e n t i a l s I e C o n n e c t i o n S p e c c x S p e c = n e w I e C o n n e c t i o n S p e c c x S p e c . s e t U s e r N a m e ( " w c a d m i n " ) ; c x S p e c . s e t P a s s w o r d ( " w c a d m i n " ) ; c x = c x f . g e t C o n n e c t i o n ( c x S p e c ) ; / / o r a n o n y m o u s / / c x = c x f . g e t C o n n e c t i o n ( ) ;

I n t e r a c t i o n i x = c x . c r e a t e I n t e r a c t i o n ( ) ; I e I n t e r a c t i o n S p e c i x S p e c = n e w I e I n t e r a c t i o n S p e c i x S p e c . s e t C l a s s N a m e ( " o r g . m y O r g . M a t h " ) ; i x S p e c . s e t F u n c t i o n N a m e ( " s u m " ) ; R e c o r d F a c t o r y r F a c t = c x f . g e t R e c o r d F a c t o r y ( ) ; M a p p e d R e c o r d i R e c = r F a c t . c r e a t e M a p p e d R e c o r d ( i R e c . p u t ( " x " , n e w I n t e g e r ( 4 ) ) ; i R e c . p u t ( " y " , n e w I n t e g e r ( 5 ) ) ;

I e I n t e r a c t i o n R e s u l t r e s u l t = ( I e I n t e r a c t i o n R e s u l t ) i x . e x e c u t e ( i x S p e c , i R e c )

I n t e g e r s u m = ( I n t e g e r ) r e s u l t . g e t R e s u l t ( ) ; S y s t e m . o u t . p r i n t l n ( " s u m i s " + s u m . i n t V a l u e ( ) )

} c a t c h ( E x c e p t i o n e x ) { e x . p r i n t S t a c k T r a c e ( ) ;

} f i n a l l y { i f ( c x ! = n u l l ) c x . c l o s e ( ) ;

}




E x a m p l e S t a n d a l o n e J a v a S t a n d a l o n e J a v a S O A P c l i e n t s c a n u s e t h e J a v a E

I n f o * E n g i n e . T h e y d o n o t , h o w e v e r , p r o v i d e t h es e r v e r c a n b r i n g t o y o u r c o n n e c t i o n s .

W r i t i n g a s t a n d a l o n e J a v a S O A P c l i e n t r e q u i r e s

1 . D e c i d e o n t h e c l a s s e s a n d m e t h o d s r e q u i r e d b 2 . I m p l e m e n t t h e r e q u i r e d t a s k s i n s i d e o f a d i r e c

r e q u i r e d c l a s s e s .

I n o u r e x a m p l e t h i s i n c l u d e s t h e a v e r a g e . x m l a n d s u m . x m l t a s k s i n t h e o r g / m y O r g / M a t h s u b d i r e c t o r y o f t h e t a s k r o o t . T h e s eI m p l e m e n t i n g T a s k s a n d J a v a C l a s s e s o n p a g e .

3 . C r e a t e t h e r e q u i r e d t y p e i d e n t i e r s a n d d e l e g ai s d i s c u s s e d i n R e g i s t e r i n g D e l e g a t e s o n p a g e 2 0 9 .

4 . G e n e r a t e D a t a A c c e s s O b j e c t s ( D A O s ) f o r e a d i s c u s s e d i n G e n e r a t i n g D A O s o n p a g e 2 1 0 .

5 . D e c i d e h o w c o n n e c t i o n s a r e t o b e c r e a t e d , a n df a c t o r y o b j e c t s i n t h e L D A P d i r e c t o r y . T h i s i s C r e a t i n g a C o n n e c t i o n H a n d l e o n p a g e 2 1 2 a n d M a n a g i n g C o n n e c t i o n F a c L D A P D i r e c t o r y o n p a g e 2 1 3 .

6 . W r i t e c l i e n t s o u r c e c o d e t h a t u s e s t h e D A O s f rT h i s i s d e s c r i b e d i n P u t t i n g I t A l l T o g e t h e r o n p a g e 2 1 6 .

T h e f o l l o w i n g s e c t i o n s u s e a s i m p l e e x a m p l e a p p

s t a n d a l o n e J a v a S O A P c l i e n t s h o u l d c o m m u n i c a

B e f o r e Y o u B e g i n W r i t i n g t h e S t a P C l i e n t B e f o r e y o u b e g i n w r i t i n g y o u r s t a n d a l o n e J a v a So f t h e f o l l o w i n g :

• E n s u r e t h a t t h e f o l l o w i n g J A R l e s a r e i n y o u r ○ $ ( < W i n d c h i l l > ) / l i b / s e r v l e t . j a r ○ $ ( < W i n d c h i l l > ) / c o d e b a s e / W E B - I N F / l i b / i e W○ $ ( < W i n d c h i l l > ) / c o d e b a s e / W E B - I N F / l i b / i e 3




w h e r e < W i n d c h i l l > i s t h e I n f o * E n g i n e i n s t a l l a t i o n d i r e c t o

o r

• E x t r a c t t h e c o n t e n t s o f $ ( < W i n d c h i l l > ) / i e c o n n e c t o r / i e . r a r i n t o a d i r e c t o r y a n d a d d a l l J A R l e s f o u n d t h e r e t o y o u r C

A s s u m e d K n o w l e d g e

B e f o r e i m p l e m e n t i n g a n I n f o * E n g i n e S O A P c l i e n t , f o l l o w i n g k n o w l e d g e :

• Y o u s h o u l d b e f a m i l i a r w i t h t h e I n f o * E n g i n e S O At a s k s f o r u s e w i t h S O A P .

• Y o u s h o u l d h a v e a s o l i d w o r k i n g k n o w l e d g e o f w rT h e s e s e c t i o n s d o n o t c o v e r f u n d a m e n t a l s s u c h a s

c o d e o r s e t t i n g t h e C L A S S P A T H .

I m p l e m e n t i n g T a s k s a n d J a v a C l a s sF o r o u r e x a m p l e , t h e s u m . x m l a n d a v e r a g e . x m l t a s k s a r e e x p o s e d t o a s t a n d a l o n e S O A P c l i e n t u s i n g t h e “ o r g . m y O r g . M a t h

N o t e F o r e a s e o f i n s t r u c t i o n , t h e t a s k s u s e d i n t h i s s a m p l e a a s e x a m p l e s , a n d d o n o t r e p r e s e n t t h e t y p e s o f a c t i v i t i t a s k s a r e t y p i c a l l y w r i t t e n t o a c c o m p l i s h .

s u m . x m l

T h e s u m . x m l t a s k t a k e s t w o i n t e g e r s a n d r e t u r n s t h e i r s u m i s t h e c o n t e n t s o f / o r g / m y O r g . M a t h / s u m . x m l :

< % @ p a g e l a n g u a g e = " j a v a " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b / c o r e " p r e f i x = " i e " % >

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f t h i s t a s k t a k e s t w o i n t e g e r s a n d a d d s t h e m t o g e t h e r @ p a r a m i n t x

@ p a r a m i n t y

@ r e t u r n i n t $ ( o u t p u t [ ] s u m [ ] ) - - > < % I n t e g e r x = ( I n t e g e r ) g e t P a r a m ( " x " ) ; I n t e g e r y = ( I n t e g e r ) g e t P a r a m ( " y " ) ; S t r i n g e l e m e n t = " s u m = " + ( x . i n t V a l u e ( ) + y . i n t V a l u e ( ) ) ; % >




 

 

a v e r a g e . x m l

T h e a v e r a g e . x m l t a s k t a k e s a n a r r a y o f n u m b e r s a n d r e tf o l l o w i n g c o d e i s t h e c o n t e n t s o f / o r g / m y O r g / M a t h / a v e r a g e :

< % @ p a g e l a n g u a g e = " j a v a " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a l i b / c o r e " p r e f i x = " i e " % >

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f t h i s t a s k t a k e s a n a r r a y o f n u m b e r s a n d a v e r a g e s t h e m

@ p a r a m d o u b l e [ ] n u m s

@ r e t u r n d o u b l e $ ( o u t p u t [ ] a v g [ ] ) - - > < % j a v a . u t i l . V e c t o r n u m s = g e t P a r a m s ( " n u m s " ) ; d o u b l e s u m = 0 ; f o r ( i n t i = 0 ; i < n u m s . s i z e ( ) ; i + + )

s u m + = ( ( D o u b l e ) n u m s . e l e m e n t A t ( i ) ) . d o u b l e V a l u e (S t r i n g e l e m e n t = " a v g = " + ( s u m / ( d o u b l e ) n u m s . s i z e ( )

% > 



R e g i s t e r i n g D e l e g a t e s F o r a n y S O A P c l i e n t t o i n v o k e a n I n f o * E n g i n e t aa s a d e l e g a t e i n t h e L D A P d i r e c t o r y .

T h e t a s k s f r o m o u r e x a m p l e w o u l d b e r e g i s t e r e d “ o r g . m y O r g . M a t h . ” T h i s t y p e i d e n t i e r w o u l d c s u m a n d a v e r a g e .

F o r m o r e i n f o r m a t i o n o n r e g i s t e r i n g t a s k s a s d e l a v a i l a b l e f r o m t h e T a s k D e l e g a t e A d m i n i s t r a t i o n




G e n e r a t i n g D A O s D a t a A c c e s s O b j e c t s ( D A O s ) a r e g e n e r a t e d f r o m I n f

e x p o s e s o n e m e t h o d s i g n a t u r e p e r e x p o s e d I n f o * E n gA D A O g e n e r a t e d f r o m t h e “ o r g . m y O r g . M a t h ” c l a s s p u b l i c m e t h o d s i g n a t u r e s :

p u b l i c i n t s u m ( i n t x , i n t y ) t h r o w s E x c e p t i o n ; p u b l i c d o u b l e a v e r a g e ( d o u b l e [ ] n u m s ) t h r o w s E x c e p t i

A n d t h e f o l l o w i n g c o n s t r u c t o r ( a s s u m i n g a c l a s s n a m

p u b l i c M a t h D A O ( j a v a x . r e s o u r c e . c c i . C o n n e c t i o n c , j a v ar e s o u r c e . c c i . R e c o r d F a c t o r y r ) ;

C r e a t i o n o f t h e r e q u i r e d i n s t a n c e s o f j a v a x . r e s o u r c e . c c i . C o n n e c a n d j a v a x . r e s o u r c e . c c i . R e c o r d F a c t o r y a r e d i s c u s s e d i n C r e a t i n g a C o n n e c t i o n H a n d l e o n p a g e 2 1 2 .

G e n e r a t e d D A O m e t h o d s m a y t h r o w a j a v a . l a n g . E x c e p t i o n . T h e r e a s o n s u c h a g e n e r i c e x c e p t i o n i s u s e d i s b e c a u s e t hu s e d t o i s s u e a S O A P r e q u e s t c a n c h a n g e . F o r e x a m p b e c o n g u r e d t o u s e H T T P o r J M S a s t h e u n d e r l y i n g S O A P c o n n e c t i o n i s s u e s a j a v a . n e t . C o n n e c t i o n R e f u s e d e x c e p t i o n i f t h e H T T P s e r v i c e i s u n a v a i l a b l e , w h e r e a J M S S O Aj a v a x . j m s . J M S E x c e p t i o n i f a J M S - r e l a t e d e r r o r o c c u r s .

D A O g e n e r a t i o n r e q u i r e s t h e f o l l o w i n g i n f o r m a t i o n

• e n d P o i n t

T h i s i s t h e l o c a t i o n o f t h e I n f o * E n g i n e S O A P s e r v i d e f a u l t s t o h t t p : / / < h o s t > / < W i n d c h i l l > / s e r v l e t / R P C . D e p e n d i n g o n y o u r c o n g u r a t i o n , t h e d e f a u l t v a l u e m a y n o t b ey o u m u s t e x p l i c i t l y s p e c i f y t h i s i n f o r m a t i o n . I f c r ea c c e s s t h e s e r v i c e t h e n t h e U R L f o r m o f “ h t t p : / / < u s h o u l d b e u s e d .

• s o a p C l a s s

T h i s i s t h e b a s e c l a s s ( t y p e i d e n t i e r ) f r o m w h i c h t he x a m p l e t h i s v a l u e i s “ o r g . m y O r g . M a t h . ”

• f i l e S y s t e m

T h i s v a l u e p o i n t s t o a l o c a l d i r e c t o r y w h e r e t h e r o o l o c a t e d .

• p a c k a g e

T h i s i s t h e n a m e o f t h e J a v a p a c k a g e t o w h i c h t h e g • c l a s s

T h i s i s t h e n a m e o f t h e c l a s s b e i n g g e n e r a t e d .




T h e r e a r e t w o w a y s t o g e n e r a t e a D A O : m a n u a l l yt h e D A O g e n e r a t i o n t o o l , o r u s e a n A n t e x t e n s i o n

F o r t h e p u r p o s e s o f t h i s e x a m p l e a s s u m e t h e f o l l • Y o u a r e d e v e l o p i n g t h e s t a n d a l o n e J a v a c l i e n t

S O A P s e r v i c e i s r u n n i n g . • T h e S O A P s e r v i c e r e q u i r e s t h e c r e d e n t i a l s u s e w c a d m i n ) a n d p a s s w o r

( w c a d m i n ) . • T h e r o o t o f y o u r J a v a s o u r c e t r e e i s / h o m e / u s e r / s r c .

T o g e n e r a t e a D A O f o r t h e “ o r g . m y O r g . M a t h ” c li n v o k e t h e f o l l o w i n g c o m m a n d ( a l l o n o n e l i n e ) :

j a v a c o m . i n f o e n g i n e . c o n n e c t o r . d a o . D A O G e n e r a t o r e W i n d c h i l l / s e r v l e t / R P C s o a p C l a s s = o r g . m y O r g . M a t h f

m y O r g . M a t h c l a s s = M a t h D A O

A n A n t b u i l d s c r i p t t h a t g e n e r a t e s t h e D A O s h o u c o d e :

< ? x m l v e r s i o n = " 1 . 0 " ? > < p r o j e c t n a m e = " g e n e r a t e D A O " d e f a u l t = " a l l " b a s e d i r

 





< t a r g e t n a m e = " d e c l a r e " > < t a s k d e f n a m e = " g e n e r a t o r " c l a s s n a m e = " c o m . i n f o e

c o n n e c t o r . d a o . A n t D A O G e n e r a t o r " > < c l a s s p a t h r e f i d = " c p " / > < / t a s k d e f >

< / t a r g e t > < t a r g e t n a m e = " a l l " d e p e n d s = " d e c l a r e " >

< g e n e r a t o r e n d P o i n t = " h t t p : / / w c a d m i n : w c a d m i n @ l o c a l h o s t / W

s e r v l e t / R P C " s o a p C l a s s = " o r g . m y O r g . M a t h "

S O A P S e r v i c e s 2 1 1





I n t h i s s i t u a t i o n u p d a t i n g t h e l o c a t i o n o f t h e S Ot o b e r e c o n g u r e d i n a s i n g l e p l a c e , a s o p p o s e d r e s i d e s . A s l o n g a s t h e l o c a t i o n o f t h e L D A P d i d o n o t n e e d t o b e u p d a t e d .

M a n a g i n g C o n n e c t i o n F a c t o r i e s D i r e c t o r y I n f o * E n g i n e s u p p l i e s t h e c o m . i n f o e n g i n e . c o n n e c t o r . A J a v a c l a s s f o r m a n a g i n g c o n n e c t i o n f a c t o r i e s i n t h e L Dy o u t o b i n d a n e w c o n n e c t i o n f a c t o r y o r u n b i n d a

T h e v a r i a b l e s a n d a c t i o n s u s e d b y t h e t o o l a r e s u pc o m m a n d . T h e p r o p e r t i e s l e c o n t a i n i n g t h e c o n

m u s t a l s o b e s u p p l i e d . V a r i a b l e s

p r i n c i p a l T h e u s e r n a m e .

p a s s w o r d T h e p a s s w o r d f o r t h e u s e r .

N o t e A n y p a r a m e t e r s b e i n g s p e c i e d f r o m t h e v a r i a b l e s p a r a m e t e r f r o m t h e a c t i o n s s e c t i o n .

A c t i o n s

T h e f o l l o w i n g a c t i o n s a r e a v a i l a b l e f r o m t h e t o o

- b i n d C o n n e c t i o n F a c t o r y p r o v i d e r o b j e c t C o n n e c t i o n I m p l e m e n t a t i o n P r o p e r t i e s F i l

W h e r e :

• p r o v i d e r i s t h e L D A P s y s t e m p r o v i d i n g t h e c o n • o b j e c t i s t h e c o n n e c t i o n f a c t o r y b e i n g b o u n d . • C o n n e c t i o n I m p l e m e n t a t i o n i s t h e c o n n e c t i o n i m p l e m

s p e c i e d i n t h e p r o p e r t i e s l e . • P r o p e r t i e s F i l e i s t h e n a m e o f t h e J a v a p r o p e r t i e s

c o n n e c t i o n c o n g u r a t i o n p r o p e r t i e s . T h i s p r

- u n b i n d C o n n e c t i o n F a c t o r y p r o v i d e r o b j e c t W h e r e :

• p r o v i d e r i s t h e L D A P s y s t e m p r o v i d i n g t h e c o n • o b j e c t i s t h e c o n n e c t i o n f a c t o r y b e i n g u n b o u n




C o n g u r a t i o n P r o p e r t i e s

T h e f o l l o w i n g c o n g u r a t i o n p r o p e r t i e s c a n b e s p e c i

H T T P C o n n e c t i o n I m p l e m e n t a t i o n T h i s p r o p e r t y a p p l i e s t o a n H T T P c o n n e c t i o n i m p l

C o n n e c t i o n U R L S p e c i e s t h e e n d p o i n t o f t h e I n f o * E n g i n e S O A P h t t p : / / < h o s t > / < W i n d c h i l l > / s e r v l e t / R P C

J M S C o n n e c t i o n I m p l e m e n t a t i o n T h e s e p r o p e r t i e s a p p l y t o a J M S c o n n e c t i o n i m p l e

i n . q u e u e S p e c i e s t h e q u e u e t o w h i c h t h e S O A P r e q u e s t s p r o p e r t y i s r e q u i r e d .

o u t . q u e u e S p e c i e s t h e q u e u e o n w h i c h t o w a i t f o r t h e S O A p r o p e r t y i s r e q u i r e d .

o u t . q u e u e . w a i t S p e c i e s h o w l o n g , i n m i l l i s e c o n d s , t o w a i t f o r t hd e f a u l t v a l u e f o r t h i s p r o p e r t y i s - 1 , w h i c h m e a n s t o w a i t i n d e n i ta r e s p o n s e .

p r o v i d e r . u r l S p e c i e s t h e L D A P U R L f o r t h e l o c a t i o n o f t h e sa d m i n i s t e r e d o b j e c t s . F o r e x a m p l e :

l d a p : / / l o c a l h o s t / c n = M Q S e r i e s , o = M y C o T h i s p r o p e r t y i s r e q u i r e d .

p r o v i d e r . p r i n c i p a l I f r e q u i r e d b y y o u r L D A P a c c e s s c o n t r o l s , s p e c i t o b i n d t o p r o v i d e r . u r l . F o r e x a m p l e : c n = M a n a g e r .

p r o v i d e r . c r e d e n t i a l s T h e p a s s w o r d f o r p r o v i d e r . p r i n c i p a l , i f r e q u i r e d b y y o u r L D A a c c e s s c o n t r o l s .

q u e u e C o n n e c t i o n F a c t o r y S p e c i e s t h e r e l a t i v e d i s t i n g u i s h e d n a m e ( d n ) o f t h e q u e u e c o n n e c t i o nf a c t o r y a d m i n i s t e r e d o b j e c t . T h i s p r o p e r t y i s r e q

q u e u e C o n n e c t i o n F a c t o r y . u s e r I f r e q u i r e d , s p e c i e s t h e u s e r n a m e n e e d e d t o c o q u e u e C o n n e c t i o n F a c t o r y .

q u e u e C o n n e c t i o n F a c t o r y . p a s s w o r d I f r e q u i r e d b y y o u r L D A P a c c e s s c o n t r o l s , s p e c ia s s o c i a t e d w i t h q u e u e C o n n e c t i o n F a c t o r y . u s e r .




N o n - C o n n e c t i o n I m p l e m e n t a t i o n S p e c i c T h e f o l l o w i n g p r o p e r t i e s a r e n o t c o n n e c t i o n i m

s i g n R e q u e s t s E n a b l e s o r d i s a b l e s d i g i t a l s i g n i n g o f S O A P T R U E a n d F A L S E , w i t h F A L S E b e i n g t h e d e

k e y S t o r e T y p e S p e c i e s t h e t y p e o f k e y s t o r e . T h e d e f a u l t v a J K S .

k e y S t o r e P a c k a g e P r o v i d e r S p e c i e s t h e k e y s t o r e p a c k a g e p r o v i d e r . T h i

k e y S t o r e F i l e n a m e S p e c i e s t h e p a t h t o t h e k e y s t o r e . T h e d e f a u l. k e y s t o r e i n t h e u s e r ’ s h o m e d i r e c t o r y .

k e y S t o r e P a s s w o r d S p e c i e s t h e p a s s w o r d f o r t h e k e y s t o r e . T h i s

c e r t i f i c a t e A l i a s S p e c i e s t h e a l i a s o f c e r t i c a t e t o u s e . T h e d e i s i e s o a p .

p r i v a t e K e y A l i a s S p e c i e s t h e a l i a s o f t h e p r i v a t e k e y . T h e d e f i s v a l u e o f t h e c e r t i f i c a t e A l i a s p r o p e r t y .

p r i v a t e K e y P a s s w o r d S p e c i e s t h e p r i v a t e k e y p a s s w o r d . T h e d e f a v a l u e o f t h e

k e y S t o r e P a s s w o r d p r o p e r t y .

J a v a P r o p e r t i e s F i l e

W h e n c r e a t i n g a c o n n e c t i o n f a c t o r y y o u m u s t s u c o n t a i n s t h e c o n n e c t i o n ’ s c o n g u r a t i o n p r o p e r t i

A n e x a m p l e o f a n H T T P c o n n e c t i o n f a c t o r y c o n

# C o n n e c t i o n I m p l e m e n t a t i o n = c o m . i n f o e n g i n e . c o n n e c C o n n e c t i o n U R L = h t t p : / / h o s t / W i n d c h i l l / s e r v l e t / R P C

A n e x a m p l e o f a J M S c o n n e c t i o n f a c t o r y c o n g u

# C o n n e c t i o n I m p l e m e n t a t i o n = c o m . i n f o e n g i n e . c o n n e c i n . q u e u e = c n = S O A P . i n o u t . q u e u e = c n = S O A P . o u t o u t . q u e u e . w a i t = 6 0 0 0 0 q u e u e C o n n e c t i o n F a c t o r y = c n = S O A P . q c f p r o v i d e r . u r l = l d a p : / / l o c a l h o s t / c n = M Q S e r i e s , o = M y C op r o v i d e r . p r i n c i p a l = c n = M a n a g e r p r o v i d e r . c r e d e n t i a l s = a d m i n




A s s u m i n g t h e p r o p e r t i e s l i s t e d p r e v i o u s l y f o r a n H T s t o r e d i n a p r o p e r t i e s l e n a m e d h t t p . p r o p e r t i e s , t h e f o l l o w i n g c o m m a nc o u l d b e u s e d t o b i n d a n e w c o n n e c t i o n f a c t o r y t o a n n a m e c n = c x F a c t o r y . H T T P , o = M y C o m p a n y : j a v a c o m . i n f o e n g i n e . c o n n e c t o r . A d m i n T o o l - p r i n c i p a l = c - p a s s w o r d = a d m i n - b i n d C o n n e c t i o n F a c t o r y " l d a p : / / l o c a l c x F a c t o r y . H T T P c o m . i n f o e n g i n e . c o n n e c t o r . H T T P C o n n e c t. / h t t p . p r o p e r t i e s

T h e f o l l o w i n g c o m m a n d c o u l d t h e n b e u s e d t o u n b i n j u s t c r e a t e d :

j a v a c o m . i n f o e n g i n e . c o n n e c t o r . A d m i n T o o l - p r i n c i p a l = c - u n b i n d C o n n e c t i o n F a c t o r y " l d a p : / / l o c a l h o s t / o = M y C o m p

P u t t i n g I t A l l T o g e t h e r T h e s i m p l e J a v a S O A P c l i e n t / h o m e / u s e r / s r c / o r g / m y O r g / c l i e n t / T e s t . j a vi l l u s t r a t e s h o w t o i n t e r a c t w i t h I n f o * E n g i n e u s i n g S a p p l i c a t i o n :

p a c k a g e o r g . m y O r g . c l i e n t ;

i m p o r t o r g . m y O r g . M a t h . M a t h D A O ;

i m p o r t c o m . i n f o e n g i n e . c o n n e c t o r . I e C o n n e c t i o n S p e c ;

i m p o r t j a v a . u t i l . H a s h t a b l e ; i m p o r t j a v a x . r e s o u r c e . R e s o u r c e E x c e p t i o n ; i m p o r t j a v a x . r e s o u r c e . c c i . C o n n e c t i o n ; i m p o r t j a v a x . r e s o u r c e . c c i . C o n n e c t i o n F a c t o r y ; i m p o r t j a v a x . n a m i n g . I n i t i a l C o n t e x t ; i m p o r t j a v a x . n a m i n g . N a m i n g E x c e p t i o n ;

/ / o n l y u s e d i n u n d e s i r a b l e l o c a l c o n f i g u r e d a n d c r e a t e d/ / C o n n e c t i o n F a c t o r y s i t u a t i o n i m p o r t c o m . i n f o e n g i n e . c o n n e c t o r . I e M a n a g e d C o n n e c t i o n

i m p o r t j a v a . b e a n s . P r o p e r t y V e t o E x c e p t i o n ; i m p o r t j a v a . i o . F i l e I n p u t S t r e a m ; i m p o r t j a v a . i o . I O E x c e p t i o n ;

p u b l i c c l a s s T e s t {

p r i v a t e s t a t i c C o n n e c t i o n F a c t o r y g e t L D A P F a c t o r y ( ) t h r o w s N a m i n g E x c e p t i o n {




H a s h t a b l e e n v = n e w H a s h t a b l e ( 5 ) ; e n v . p u t ( " j a v a . n a m i n g . f a c t o r y . i n i t i a l " ,

" c o m . s u n . j n d i . l d a p . L d a p C t x F a c t o r y " ) ;

e n v . p u t ( " j a v a . n a m i n g . p r o v i d e r . u r l " , " l d a p : / / l d a p . m y c o m p a n y . c o m / o = M y C o m p a n y

e n v . p u t ( " j a v a . n a m i n g . s e c u r i t y . a u t h e n t i c a t i o n " ,e n v . p u t ( " j a v a . n a m i n g . s e c u r i t y . p r i n c i p a l " , " c n =e n v . p u t ( " j a v a . n a m i n g . s e c u r i t y . c r e d e n t i a l s " , " a I n i t i a l C o n t e x t c t x = n e w I n i t i a l C o n t e x t ( e n v ) ; r e t u r n ( C o n n e c t i o n F a c t o r y ) c t x . l o o k u p (

" c n = c x F a c t o r y . H T T P " ) ; }

p r i v a t e s t a t i c C o n n e c t i o n F a c t o r y g e t M a n u a l F a c t o r t h r o w s P r o p e r t y V e t o E x c e p t i o n , I O E x c e p t i o n , R e s o u

I e M a n a g e d C o n n e c t i o n F a c t o r y m c f = n e w I e M a n a g e d C o n n e c t i o n F a c t o r y ( ) ;

/ / f o l l o w i n g o p t i o n a l s i n c e H T T P C o n n e c t i o n i s t hm c f . s e t C o n n e c t i o n I m p l e m e n t a t i o n (

" c o m . i n f o e n g i n e . c o n n e c t o r . H T T P C o n n e c t i o n " ) ; / / c o n f i g u r e f r o m p r o p e r t i e s f i l e m c f . l o a d C o n n e c t i o n P r o p e r t i e s (

n e w F i l e I n p u t S t r e a m ( " . / h t t p . p r o p e r t i e s " ) ) ; / / o r v i a m e t h o d c a l l / / m c f . s e t C o n n e c t i o n P r o p e r t i e s (

/ / " C o n n e c t i o n U R L = h t t p : / / l o c a l h o s t / W i n d c h i l l / r e t u r n ( C o n n e c t i o n F a c t o r y ) m c f . c r e a t e C o n n e c t i o n

}

p r i v a t e s t a t i c S t r i n g f o r m a t A r r a y ( d o u b l e [ ] a r r ) S t r i n g B u f f e r s b = n e w S t r i n g B u f f e r ( ) ; f o r ( i n t i = 0 ; i < a r r . l e n g t h ; i + + )

s b . a p p e n d ( a r r [ i ] ) . a p p e n d ( ( ( i + 1 ) < a r r . l e n g t h ) ? " + " : " " ) ;

r e t u r n s b . t o S t r i n g ( ) ;

} p u b l i c s t a t i c v o i d m a i n ( S t r i n g [ ] a r g s ) t h r o w s E x

C o n n e c t i o n F a c t o r y c x f = g e t L D A P F a c t o r y ( ) ; / / C o n n e c t i o n F a c t o r y c x f = g e t M a n u a l F a c t o r y ( ) ;

C o n n e c t i o n c x = n u l l ; t r y {

/ / g e t c o n n e c t i o n w i t h c r e d e n t i a l s I e C o n n e c t i o n S p e c c x S p e c = n e w I e C o n n e c t i o n S p e




c x S p e c . s e t U s e r N a m e ( " w c a d m i n " ) ; c x S p e c . s e t P a s s w o r d ( " w c a d m i n " ) ; c x = c x f . g e t C o n n e c t i o n ( c x S p e c ) ;

/ / o r a n o n y m o u s / / c x = c x f . g e t C o n n e c t i o n ( ) ;

M a t h D A O d a o = n e w M a t h D A O ( c x , c x f . g e t R e c o r d F a c t

i n t f o u r A n d F i v e = d a o . s u m ( 4 , 5 ) ; S y s t e m . o u t . p r i n t l n (

" 4 + 5 = " + f o u r A n d F i v e ) ;

d o u b l e [ ] n u m s = n e w d o u b l e [ ] { 4 , 5 , 6 , 7 } ; d o u b l e a v g = d a o . a v e r a g e ( n u m s ) ; S y s t e m . o u t . p r i n t l n (

" a v e r a g e o f " + f o r m a t A r r a y ( n u m s ) + " = " + a v g )

} f i n a l l y { i f ( c x ! = n u l l ) c x . c l o s e ( ) ; S y s t e m . e x i t ( 0 ) ;

} }

}




1 1 S e r v e r A c c e s

A b o u t t h e S e r v e r A c c e s s K i t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E x a m p l e S A K A p p l i c a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

T h e f o l l o w i n g t o p i c s d i s c u s s t h e I n f o * E n g i n e S e p r o v i d e a n e x a m p l e o f a n S A K a p p l i c a t i o n .

2 1 9



A b o u t t h e S e r v e r A c c e s s K i t T h e I n f o * E n g i n e S e r v e r A c c e s s K i t ( S A K ) a l l o w s J a

I n f o * E n g i n e t a s k s , p a s s p a r a m e t e r s t o t h e m , a n d i n s i n s t a n t i a t e d a s J a v a c l a s s e s . A f t e r c o n s t r u c t i n g a t a s ko b j e c t c a n b e c a l l e d t o a d d p a r a m e t e r s a n d e s t a b l i s h et a s k i s i n v o k e d . A f t e r a d d i n g p a r a m e t e r s a n d e s t a b l i i n v o k e m e t h o d f o r t h e t a s k c a n b e c a l l e d t o e x e c u t e t h e t a s k . m e t h o d s o n t h e t a s k o b j e c t c a n b e c a l l e d t o o b t a i n t h e

D o c u m e n t a t i o n f o r t h e I n f o * E n g i n e A P I s t h a t a r e a vt h e S A K c a n b e f o u n d i n t h e J a v a d o c l e s t h a t r e s i d ec o d e b a s e / i n f o e n g i n e / d o c s / a p i d o c s d i r e c t o r y w h e r e I n f o * E n g ii n s t a l l e d .

C o n n e c t i n g t o I n f o * E n g i n e B e f o r e c r e a t i n g o r a t t e m p t i n g t o e x e c u t e a n y t a s k i n si n i t i a l i z e i t s c o n n e c t i o n w i t h t h e I n f o * E n g i n e N a m i nS e r v i c e e n a b l e s t h e t a s k s e x e c u t e d b y t h e a p p l i c a t i o ns e r v i c e s d e p l o y e d a c r o s s t h e e n t e r p r i s e n e t w o r k . T h i s e s t a b l i s h e d b y c a l l i n g a s t a t i c f a c t o r y m e t h o d a s f o

i m p o r t c o m . i n f o e n g i n e . a u . N a m i n g S e r v i c e ; : :

N a m i n g S e r v i c e n a m i n g S e r v i c e =

N a m i n g S e r v i c e . n e w I n s t a n c e ( " c o m . m y C o m p a n y . n a m i n g S e r v i c e " ,

" l d a p : / / l d a p . m y c o m p a n y . c o m / d c = m y C o m p a n y , d c =

T h i s s t a t i c f a c t o r y m e t h o d l o c a t e s a N a m i n g S e r v i c e“ c o m . m y C o m p a n y . n a m i n g S e r v i c e ” ( a N a m i n g S e r ve n t e r p r i s e ) i n t h e L D A P d i r e c t o r y . I t s e a r c h e s t h e L D N a m i n g S e r v i c e d e n i t i o n . T h e r o o t w h e r e t h e s e a r c d i r e c t o r y e n t r y w i t h t h e d i s t i n g u i s h e d n a m e d c = m y C o m p a n y , d c = c o m a n d t h e h o s t o n w h i c h t h e L D A P s e r v e r r e s i d e s i s n a m e d “ l d av a l u e c o u l d b e a p a t h t o t h e i e . p r o p e r t i e s l e o r a n L D A P U R L t h a t p ot o t h e p l a c e i n t h e d i r e c t o r y t o n d t h e p r o p e r t i e s . T o

t o p o i n t t o t h e i e . p r o p e r t i e s l e . Y o u m u s t r e p l a c e t h i s N a m i n g S e r v i c e n a m e , t h e d i s L D A P h o s t n a m e w i t h o n e s t h a t a p p l y t o y o u r n e t w o s t r u c t u r e . T h e L D A P d i r e c t o r y s t r u c t u r e a n d t h e N a mt y p i c a l l y c r e a t e d w h e n t h e I n f o * E n g i n e s o f t w a r e i s




U p o n l o c a t i n g t h e N a m i n g S e r v i c e d e n i t i o n , t h p a r a m e t e r s , a u t o m a t i c a l l y l o a d s a l l I n f o * E n g i n eL D A P d i r e c t o r y s e r v i c e , a n d t h e n r e t u r n s c o n t r o p o i n t , t h e a p p l i c a t i o n c a n c r e a t e a n d e x e c u t e t a s k

E x e c u t i n g T a s k s T o c r e a t e a n i n s t a n c e o f a t a s k o b j e c t , u s e t h e c o n p a r a m e t e r . F o r e x a m p l e :

i m p o r t c o m . i n f o e n g i n e . S A K . T a s k ; : :

T a s k t a s k = n e w T a s k ( " / c o m / a c m e / i n f o a p p / Q u e r y B

T h e p a r a m e t e r o f t h i s T a s k c o n s t r u c t o r i s t h e U R L o f a n I n f o *v a r i e t y o f U R L f o r m a t s c a n b e s p e c i e d . F o r e x a I n f o * E n g i n e J S P P a g e s o n p a g e 5 9 .

A f t e r c o n s t r u c t i n g a t a s k i n s t a n c e , t h e a p p l i c a t i o b y c a l l i n g t h e a d d P a r a m m e t h o d . T h i s m e t h o d a c c e p t s t h e n t o b e a d d e d a n d i t s v a l u e . F o r e x a m p l e :

i m p o r t c o m . i n f o e n g i n e . S A K . T a s k ; : :

T a s k t a s k = n e w T a s k ( " / c o m / a c m e / i n f o a p p / Q u e r y Bt a s k . a d d P a r a m ( " c l a s s " , " w t . p a r t . W T P a r t " ) ;

t a s k . a d d P a r a m ( " w h e r e " , " n a m e = ' E n g i n e ' " ) ; t a s k . a d d P a r a m ( " g r o u p _ o u t " , g r o u p O u t N a m e ) ;

T h e s a m e p a r a m e t e r n a m e c a n b e s p e c i e d i n m o a d d P a r a m i n o r d e r t o a d d m u l t i v a l u e d p a r a m e t e r s . P a r a m e t e r P a r a m e t e r s a r e r e f e r e n c e d w i t h i n a t a s k b y u s i n g a g a i n s t t h e @ F O R M c o n t e x t g r o u p . T h u s , e a c h c a l l t o t h e m e t h o d a d d P a r a m a d d s a n a t t r i b u t e w i t h t h e s p e c i e d n a m e a n d v a l u e t o tt h e t a s k t o b e e x e c u t e d .

I n a d d i t i o n t o a d d i n g p a r a m e t e r s t o a t a s k , a n a p pe x e c u t i o n o p t i o n s a g a i n s t t h e t a s k b e f o r e i n v o k i nc a n s e t t h e u s e r n a m e u n d e r w h i c h t h e t a s k s h o u l d b e u s e d b y I n f o * E n g i n e a s a c r e d e n t i a l s m a p p i n ge x a m p l e , u s e r n a m e a n d p a s s w o r d ) t h a t a r e p r o v it h e t a s k c o m m u n i c a t e s . T h e t a s k ’ s u s e r n a m e c a n

t a s k . s e t U s e r n a m e ( " g u e s t " ) ;

T h i s s e t s t h e a u t h - u s e r a t t r i b u t e i n t h e @ S E R V E R c o n t e x t O t h e r a t t r i b u t e s c a n b e a d d e d t o t h e @ S E R V E R cg r o u p u s u a l l y c o n t a i n s i n f o r m a t i o n a b o u t t h e r u n

S e r v e r A c c e s s K i t 2 2 1



t a s k i s e x e c u t i n g . F o r e x a m p l e , w h e n a t a s k i s e x e c u ts e r v l e t , t h e @ S E R V E R c o n t e x t g r o u p i s p o p u l a t e d wi n f o r m a t i o n p r o v i d e d b y t h e w e b s e r v e r i n c l u d i n g a lA p p l i c a t i o n s t h a t c r e a t e a n d e x e c u t e t a s k i n s t a n c e s c s e t S e r v e r A t t r i b u t e m e t h o d t o p o p u l a t e t h e @ S E R V E R g r o u p w i t h r u n t i F o r e x a m p l e :

t a s k . s e t S e r v e r A t t r i b u t e ( " a c c e p t - l a n g u a g e " , " e n - U S " )

B y d e f a u l t , I n f o * E n g i n e e x e c u t e s t a s k s w i t h i n t h e J ao f t h e c a l l i n g a p p l i c a t i o n . S o m e t i m e s i t i s m o r e a p p rn o n - l o c a l J V M t h a t i s h o s t i n g a n I n f o * E n g i n e t a s k p t r u e w h e n t h e s o u r c e c o d e o f t h e t a s k c a n b e a c c e s s e d p r o c e s s o r . F o r e x a m p l e , i f t h e t a s k s o u r c e c o n t a i n s s p r i v i l e g e d p a s s w o r d s , a c c e s s t o i t m a y b e r e s t r i c t e d . b y a n o n - l o c a l t a s k p r o c e s s o r , a n a p p l i c a t i o n c a n c a l a d d P r o c e s s o r m e t h o d t o s p e c i f y t h e n a m e s o f t h e I n f o * E n g i n e t a s k p r o c e s se x e c u t e d . F o r e x a m p l e :

t a s k . a d d P r o c e s s o r ( " c o m . m y c o m p a n y . e n g i n e e r i n g . w i n d

A f t e r a d d i n g a l l n e c e s s a r y p a r a m e t e r s a n d s e r v i c e o pc a l l i n g i t s i n v o k e m e t h o d a s f o l l o w s :

t a s k . i n v o k e ( ) ;

C a t c h i n g E r r o r s I f a n y e r r o r c o n d i t i o n s a r e d e t e c t e d w h i l e e x e c u t i n g a r e t h r o w n . T h e c a l l i n g a p p l i c a t i o n c a n u s e n o r m a l J a n d i n s p e c t e x c e p t i o n s w h e n t h a t i s d e s i r a b l e . O f c o s u c c e s s f u l l y w i t h o u t d e t e c t i n g a n y e r r o r c o n d i t i o n s ,

W h e n t h e a d d P r o c e s s o r m e t h o d i s u s e d t o s p e c i f y t h a t a t a s k m u a n o n - l o c a l t a s k p r o c e s s o r , I n f o * E n g i n e a u t o m a t i c a w i t h t h e t a s k p r o c e s s o r , c o n v e y s t h e r e q u e s t t o e x e c u( i n c l u d i n g t r a n s m i s s i o n o f a l l p a r a m e t e r s a n d s e r v i c r e s u l t s . I f a r e m o t e l y e x e c u t e d t a s k t h r o w s a n e x c e p t b a c k t o t h e l o c a l J V M a n d r e t h r o w n t h e r e . I f m o r e t h s p e c i e d b y c a l l i n g a d d P r o c e s s o r m o r e t h a n o n c e , I n f o * E n g i n e a t t e e s t a b l i s h c o m m u n i c a t i o n s w i t h t h e s p e c i e d p r o c e s st h e i r n a m e s w e r e a d d e d . T h e t a s k i s e x e c u t e d i n t h e c o m m u n i c a t i o n s a r e e s t a b l i s h e d s u c c e s s f u l l y .

I n g e n e r a l , w h e n I n f o * E n g i n e d e t e c t s e r r o r c o n d i t i o e x e c u t i n g t a s k s , i t t h r o w s e x c e p t i o n s . W h e n u n d e r l y b y I n f o * E n g i n e t h r o w e x c e p t i o n s , I n f o * E n g i n e w r a c l a s s e s . C o n s e q u e n t l y , a l l I n f o * E n g i n e e x c e p t i o n c l




T h r o w a b l e o b j e c t s . T h e I n f o * E n g i n e e x c e p t i o n c l a s s o b t a i n i n g t h e s e n e s t e d T h r o w a b l e o b j e c t s s o t h a t a p p l i c a t i o n s c a r o o t c a u s e s o f e r r o r i n d i c a t i o n s .

F o r d e t a i l s o n t h e c o m . i n f o e n g i n e . u t i l . I E E x c e p t i o c l a s s a n d i t s s u b c l a s s e s , s e e t h e J a v a d o c .

I n s p e c t i n g T a s k R e s u l t s T h e a p p l i c a t i o n r e s u m e s c o n t r o l w h e n t h e t a s k c a p p l i c a t i o n c a n t h e n i n s p e c t t h e r e s u l t s . R e s u l t s ag r o u p o b j e c t s s t o r e d i n t h e t a s k V i r t u a l D a t a b a s e c u r r e n t l y s t o r e d i n t h e V D B a t a n y p o i n t i n t i m e cg e t G r o u p N a m e s m e t h o d a s f o l l o w s :

j a v a . u t i l . E n u m e r a t i o n g r o u p N a m e s = t a s k . g e t G r o u p

A n y g r o u p c a n b e o b t a i n e d b y n a m e f r o m t h e V D g e t G r o u p m e t h o d p r o v i d e d b y t h e T a s k c l a s s . F o r e x a m p l e :

i m p o r t c o m . i n f o e n g i n e . S A K . T a s k ; i m p o r t c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . G r o u p ;

: :

T a s k t a s k = n e w T a s k ( " / c o m / a c m e / i n f o a p p / Q u e r y Bt a s k . a d d P a r a m ( " c l a s s " , " w t . p a r t . W T P a r t " ) ; t a s k . a d d P a r a m ( " w h e r e " , " n a m e = ' E n g i n e ' " ) ; t a s k . a d d P a r a m ( " g r o u p _ o u t " , " e n g i n e _ p a r t s " ) ;

t a s k . i n v o k e ( ) ; G r o u p g r o u p = t a s k . g e t G r o u p ( " e n g i n e _ p a r t s " ) ;

G r o u p s c a n b e a d d e d t o t h e V D B b y a n a p p l i c a t i ow h e n a t a s k i s d e s i g n e d t o o p e r a t e u p o n a g r o u p t hI n t h i s c a s e , t h e a p p l i c a t i o n a d d s t h e g r o u p t o t h e i n v o k e m e t h o d . F o r e x a m p l e :

i m p o r t c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . G r o u p ; i m p o r t c o m . i n f o e n g i n e . S A K . T a s k ;

: :

G r o u p b o m G r o u p = n e w G r o u p ( " p r o d u c t - s t r u c t u r e "

: 

: T a s k t a s k = n e w T a s k ( " / c o m / a c m e / i n f o a p p / U p d a t e t a s k . a d d P a r a m ( " g r o u p _ i n " , b o m G r o u p . g e t N a m e ( ) )t a s k . a d d G r o u p ( b o m G r o u p ) ; t a s k . i n v o k e ( ) ;

S e r v e r A c c e s s K i t 2



R e s u l t i n g D a t a A G r o u p o b j e c t ( c l a s s c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . G )

i s a c o n t a i n e r f o r E l e m e n t o b j e c t s ( c l a s s c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . E l e m e n t ) , a n d a n E l e m e n t o b j e c t i s a c o n t a i n e r f o r A t t o b j e c t s ( c l a s s c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . A t t ) . U s u a l l y , a n E l e m e n t o b j e c t r e p r e s e n t s a b u s i n e s s o b j e c t o r a r o w f r o m a d a t a b a s ed a t a b a s e a d a p t e r s ) . A n A t t o b j e c t r e p r e s e n t s a s i n g l e a t t r i b u t e o f aE a c h A t t o b j e c t h a s a n a m e a n d o n e o r m o r e v a l u e s . A v a l A t t o b j e c t c a n b e a n y c l a s s o f o b j e c t . T h e r e f o r e , a G r o u p i s a c o n t a i n e r f o r o n e o r m o r e bo b j e c t s . E a c h b u s i n e s s o b j e c t i s r e p r e s e n t e d a s a n E l e m e n t o b j e c t a n d e a c h E l e m e n t o b j e c t c o n t a i n s o n e o r m o r e n a m e / v a l u e p a i r s r e A t t o b j e c t s .

R e s u l t i n g M e t a d a t a I n a d d i t i o n t o r e g u l a r d a t a , G r o u p , E l e m e n t , a n d A t t o b j e c t s c a n c o n t a i n m e t a A p p l i c a t i o n s c a n , a n d I n f o * E n g i n e i t s e l f d o e s , u s e m a b o u t a n o b j e c t o n t h e o b j e c t i t s e l f . E a c h m e t a d a t a i t M o s t m e t a d a t a i t e m s c r e a t e d a n d u s e d b y I n f o * E n g i w i t h c o m . i n f o e n g i n e . A p p l i c a t i o n s c a n a d d t h e i r o w n m e t a dt h e y s h o u l d a v o i d u s i n g n a m e s t h a t b e g i n w i t h c o m . i n f o e n g i n e b e c a u s e t h i s n a m e s p a c e i s r e s e r v e d b y I n f o * E n g i n e . A l l o f t h e i n m e t h o d s t h a t s u p p o r t i n s p e c t i o n , c r e a t i o n , a n d m a n ad e t a i l s o n t h e s e m e t h o d s , s e e t h e J a v a d o c .

C o m m o n M e t h o d s T h e G r o u p , E l e m e n t , a n d A t t c l a s s e s a l l s u p p o r t a v a r i e t y o f m e t h i n s p e c t i n g a n d m a n a g i n g t h e i r c o n t e n t . F o r d e t a i l s o J a v a d o c . T h e s e c l a s s e s c o m m o n l y i n c l u d e t h e f o l l o w

C o m m o n G r o u p M e t h o d s

g e t A t t r i b u t e V a l u e R e t r i e v e s t h e v a l u e o f a s p e c i c a t t r i b u t e ( A t t ) o f a s p e c i c E l e m e n t o b j e c t c o n t a i n e d i n t h e G r o u p .

a d d E l e m e n t

A d d s a n e w E l e m e n t o b j e c t t o t h e G r o u p . g e t E l e m e n t C o u n t

R e t u r n s t h e n u m b e r o f E l e m e n t o b j e c t s c o n t a i n e d i n t h e G r o u p .

g e t E l e m e n t s R e t u r n s a l l o f t h e E l e m e n t o b j e c t s o f t h e G r o u p a s a n e n u m e r a t i o n .

g e t E l e m e n t A t R e t r i e v e s a s p e c i c E l e m e n t o b j e c t f r o m t h e G r o u p b y i n d e x .




r e m o v e E l e m e n t A t R e m o v e s a s p e c i c E l e m e n t o b j e c t f r o m t h e G r o u p b y i n d e x .

t o X M L R e n d e r s t h e e n t i r e G r o u p t o X M L a n d r e t u r n s t h e r e s u l t a s ai t t o a n o u t p u t s t r e a m .

C o m m o n E l e m e n t M e t h o d s

a d d A t t A d d s a n e w a t t r i b u t e ( A t t ) t o t h e E l e m e n t , o r a d d s a n e w v a l u e t o a a t t r i b u t e o f t h e E l e m e n t .

g e t A t t R e t r i e v e s a s p e c i c a t t r i b u t e ( A t t ) o b j e c t f r o m t h e E l e m e n t b y n a m e .

g e t A t t s R e t u r n s a l l a t t r i b u t e o b j e c t s o f t h e E l e m e n t a s a n e n u m e r a t i o n .

g e t V a l u e R e t r i e v e s t h e v a l u e o f a s p e c i c a t t r i b u t e ( A t t ) o f t h e E l e m e n t .

g e t V a l u e s R e t r i e v e s a l l v a l u e s o f a s p e c i c a t t r i b u t e ( A t t ) o f t h e E l e m e n t a s a v e c t o r .

r e m o v e A t t R e m o v e s a s p e c i c a t t r i b u t e ( A t t ) f r o m t h e E l e m e n t b y n a m e .

t o X M L R e n d e r s t h e E l e m e n t t o X M L a n d w r i t e s i t t o a n o u t p u t s t

C o m m o n A t t M e t h o d s

a d d V a l u e A d d s a v a l u e t o t h e a t t r i b u t e .

g e t V a l u e R e t r i e v e s t h e v a l u e o f t h e a t t r i b u t e .

g e t V a l u e s R e t r i e v e s a l l v a l u e s o f t h e a t t r i b u t e a s a n e n u m

t o X M L R e n d e r s t h e a t t r i b u t e t o X M L a n d w r i t e s i t t o a n

S A K E x a m p l e M e t h o d T h e f o l l o w i n g e x a m p l e m e t h o d t r a v e r s e s a G r o u p o b j e c t t o d i s p l a y a l l o fE l e m e n t o b j e c t s a n d t h e i r a t t r i b u t e s :

p r i v a t e v o i d d i s p l a y O b j e c t s ( G r o u p o b j e c t s ) { / / / / x m l D i s p l a y i s a b o o l e a n i n s t a n c e v a r i a b l e t h a t




/ / w h e t h e r t h e G r o u p s h o u l d b e r e n d e r e d a s X M L o r a s / / t e x t . / /

i f ( x m l D i s p l a y ) { P r i n t W r i t e r p w = n e w P r i n t W r i t e r ( S y s t e m . o u t ) ; o b j e c t s . t o X M L ( p w , t r u e , t r u e ) ;

} e l s e {

i n t n = o b j e c t s . g e t E l e m e n t C o u n t ( ) ; f o r ( i n t i = 0 ; i < n ; + + i ) {

/ / / / P r i n t o n e e m p t y l i n e b e t w e e n E l e m e n t s / /

S y s t e m . o u t . p r i n t l n ( " " ) ; E l e m e n t o b j e c t = o b j e c t s . g e t E l e m e n t A t ( i ) ; E n u m e r a t i o n a t t s = o b j e c t . g e t A t t s ( ) ; w h i l e ( a t t s . h a s M o r e E l e m e n t s ( ) ) {

/ / / / R e n d e r e a c h a t t r i b u t e a s " n a m e : v a l u e " / / I f a n a t t r i b u t e i s m u l t i v a l u e d , i n d e n t e a c h / / v a l u e s u c h t h a t t h e y a r e v e r t i c a l l y a l i g n e d . / /

A t t a t t = ( A t t ) a t t s . n e x t E l e m e n t ( ) ; S t r i n g n a m e = a t t . g e t N a m e ( ) ; S y s t e m . o u t . p r i n t ( n a m e + " : " ) ; E n u m e r a t i o n v a l u e s = a t t . g e t V a l u e s ( ) ;

i n t v = 0 ;

w h i l e ( v a l u e s . h a s M o r e E l e m e n t s ( ) ) {

O b j e c t v a l u e = v a l u e s . n e x t E l e m e n t ( ) ;

i f ( v + + > 0 ) {

S y s t e m . o u t . p r i n t ( " " ) ;

f o r ( i n t s = 0 ; s < n a m e . l e n g t h ( ) ; + + s ) S y s t e m . o u t . p r i n t ( " " ) ;

}

S y s t e m . o u t . p r i n t l n ( v a l u e ) ;




} }

S y s t e m . o u t . p r i n t l n ( " " ) ;

} }

E x a m p l e S A K A p p l i c a t i o n T h e f o l l o w i n g e x a m p l e a p p l i c a t i o n p r o v i d e s a s i t h e S e r v e r A c c e s s K i t ( S A K ) . T h e e x a m p l e i s n a m E x e c u t e T a s k . j a v a n d i s l o c a t e d i n t h e p r o g _ e x a m p l e s / S A K _ a p p s d i r e c t o r y w h e r e I n f o * Ei n s t a l l e d .

T h e e x a m p l e a p p l i c a t i o n e x e c u t e s a t a s k s u p p l i e

C o m p i l e t h e A p p l i c a t i o n T o c o m p i l e t h e a p p l i c a t i o n :

1 . S e t y o u r C L A S S P A T H e n v i r o n m e n t v a r i a b l e

Y o u r C L A S S P A T H e n v i r o n m e n t v a r i a b l e m u l e s / f o l d e r s : % J A V A _ H O M E % / l i b / t o o l s . j a r % < W i n d c h i l l > % / l i b / s e r v l e t . j a r % < W i n d c h i l l > % / c o d e b a s e % < W i n d c h i l l > % / c o d e b a s e / W E B - I N F / c l a s s e s % < W i n d c h i l l > % / c o d e b a s e / W E B - I N F / l i b / i e W e

E x a m p l e :

s e t C L A S S P A T H = C : / j d k 1 . 3 . 1 / l i b / t o o l s . j a r ; C : / p t c / W i n. j a r ; C : / p t c / W i n d c h i l l / c o d e b a s e ; C : / p t c / W i n d c h i l l c l a s s e s ; C : / p t c / W i n d c h i l l / c o d e b a s e / W E B - I N F / l i b /

2 . C r e a t e t h e f o l l o w i n g d i r e c t o r y :

% < W i n d c h i l l > % / c o d e b a s e / W E B - I N F / c l a s s e s

3 . C h a n g e t o t h e d i r e c t o r y : % < W i n d c h i l l > > % / p r o g _ e x a m p l e s / S A K _ a p p s a n d e x e c u t e t h e f o l l o w i n g :

j a v a c - d % < W i n d c h i l l > % / c o d e b a s e / W E B - I N F / c l a s s e s E x e c u t




R u n t h e A p p l i c a t i o n T o r u n t h e a p p l i c a t i o n , u s e t h e f o l l o w i n g s y n t a x :

j a v a c o m . i n f o e n g i n e . e x a m p l e s . a p p l i c a t i o n s . E x e c u t e T a - t < t a s k _ u r i > - u - p r o p s - n < n a m i n g s e r v i c e n a m e >

w h e r e :

• < t a s k _ u r i > i s t h e U R I o f t h e t a s k t o b e e x e c u t e d • a s s o c i a t e s t h e u s e r n a m e s p e c i e d w i t h t h e • i s t h e d i r e c t o r y p a t h t o t h e p r o p e r t y

i e . p r o p e r t i e s • < n a m i n g s e r v i c e n a m e > u s e s t h e s p e c i e d N a m i n g S e r v i c e


j a v a c o m . i n f o e n g i n e . e x a m p l e s . a p p l i c a t i o n s . E x e c u t e T a C : / p t c / W i n d c h i l l / t a s k s / i n f o e n g i n e / e x a m p l e s / C r e a t e G r o w c a d i m n - p r o p s C : / p t c / W i n d c h i l l / c o d e b a s e / W E B - I N F / i- n c o m . p t c . h o s t . n a m i n g S e r v i c e

A p p l i c a t i o n S o u r c e T h e f o l l o w i n g c o d e i m p l e m e n t s t h e e x a m p l e :

p a c k a g e c o m . i n f o e n g i n e . e x a m p l e s . a p p l i c a t i o n s ;

i m p o r t c o m . i n f o e n g i n e . a u . N a m i n g S e r v i c e ; i m p o r t c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . G r o u p ; i m p o r t c o m . i n f o e n g i n e . S A K . T a s k ; i m p o r t c o m . i n f o e n g i n e . u t i l . I E E x c e p t i o n ;

i m p o r t j a v a . i o . F i l e N o t F o u n d E x c e p t i o n ; i m p o r t j a v a . i o . P r i n t W r i t e r ; i m p o r t j a v a . u t i l . E n u m e r a t i o n ; i m p o r t j a v a . u t i l . V e c t o r ;

p u b l i c c l a s s E x e c u t e T a s k {

/ * * * D e m o n s t r a t e t h e c o m . i n f o e n g i n e . S A K i n t e r f a c e o f I * * c o m m a n d l i n e : j a v a c o m . i n f o e n g i n e . e x a m p l e s . a p p l i * - t < t a s k u r i > * - p 




* - u * - n < n a m i n g s e r v i c e n a m e > * - p r o p s 

* * @ p a r a m a r g s * /

p u b l i c s t a t i c v o i d m a i n ( S t r i n g [ ] a r g s ) {

S t r i n g t a s k U r i = n u l l ; S t r i n g p r o c e s s o r = n u l l ; S t r i n g u s e r n a m e = n u l l ; S t r i n g n a m i n g S e r v i c e = n u l l ; S t r i n g p r o p s = n u l l ;

f o r ( i n t i = 0 ; i < a r g s . l e n g t h ; i + + ) { i f ( a r g s [ i ] . e q u a l s ( " - t " ) ) {

i f ( i < a r g s . l e n g t h - 1 ) t a s k U r i = a r g s [ + + i ] ;

} e l s e i f ( a r g s [ i ] . e q u a l s ( " - p " ) ) {

i f ( i < a r g s . l e n g t h - 1 ) p r o c e s s o r = a r g s [ + + i ] ;

} e l s e i f ( a r g s [ i ] . e q u a l s ( " - u " ) ) {

i f ( i < a r g s . l e n g t h - 1 ) u s e r n a m e = a r g s [ + + i ] ;

} e l s e i f ( a r g s [ i ] . e q u a l s ( " - n " ) ) {

i f ( i < a r g s . l e n g t h - 1 ) n a m i n g S e r v i c e = a r g s [ + + i ] ;

} e l s e i f ( a r g s [ i ] . e q u a l s ( " - p r o p s " ) ) {

i f ( i < a r g s . l e n g t h - 1 ) p r o p s = a r g s [ + + i ] ;

} e l s e {

S y s t e m . e r r . p r i n t l n ( " u n r e c o g n i z e d p a r a m e t e r \ " " + a r g s [ i ]

u s a g e ( ) ; }

} i f ( t a s k U r i = = n u l l ) {

S y s t e m . e r r . p r i n t l n ( " m i s s i n g r e q u i r e d p a r a mu s a g e ( ) ;

} i f ( n a m i n g S e r v i c e = = n u l l )




n a m i n g S e r v i c e = " n a m i n g S e r v i c e " ; i f ( p r o p s = = n u l l )

S y s t e m . e r r . p r i n t l n

( " m i s s i n g r e q u i r e d p a r a m e t e r - p r o p s < p r o p e r t yu s a g e ( ) ;

/ / I n i t i a l i z e t h e n a m i n g s e r v i c e a n d r e a d t h e i n f o e nt r y {

N a m i n g S e r v i c e n s = N a m i n g S e r v i c e . n e w I n s t a n c e ( n a m i n g S e r v i c e , p

} c a t c h ( F i l e N o t F o u n d E x c e p t i o n f ) {

S y s t e m . e r r . p r i n t l n ( p r o p s + " : p r o p e r t y f i l e n o t S y s t e m . e x i t ( 1 ) ;

} c a t c h ( E x c e p t i o n e ) {

S y s t e m . e r r . p r i n t l n ( p r o p s + " : u n a b l e t o r e a d p r oe . p r i n t S t a c k T r a c e ( S y s t e m . e r r ) ; S y s t e m . e x i t ( 1 ) ;

} / / C r e a t e a T a s k o b j e c t t o e x e c u t e T a s k t a s k = n u l l ; i f ( p r o c e s s o r = = n u l l ) {

t a s k = n e w T a s k ( t a s k U r i ) ; } e l s e {

V e c t o r p r o c V e c t o r = n e w V e c t o r ( ) ;

p r o c V e c t o r . a d d E l e m e n t ( p r o c e s s o r ) ; t a s k = n e w T a s k ( t a s k U r i , p r o c V e c t o r ) ;

} / / e x e c u t e t h e t a s k t r y {

t a s k . i n v o k e ( ) ; } c a t c h ( E x c e p t i o n e ) {

e . p r i n t S t a c k T r a c e ( S y s t e m . e r r ) ; S y s t e m . e x i t ( 1 ) ;

} / / r e t r i e v e a n d p r i n t t h e r e s u l t s E n u m e r a t i o n g r o u p s = t a s k . g e t G r o u p N a m e s ( ) ; S y s t e m . o u t . p r i n t l n ( " g r o u p s p r o d u c e d b y " + t a s k U rP r i n t W r i t e r p w = n e w P r i n t W r i t e r ( S y s t e m . o u t ) ; w h i l e ( g r o u p s . h a s M o r e E l e m e n t s ( ) ) {

G r o u p g r o u p = t a s k . g e t G r o u p ( ( S t r i n g ) g r o u p s . n e g r o u p . t o X M L ( p w , t r u e , t r u e ) ;

} S y s t e m . e x i t ( 0 ) ;




} / * *

* P r i n t t h e c o m m a n d l i n e p a r a m e t e r s

* / p u b l i c s t a t i c v o i d u s a g e ( ) {

S y s t e m . e r r . p r i n t l n ( " j a v a c o m . i n f o e n g i n e . e x a m p l e s . a p p l i c a t i o n

S y s t e m . e r r . p r i n t l n ( " \ t - t < t a s k u r i > " ) ; S y s t e m . e r r . p r i n t l n ( " \ t - p " ) ; S y s t e m . e r r . p r i n t l n ( " \ t - u " ) ; S y s t e m . e r r . p r i n t l n ( " \ t - n < n a m i n g s e r v i c e n a m S y s t e m . e r r . p r i n t l n ( " \ t - p r o p s < p r o p e r t y r e s o u rS y s t e m . e x i t ( 1 ) ;

} }






1 2 I n f o * E n g i n e C u s t o m T

S c r i p t l e t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E x p r e s s i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .D e c l a r a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D i r e c t i v e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I n f o * E n g i n e T a g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

T h i s f o l l o w i n g t o p i c s p r o v i d e r e f e r e n c e i n f o r m a

I n f o * E n g i n e c o r e a n d d i r e c t o r y t a g l i b r a r i e s . T h c o m m o n J S P e l e m e n t t y p e s , w i t h t i p s f o r u s i n g t J S P p a g e s . T h e e l e m e n t s d e s c r i b e d i n t h e s e t o p i cI n f o * E n g i n e J S P p a g e s a n d I n f o * E n g i n e s t a n d a l

2 3 3



S c r i p t l e t s A s c r i p t l e t i s a s t a n d a r d J a v a S e r v e r P a g e ( J S P ) e l e m e

I n f o * E n g i n e s t a n d a l o n e t a s k s a n d o n I n f o * E n g i n e J c o d e f r a g m e n t .

S t a n d a l o n e T a s k U s e

T h e t a s k c o m p i l e r c o p i e s s c r i p t l e t s d i r e c t l y t o t h e J a vt o t h e J a v a c o m p i l e r . T h i s a l l o w s J a v a p r o g r a m m i n g I n f o * E n g i n e t a s k s i n o r d e r t o i m p l e m e n t c o n d i t i o n a i t e r a t i o n ( f o r / w h i l e ) , a n d n o n t r i v i a l c o m p u t a t i o n .

T a s k s c a n i n c l u d e e m b e d d e d J a v a s c r i p t l e t s ( < % … % > ) .

N o t e

T h e f o l l o w i n g a p p l i e s t o t h e u s e o f s c r i p t l e t s w h e n y o uu s e g u a r a n t e e d t a s k e x e c u t i o n ( i f y o u h a v e s e t E N A B L E R E C O V E R Y t o T R U E o n t h e p a g e d i r e c t i v e ) .

B e c a r e f u l w h e n p o s i t i o n i n g s c r i p t l e t s i n t a s k s u s e d i w h e r e t h e g u a r a n t e e d t a s k e x e c u t i o n f e a t u r e h a s b e e s c r i p t l e t s w i t h a c t i o n w e b j e c t s o r t a s k t a g s c a n i n t e r f e r e w i t h t h e c o d e gu s e d f o r s u p p o r t i n g g u a r a n t e e d t a s k e x e c u t i o n . T o a m o r e o f t h e f o l l o w i n g :

• P l a c e y o u r s c r i p t l e t e i t h e r b e f o r e t h e r s t w e b j e c t o t a s k t a g , o r a f t e r t h e l a s t .

• A v o i d s u r r o u n d i n g a c t i o n w e b j e c t s o r t a s k t a g s w i t h s c r i p t l e t s . F o r e x a

d o n o t i n c l u d e t h e w e b j e c t s o r t a s k t a g s i n t h e f o r o r w h i l e l o o p s o r i n i f / t h e n / e l s e c o n s t r u c t s .

• S p e c i f y t h e r e s u m a b l e = t r u e a t t r i b u t e i n a l l o f y o u r a c t i o n w e ba n d t a s k t a g s t o d i s a b l e t h e g u a r a n t e e d t a s k e x e c u t i o n fw e b j e c t s a n d t a s k s .

T h e l a s t o p t i o n i s r e c o m m e n d e d i n t h e c a s e s w h e r e t a w h e n I n f o * E n g i n e e n c o u n t e r s t h e c o d e r a t h e r t h a n t hf o r e x e c u t i o n .

J S P U s e

S c r i p t l e t s a r e e x e c u t e d w h e n t h e J S P i n t e r p r e t e r p r o ct h e m . T h i s m e a n s t h a t n e s t e d s c r i p t l e t s a r e e x e c u t e d r e a d . H o w e v e r , I n f o * E n g i n e c u s t o m t a g s a r e d e n e dn e s t e d c u s t o m t a g s i s d e f e r r e d u n t i l t h e e n d t a g o f t h eT h e r e f o r e , a n y n e s t e d s c r i p t l e t o n a J S P p a g e i s e x e c uc u s t o m t a g b l o c k i n w h i c h i t i s n e s t e d .






J S P U s e

T h e e x p r e s s i o n i s e v a l u a t e d a n d i t s r e s u l t i s d i s p l a y e

w h e r e t h e t a g i s d e n e d . N o t e T h e u s e o f e x p r e s s i o n s w i t h i n I n f o * E n g i n e c u s t o m p a r a m t a g a t t r i b u t e v a l u e s m a y n o t g i v e y o u t h e r e s u l t s y o u e x p e c t w h e n y o u a r e e n g i n e . I n t h e T o m c a t s e r v l e t e n g i n e , w h e n a n e x p r e sd a t a a t t r i b u t e v a l u e , i t i s n o t e v a l u a t e d c o r r e c t l y . H o w et h e d a t a a t t r i b u t e i s a n e x p r e s s i o n , t h e r e s u l t i s c o r r e c t .

T o w o r k a r o u n d t h i s i s s u e , y o u c a n c r e a t e t h e e n t i r e v u s e t h e r e s u l t s i n a n e x p r e s s i o n i n t h e d a t a a t t r i b u t e . F o r e x a m p l e , t h e f o l d a t a a t t r i b u t e o n a p a r a m t a g i s n o t e v a l u a t e d c o r r e c t l y :

< i e : p a r a m n a m e = " E L E M E N T " d a t a = " E N A M E = < % = E N A M E %

I n s t e a d , y o u c a n c o d e t h i s a s f o l l o w s :

< % S t r i n g e l V a l u e = " E N A M E = " + E N A M E ; % > " / >

T a g S y n t a x

< % = e x p r e s s i o n % >

E x a m p l e

I n t h e f o l l o w i n g p a r a g r a p h , t w o e x p r e s s i o n s a r e u s e dt a b l e a n d w h e r e :

 Q u e r y t a b l e < % = t a b l e % > w i t h w h e r e c l a u s e < % = w h e r e % 

D e c l a r a t i o n s A d e c l a r a t i o n s p e c i e s t e x t t h a t d e c l a r e s v a r i a b l e s a nt h e J S P p a g e o r I n f o * E n g i n e s t a n d a l o n e t a s k .

S t a n d a l o n e T a s k U s e T h e t a s k c o m p i l e r e m i t s t h e t e x t i n e a c h d e c l a r a t i o n aJ a v a c l a s s i t g e n e r a t e s f o r t h e t a s k . T h e r e f o r e , t h e d e i n s t a n c e v a r i a b l e s a n d m e t h o d s o n t h e c l a s s . Y o u c a nd e n e s t a t i c i n i t i a l i z a t i o n b l o c k s f o r t h e g e n e r a t e d c l




J S P U s e

D e c l a r a t i o n s a r e i n i t i a l i z e d w h e n t h e J S P p a g e i s

t o o t h e r d e c l a r a t i o n s , s c r i p t l e t s , a n d e x p r e s s i o n sT a g S y n t a x < % ! d e c l a r a t i o n % >

E x a m p l e

T h e r s t d e c l a r a t i o n d e c l a r e s a n i n t e g e r a n d i n i t i d e c l a r a t i o n d e c l a r e s a m e t h o d :

< % ! i n t i = 0 ; % >

< % ! p u b l i c i n t a d d ( i n t a , i n t b ) { r e t u r n a + b ; } %

D i r e c t i v e s D i r e c t i v e s p r o v i d e g l o b a l i n f o r m a t i o n t h a t i s c o ns p e c i c r e q u e s t r e c e i v e d b y t h e J S P p a g e o r b y t h d i r e c t i v e i s u s e d t o d e n e a p r e x t h a t i s r e q u i r e d

Y o u c a n u s e t h e f o l l o w i n g d i r e c t i v e s o n J S P p a g e

• T h e p a g e d i r e c t i v e d e n e s t h e g e n e r a l c h a r a c t e r i s t

• T h e t a g l i b d i r e c t i v e d e c l a r e s t h a t t h e p a g e o r t a s k u n i q u e l y i d e n t i e s t h e t a g l i b r a r y u s i n g a U R I , d i s t i n g u i s h e s u s a g e o f t h e a c t i o n s i n t h e l i b r a r y

p a g e D i r e c t i v e T h e p a g e d i r e c t i v e d e n e s t h e g e n e r a l c h a r a c t e r i s t i c p a g e d i r e c t i v e i s a s t a n d a r d J S P d i r e c t i v e a n d i s a l s o u i n c l u d e t h e p a g e d i r e c t i v e a s t h e r s t t a g o n a n I n f o * E n g r s t l i n e i n a t a s k l e .

S t a n d a l o n e T a s k U s e

T h e t a s k c o m p i l e r r e c o g n i z e s a s t a n d a r d p a g e d i r e c t i v e , b u t o n l y u s e s i m p o r t a t t r i b u t e f o r i m p o r t i n g c l a s s l e s t h a t a r e n e e d e d a c c e s s a t t r i b u t e f o r d e t e r m i n i n g h o w a t a s k c a n b e i n v o k

N o t e T h e a c c e s s a t t r i b u t e i s a c c e p t e d o n l y b y t a s k s , n o t J S P s

I n f o * E n g i n e C u s t o m T a g R e f e r e n c e 2 3 7



J S P U s e

U s e t h i s d i r e c t i v e t o s p e c i f y t h e c h a r a c t e r i s t i c s o f t h e

• I d e n t i f y t h e J a v a l a n g u a g e u s e d i n s c r i p t s o n t h e p a• S p e c i f y t h e M I M E t y p e a n d c h a r a c t e r e n c o d i n g • S p e c i f y t h e p a g e s c o p e • I m p o r t a n y c l a s s l e s o r p a c k a g e s n e e d e d f o r t h e p • D e t e r m i n e w h a t p a g e i s d i s p l a y e d f o r e r r o r s • I d e n t i f y t h e p a g e a s t h e e r r o r p a g e

T a g S y n t a x f o r C o m m o n P a g e C h a r a c t e r i s t i c s

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " b o o l e a n " i m p o r t = " l i s t _ o f _ c l a s s e s " c o n t e n t T y p e = " m i m e T y p e [ ; c h a r s e t = c he r r o r P a g e = " e r r o r _ p a g e _ u r l " i s E r r o r P a g e = " b o o l e a n " a c c e s s = " h t t p | s o a p | i n t e r n a l " % >

A t t r i b u t e D e s c r i p t i o n s

R e q u i r e d a t t r i b u t e s : l a n g u a g e




a c c e s s S p e c i e s a l i s t o f a c c e s s m e t h o d s a c c e p t a b l e t o p o s s i b l e v a l u e s a r e :

• i n t e r n a l — T h e t a s k c a n b e i n v o k e d b y c a l l e r s iV M . T h i s v a l u e i s i m p l i c i t .

• s o a p — T h e t a s k c a n b e c a l l e d b y S O A P c l i e n t • h t t p — T h e t a s k c a n b e c a l l e d b y r a w H T T P c l i

V a l u e s c a n b e s p e c i e d a s a p i p e - s e p a r a t e d l i s ta c c e s s = “ h t t p | s o a p ” f o r t a s k s t h a t c a n b e i n v o k e d u s i no r t h e I E s e r v l e t . U s e a c c e s s = “ i n t e r n a l ” t o m a k e s u r e t h a t n o e c l i e n t s a r e a l l o w e d t o i n v o k e a t a s k .

I t m i g h t n o t a l w a y s b e c o n v e n i e n t t o s p e c i f y t h d i r e c t l y . T o c o n t r o l t h e a c c e s s v a l u e f o r a g r o u a c c e s s w i t h i n a . d e l e g a t e I n f o l e i n t h e s u b d i r e c t o r y w h e r a r e i n s t a l l e d . A . d e l e g a t e I n f o l e i s a s i m p l e J a v a p r o p e r t i t h i s c a s e y o u w o u l d n o t u s e q u o t e s w h e n s p e c i a c c e s s = i n t e r n a l .

N o t e C u r r e n t l y , W i n d c h i l l u s e s t h e “ h t t p | s o a p ” t a s k a c c e s s b y d e f a u l t , t a s k s t o b e c a l l e d e x t e r n a l l y . M a n y P T C r e l e a s ea c c e s s p e r m i s s i o n s a s i n t e r n a l t o a v o i d p o s s i b l c l i e n t s . H o w e v e r , i n f u t u r e r e l e a s e s P T C m i g h t t o i n t e r n a l , i n w h i c h c a s e y o u m u s t e x p l i c i t l y s p e c it h a t a r e i n t e n d e d t o b e c a l l e d b y e x t e r n a l c l i e n t

c o n t e n t T y p e T h e M I M E t y p e a n d c h a r a c t e r e n c o d i n g t h e J S s e n d s t o t h e c l i e n t . Y o u c a n u s e a n y M I M E t y p f o r t h e J S P . T h e d e f a u l t M I M E t y p e i s t e x t / h t m l a n d t h e d e f a u l t c h a s e t i s I S O - 8 8 5 9 – 1 .

e r r o r P a g e D e n e s t h e U R L t o t h e e r r o r p a g e f o r t h e c u r r e no n t h e p a g e c a u s e t h e p a g e n a m e d i n t h i s a t t r i b un a m e d m u s t i n c l u d e t h e i s E r r o r P a g e = " t r u e " a t t r i b u t e i n i t s p a g e d i r e c t i v e .

i m p o r t I d e n t i e s t h e J a v a c l a s s l e s o r p a c k a g e s t h a t a rs c r i p t i n g l a n g u a g e t h a t i s o n t h e p a g e o r i n t h e c o m m a - s e p a r a t e d l i s t c o n t a i n i n g e i t h e r f u l l y q n a m e s f o l l o w e d b y “ * ” . S p e c i f y i n g a p a c k a g e t h e p a c k a g e a v a i l a b l e .




i s E r r o r P a g e I n d i c a t e s w h e t h e r t h e c u r r e n t p a g e i s u s e d a s t h e t a e r r o r P a g e a t t r i b u t e . T o u s e t h e c u r r e n t p a g e a s a n e r r o r ps e t t h i s a t t r i b u t e t o t r u e . B y d e f a u l t , t h i s a t t r i b u t e i s s e t t o f a l s e .

l a n g u a g e D e n e s l a n g u a g e t h a t i s u s e d i n t h e p a g e . T h e v a l u b e j a v a .

T h i s a t t r i b u t e i s r e q u i r e d .

s e s s i o n S e t s t h e s c o p e f o r t h e p a g e . T o s e t t h e p a g e s c o p e t oa t t r i b u t e t o t r u e . T o s e t t h e p a g e s c o p e t o t h e c u r r e n t p a g e a t t r i b u t e t o f a l s e .

T h i s i s a n o p t i o n a l a t t r i b u t e . I f y o u o m i t t h i s a t t r i b us e s s i o n .

E x a m p l e

T h e f o l l o w i n g p a g e d i r e c t i v e s e t s t h e l a n g u a g e t o J a v a , s e t s t h t o t h e s e s s i o n , i m p o r t s t h e I n f o * E n g i n e f a c t o r y a n d oe r r o r p a g e t o I E E r r o r . j s p :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " t r u e " i m p o r t = " c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . * ,

c o m . i n f o e n g i n e . o b j e c t . * " e r r o r P a g e = " I E E r r o r . j s p " % >

F o r a d d i t i o n a l i n f o r m a t i o n a b o u t e r r o r p a g e s , s e e C a t c h i n g E x c e p t i o n s o n p a .

t a g l i b D i r e c t i v e T h e t a g l i b d i r e c t i v e d e c l a r e s t h a t a J S P p a g e o r I n f o * E n u s e s c u s t o m t a g s d e n e d i n a t a g l i b r a r y . Y o u m u s t p ul i n e s t h a t u s e t h e c u s t o m t a g s i n t h e l i b r a r y .

T a g S y n t a x

< % @ t a g l i b u r i = " i e _ u r i " p r e f i x = “ i e _ p r e f i x

A t t r i b u t e D e s c r i p t i o n s R e q u i r e d a t t r i b u t e s : p r e x a n d u r i

p r e x D e n e s t h e p r e x t h a t d i s t i n g u i s h e s t a g s p r o v i d e d f r o m t h o s e p r o v i d e d b y o t h e r t a g l i b r a r i e s . I f y o u s t a g l i b d i r e c t i v e s , e a c h p r e x m u s t b e u n i q u e .







T a g L i b r a r y t a g l i b P r e x S u p p l i e d – J S T L c S u p p l i e d – X S L x s l S u p p l i e d – L o g g i n g l o g

T h e f o l l o w i n g I n f o * E n g i n e t a g s a r e a v a i l a b l e :

T a g T a g L i b r a r y a n d D e s c r i p t i o n c h o o s e T a g o n p a g e 2 7 9 S u p p l i e d T a g L i b r a r y ( J S T L ) . A l l o w s f o r c

e v a l u a t i o n w i t h a n a l t e r n a t i v e f o r e v a( i f / e l s e ) .

c r e a t e O b j e c t s T a g o n p a g e 2 7 3

D i r e c t o r y T a g L i b r a r y . C r e a t e s n e w e n t rs p e c i e d L D A P d i r e c t o r y s e r v i c e .

d e l e t e O b j e c t T a g o n p a g e 2 7 4

D i r e c t o r y T a g L i b r a r y . D e l e t e s a n L Dt h e L D A P d i r e c t o r y s e r v i c e .

d i s p l a y R e s o u r c e T a g o n p a g e 2 4 6

C o r e T a g L i b r a r y . E x t r a c t s a n d d i s p l ad i r e c t l y f r o m a r e s o u r c e b u n d l e o r f r oc r e a t e d w i t h t h e G e t - R e s o u r c e w e b j e

f a i l u r e T a g o n p a g e 2 4 8 C o r e T a g L i b r a r y . A l l o w s y o u t o s u p pf a i l u r e p r o c e s s i n g w i t h i n a u n i t .

f o r E a c h T a g o n p a g e 2 4 9 C o r e T a g L i b r a r y . A l l o w s y o u t o i t e r ae x i s t i n g I n f o * E n g i n e g r o u p , o n e e l e m

f o r E a c h T a g o n p a g e 2 8 0 S u p p l i e d T a g L i b r a r y ( J S T L ) . S u p p o r t s i t e ra n i t e r a b l e , g r o u p , o r a r r a y o f o b j e c t s .

s u p p o r t f o r I n f o * E n g i n e t a s k s . g e t S e r v i c e T a g o n p a g e 2 5 1 C o r e T a g L i b r a r y . E s t a b l i s h e s a v a r i r e f e r e n c e t o t h e I n f o * E n g i n e o b j e c t ( c o m . i n f o e n g i n e . j s p . I n f o E n g i n ) t h a t i s b e i n g u s e d b y t h e I n f o * E n g i n e o n a J S P p a g e .

g e t V a l u e T a g o n p a g e 2 5 3 C o r e T a g L i b r a r y . R e t r i e v e s t h e s t r i n s p e c i e d a t t r i b u t e f r o m t h e r s t e l e m e n t i n tg r o u p .

i f T a g o n p a g e 2 8 1 S u p p l i e d T a g L i b r a r y ( J S T L ) . A l l o w s f o r c o e v a l u a t i o n o f i t s b o d y . P r o v i d e s J S T LI n f o * E n g i n e t a s k s .

i n f o , d e b u g , w a r n , e r r o r , t r a c e T a g s o n p a g e 2 8 5

S u p p l i e d T a g L i b r a r y ( L o g g i n g ) . O n e t a g fc o r r e s p o n d i n g l o g 4 j l o g l e v e l . E a c h im e s s a g e t o t h e c o r r e s p o n d i n g l o g m e

i n i t T a g o n p a g e 2 5 5 C o r e T a g L i b r a r y . S u p p l i e s t h e i n i t i a u n i t .




T a g T a g L i b r a r y a n d D e s c r i p t i o n l i s t O b j e c t s T a g o n p a g e 2 7 5

D i r e c t o r y T a g L i b r a r y . C r e a t e s a g r o u p c o n t a i n i n g e l e m e n t s t h a t a d i s t i n g u i s h e d n a m e s o f t h e L D A Pl o c a t e d d i r e c t l y u n d e r t h e s p e c i el e v e l .

o t h e r w i s e T a g o n p a g e 2 8 1 S u p p l i e d T a g L i b r a r y . ( J S T L ) . I f w h e n t a g e v a l u a t e s t o f a l s e , t h e n t h e c o n t e n t o f t h eo t h e r w i s e t a g i s i n v o k e d a n d e x e c u t e d t h e “ e l s e ” o f i f / e l s e l o g i c ) . P r o v i df o r I n f o * E n g i n e t a s k s .

p a r a l l e l T a g o n p a g e 2 5 7 C o r e T a g L i b r a r y . A l l o w s y o u t o d e n ew e b j e c t s o r t a s k s t h a t a r e e x e c u t e

p a r a m T a g o n p a g e 2 5 8 C o r e T a g L i b r a r y . D e n e s a p a r a mw e b j e c t t a g s , t a s k t a g s , a n d d i r e c t p a r a m T a g o n p a g e 2 8 6 S u p p l i e d T a g L i b r a r y ( X S L ) . S p e

X S L p a r a m e t e r t o b e s u p p l i e d f o r t h eT h i s t a g i s e m b e d d e d w i t h i n a t r a n s f o r m t a g a n d i s o p t i o n a l . P r o v i d e s X S L t r a n s f o r m

q u e r y O b j e c t s T a g o n p a g e 2 7 6

D i r e c t o r y T a g L i b r a r y . C r e a t e s a nc o n t a i n i n g e l e m e n t s t h a t a r e t h e Le n t r i e s m a t c h i n g t h e s e a r c h c r i t e r

r e s e t S e r v i c e T a g o n p a g e 2 6 2

C o r e T a g L i b r a r y . R e s e t s t h e I n f o( c o m . i n f o e n g i n e . j s p . I n f o E n g i n ) t h a t i s

b e i n g u s e d b y t h e I n f o * E n g i n e c u p a g e o r i n a s e s s i o n . r e t u r n T a g o n p a g e 2 8 2 S u p p l i e d T a g L i b r a r y ( J S T L ) . T e

i n v o c a t i o n . P r o v i d e s J S T L s u p p ot a s k s .

s e t T a g o n p a g e 2 8 2 S u p p l i e d T a g L i b r a r y ( J S T L ) . S e e i t h e r t h e t a s k l e t c o n t e x t o r r e q u e J S T L s u p p o r t f o r I n f o * E n g i n e t a s

s e t L o g g e r T a g o n p a g e 2 8 5 S u p p l i e d T a g L i b r a r y ( L o g g i n g ) . S e t sl o g g e r t o b e u s e d .

s u c c e s s T a g o n p a g e 2 6 4 C o r e T a g L i b r a r y . A l l o w s y o u t o s u p p ls u c c e s s p r o c e s s i n g w i t h i n a u n i t .

t a s k T a g o n p a g e 2 6 5 C o r e T a g L i b r a r y . I d e n t i e s a n X Mw a n t t o e x e c u t e .

t r a n s f o r m T a g o n p a g e 2 8 6 S u p p l i e d T a g L i b r a r y ( X S L ) . P e rt r a n s f o r m a t i o n o n a n i n p u t g r o u p r e s u l t t o t h e t a s k ’ s o u t p u t s t r e a m . p a r a m t a g s .




T a g T a g L i b r a r y a n d D e s c r i p t i o n

u n i t T a g o n p a g e 2 6 8 C o r e T a g L i b r a r y . A l l o w s y o u t o g r o uo f w e b j e c t s , t a s k s , o r J a v a c o d e s o t h a e x e c u t e d a s a u n i t .

u p d a t e O b j e c t s T a g o n p a g e 2 7 7

D i r e c t o r y T a g L i b r a r y . U p d a t e s e x i s tL D A P d i r e c t o r y s e r v i c e .

w e b j e c t T a g o n p a g e 2 7 0 C o r e T a g L i b r a r y . I d e n t i e s t h e w e b j t o e x e c u t e .

w h e n T a g o n p a g e 2 8 3 S u p p l i e d T a g L i b r a r y ( J S T L ) . S i m i l a i f t a g , b u t w i t h i n t h e c h o o s e p a r e n t t a g ( r e p r e s e n t s t h e “ i f ” o f i f / e l s e l o g i c ) . P r o v i d e s J S T L sI n f o * E n g i n e t a s k s .

T h e f o l l o w i n g s e c t i o n d e s c r i b e s s o m e r u l e s y o u n e e df o l l o w e d b y t o p i c s d e s c r i b i n g e a c h t a g i n d e t a i l .

A t t r i b u t e a n d V a l u e R u l e s f o r I n f o * Ea n d T a s k s I n a d d i t i o n t o t h e g e n e r a l J S P r u l e s , a f e w a d d i t i o n a l a n d t h e i r d a t a v a l u e s m u s t b e f o l l o w e d i n o r d e r f o r a n p a g e t o b e w e l l - f o r m e d a n d v a l i d :

• A l l v a l u e s f o r a t t r i b u t e s m u s t b e e n c l o s e d i n q u o t a

f o l l o w i n g a r e c o r r e c t : 



H o w e v e r , t h e f o l l o w i n g i s i n c o r r e c t :



• T h e q u o t e s m u s t m a t c h o n e i t h e r s i d e o f t h e a t t r i b ue x a m p l e f r o m a b o v e , t h e f o l l o w i n g i s c o r r e c t :






• I f a p a r t i c u l a r q u o t a t i o n m a r k m u s t a p p e a r w i t h i n q u o t a t i o n m a r k s s u r r o u n d i n g t h e e n t i r e v a l u e c a n n o t b e o f t h e s a m e tF o r e x a m p l e , t h e f o l l o w i n g i s c o r r e c t :









I n s t e a d o f u s i n g d i f f e r e n t q u o t a t i o n m a r k s , y o ut h e i n t e r n a l q u o t a t i o n m a r k . F o r e x a m p l e , t h e f

 • S o m e s p e c i a l c h a r a c t e r s c a n n o t a p p e a r d i r e c t l

a s p a r t o f t h a t v a l u e . T h e s e v a l u e s c a n c a u s e p r oc a u t i o n . T o i n c l u d e t h e s e c h a r a c t e r s a s p a r t o f ae n c o d e d a s f o l l o w s , s i m i l a r t o s p e c i a l c h a r a c t e

S y m b o l N a m e A p p e a r a n c e C h a r a c t e r E n c o d l e s s t h a n < & l t ; g r e a t e r t h a n > & g t ; a m p e r s a n d & & a m p ; a p o s t r o p h e ' & a p o s ;

d o u b l e q u o t e " & q u o t ; • I n f o * E n g i n e m a i n t a i n s t h e @ F O R M , @ S E R V

g r o u p s a s p a r t o f t h e V D B . T h e r e f o r e , y o u c a n a n d @ C O O K I E a s n a m e s o f a n y g r o u p s c r e a t e d i n I n f o * E n g i n e t a s k sa d d i t i o n , t h e A u t h - M a p c o n t e x t g r o u p i s c r e a t e d a s a r e s u la u t h e n t i c a t i o n t a s k . D o n o t u s e t h i s g r o u p n a m u s e r a u t h e n t i c a t i o n g r o u p . F o r a d d i t i o n a l i n f o r A u t h - M a p c o n t e x t g r o u p , s e e C r e d e n t i a l s M a p p i n g o n p a g e 1 1 9 .

N o t e T h e U R I s s h o w n i n t h i s g u i d e u s e t h e f o r w a r d s l a

p a t h s e v e n t h o u g h t h e b a c k s l a s h ( \ ) i s t h e d i r e c t o r y s e p a r a t o r u s e d T s y s t e m s . I n f o * E n g i n e c o r r e c t l y i d e n t i e s a l l s y s t e m U R I s w s l a s h . I f y o u p r e f e r t o u s e t h e b a c k s l a s h f o r N T U R s l a s h i n t h e U R I . T h i s m e a n s t h a t y o u e n t e r t w o \ \ f U R I l o c a t i o n s , s e e t h e s e c t i o n t i t l e d S p e c i f y i n g U R I s a n d U R L s o n .

C o r e L i b r a r y T a g s T o u s e t h e I n f o * E n g i n e t a g s , i n c l u d e t h e t a g l i b d i r e c t i v e , w h i c h i d e n tt a g l i b r a r y a n d p r o v i d e s a p r e x f o r u n i q u e l y i d e ne x a m p l e , t o u s e t h e c o r e I n f o * E n g i n e t a g s a n d i d i e p r e x , i n c l u d e t h e f o l l o w i n g d i r e c t i v e :

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t p r e f i x = " i e " % >

T h e s y n t a x f o r t h e t a g a s s u m e s t h a t y o u h a v e s p e i e p r e x i n t h e t a g l i b d i r e c t i v e . I f y o u s p e c i f y a d i f f e r e n t p r e x , u p l a c e o f i e i n t h e t a g s y n t a x .




d i s p l a y R e s o u r c e T a g T h e d i s p l a y R e s o u r c e t a g e x t r a c t s a s t r i n g f r o m a g r o u p c r e a t e d

G e t - R e s o u r c e w e b j e c t o r d i r e c t l y f r o m a r e s o u r c e b uo n e v a r i a b l e p l a c e h o l d e r i n t h e e x t r a c t e d s t r i n g ( i f y a n d d i s p l a y s t h e r e s u l t i n g s t r i n g .

T h i s t a g i s p r o v i d e d a s a n a l t e r n a t i v e t o u s i n g t h e D i s

N o t e T a g s d o n o t s u p p o r t m u l t i v a l u e d a t t r i b u t e s . T h e r e f o r c o n t a i n s m o r e t h a n o n e v a r i a b l e p l a c e h o l d e r , y o u c a n d i s p l a y R e s o u r c e t a g t o p r o p e r l y d i s p l a y t h e r e s u l t i n g s t r i n g . I n s t e a d , y D i s p l a y - R e s o u r c e w e b j e c t .

S y n t a x 


R e q u i r e A t t r i b u t e s : b u n d l e o r g r o u p I n , a n d k e y .

b u n d l e I n d i c a t e s t h e J a v a c l a s s r e s o u r c e b u n d l e f r o m w h i c

e x t r a c t e d . T h i s a t t r i b u t e i s r e q u i r e d i f n o g r o u p I n a t t r i b u t e i s s u p p l i e d . g r o u p I n

I n d i c a t e s t h e b u n d l e g r o u p f r o m w h i c h t h e m e s s a ga t t r i b u t e i s r e q u i r e d i f n o b u n d l e a t t r i b u t e i s s u p p l i e d .

k e y I n d i c a t e s t h e k e y i n t o t h e r e s o u r c e b u n d l e . T h i s c a na c t u a l J a v a v a r i a b l e r e f e r e n c e n a m e . T h i s i s a r e q u




p a r a m S p e c i e s t e x t t o b e i n s e r t e d i n t o a l o c a l i z e d m e p l a c e h o l d e r . F o r e x a m p l e , i f t h e e x t r a c t e d s t r i h o l d e r f o r t e x t , s u c h a s :

T h e v a l i d a t i o n o f u s e r " { 0 } " h a s f a i l e d .

Y o u c a n i n c l u d e t h e t e x t t h a t r e p l a c e s { 0 } i n t h e p a r a m a t t r i b u t e . F o r e x a m p l e , a s s u m e t h a t y o u i n c l u d e t h e f o l l o w i n

p a r a m = " a b c 1 2 3 "

T h e n , t h e r e s u l t i n g s t r i n g b e c o m e s :

T h e v a l i d a t i o n o f u s e r " a b c 1 2 3 " h a s f a i l e d .

T h i s i s a n o p t i o n a l a t t r i b u t e . I f t h e a t t r i b u t e i s od o e s n o t o c c u r .

I f a n e x t r a c t e d s t r i n g c o n t a i n s m o r e t h a n o n e v au s e t h e D i s p l a y - R e s o u r c e w e b j e c t r a t h e r t h a n t

E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e p r e x . T h e d i s p l a y R e s o u r c e t a g i n t h e e x a m p l e s p e c i e s t h a t t h e m e s s a g e s a s s o c i a t e d w r e t r i e v e d u s i n g t h e G e t - R e s o u r c e w e b j e c t b e d i s p


 < i e : p a r a m n a m e = " B U N D L E "

d a t a = " c o m . i n f o e n g i n e . u t i l . I E R e s o u r c e 

 




f a i l u r e T a g T h e f a i l u r e t a g a l l o w s y o u t o s u p p l y c o d e f o r f a i l u r e p r o c e

T h e c o d e b e t w e e n t h e s t a r t a n d e n d f a i l u r e t a g e x e c u t e s o n l y w h e n t h e b ot h e u n i t d o e s n o t c o m p l e t e s u c c e s s f u l l y . Y o u c a n i n c f a i l u r e t a g b l o c k s i n a u n i t :

• T o i n c l u d e g e n e r a l f a i l u r e p r o c e s s i n g , s p e c i f y t h e f a i l u r e t a g w i t h n o a t t r i b u t e s• T o i n c l u d e c o d e f o r p r o c e s s i n g a s p e c i c e x c e p t i o f a i l u r e t a g

w i t h t h e n a m e o f t h e e x c e p t i o n i n t h e e x c e p t i o n a t t r i b u t e .

I f y o u d o n o t i n c l u d e a f a i l u r e t a g b l o c k f o r p r o c e s s i n g a n e r r o r t h a t o c c u r s i n t h e b o d y o f a u n i t , n o f a i l u r e p r o c e s s i n g o c c u r s a n d t h e p f o l l o w i n g t h e u n i t e n d t a g .

Y o u n e s t t h i s t a g i n u n i t t a g b l o c k s . T o p r o v i d e f a i l u r e c o d e s e t s

y o u c a n s p e c i f y m u l t i p l e f a i l u r e t a g b l o c k s . O n e a c h f a i l u r e t a g , y o u c a n n a m e a s p e c i c e r r o r i n t h e e x c e p t i o n a t t r i b u t e . Y o u c a n n e s t m u l t i p l e w e b j e c t , t a s k , u n i t , a n d p a r a l l e l t a g s i n t h i s t a g b l o c k .

T o m a n a g e e x c e p t i o n s w i t h i n a f a i l u r e t a g b l o c k , y o u c a n i n c l u d e t h e T h r o w - E x c e p t i o n w e b j e c t o n p a g e 4 3 8 . I n c l u d i n g t h i s w e b j e c t i s a w a y p r o p a g a t e ( r e t h r o w ) e x c e p t i o n s t h a t a r e c a u g h t b y f a i l u r e t a g s . Y o u c a n s i m p l y a d d t h e f o l l o w i n g i n t h e b l o c k :



I n c l u d i n g t h i s w e b j e c t c a u s e s t h e c a u g h t e x c e p t i o n t e x c e p t i o n s i s u s e f u l w h e n u n i t b l o c k s a r e n e s t e d o r w h e n y o u w a n t c a u g h t i n a u n i t b l o c k t o b e p a s s e d o n t o t h e p a g e .

I f a n e x c e p t i o n o c c u r s i n a f a i l u r e t a g b l o c k , t h e e x c e p t i o n i s p r o p a g at h e u n i t b l o c k .

S c r i p t l e t s t h a t a r e n e s t e d i n u n i t , i n i t , s u c c e s s , a n d f a i l u r e t a g b l o c k s a r e n o t p r o c e s s e d o n J S P p a g e s t h e s a m e w a y t h e y a r e p r o c e p r o c e s s o r . U s e t h e f o l l o w i n g g u i d e l i n e s t o d e t e r m i n i n t h e s e t a g s :

• Y o u c a n n e s t s c r i p t l e t s w i t h i n t a g b l o c k s i n a s t a n d • Y o u s h o u l d n o t n e s t s c r i p t l e t s i n a n y t a g b l o c k o n a

s t a n d a l o n e t a s k s t h a t c o n t a i n t h e s c r i p t l e t s . Y o u c at h e J S P p a g e b y u s i n g t h e I n f o * E n g i n e t a s k t a g .

F o r a d d i t i o n a l i n f o r m a t i o n a b o u t s c r i p t l e t s , s e e S c r i p t l e t s o n p a g e 2 3 4 .

N o t e E m b e d d e d H T M L i s n o t s u p p o r t e d w i t h i n f a i l u r e t a g s i n J S P s .

S y n t a x

 .




. ( w e b j e c t , t a s k , u n i t , o r p a r a l l e l t a g b l o c k s )

. 


e x c e p t i o n S p e c i e s a J a v a e x c e p t i o n n a m e f o r l i m i t i n g t h ec o d e . W h e n t h i s a t t r i b u t e i s i n c l u d e d , t h e f a i l u r e b l o c k i s e x e c u t e d o n lt h e e x c e p t i o n n a m e d h a s o c c u r r e d .

I f y o u o m i t t h i s a t t r i b u t e , t h e e x c e p t i o n n a m e i“ j a v a . l a n g . E x c e p t i o n . ”

E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s c o r e t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e p r e x . T h e f o l l o w i n g f a i l u r e t a g s p r o v i d e g e n e r a l e r r o r p r o c e s s i n g f o r t h e u n i t a n d I E N o t F o u n d E x c e p t i o n e x c e p t i o n :




< i e : f a i l u r e e x c e p t i o n = " c o m . i n f o e n g i n e . e x c e p t i o n . f a t a l . I E N o

< ! - - s p e c i f i c f a i l u r e p r o c e s s i n g f o r I E N o t F o u n

 < ! - - A d d g e n e r a l f a i l u r e p r o c e s s i n g h e r e . - - >





f o r E a c h T a g T h e f o r E a c h t a g b l o c k a l l o w s y o u t o i t e r a t e t h r o u g h a ng r o u p o n e e l e m e n t a t a t i m e . T h e r e s u l t o f e a c h i t( i n c l u d i n g a l l a t t r i b u t e s o f t h e e l e m e n t ) i n t h e o u r e s u l t i n g e l e m e n t i s o n l y a v a i l a b l e w i t h i n t h e f o r E a c h t a g b l o c k f o r w h i c h p r o d u c e d . Y o u c a n t h e n u s e t h i s o u t p u t g r o u p a s t a g s t h a t a r e n e s t e d i n t h e b l o c k .




E a c h t i m e t h e f o r E a c h e n d t a g i s r e a c h e d , t h e p r o c e s s i n g l o o p s f o r E a c h s t a r t t a g u n t i l t h e r e a r e n o m o r e e l e m e n t s i n t h e ie l e m e n t s h a v e b e e n p r o c e s s e d , t h e l a s t e l e m e n t i n t h e f o r E a c h i n p u t g r o u p i s n o w i n t h e o u t p u t g r o u p ( n a m e d i n t h e g r o u p O u t a t t r i b u t e ) . P r o c e s s i n g c o n t i n t h e n e x t l i n e a f t e r t h e f o r E a c h e n d t a g .

N o t e T h i s t a g c a n n o t b e n e s t e d i n o t h e r I n f o * E n g i n e t a g s , bc a n b e n e s t e d u n d e r t h i s t a g .

S y n t a x




R e q u i r e d A t t r i b u t e s : g r o u p I n a n d g r o u p O u t .

g r o u p I n S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e g r o u p t o u s eo f t h e l o o p , t h e n e x t e l e m e n t ( i n c l u d i n g a l l a t t r i b u tf r o m t h e i n p u t g r o u p i s m o v e d t o t h e o u t p u t g r o u p .


g r o u p O u t S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e g r o u p t o g e n


E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s e s t ac o r e t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e p r e x . T h e e x a m p l e a s s u m e st h e “ e m p l o y e e s ” g r o u p e x i s t s a s a r e s u l t o f a “ C r e a t eT h e f o r E a c h t a g b l o c k i t e r a t e s t h r o u g h t h e “ e m p l o y e e s ” g rt i m e . N e s t e d w i t h i n t h e b l o c k i s t h e D i s p l a y - O b j e c t w

a t t r i b u t e s w i t h e a c h e l e m e n t u s i n g t h e c a p t i o n “ O n e < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i

p r e f i x = " i e " % >

< ! - - c r e a t e i n p u t g r o u p - - > 

< ! - - i t e r a t e g r o u p , d i s p l a y i n g t h e a t t r i b u t e s f o r o n e e




< ! - - i n e a c h i t e r a t i o n - - > < i e : f o r E a c h g r o u p I n = " e m p l o y e e s " g r o u p O u t = " e m p l

< i e : w e b j e c t n a m e = " D i s p l a y - O b j e c t " t y p e = " D S P "

 

g e t S e r v i c e T a g T h e g e t S e r v i c e t a g e s t a b l i s h e s a v a r i a b l e r e f e r e n c e t o t h ( c o m . i n f o e n g i n e . j s p . I n f o E n g i n e ) t h a t i s b e i n g u s e d b y t h e Ic u s t o m t a g s o n a J S P p a g e .

A f t e r y o u d e n e t h e v a r i a b l e , y o u c a n u s e i t i n c o

t h e I n f o * E n g i n e S e r v e r A c c e s s K i t ( S A K ) . F o r ei n f o r m a t i o n , r e t r i e v e g r o u p s , f o r m a t r o w s a n d c o

T h i s t a g a l s o e s t a b l i s h e s i m p l i c i t v a r i a b l e r e f e r e n b y t a g s w i t h i n t h e p a g e ( c o m . i n f o e n g i n e . o b j e c t . f a c t o ) . T h e v a r i a b l e s i n s t a n t i a t e d a r e :

f o r m G r o u p C o n t a i n s a t t r i b u t e s t h a t a r e o b t a i n e d f r o m t h e Ct h a t i s r e c e i v e d w i t h t h e U R L u s e d t o a c c e s s t h a n y H T M L f o r m d a t a t h a t w a s r e c e i v e d a s t h e rr e q u e s t . T h i s i s t h e s a m e i n f o r m a t i o n s t o r e d i n

s e r v e r G r o u p C o n t a i n s a t t r i b u t e s t h a t a r e d e r i v e d f r o m t h e p rf r o m t h e w e b b r o w s e r t o t h e w e b s e r v e r . I t c a n a c c e p t - l a n g u a g e o r a u t h - u s e r . R e f e r t o t h e c u r r e n t w e b - b r o w p r o t o c o l s p e c i c a t i o n t o n d m o r e i n f o r m a t i o n f o u n d i n t h i s g r o u p . T h i s i s t h e s a m e i n f o r m a t ic o n t e x t g r o u p .

c o o k i e G r o u p C o n t a i n s o n e e l e m e n t t h a t h a s a n a t t r i b u t e f o r ed u r i n g t h e c o n n e c t i o n t o t h e J S P p a g e . T h i s i s tt h e C O O K I E c o n t e x t g r o u p .

a u t h G r o u p C o n t a i n s a t t r i b u t e s t h a t p r o v i d e a c r e d e n t i a l s mw e b j e c t e x e c u t e s . T h e m a p c o n t a i n s a u t h e n t i c a d a p t e r s i n e s t a b l i s h i n g c o n n e c t i o n s t o b a c k - e e l e m e n t o f a c r e d e n t i a l s m a p p r o v i d e s a u s e r n at h a t a r e u s e d i n c o n n e c t i n g t o a s p e c i c b a c k - e ni n f o r m a t i o n s t o r e d i n t h e A u t h - M a p c o n t e x t g r o u p .




N o t e O n l y u s e t h i s t a g o n J S P p a g e s ; d o n o t u s e i t i n s t a n d a l

E a c h p a g e c a n o n l y h a v e o n e g e t S e r v i c e t a g o n i t . T h i s t a g c a n n o t b e e m b e d d e d w i t h i n o t h e r I n f o * E n g i

S y n t a x

< i e : g e t S e r v i c e v a r N a m e = " v a r i a b l e _ n a m e " /


R e q u i r e d A t t r i b u t e s : v a r N a m e

v a r N a m e S p e c i e s a J a v a v a r i a b l e n a m e f o r t h e I n f o * E n g i n e v a r i a b l e ; y o u d o n o t n e e d t o d e n e i t b e f o r e s p e c i f yT h i s a t t r i b u t e i s r e q u i r e d .

E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s e s t ac o r e t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e p r e x . T h e e x a m p l e c r e a t e s t“ E M P L O Y E E d a t a ” g r o u p t h r o u g h a q u e r y a n d t h e n i n t h e g r o u p . T o g e t t h e n u m b e r o f r o w s , t h e e x a m p l e g e t S e r v i c e t a g t o i d e n t i f y t h e s e r v i c e a s “ i e O b j ” a n d t h e n u s e s t h e g e t E l e m e n t C o u n t m e t h o d f r o m c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . G r o u p c l a s s t o r e t r i e v e t h e n u m b

o f r o w s : < % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " t r u e " e r r o r P a g e = " .


< h t m l > 

< ! - - p e r f o r m a q u e r y - - > 

 

< ! - - d i s p l a y h o w m a n y e l e m e n t s w e r e r e t u r n e d - - > 

 S e a r c h r e t u r n e d < % = i e O b j . g e t E l e m e n t C o u n t ( ) % > e m p l o y e e s . e m p




 < / h t m l >

g e t V a l u e T a g T h e g e t V a l u e t a g r e t r i e v e s t h e s t r i n g v a l u e o f t h e s p e c i e l e m e n t i n t h e i n p u t g r o u p .

T h i s t a g c a n b e n e s t e d i n o t h e r I n f o * E n g i n e t a g s

D o n o t i m b e d t h i s t a g i n s c r i p t l e t s ; d o i n g s o c a u s t a g i s r e a d a s p l a i n t e x t . F o r e x a m p l e , t h e f o l l o w i

< % f l o a t t o t a l = 0 ; % >

 < % t o t a l + = ; % > 

I n s t e a d , w i t h i n a s c r i p t l e t y o u c a n u s e t h e g e t A t t r i b u t e V a l u e m e t h o d . F o r a n e x a m p l e t h a t u s e s t h i s m e t h o d , s e e t h e “ E x a m p l e

S y n t a x

< i e : g e t V a l u e n a m e = " a t t r _ n a m e " g r o u p I


R e q u i r e d A t t r i b u t e s : n a m e

g r o u p I n S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e g r o u p t o

T h i s a t t r i b u t e i s o p t i o n a l . I f y o u o m i t t h i s a t t r i bt h e V D B i s u s e d .

n a m e S p e c i e s t h e n a m e o f t h e a t t r i b u t e w h o s e v a l u e r s t e l e m e n t i n t h e I n f o * E n g i n e i n p u t g r o u p .





E x a m p l e s

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s e s t a

c o r e t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e p r e x . T h e e x a m p l e a s s u m e st h e “ e m p l o y e e s ” g r o u p e x i s t s a s a r e s u l t o f a “ C r e a t e g e t V a l u e t a g s a r e n e s t e d w i t h i n t a b l e H T M L t a g s , p r o d u c i n g v a l u e s f oi n t h e t a b l e r o w s t h a t a r e d i s p l a y e d .


< ! - - c r e a t e i n p u t g r o u p - - > 

< ! - - i t e r a t e g r o u p , d i s p l a y i n g t h e s a l a r y f o r o n e e m p l < ! - - i n e a c h i t e r a t i o n - - > < t a b l e > < t r > < t d > E m p l o y e e N a m e < / t d > < t d > S a l a r y < / t d > < / t r > < t d > < / t d > < t d > $ < / t d >

< / t r > < / t a b l e >

T h e f o l l o w i n g e x a m p l e p a g e u s e s t h e g e t V a l u e t a g s t o d i s p l a y s e l e c t e d a t t r ii n e a c h e l e m e n t a n d u s e s a s c r i p t l e t t o c a l c u l a t e a r u n t h e s a l a r y t o t a l u s e s t h e I n f o * E n g i n e g e t A t t r i b u t e V a l u e m e t h o d : < % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " .

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b /p r e f i x = " i e " % >

< ! - - c r e a t e a g r o u p t h a t c o n t a i n s e m p l o y e e n a m e , n u m b e r

< h t m l > 

 < % f l o a t t o t _ s a l = 0 ; % >

< ! - - i t e r a t e g r o u p , d i s p l a y i n g t h e s a l a r y f o r o n e e m p l o y< ! - - i n e a c h i t e r a t i o n a n d c a l c u l a t i n g t h e t o t a l s a l a r y - E m p l o y e e N u m b e r : e m p l o y e e n a m e : 




 s a l a r y : $ < h r > < %

S t r i n g s s a l = p i e . g e t A t t r i b u t e V a l u e ( " o n e - e l e m t o t _ s a l + = F l o a t . p a r s e F l o a t ( ( ( s s a l ! = n u l l & &

? s s a l : " 0 " ) ) ;

% > < ! - - D i s p l a y t h e s a l a r y t o t a l f o r a l l e m p l o y e e i n t h e S a l a r y T o t a l : $ < % = t o t _ s a l % > 

< / h t m l > 

i n i t T a g T h e i n i t t a g s u p p l i e s t h e i n i t i a l i z a t i o n f o r a u n i t . T h e e n d i n i t t a g s e x e c u t e s r s t i n a u n i t e a c h t i m e t h e u n i t i n i t c o d e b l o c k a l l o w s y o u t o i d e n t i f y s p e c i c c o d e t ht h e u n i t i s e x e c u t e d , e v e n i f t h e c o d e b l o c k i s n o t e x a m p l e , i n t h e i n i t i a l i z a t i o n c o d e , y o u c o u l d s a vt h a t a r e m a n i p u l a t e d i n t h e u n i t . T h e n , i f a n e r r o r f a i l u r e b l o c k c o u l d r e s t o r e t h e o b j e c t s t o t h i s i n i t i a l s

I f a f a i l u r e o c c u r s i n a n i n i t t a g b l o c k , t h e e r r o r i s r e t u r n e d t o t w h i c h t h e u n i t w a s e x e c u t e d . F o r e x a m p l e , a s s u mn e s t e d i n a n o t h e r u n i t a s f o l l o w s :

< ! - - T o p o f p a g e - - > : : < ! - - F i r s t U n i t - - > 

 < ! - - I n i t i a l i z a t i o n o f F i r s t U n i t - - > < ! - - E r r o r s o c c u r r i n g h e r e a r e p a s s e d b a c k t o t



< ! - - B o d y o f F i r s t U n i t - - > … … 

< ! - - N e s t e d U n i t - - > 

 < ! - - I n i t i a l i z a t i o n o f N e s t e d U n i t - - >




< ! - - E r r o r s o c c u r r i n g h e r e a r e p a s s e d b a c k t o f i r s t u

< ! - - B o d y o f N e s t e d U n i t - - > … … 

 < ! - - N e s t e d U n i t f a i l u r e p r o c e s s i n g a c c e s s e d w h e n < ! - - t h e r e i s a n e r r o r i n t h e b o d y o f t h e n e s t e d u n i t - - > 

< ! - - E n d o f N e s t e d U n i t - - > 

 < ! - - F i r s t U n i t f a i l u r e p r o c e s s i n g a c c e s s e d w h e n - < ! - - t h e r e i s a n e r r o r i n t h e b o d y o f t h e f i r s t u n i t -

 < ! - - E n d o f F i r s t U n i t - - > 

< ! - - P a g e E r r o r P r o c e s s i n g - - > : : < ! - - E n d o f P a g e - - >

I f t h e i n i t i a l i z a t i o n o f t h e n e s t e d u n i t f a i l s , t h e f a i l u r et h e b o d y o f t h e r s t u n i t . I f t h e i n i t i a l i z a t i o n o f t h e r s p r o c e s s e d b y t h e p a g e , w h i c h m a y a u t o m a t i c a l l y s e n

S c r i p t l e t s t h a t a r e n e s t e d i n u n i t , i n i t , s u c c e s s , a n d f a i l u r e t a g b l o c k s a r e n o t p r o c e s s e d o n J S P p a g e s t h e s a m e w a y t h e y a r e p r o c e p r o c e s s o r . U s e t h e f o l l o w i n g g u i d e l i n e s t o d e t e r m i n i n t h e s e t a g s :

• Y o u c a n n e s t s c r i p t l e t s w i t h i n t a g b l o c k s i n a s t a n d • Y o u s h o u l d n o t n e s t s c r i p t l e t s i n a n y t a g b l o c k o n a

s t a n d a l o n e t a s k s t h a t c o n t a i n t h e s c r i p t l e t s . Y o u c a

t h e J S P p a g e b y u s i n g t h e I n f o * E n g i n e t a s k t a g . F o r m o r e i n f o r m a t i o n , s e e S c r i p t l e t s o n p a g e 2 3 4 .

N o t e E m b e d d e d H T M L i s n o t s u p p o r t e d w i t h i n i n i t t a g s i n J S P s .

Y o u n e s t t h i s t a g i n u n i t t a g b l o c k s .

Y o u c a n n e s t m u l t i p l e w e b j e c t , t a s k , u n i t , a n d p a r a l l e l t a g s i n t h i s t a g b l o c k .




S y n t a x



. . ( w e b j e c t , t a s k , u n i t , o r p a r a l l e l t a g b l o c k s )

. 

p a r a l l e l T a g T h e p a r a l l e l t a g a l l o w s y o u t o d e n e a s e t o f w e b j e c t s o c o n c u r r e n t l y .

E a c h w e b j e c t a n d e a c h t a s k t h a t i s n e s t e d i n a p a r a l l e l t a g b l o c k i s e x e c u t ei n i t s o w n e n v i r o n m e n t a t t h e s a m e t i m e a s t h e o t b l o c k . A f t e r a l l o f t h e w e b j e c t s a n d t a s k s s u c c e s so f t h e i n d i v i d u a l p r o c e s s e s a r e m e r g e d w i t h t h e VP r o c e s s i n g c o n t i n u e s s t a r t i n g w i t h t h e l i n e a f t e r t p a r a l l e l e n d t a g .

I f a n e x c e p t i o n o c c u r s w i t h i n t h e p a r a l l e l b l o c k , b y d e f a u l t t h e e x c e p p r o p a g a t e d o u t s i d e t h e p a r a l l e l b l o c k a f t e r t h e p a r e n t V D B h a s ba w e b j e c t o r t a s k w i t h i n a p a r a l l e l t a g b l o c k f a i l s , y o u s h o u l d a s s c o n t e n t o f t h e r e s u l t i n g V D B i s u n p r e d i c t a b l e .

Y o u c a n n e s t t h i s t a g i n u n i t , i n i t , s u c c e s s , o r f a i l u r e t a g b o c k s . Y o u c a n a m u l t i p l e w e b j e c t a n d t a s k t a g s i n t h i s t a g b l o c k .

N o t e D i s p l a y w e b j e c t s c a n n o t b e n e s t e d i n a p a r a l l e l t a g b o c k .

S y n t a x

 . . ( w e b j e c t o r t a s k t a g b l o c k s ) .



E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s

t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e p r e x . T h e f o l l o w i n g p a r a l l e l t a g b l o c k e x e c u t e s t w o Q u e r y - O b j e c t w e b j e c t s a n d a t a s k a







< i e : p a r a m n a m e = " I N S T A N C E " d a t a = " j n d i A d a p t e r



 



 





I f t h i s p a r a l l e l t a g b l o c k i s p a r t o f a J S P p a g e , a l l f o u r o f t h e g b l o c k a r e a v a i l a b l e t o a n y d i s p l a y w e b j e c t s t h a t f o l l o i n a t a s k , y o u w o u l d u s e t h e R e t u r n - G r o u p s w e b j e c t ag r o u p s a v a i l a b l e t o d i s p l a y w e b j e c t s .

p a r a m T a g T h e p a r a m t a g d e n e s a p a r a m e t e r f o r u s e w i t h i n w e b j e c t t a g s , t a s k t a g s a n d d i r e c t o r y s e r v i c e t a g s :

• W e b j e c t p a r a m e t e r s p r o v i d e t h e i n p u t c r i t e r i a f o r ta r e s p e c i e d .

• T a s k p a r a m e t e r s p r o v i d e a w a y t o s e t t h e f o l l o w i n ○ @ F O R M c o n t e x t g r o u p v a r i a b l e s s o t h a t t h e y a r e○ T h e V D B g r o u p s t h a t a r e a v a i l a b l e t o t h e t a s k . ○ T h e V D B g r o u p s t h a t a r e a v a i l a b l e w h e n t h e t a s k

• D i r e c t o r y s e r v i c e p a r a m e t e r s p r o v i d e t h e n a m e s oi n p u t t o a n d o u t p u t f r o m c r e a t i n g , u p d a t i n g , q u e r y s e r v i c e e n t r i e s .

I n e a c h c a s e , t h e p a r a m e t e r r e q u i r e m e n t s a r e d i c t a t e dt a s k s , a n d d i r e c t o r y s e r v i c e a c t i o n s w h e r e t h e y a r e s pi n f o r m a t i o n , s e e t h e d e s c r i p t i o n o f t h e s p e c i c w e b j ea c t i o n y o u w a n t t o a c c o m p l i s h .




Y o u c a n i n c l u d e e x p r e s s i o n s a s a t t r i b u t e v a l u e s o p a r a m t a g . F o r m o r e i n f o r m a t i o n , s e e E x p r e s s i o n s o n p a g e 2 3 5 .

Y o u c a n n e s t t h i s t a g i n t h e w e b j e c t , t a s k , c r e a t e O b j e c t s , l i s t O b j e c t s , q u e r y O b j e c t s , a n d u p d a t e O b j e c t s t a g s .

S y n t a x

< i e : p a r a m n a m e = " P A R A M E T E R _ N A M E " d a t a = " v a l u e _ l i s t " d e l i m = " d e l i m i t e r " d e f a u l t = " d e f a u l t _ v a l u e " e l e m e n t S e p a r a t o r = " c h a r a c t e r " v a l u e S e p a r a t o r = " c h a r a c t e r " / >


R e q u i r e d a t t r i b u t e s : n a m e a n d d a t a .

d a t a S p e c i e s o n e o r m o r e d a t a v a l u e s t o a s s i g n t o t h n a m e a t t r i b u t e . I n c l u d e t h e d a t a v a l u e s w i t h i n q u o t a to f d a t a v a l u e s t h a t y o u c a n a s s i g n a r e d e t e r m i n

F o r p a r a m e t e r s t h a t c a n h a v e m u l t i p l e d a t a v a l uc o m m o n w a y t o e n t e r m u l t i p l e d a t a v a l u e s i s b p a r a m t a g s , a l l w i t h t h e s a m e n a m e a t t r i b u t e a n d d i f f e r e n t d a t a a t t r i b u t e s .

Y o u c a n a l s o i n c l u d e m u l t i p l e v a l u e s i n t h e d a t a a t t r i b u t e b y s e p a r a t i n

v a l u e s u s i n g a d e l i m i t e r a n d i n c l u d i n g t h e s e p a d e l i m a t t r i b u t e . T o u st h e c o m m a a s a v a l u e s e p a r a t o r , u s e t h e f o l l o w d a t a = " v a l u e 1 , v a l u e 2 , … , v a l u e N " d e l i m

F o r e x a m p l e , t o r e t u r n m u l t i p l e g r o u p s i n t h e R i n c l u d e e i t h e r t h e f o l l o w i n g t w o p a r a m t a g s :

< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " c o n s u l t a n t s

o r o n e p a r a m t a g t h a t i n c l u d e s t h e d e l i m a t t r i b u t e :

< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " e m p l o y e e s , c o

T h e d a t a a t t r i b u t e i s r e q u i r e d .




d e f a u l t S p e c i e s a l i t e r a l s t r i n g , w h i c h i s t h e d e f a u l t v a l u e e x p r e s s i o n r e t u r n s n o v a l u e s . W h e n y o u s p e c i f y t hi n c l u d e t h e d e f a u l t v a l u e w i t h i n q u o t a t i o n m a r k s . W h e n e v e r y o u i n c l u d e s u b s t i t u t i o n e x p r e s s i o n s i n d a t a a t t r i b u t e , y o u s h o u l d i n c l u d e a d e f a u l t f o r t h e e x p r e s s i o n . F o r e x a p a r a m t a g s e t s t h e d e f a u l t f o r t h e A T T R I B U T E p a r a m e t e r

< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = ” $ ( @ F O R M [ ] a t t r [

T h i s a t t r i b u t e i s o p t i o n a l .

d e l i m D e n e s t h e d e l i m i t i n g s y m b o l t h a t I n f o * E n g i n e u sv a l u e s i n t h e d a t a a t t r i b u t e . W h e n y o u s p e c i f y t h i s a t t r i b u t et h e s y m b o l w i t h i n q u o t a t i o n m a r k s . F o r e x a m p l e , ia s t h e d e l i m i t e r , t h e s y n t a x f o r t h e d a t a a n d d e l i m a t t r i b u t e s i s : d a t a = " v a l u e 1 , v a l u e 2 , … , v a l u e N " d e l i m = " , " T h e f o l l o w i n g p a r a m t a g e x a m p l e h a s t h r e e v a l u e s d e n e d i n d a t a a t t r i b u t e a n d u s e s t h e c o m m a a s t h e d e l i m i t e r :

< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " e n a m e , p h o n e , t i

B y u s i n g m u l t i p l e p a r a m t a g s t h a t h a v e o n l y o n e v a l u e i n e a c h d a t a a t t r i b u t e , t h i s s a m e p a r a m e t e r c o u l d a l s o h a v e b e e n s p e c i e d

 

 I n a n a c t u a l w e b j e c t , t h e r e s u l t i n g p a r a m e t e r i n b o tt h a t t h e w e b j e c t e x p e c t s t o r e c e i v e e m p l o y e e n a m et e l e p h o n e n u m b e r ( p h o n e ) , a n d e m p l o y e e t i t l e ( t i t g r o u p o f d a t a r e t u r n e d f r o m t h e d a t a r e p o s i t o r y .

T h i s a t t r i b u t e i s o p t i o n a l .




e l e m e n t S e p a r a t o r S p e c i e s t h e e l e m e n t s e p a r a t o r t h a t I n f o * E n g i s u b s t i t u t i o n e x p r e s s i o n s t h a t a r e i n t h e d a t a a t t r i b u t e . T h e s p e c i e d i s u s e d w h e n c o n c a t e n a t i n g t o g e t h e r a t t r i b u t e v( r o w s ) . T h e s e l e c t i o n o f m u l t i p l e e l e m e n t s c a nc o n t a i n s t h e a s t e r i s k ( * ) a s t h e e l e m e n t s e l e c t o

B y d e f a u l t , I n f o * E n g i n e u s e s t h e s e m i c o l o n a s i n f o r m a t i o n a b o u t d e n i n g s u b s t i t u t i o n e x p r e s D y n a m i c P a r a m eV a l u e S u b s t i t u t i o n o n p a g e 4 0 .

T h e f o l l o w i n g p a r a m t a g i n c l u d e s a s u b s t i t u t i o n e x p r e s s d a t a a t t r i b u t e t h a t h a s t h e a s t e r i s k a s t h e e l e m e n t s e ls e p a r a t o r t o “ # ” :

< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = ” $ ( g r p 1 [ * ] a t

T h i s a t t r i b u t e i s o p t i o n a l . n a m e

S p e c i e s a p a r a m e t e r n a m e t o w h i c h a d a t a v a l p a r a m e t e r n a m e w i t h i n q u o t a t i o n m a r k s . T h e nc a s e s e n s i t i v e , b u t a r e d o c u m e n t e d u s i n g u p p e


v a l u e S e p a r a t o r S p e c i e s t h e v a l u e s e p a r a t o r t h a t I n f o * E n g i n e s u b s t i t u t i o n e x p r e s s i o n s t h a t a r e i n t h e d a t a a t t r i b u t e . T h e s p e c i e d i s u s e d w h e n c o n c a t e n a t i n g t o g e t h e r m u l t i p l e vo n e a t t r i b u t e l o c a t i o n . T h e l o c a t i o n i s d e n e d ba n e l e m e n t ( r o w ) p a i r t h a t r e s u l t s f r o m p r o c e s sM u l t i p l e v a l u e s c a n o c c u r w h e n t h e e x p r e s s i o nt h e v a l u e s e l e c t o r .

B y d e f a u l t , I n f o * E n g i n e u s e s t h e c o m m a a s t h ei n f o r m a t i o n a b o u t d e n i n g s u b s t i t u t i o n e x p r e s D y n a m i c P a r a m eV a l u e S u b s t i t u t i o n o n p a g e 4 0 .

T h e f o l l o w i n g p a r a m t a g i n c l u d e s a s u b s t i t u t i o n e x p r e s s d a t a a t t r i b u t e t h a t h a s t h e a s t e r i s k a s t h e v a l u e s e l e c t o “ | ” :

< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = ” $ ( g r p 1 [ 0 ] a tT h i s a t t r i b u t e i s o p t i o n a l .




E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e o r t a s k

I n f o * E n g i n e c o r e t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h i e p r e x . T h e p a r a m t a g s d e n e t w o p a r a m e t e r s f o r t h e C o p y - G r o u p w e b j e c t :


 



r e s e t S e r v i c e T a g T h e r e s e t S e r v i c e t a g r e s e t s t h e I n f o * E n g i n e o b j e c t ( c o m . i n f o e n g i n e . j s p . I n f o E n g i n e ) t h a t i s b e i n g u s e d b y t h e I n f o c u s t o m t a g s o n a J S P p a g e o r i n a s e s s i o n . I f y o u i n c l u p a g e s c o p e , t h e r e s e t o b j e c t e x i s t s o n l y w h i l e t h e p a g e e x e c u t e s . I f y o u s p e s e s s i o n s c o p e , t h e r e s e t o b j e c t i s a v a i l a b l e t o a l l p a g e s i n t h e s e s s i o n .

W h e n y o u r e s e t a n I n f o * E n g i n e o b j e c t u s i n g a p a g e s c o p e , t h e f o l l o w i n g t h i nh a p p e n :

• A l l V D B g r o u p s t h a t w e r e a v a i l a b l e t o t h e p a g e a r en e w o b j e c t .

• A l l V D B g r o u p s c r e a t e d a f t e r t h e o b j e c t i s r e s e t a r e

( e v e n i f t h e p a g e d i r e c t i v e f o r t h e p a g e i n c l u d e s s e s s i o n = T R U E ) . Y o u c a n c o p y a g r o u p f r o m a s e s s i o n V D B t o a p a g e p a g e V D B t o a s e s s i o n V D B u s i n g t h e a d d G r o u p m e t h o d f r o m t h e c o m . i n f o e n g i n e . o b j e c t . f a c t o r y . G r o u p c l a s s .

W h e n y o u r e s e t a n I n f o * E n g i n e o b j e c t u s i n g a s e s s i ow e r e a v a i l a b l e t o t h e s e s s i o n a r e n o l o n g e r a v a i l a b l e

U n l e s s y o u e x p l i c i t l y s a v e a n e x i s t i n g I n f o * E n g i n e ol o n g e r a v a i l a b l e w h e n y o u r e s e t t h e o b j e c t u s i n g t h e r e s e t S e r v i c e t a g .

I f y o u s u p p l y a n e w v a r i a b l e n a m e f o r t h e r e s e t o b j e cc a n b e r e f e r e n c e d b y t h e n a m e i n c o d e t h a t u s e s m e t hS e r v e r A c c e s s K i t ( S A K ) . F o r e x a m p l e , y o u c a n a c c eg r o u p s , f o r m a t r o w s a n d c o l u m n s , a n d s o o n .

T h e r e s e t S e r v i c e t a g c a n b e v e r y u s e f u l i n t h e f o l l o w i n g s i t u a

• A v o i d i n g c o n i c t s w h e n a c c e s s i n g g r o u p s i n t h e Vt h i s w h e n a n a p p l i c a t i o n t h a t c o n s i s t s o f m u l t i p l e J a n d t h e r e c a n b e m u l t i p l e r e q u e s t s f o r V D B g r o u p sE n s u r i n g t h a t e a c h r e q u e s t g e t s b a c k t h e i n t e n d e d gu n l e s s y o u r e s e t t h e I n f o * E n g i n e o b j e c t f o r e a c h p a




r e s t r i c t t h e g r o u p s a v a i l a b l e i n t h e V D B t o t h o ss e t t i n g o t h e r i n f o r m a t i o n t o a s e s s i o n s c o p e .

• C l e a n i n g u p t h e V D B . W h e n y o u r a p p l i c a t i o n t h a t a r e n o l o n g e r n e e d e d b y t h e a p p l i c a t i o n , y ou p r e s o u r c e s .

N o t e O n l y u s e t h i s t a g o n J S P p a g e s ; d o n o t u s e i t i n s t a

Y o u c a n i n c l u d e m u l t i p l e r e s e t S e r v i c e t a g s o n t h e s a m e p a g e a s l o n go m i t t h e v a r i a b l e n a m e o r s p e c i f y u n i q u e o b j e c t n s a m e v a r i a b l e n a m e o n m u l t i p l e r e s e t S e r v i c e t a g s , o r c o n v e r s e l y o n a g e t S e r v i c e t a g a n d a r e s e t S e r v i c e t a g .

T h i s t a g c a n n o t b e e m b e d d e d w i t h i n o t h e r I n f o * E

S y n t a x




v a r N a m e S p e c i e s a J a v a v a r i a b l e n a m e f o r t h e I n f o * E n gt h e v a r i a b l e ; d o n o t d e n e i t b e f o r e s p e c i f y i n g tn a m e c a n n o t b e t h e s a m e n a m e s p e c i e d i n e i t h g e t S e r v i c e t a g o r o t h e r a s s o c i a t e d r e s e t S e r v i c e t a g s .

T h i s a t t r i b u t e i s o p t i o n a l . I f o m i t t e d , t h e o b j e c tS A K m e t h o d s .

s c o p e S p e c i e s w h e r e t h e I n f o * E n g i n e o b j e c t i s s t o r ea r e :

P A G E — S e t s t h e o b j e c t s c o p e t o t h e p a g e i n w h i c h

S E S S I O N — S e t s t h e o b j e c t s c o p e t o t h e s e s s i o n i n w

T h i s a t t r i b u t e i s o p t i o n a l . I f o m i t t e d , t h e v a l u e I n f o * E n g i n e o b j e c t i n u s e . I f s e s s i o n = t r u e o n t h e p a g e d i r e c t i v e , t h e n

t h e s e s s i o n I n f o * E n g i n e o b j e c t i s r e s e t . O t h e r wo b j e c t i s r e s e t .




E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e h a s a s

f r o m t h e I n f o * E n g i n e c o r e t a g l i b r a r y a n d t h a t t h e t a i e p r e x . T h e e x a m p l e e x p a n d s o n t h e g e t S e r v i c e t a g e x a m p l e w h i c h g e t s t h e n u m b t h e “ E M P L O Y E E d a t a ” . T h e e x a m p l e r e s e t s t h e s e r vt h e r e s e t S e r v i c e t a g a n d c o n t i n u e s o n w i t h o t h e r q u e r i e s :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " t r u e " e r r o r P a g e = " .


< h t m l > < ! - - p e r f o r m a q u e r y - - > 

 

< ! - - d i s p l a y h o w m a n y e l e m e n t s w e r e r e t u r n e d - - > 

 S e a r c h r e t u r n e d < % = i e O b j . g e t E l e m e n t C o u n t ( ) % > e m p l o y e e s .

< ! - - r e s e t t h e V D B f o r t h e p a g e - - > < ! - - p e r f o r m a d d i t i o n a l q u e r i e s - - >

.

.

. < / h t m l >

N o t e B e c a u s e t h e r e s e t S e r v i c e t a g o n l y r e s e t s t h e s e r v i c e f o r r e m a i n d e p a g e , a t t h e e n d o f t h e p a g e p r o c e s s i n g , t h e s e s s i o n V

“ E M P L O Y E E d a t a ” g r o u p .

s u c c e s s T a g T h e s u c c e s s t a g a l l o w s y o u t o s u p p l y c o d e f o r s u c c e s s p r o cT h e c o d e b e t w e e n t h e s t a r t a n d e n d s u c c e s s t a g e x e c u t e s o n l y w h e n t h e b ot h e u n i t c o m p l e t e s s u c c e s s f u l l y .




I f a f a i l u r e o c c u r s i n t h i s b l o c k , t h e e x c e p t i o n i s pu n i t b l o c k .

N e s t t h i s t a g i n u n i t t a g b l o c k s . Y o u c a n a l s o n e s t m u l t i p l e w e b j e c t , t a s k , u n i t , a n d p a r a l l e l t a g s i n t h i s t a g b l o c k .

S c r i p t l e t s t h a t a r e n e s t e d i n u n i t , i n i t , s u c c e s s , a n d f a i l u r e t a g b l o c k s a r e n o t p r o c e s s e d o n J S P p a g e s t h e s a m e w a y t h e y a r e p r p r o c e s s o r . U s e t h e f o l l o w i n g g u i d e l i n e s t o d e t e r i n t h e s e t a g s :

• Y o u c a n n e s t s c r i p t l e t s w i t h i n t a g b l o c k s i n a s t• Y o u s h o u l d n o t n e s t s c r i p t l e t s i n a n y t a g b l o c k

s t a n d a l o n e t a s k s t h a t c o n t a i n t h e s c r i p t l e t s . Y o t h e J S P p a g e b y u s i n g t h e I n f o * E n g i n e t a s k t a g .

F o r m o r e i n f o r m a t i o n , s e e S c r i p t l e t s o n p a g e 2 3 4 . N o t e E m b e d d e d H T M L i s n o t s u p p o r t e d w i t h i n s u c c e s s t a g s i n J S P s .

S y n t a x

 . . ( w e b j e c t , t a s k , u n i t , o r p a r a l l e l t a g b l o c k s ) .



E x a m p l e S e e t h e u n i t t a g e x a m p l e o n p a g e 2 6 9 .

t a s k T a g T h e t a s k t a g i d e n t i e s a n X M L t a s k t h a t y o u w a n t t o e

Y o u c a n n e s t t h i s t a g i n u n i t , i n i t , p a r a l l e l , s u c c e s s , a n d f a i l u r e t a g b l o c k s .

Y o u c a n s p e c i f y t h e p a r a m e t e r s f o r a t a s k b y n e s t p a r a m t a g w i t h i n t h i s t b l o c k . T a s k p a r a m e t e r s p r o v i d e a w a y t o s e t t h e f

• T h e V D B g r o u p s t h a t a r e a v a i l a b l e t o t h e t a s k . p a r a m e t e r s a l l o w s y o u t o d e n e w h i c h g r o u p s a

• T h e V D B g r o u p s t h a t a r e a v a i l a b l e w h e n t h e t G R O U P _ O U T t a s k p a r a m e t e r s a l l o w s y o u t o t o t h e V D B o f t h e t a s k i n w h i c h t h e n e s t e d t a s k

B y d e f a u l t , t h e G R O U P _ O U T p a r a m e t e r o n t h t h e g r o u p s t h a t a r e r e t u r n e d . I f t h e r e i s n o G R O t h e n t h e l a s t g r o u p a d d e d t o t h e V D B i s r e t u r n e




W h e n m u l t i p l e g r o u p s a r e r e t u r n e d t h r o u g h t h e l a sc a s e w i t h t h e R e t u r n - G r o u p s w e b j e c t ) , s p e c i f y i n g G R O U P _ O U T t a s k p a r a m e t e r l i m i t s t h e g r o u p s t h t h e c a l l i n g t a s k .

• @ F O R M c o n t e x t g r o u p v a r i a b l e s s o t h a t t h e y a r e @ F O R M c o n t e x t g r o u p v a r i a b l e i s s e t f o r e a c h p a rt h a t y o u s p e c i f y i n a p a r a m t a g n e s t e d i n a t a s k t a g b l o c k . T h i s i n c l u d e s aG R O U P _ I N a n d G R O U P _ O U T p a r a m e t e r s s p e c i

B e c a u s e t h e @ F O R M g r o u p G R O U P _ I N v a r i a b l e V D B g r o u p s t h a t a r e i n i t i a l l y a v a i l a b l e i n t h e t a s k , n a m e s b y r e a d i n g t h e v a l u e s f r o m t h e @ F O R M g r o

N o t e U s i n g t h i s t a g i n c o n j u n c t i o n w i t h t h e I n f o * E n g i n e t a s . s e c r e t . t e x t

o r . s e c r e t . t e x t 2 a n d . s e c r e t . a l g o r i t h m p r o p e r t i e s a l l o w s f o r v a l i d a t i o n t o o c c u r b e f o r e a r e m o t e p r o c e s s o r e x e c u t ea b o u t c o n g u r i n g t h e s e p r o p e r t i e s , s e e t h e I n f o * E n g i n

S y n t a x

W h e n t h e r e a r e p a r a m e t e r s , y o u c a n u s e t h e f o l l o w i n

< i e : t a s k u r i = " u r i _ t a s k _ s o u r c e " p r o c e s s o r = " p r o c e s s o r 1 " p r o c e s s o r = " p r o c e s s o r 2 " . . . p r o c e s s o r = " p r o c e s s o r n " r e s u m a b l e = " [ t r u e | f a l s e ] " >

.

. ( N e s t t a s k p a r a m e t e r s u s i n g p a r a m t a g s )

. 

W h e n t h e r e a r e n o p a r a m e t e r s , y o u c a n u s e t h e f o l l o w

< i e : t a s k u r i = " u r i _ t a s k _ s o u r c e " p r o c e s s o r = " p r o c e s s o r 1 "

p r o c e s s o r = " p r o c e s s o r 2 " . . .

p r o c e s s o r = " p r o c e s s o r n " r e s u m a b l e = " [ t r u e | f a l s e ] " / >


R e q u i r e d a t t r i b u t e : u r i




p r o c e s s o r S p e c i e s o n e o r m o r e n a m e s o f r e m o t e I n f o * E nt h e t a s k c a n b e s e n t f o r e x e c u t i o n . E a c h n a m e y p r o c e s s o r t h a t i s a v a i l a b l e f r o m y o u r c u r r e n t e ns p e c i f y i n t h i s a t t r i b u t e a r e t h o s e s e r v i c e n a m e t h r o u g h t h e I n f o * E n g i n e P r o p e r t y A d m i n i s t r a

T h i s a t t r i b u t e i s o p t i o n a l . W h e n i t i s n o t s p e c i t a s k t a g i s e x e c u t e d b y t h e t a s k p r o c e s s o r t h a t i s c p a g e o r t a s k t h a t c o n t a i n s t h e t a s k t a g . F o r J S P p a g e s , t h e t a s k pu s e d b y d e f a u l t i s r u n n i n g i n t h e J S P e n g i n e . T e x e c u t e i n t h e I n f o * E n g i n e S e r v e r t a s k p r o c e s e n g i n e ) , y o u m u s t i n c l u d e t h e p r o c e s s o r a t t r i b u t e t h a t i d e n t i e s t h t a s k p r o c e s s o r . F o r e x a m p l e , i f t h e t a s k p r o c e so f “ c o m . m y C o m p a n y . s e r v e r . t a s k P r o c e s s o r ” y

p r o c e s s o r a t t r i b u t e : p r o c e s s o r = " c o m . m y C o m p a n y . s e r v e r . t a s k P r o c e s s o

I f y o u r c u r r e n t e n v i r o n m e n t h a s o t h e r t a s k p r o y o u c a n d i r e c t t h e t a s k t o c h o o s e o n e o f t h o s e t at h e p r o c e s s o r n a m e s o n p r o c e s s o r a t t r i b u t e s i n t h e o r d e r y o u w s e l e c t e d . F o r e x a m p l e , a s s u m e t h a t y o u r s i t e h aa n d “ y y y . t a s k P r o c e s o r ” f o r y o u r u s e , a n d t h a t t h e t a s k o n “ y y y . t a s k P r o c e s s o r ” . T o a c c o m p l i sp r o c e s s o r a t t r i b u t e s i n t h e t a s k t a g :

< i e : t a s k u r i = " t a s k 1 . x m l " p r o c e s s o r = " y y y . t a s k P r

" x x x . t a s k P r o c e s s o r " p r o c e s s o r = " z z z . t a s k P r o c e s s o N o t i c e t h a t t h e t h i r d p r o c e s s o r n a m e d i s t h e “ z zi f b o t h o f t h e o t h e r p r o c e s s o r s a r e n o t a v a i l a b l e

r e s u m a b l e I n d i c a t e s w h e t h e r t h e V D B s t a t e m u s t b e s a v e dn a m e d i n t h i s t a s k t a g . T h i s a t t r i b u t e i s o n l y u s e d w h e n e x e c u t i o n h a s b e e n e n a b l e d a n d t h e t a s k t a g i s e x e c u t e d f r o m a t a s

I f y o u o m i t t h e a t t r i b u t e ( o r s e t i t t o f a l s e ) a n d g u a r a n t e e d t a s k e xi s e n a b l e d , t h e n I n f o * E n g i n e s a v e s t h e s t a t e o f t a s k . W h e n t h i s i s d o n e , t h e V D B c a n b e r e s t o r m u s t b e r e r u n .

I f y o u s e t t h e a t t r i b u t e t o “ t r u e ” a n d g u a r a n t e e dI n f o * E n g i n e d o e s n o t s a v e t h e s t a t e o f t h e V D Br e s u m a b l e t o t r u e w h e n t h e t a s k c a n b e r u n w i t h o u t c a uw o u l d p r e v e n t t h e t a s k f r o m p r o d u c i n g t h e s a m




u r i

S p e c i e s a U R I t h a t i s t h e l o c a t i o n o f t h e X M L t a s k

c a n b e a r e l a t i v e o r a b s o l u t e U R I : • R e l a t i v e U R I s r e f e r e n c e l e s t h a t r e s i d e u n d e r t h

t h a t i s d e n e d f o r t h e l o c a l I n f o * E n g i n e t a s k p r o c• A b s o l u t e U R I s r e f e r e n c e l e s t h a t r e s i d e i n t h e l o

o n a r e m o t e H T T P s e r v e r , o r a r e r e f e r e n c e d t h r o ud i r e c t o r y .


E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e o r t a s k

I n f o * E n g i n e c o r e t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h i e p r e x . T h e e x a m p l e t a s k t a g e x e c u t e s t h e t a s k 1 . x m l l e t h a t i s i n t h e r o o t l e d i r e c t o r y f o r t h e l o c a l t a s k p r o c e s s o r . T h e n e s t e d p a r a m e t e r s e a t t r t o “ E N A M E ” :


 



u n i t T a g T h e u n i t t a g a l l o w s y o u t o g r o u p a s e q u e n c e o f w e b j e c t s , t h e g r o u p i s e x e c u t e d a s a u n i t . W i t h i n t h e u n i t , y o u c c a n a l s o d e n e t h e f o l l o w i n g n e s t e d t a g s t o e x p l i c i t l y

• T h e i n i t t a g b l o c k s u p p l i e s t h e i n i t i a l i z a t i o n f o r t h e u n it h e s t a r t a n d e n d i n i t t a g e x e c u t e s r s t i n t h e u n i t .

• T h e s u c c e s s t a g b l o c k p r o v i d e s a w a y t o s p e c i f y c o d e t h a t h e c o d e i n t h e b o d y o f t h e u n i t h a s c o m p l e t e d s u c c

• T h e f a i l u r e t a g b l o c k p r o v i d e s a w a y t o s p e c i f y c o d e t h a t h e c o d e i n t h e b o d y o f t h e u n i t h a s f a i l e d . Y o u c a n i f a i l u r e t a g

b l o c k s i n w h i c h y o u c a n s p e c i f y e r r o r p r o c e s s i n g f T h e m a i n b o d y o f a u n i t c o n s i s t s o f a l l w e b j e c t s , t a s k u n i t s t a r t a n d e n d t a g s , b u t o u t s i d e o f t h e n e s t e d i n i t , s u c c e s s , a n d f a i l u r e t a g b l o c k s .

T h e p l a c e m e n t o f t h e i n i t , s u c c e s s , a n d f a i l u r e t a g b l o c k s i n t h e u n i t h a v e ns i g n i c a n c e . W h e n t h e u n i t e x e c u t e s , t h e c o d e i n t h e i n i t t a g b l o c k e x e c u t e s r s tr e g a r d l e s s o f w h e r e i t i s i n t h e u n i t . I f i t c o m p l e t e s s u t h e b o d y o f t h e u n i t e x e c u t e s i n t h e o r d e r i t i s p r e s e n t




b e g i n n i n g o f t h e u n i t . I f t h e b o d y c o m p l e t e s s u c cs u c c e s s t a g b l o c k e x e c u t e s . I f a n y c o d e i n t h e b o d y f a f a i l u r e t a g s i n t h e u n i t a r e c h e c k e d t o d e t e r m i n e i f p r o c e s s i n g f o r t h p r o v i d e e r r o r p r o c e s s i n g f o r t h e e r r o r t h a t h a s o c I f a n e x c e p t i o n o c c u r s i n a s u c c e s s b l o c k , t h e e x c e p t i o n i s t h r o w nn o t p r o c e s s e d . I f a n e x c e p t i o n o c c u r s i n t h e b o d y b y a f a i l u r e t a g ( i f o n e i s d e n e d f o r t h e e x c e p t i o n ) o r b f a i l u r e t a g . I f a n e r r o r i n t h e b o d y o f a u n i t i s n o t c a u g h t t h r o u f a i l u r e t a g , t h e e r r o r i s n o t h a n d l e d .

Y o u c a n n e s t t h i s t a g i n o t h e r u n i t t a g b l o c k s a n d i n i n i t , s u c c e s s , a n d f a i l u r e t a g b l o c k s .

Y o u c a n n e s t o n e i n i t t a g b l o c k , o n e s u c c e s s t a g b l o c k , a n d o n e o r m o r f a i l u r e t a g b l o c k s i n t h i s t a g b l o c k . Y o u c a n a l s o n e s t m u w e b j e c t , t a s k , u n i t , a n d

p a r a l l e l t a g s i n t h i s t a g b l o c k . F o r a d d i t i o n a l i n f o r m a t i o n a b o u t t h e i n i t , s u c c e s s , a n d f a i l u r e t a g s , s e e t h e s e c t h a t c o r r e s p o n d s t o e a c h t a g .

S c r i p t l e t s t h a t a r e n e s t e d i n u n i t , i n i t , s u c c e s s , a n d f a i l u r e t a g b l o c k s a r e n o t p r o c e s s e d o n J S P p a g e s t h e s a m e w a y t h e y a r e p r p r o c e s s o r . U s e t h e f o l l o w i n g g u i d e l i n e s t o d e t e r u c a n n e s t s c r i p t li n t h e s e t a g s :

• Y o u c a n n e s t s c r i p t l e t s w i t h i n t a g b l o c k s i n a s t• Y o u s h o u l d n o t n e s t s c r i p t l e t s i n a n y t a g b l o c k

s t a n d a l o n e t a s k s t h a t c o n t a i n t h e s c r i p t l e t s . Y o

t h e J S P p a g e b y u s i n g t h e I n f o * E n g i n e t a s k t a g . F o r a d d i t i o n a l i n f o r m a t i o n a b o u t s c r i p t l e t s , s e e S c r i p t l e t s o n p a g e 2 3 4 .

N o t e E m b e d d e d H T M L i s n o t s u p p o r t e d w i t h i n u n i t t a g s i n J S P s .

S y n t a x

 . . ( w e b j e c t , t a s k , i n i t , u n i t , p a r a l l e l , s u c c e s s , a n d f a i l u r e t a g b l o c k s . ) .



E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e p r e x . T h e e x a m p l e u n i t t a g g r o u p s t h e m a i n b o d y c o n t a i n i n g t h e Q u e r y - O b j e c t s w e s u c c e s s a n d f a i l u r e




b l o c k . T h e Q u e r y - O b j e c t s w e b j e c t e x e c u t e s a n d , i f i t h e s u c c e s s b l o c k e x e c u t e s . I f i t d o e s n ’ t c o m p l e t e s u c c e s s f a i l u r e b l o c k e x e c u t e s :




 



 

 

 



 

 

 



w e b j e c t T a g T h e w e b j e c t t a g i d e n t i e s t h e w e b j e c t y o u w a n t t o e x e c u t e

O n J S P p a g e s , y o u c a n n a m e a n y d e n e d w e b j e c t i n t h w e b j e c t t a g .

Y o u c a n n e s t t h i s t a g i n u n i t , i n i t , s u c c e s s , f a i l u r e , a n d p a r a l l e l t a g b l o c k s .

F o r w e b j e c t s t h a t r e q u i r e p a r a m e t e r s , y o u s p e c i f y t h p a r a m t a g i n t h i s t a g b l o c k .




N o t e I n s t a n d a l o n e t a s k s , d i s p l a y w e b j e c t s a r e n o t a l l o

D i s p l a y w e b j e c t s a r e n o t a l l o w e d t o b e e m b e d d e d p a r a l l e l t a g b l o c k s .

S y n t a x

W h e n t h e r e a r e p a r a m e t e r s , y o u c a n u s e t h e f o l l o



.

. ( N e s t w e b j e c t p a r a m e t e r s u s i n g p a r a m t a g s )

. W h e n t h e r e a r e n o p a r a m e t e r s , y o u c a n u s e t h e f o




R e q u i r e d a t t r i b u t e s : n a m e a n d t y p e

n a m e S p e c i e s a n I n f o * E n g i n e w e b j e c t n a m e . T h i s a

r e s u m a b l e I n d i c a t e s w h e t h e r t h e V D B s t a t e m u s t b e s a v e dn a m e d i n t h i s w e b j e c t t a g . T h i s a t t r i b u t e i s o n l y u s e d w h ee x e c u t i o n h a s b e e n e n a b l e d a n d t h e w e b j e c t i s at h a t r e s i d e s i n a t a s k .

I f y o u o m i t t h e a t t r i b u t e ( o r s e t i t t o f a l s e ) a n d g u a r a n t e e d t a s k e xi s e n a b l e d , t h e n I n f o * E n g i n e s a v e s t h e s t a t e o f a c t i o n w e b j e c t . W h e n t h i s i s d o n e , t h e V D B c a t h e w e b j e c t m u s t b e r e r u n .

I f y o u s e t t h e a t t r i b u t e t o t r u e a n d g u a r a n t e e d t a s k e x e c u t i o nI n f o * E n g i n e d o e s n o t s a v e t h e s t a t e o f t h e V D Ba t a s k . S e t r e s u m a b l e t o t r u e w h e n t h e w e b j e c t c a n b e r u n w s i d e e f f e c t s t h a t w o u l d p r e v e n t t h e w e b j e c t f r o mi t w e r e r u n a g a i n .




t y p e I n d i c a t e s t h e t y p e o f w e b j e c t y o u w a n t t o u s e . T h e p a c k a g e i s s e a r c h e d f o r t h e w e b j e c t c l a s s l e . I n f o *d e n e d f o r t h e f o l l o w i n g t y p e s o f w e b j e c t s :

T y p e C o n s t a n t W e b j e c t T y p e D S P D i s p l a y I M G I m a g e A C T A c t i o n O B J Q u e r y G R P G r o u p E X T E x t e r n a l M G T M a n a g e m e n t M S G M e s s a g i n g W E S W e b E v e n t S e r v i c e


N o t e D i s p l a y w e b j e c t s ( t y p e = D S P ) c a n n o t b e u s e d i n I n f o

T h e M e s s a g i n g ( t y p e = M S G ) a n d W e b E v e n t S e r v w e r e d e v e l o p e d f o r u s e i n I n f o * E n g i n e t a s k s . T h e sn o t b e u s e d d i r e c t l y w i t h i n a J S P p a g e , a l t h o u g h n ow e b j e c t s s h o u l d b e c a l l e d f r o m a J S P p a g e u s i n g t h p r o c e s s o r a t t r i b u t e .

u s e S p e c i e s t h e p a t h t o t h e c l a s s c o n t a i n i n g t h e e x t e r n n a m e d i s n o t a c l a s s w i t h i n .

T h i s a t t r i b u t e i s r e q u i r e d w h e n t h e t y p e a t t r i b u t e i s s e t t o E X T .

E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e o r t a s kI n f o * E n g i n e c o r e t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h i e p r e x . T h e e x a m p l e w e b j e c t t a g n a m e s t h e C o p y - G r o u p w e b j e c t , w h i c h i s a gt w o p a r a m e t e r s :


 






D i r e c t o r y L i b r a r y T a g s T o u s e t a g s i n t h e d i r e c t o r y t a g l i b r a r y , y o u m u s t t a g l i b d i r e c t i v e

s i m i l a r t o t h e f o l l o w i n g : < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t

p r e f i x = " i e d i r " % >

T h e s y n t a x f o r t h e s e t a g s a s s u m e s t h a t y o u h a v e s i e d i r p r e x i n t h e t a g l i b d i r e c t i v e . I f y o u s p e c i f y a d i f f e r e n t p r e x , u i n p l a c e o f i e d i r i n t h e t a g s y n t a x .

N o t e T h e d i r e c t o r y l i b r a r y t a g s c a n o n l y b e u s e d i n J S P i n s t a n d a l o n e t a s k s .

c r e a t e O b j e c t s T a g T h e c r e a t e O b j e c t s t a g c r e a t e s n e w e n t r i e s i n t h e s p e c i e d

B e f o r e e x e c u t i n g t h i s t a g , y o u m u s t c r e a t e a n I n f o * E n g i n e g r o u p t h a t ce l e m e n t s t h a t d e n e t h e L D A P e n t r i e s . E a c h e l e ma t t r i b u t e s :

• d n — T h e d i s t i n g u i s h e d n a m e o f t h e e n t r y . • o b j e c t C l a s s — T h e o b j e c t c l a s s t o a s s o c i a t e w i t h t h e e

v a l u e s f r o m t h e d i r e c t o r y s c h e m a c o n g u r e d f o

Y o u c a n i n c l u d e a d d i t i o n a l a t t r i b u t e s i n e a c h e l e o b j e c t c l a s s . Y o u s p e c i f y t h e r e q u i r e d I n f o * E n g i n e i n p u t g r o u p a r a m t a g i n t h i s t a g b l o c k a n d p r o v i d i n g t h e G R O U P _ I N p a r a m e s e e t h e p a r a m T a g o n p a g e 2 5 8 .

Y o u a l s o s p e c i f y t h e r e q u i r e d p a r a m e t e r b y n e s t i p a r a m t a g i n t h i s t a g b l o

S y n t a x




R e q u i r e d A t t r i b u t e s : u r i




u r i S p e c i e s a n L D A P U R L t h a t i d e n t i e s t h e d i r e c t o rc r e a t i n g t h e n e w e n t r i e s . F o r e x a m p l e , e n t e r i n g t h et h e h o s t a n d t h e b a s e e n t r y a s “ m y H o s t . m y S t a t e . m

l d a p : / / m y H o s t . m y S t a t e . m y C o m p a n y . c o m


E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s e s t ad i r e c t o r y a n d c o r e t a g l i b r a r i e s a n d t h a t t h e t a g s h a v e i e d i r a n d i e p r e x e s . T h e t a s k t a g b l o c k c r e a t e s t h e g r o u p o f e l e m e n t s u s ec r e a t e O b j e c t s t a g b l o c k c r e a t e s L D A P e n t r i e s i n t h e “ m y H od i r e c t o r y s e r v i c e :


< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l ip r e f i x = " i e d i r " % >

 



 

d e l e t e O b j e c t T a g T h e d e l e t e O b j e c t t a g d e l e t e s o n e L D A P l e a f e n t r y f r o m t h e Ls e r v i c e .

S y n t a x








u r i S p e c i e s a n L D A P U R L t h a t i d e n t i e s o n e L D A

T h e f o r m a t o f t h i s L D A P U R L i s : l d a p : / / h o s t n a m e : p o r t / s e a r c h _ b a s e

R e p l a c e e a c h p a r t o f t h e U R L w i t h t h e a p p r o p r

• h o s t n a m e : p o r t l o c a t e s t h e L D A P d i r e c t o r y .

• s e a r c h _ b a s e i s t h e d i s t i n g u i s h e d n a m e i d e n t i f y i nd e l e t e .


E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s * E n g i n e d i r e c t o r y t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e d i r p r e x . T h e d e l e t e O b j e c t t a g d e l e t e s t h e “ c o m . m y c o m p a n y . m y H o s t . j A d p s e r v i c e l o c a t e d a t “ m y C o m p a n y . c o m ” :

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t p r e f i x = " i e d i r " % >

< i e d i r : d e l e t e O b j e c t u r i = " l d a p : / / m y C o m p a n y . c o m / d c = j A d a p t e r , d c = m y H o

l i s t O b j e c t s T a g T h e l i s t O b j e c t s t a g c r e a t e s a n I n f o * E n g i n e g r o u p c o n t a t h e r e l a t i v e d i s t i n g u i s h e d n a m e s o f t h e L D A P d i u n d e r t h e s p e c i e d b a s e d i r e c t o r y e n t r y . E a c h e l ea t t r i b u t e w h i c h i s t h e d i s t i n g u i s h e d n a m e r e l a t i v

I f t h e r e a r e n o e n t r i e s d i r e c t l y u n d e r t h e s p e c i e d i s e m p t y .

Y o u n a m e t h e I n f o * E n g i n e g r o u p t h a t i s c r e a t e d uo n a n e s t e d p a r a m t a g . F o r m o r e i n f o r m a t i o n , s e e t h e p a r a m T a g o n p a g e 2 .

Y o u a l s o s p e c i f y t h e r e q u i r e d p a r a m e t e r b y n e s t i p a r a m t a g i n t h i s t a g b l o

S y n t a x








u r i S p e c i e s a n L D A P U R L t h a t i d e n t i e s t h e b a s e d i ru s e w h e n s e a r c h i n g f o r e n t r i e s . F o r e x a m p l e , e n t e U R L i d e n t i e s t h e “ m y C o m p a n y . c o m ” h o s t s e t s t h“ m y H o s t . m y S t a t e . m y C o m p a n y . c o m ” :

l d a p : / / m y C o m p a n y . c o m / d c = m y H o s t , d c = m y = m y C o m p a n y , o m


E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s e s t ad i r e c t o r y t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e d i r p r e x . T h e l i s t O b j e c t s t a g b l o c k c r e a t e s t h e “ l d a p _ m y H o s t ” g r o u p f r o m e n tl o c a t e d a t “ m y C o m p a n y . c o m ” u n d e r t h e “ d c = m y H o b a s e e n t r y :

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i p r e f i x = " i e d i r " % >

< i e d i r : l i s t O b j e c t s u r i = " l d a p : / / m y C o m p a n y . c o m / d c = m y H o s t , d c = m y C o m



q u e r y O b j e c t s T a g T h e q u e r y O b j e c t s t a g c r e a t e s a n I n f o * E n g i n e g r o u p c o n t a i n it h e L D A P d i r e c t o r y e n t r i e s m a t c h i n g t h e s e a r c h c r i t ei n t h e g r o u p c o n s i s t s o f t h e a t t r i b u t e s f o u n d i n e a c h e o f t h e a t t r i b u t e s i n e a c h e l e m e n t c o r r e s p o n d t o t h e n aL D A P d i r e c t o r y e n t r y a t t r i b u t e s . A t a m i n i m u m , e v ea t t r i b u t e s :

A t t r i b u t e D e s c r i p t i o n d n T h e d i s t i n g u i s h e d n a m e o f t h e e n t r y . o b j e c t C l a s s T h e o b j e c t c l a s s t o a s s o c i a t e w i t h t h e e n t r y .

I f t h e r e a r e n o e n t r i e s f o u n d u s i n g t h e s p e c i e d s e a r c hi s e m p t y .

Y o u n a m e t h e I n f o * E n g i n e g r o u p t h a t i s c r e a t e d u s i n o n a n e s t e d p a r a m t a g . F o r m o r e i n f o r m a t i o n , s e e t h e p a r a m T a g o n p a g e 2 5 8 .

S y n t a x








A t t r i b u t e D e s c r i p t i o n s R e q u i r e d A t t r i b u t e s : u r i

u r i S p e c i e s a n L D A P U R L t h a t i d e n t i e s t h e s e a r L D A P d i r e c t o r y e n t r i e s .

F o r t h e g e n e r a l f o r m a t o f t h i s L D A P U R L a n d e S p e c i f y i n g U Ra n d U R L s o n p a g e 6 4 .


E x a m p l e T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s d i r e c t o r y t a g l i b r a r y a n d t h a t t h e t a g s h a v e t h e i e d i r p r e x . T h e q u e r y O b j e c t st a g b l o c k c r e a t e s t h e “ l d a p _ q u e r y ” g r o u p t h a t c ot h a t r e s i d e i n t h e d i r e c t o r y s e r v i c e l o c a t e d a t “ m y“ d c = m y H o s t , d c = m y C o m p a n y , d c = c o m ” b a s e e n o b j e c t C l a s s a t t r i b u t e :

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a gp r e f i x = " i e d i r " % >

< i e d i r : q u e r y O b j e c t s

u r i = " l d a p : / / m y C o m p a n y . c o m / d c = m y H o s t , d c = m y C

u p d a t e O b j e c t s T a g T h e u p d a t e O b j e c t s t a g u p d a t e s e x i s t i n g e n t r i e s i n a n L D AU s i n g t h i s t a g , y o u c a n a d d n e w a t t r i b u t e s t o e x i se x i s t i n g a t t r i b u t e s , o r d e l e t e e x i s t i n g a t t r i b u t e s . t h a t c o n t a i n s t h e L D A P a t t r i b u t e s t h a t y o u a r e u p p a r a m e t e r o n a n e s t e d p a r a m t a g .

B e f o r e e x e c u t i n g t h i s t a g , y o u m u s t c r e a t e a n I n f o * E n g i n e g r o u p t h ae l e m e n t s t h a t d e n e t h e L D A P e n t r i e s t o b e m o d i h e d n a t t r i b u t e , t h e d i s t i n g u i s h e d n a m e o f t h e e n t r y . Te l e m e n t i d e n t i f y n a m e s a n d v a l u e s o f t h e L D A P

S y n t a x








A t t r i b u t e D e s c r i p t i o n s R e q u i r e d A t t r i b u t e s : u r i

u r i S p e c i e s a n L D A P U R L t h a t i d e n t i e s t h e d i r e c t o r e n t r y t o u s e w h e n u p d a t i n g e n t r i e s . F o r e x a m p l e , e i d e n t i e s t h e “ m y C o m p a n y . c o m ” d i r e c t o r y s e r v i c

l d a p : / / m y C o m p a n y . c o m /


m o d i c a t i o n S p e c i e s t h e t y p e o f m o d i c a t i o n t o d o . E n t e r o n e o

M o d i c a t i o n T y p e

D e s c r i p t i o n

A D D A d d s t h e L D A P a t t r i b u t e s s p e c i e d i n t h t o t h e L D A P e n t r y i d e n t i e d b y t h e d n g r o u p e l e m e n t a t t r i b u t e .

I f a n L D A P a t t r i b u t e t h a t i s s p e c i e d i n a a l r e a d y e x i s t s i n t h e L D A P e n t r y , t h e t a g

D E L E T E D e l e t e s t h e L D A P a t t r i b u t e s o t h e r t h a n d n t h a t a r e n a m e d

i n g r o u p e l e m e n t a t t r i b u t e s f o r t h e L D A L D A P e n t r y i s i d e n t i e d b y t h e d n g r o u p e l e m e n t a t t r i b u tT o d e l e t e a n e n t i r e L D A P e n t r y , u s e t h e d e l e t e O b j e c t t a g .

I f a n L D A P a t t r i b u t e t h a t i s s p e c i e d i n a d o e s n o t e x i s t i n t h e L D A P e n t r y , t h e t a ge r r o r o r m a y c o m p l e t e w i t h o u t a n e r r o r , L D A P s e r v e r i n u s e .

R E P L A C E R e p l a c e s t h e v a l u e s o f e x i s t i n g L D A P a s p e c i e d i n t h e g r o u p e l e m e n t . T h e L D A r e p l a c e m e n t i s d o n e i s i d e n t i e d b y t h e d n g r o u p e l e m e n t a t t r i b u t e .

I f a n L D A P a t t r i b u t e t h a t i s s p e c i e d i n t hd o e s n o t e x i s t i n t h e L D A P e n t r y , t h e a t t c o r r e s p o n d i n g v a l u e a r e a d d e d t o t h e e n t

T h e d e f a u l t f o r t h i s o p t i o n a l a t t r i b u t e i s R E P L A C E .




E x a m p l e

T h e f o l l o w i n g e x a m p l e d e c l a r e s t h a t t h e p a g e u s

d i r e c t o r y a n d c o r e t a g l i b r a r i e s a n d t h a t t h e t a g s i e d i r a n d i e p r e x e s . T h e t a s k t a g b l o c k c r e a t e s t h e g r o u p o f e l e m e n t t h e u p d a t e O b j e c t s t a g b l o c k u p d a t e s L D A P e n t r i e s i n t h e d i r e c t o r y s e r v i c e a t t h e “ d c = m y H o s t , d c = m y C o m


< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / tp r e f i x = " i e d i r " % >

 < i e d i r : u p d a t e O b j e c t s

u r i = " l d a p : / / m y C o m p a n y . c o m / d c = m y H o s t , d c = m y

S u p p l i e d L i b r a r y T a g s ( J S T L ) T h i s t a g l i b r a r y p r o v i d e s b a s i c J S T L - l i k e f u n c t i oi n c l u d e s t h e a b i l i t y t o s e t v a r i a b l e s , i t e r a t e o v e r l l o g i c .

T h e s e t a g s a r e i n c l u d e d i n t h e / c o m / i n f o e n g i n e / t l d s / i e j s t a g l i b r a r y . T o u s e t h e s e t a g s , y o u m u s t i n c l u d e a t a g l i b d i r e c t i v e i n y o u r t a s i m i l a r t o t h e f o l l o w i n g :

< % @ t a g l i b u r i = " / c o m / i n f o e n g i n e / t l d s / i e j s t l . t l d " p r e f i x = " c " % >

T h e s y n t a x f o r t h e s e t a g s a s s u m e s t h a t y o u h a v e c p r e x i n t h e t a g l i b d i r e c t i v e . I f y o u s p e c i f y a d i f f e r e n t p r e x , u p l a c e o f c i n t h e t a g s y n t a x .

c h o o s e T a g T h i s t a g a l l o w s f o r c o n d i t i o n a l e v a l u a t i o n w i t h a ( i f / e l s e ) . I t r e q u i r e s e m b e d d e d c h i l d r e n f o r w h e n

S y n t a x

< c : c h o o s e > < c : w h e n t e s t = “ C O N D I T I O N ” >

< ! - - p r o c e s s e d w h e n C O N D I T I O N





< ! - - p r o c e s s e d w h e n C O N D I T I O N e v a < / c : o t h e r w i s e >

< / c : c h o o s e >

E x a m p l e < c : c h o o s e >

< c : w h e n t e s t = ” $ { g r o u p = = n u l l | | g r o u p . e l e m e n t C o u n t =< ! - - d o w h e n g r o u p n a m e d “ g r o u p ” i s e m p t y - - >


< ! - - d o w h e n g r o u p c o n t a i n s e l e m e n t s - - > < / c : o t h e r w i s e >

< / c : c h o o s e >

f o r E a c h T a g T h i s t a g s u p p o r t s i t e r a t i o n o v e r a n i t e r a b l e , g r o u p , o r

S y n t a x

< c : f o r E a c h v a r = “ V A R I A B L E ” v a r = “ L I S T ” > < ! - - i n v o k e d o n c e f o r e a c h e l e m e n t i n

< / c : f o r E a c h >


R e q u i r e d a t t r i b u t e s : l i s t a n d v a r . l i s t

T h e l i s t t o i t e r a t e o v e r . T h i s m u s t e v a l u a t e t o a n i t e

T h i s a t t r i b u t e i s r e q u i r e d , a n d i s a l s o a n e x p r e s s i o n

v a r T h e v a r i a b l e n a m e t o u s e f o r i n d i v i d u a l l i s t e l e m e nv a l u e o f v a r s p e c i e s t h e n a m e o f a n i m p l i c i t v a r i a b l e t h aw h i c h m u s t b e u n i q u e w i t h i n i t s s c o p e w i t h i n y o u r c o n t e x t v a r i a b l e i s s e t w i t h t h i s n a m e f o r e a c h i t e r a w i t h i n o t h e r e x p r e s s i o n s . I f t h e l i s t b e i n g i t e r a t e d og r o u p , t h e n t h e c o n t e x t v a r i a b l e i s a n I n f o * E n g i n e

I n a d d i t i o n t o s e t t i n g t h e v a r i a b l e , a n e l e m e n t g r o u v a r a t t r i b u t e v a l u e i s p l a c e d i n t h e V D B ( s i m i l a r t o t h e f o r E a c h t a g f u n c t i o n a l i t y s u p p l i e d w i t h t h e I n f o * E n g i n e c o r e t a g l i b r a r y ) .

M u l t i - v a l u e d a t t r i b u t e s c a n a l s o b e i t e r a t e d o v e r u s$ { m y G r o u p [ 0 ] a t t [ * ] } . T h i s a t t r i b u t e i s r e q u i r e d .




E x a m p l e < c : f o r E a c h v a r = ” o n e ” v a r = ” $ { o u t p u t } ” >

< l o g : i n f o m e s s a g e = ” a t t r i b u t e A h a s a v a l u e o f $ { o n< / c : f o r E a c h >

i f T a g T h e i f t a g a l l o w s f o r c o n d i t i o n a l e v a l u a t i o n o f i t s b o

S y n t a x

< c : t e s t i f = “ C O N D I T I O N A L ” > < ! - - i n v o k e d i f C O N D I T I O N A L e v a l u

< / c : t e s t >


R e q u i r e d a t t r i b u t e s : t e s t

t e s t C o n t a i n s t h e c o n d i t i o n a l s t a t e m e n t t o b e e v a l u o p e r a t o r s [ = = , ! = , < , > , < = , a n d > = ] . T h e n u m e o p e r a n d s b e o f a n u m e r i c d a t a t y p e f o r c o m p a r o p e r a n d s a r e o f d i f f e r e n t d a t a t y p e s a n a t t e m p to t h e r t o a t t e m p t c o m p a r i s o n . I f o n e o f t h e o p e ra t t e m p t i s m a d e t o c o e r c e t h e v a r i a b l e t o t h e c o o f a r b i t r a r y c o m p l e x i t y c a n b e s p e c i e d . P o r t i

e v a l u a t e d t o g e t h e r m u s t b e g r o u p e d w i t h ( ) a n d b y [ | | , & & ] .

T h i s a t t r i b u t e i s r e q u i r e d a n d i s a l s o a n e x p r e s s

N o t e & & m u s t b e e n c o d e d a s ‘ & a m p ; & a m p , ’ .

E x a m p l e < c : i f t e s t = ” $ { @ F O R M [ ] b o o l [ ] = = t r u e } ” >

< ! - - c o n d i t i o n a l c o d e - - > < / c : i f >

< c : i f t e s t = ” $ { t h i s = = t h a t | | ( t h i s ! = t h a t & a m p ; & a m p ; a< ! - - c o n d i t i o n a l c o d e - - >

< / c : i f >

o t h e r w i s e T a g T h i s t a g i s r e l a t e d t o t h e c h o o s e a n d w h e n t a g s . I t m u s t b e a c h i l d o f t h c h o o s e t a g , a n d h a v e a s i b l i n g w h e n t a g . I f t h e w h e n t a g e v a l u a t e s t o f a l s e , t h e n t h e c o n t eo f t h e o t h e r w i s e t a g i s i n v o k e d a n d e x e c u t e d ( r e p r e s e n t s




S y n t a x

< c : c h o o s e >

< c : w h e n t e s t = “ C O N D I T I O N ” > < ! - - p r o c e s s e d w h e n C O N D I T I O N e v< / c : w h e n > < c : o t h e r w i s e >

< ! - - p r o c e s s e d w h e n C O N D I T I O N e v< / c : o t h e r w i s e >

< / c : c h o o s e >


< c : w h e n t e s t = ” $ { g r o u p = = n u l l | | g r o u p . e l e m e n t C o u n t =

< ! - - d o w h e n g r o u p n a m e d “ g r o u p ” i s e m p t y - - > < / c : w h e n > < c : o t h e r w i s e >


< / c : c h o o s e >

r e t u r n T a g T e r m i n a t e s t a s k i n v o c a t i o n .

S y n t a x

< c : r e t u r n / > E x a m p l e < c : i f t e s t = ” $ { i n p u t = = n u l l } ” >

< c : r e t u r n / > < / c : i f >

s e t T a g T h e s e t t a g s e t s a v a r i a b l e i n e i t h e r t h e t a s k l e t c o n t e x t o r

S y n t a x

< s e t v a r = “ V A R I A B L E ” v a l u e = “ V A L U E ” / >


R e q u i r e d a t t r i b u t e s : v a r a n d v a l u e .

v a r T h e v a r i a b l e t o s e t .





v a l u e T h e v a l u e t o s e t . T h e v a l u e a t t r i b u t e s u p p o r t s m o r e c o m p l e r e p r e s e n t i n g m a t h e m a t i c a l o p e r a t i o n s o n t w o os u p p o r t e d o p e r a n d s a r e [ + , - , * , / , % , & , | ] . W i t hm u s t b e e s c a p e d l i k e ‘ & a m p ; ’ .

T h i s a t t r i b u t e i s r e q u i r e d a n d c a n a l s o b e a n e x p

N o t e W h e r e o n e o p e r a n d i s a c o n s t a n t a n d t h e o t h e r a p o s s i b l e t h e v a r i a b l e i s c o e r c e d t o t h e d a t a t y p e d a t a t y p e s f o r m a t h e m a t i c a l o p e r a t i o n s a r e i n t a n d o a t .

r e q u e s t S c o p e B o o l e a n s p e c i f y i n g w h e t h e r t h e v a r i a b l e s h o u ld e f a u l t i s s e t t o f a l s e .

E x a m p l e < c : s e t v a r = ” o n e P l u s O n e ” v a l u e = ” $ { o n e + 1 } ” / >

w h e n T a g S i m i l a r t o i f , b u t w i t h i n a c h o o s e p a r e n t t a g ( r e p r e s e n t s t h e “ i f ” oP r o v i d e s J S T L s u p p o r t f o r I n f o * E n g i n e t a s k s .

S y n t a x

< c : c h o o s e > < c : w h e n t e s t = “ C O N D I T I O N ” >

< ! - - p r o c e s s e d w h e n C O N D I T I O N< / c : w h e n > < c : o t h e r w i s e >

< ! - - p r o c e s s e d w h e n C O N D I T I O N< / c : o t h e r w i s e >

< / c : c h o o s e >


R e q u i r e d a t t r i b u t e : t e s t .




t e s t C o n t a i n s t h e c o n d i t i o n a l s t a t e m e n t t o b e e v a l u a t e do p e r a t o r s [ = = , ! = , < , > , < = , a n d > = ] . T h e n u m e r i c oo p e r a n d s b e o f a n u m e r i c d a t a t y p e f o r c o m p a r i s o no p e r a n d s a r e o f d i f f e r e n t d a t a t y p e s t h e n a n a t t e m pt o t h e o t h e r t o a t t e m p t c o m p a r i s o n . I f o n e o f t h e o pt h e n a n a t t e m p t i s m a d e t o c o e r c e t h e v a r i a b l e t o t h e x p r e s s i o n s o f a r b i t r a r y c o m p l e x i t y c a n b e s p e c i et o b e e v a l u a t e d t o g e t h e r m u s t b e g r o u p e d w i t h ( ) a b e j o i n e d b y [ | | , & & ] .

N o t e & & m u s t b e e n c o d e d a s ‘ & a m p ; & a m p ; ’ .

T h i s a t t r i b u t e i s r e q u i r e d a n d i s a l s o a n e x p r e s s i o n .


< c : w h e n t e s t = ” $ { g r o u p = = n u l l | | g r o u p . e l e m e n t C o u n t =< ! - - d o w h e n g r o u p n a m e d “ g r o u p ” i s e m p t y - - >



< / c : c h o o s e >

S u p p l i e d L i b r a r y T a g s ( L o g g i n g ) T h i s t a g l i b r a r y a d d s s u p p o r t f o r e a s e o f u s e o f l o g 4 j I n f o * E n g i n e t a s k s w i t h o u t t h e n e e d t o u s e s c r i p t l e t s .t h i s t a g l i b r a r y i s n o t a c u s t o m e x t e n s i o n , b u t i s a c t u at h e I n f o * E n g i n e t a s k c o m p i l e r .

T h e f o l l o w i n g t a g s a r e i n c l u d e d i n t h e h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b / l o g t a g l i b r a r y . T o u s e t h e s e t a g s , y o u m u s t i n c l u d e a t a g l i b d i r e c t i v e i n y o u r t a s k s i m i l a rt o t h e f o l l o w i n g :

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i p r e f i x = " l o g " % >

T h e s y n t a x f o r t h e s e t a g s a s s u m e s t h a t y o u h a v e s p e c l o g p r e x i n t h e t a g l i b d i r e c t i v e . I f y o u s p e c i f y a d i f f e r e n t p r e x , u s e t h p l a c e o f l o g i n t h e t a g s y n t a x .




s e t L o g g e r T a g S e t s t h e l o g 4 j l o g g e r t o b e u s e d . I f t h i s t a g i s n o t u

n a m e f o r a t a s k i s b a s e d o n i t s l o c a t i o n w i t h i n t h ed i r e c t o r y n a m e p r e x e d w i t h c o m . i n f o e n g i n e . t a s k s . F o r e x a m p l e , i f y o u r t a s k i s “ / o r g / m y C o m p a n y / M y T a s k . x m l ” t h“ c o m . i n f o e n g i n e . t a s k s . o r g . m y C o m p a n y . ”

I n g e n e r a l , t h e s e t L o g g e r t a g i s s e l d o m u s e d s i n c e t h e d e f a u ls h o u l d b e s u f c i e n t l y g r a n u l a r f o r a d e q u a t e l o g g y o u w o u l d y o u r t a s k t o r e u s e a n o t h e r e x i s t i n g l o gt h e r e b y a l l o w i n g y o u t o c o n t r o l l o g g i n g f o r y o u rl o g g e r h i e r a r c h y .

S y n t a x

< l o g : s e t L o g g e r l o g g e r = “ L O G G E R _ N A M E


R e q u i r e d a t t r i b u t e : l o g g e r

l o g g e r T h e l o g g e r n a m e t o u s e . T h i s a t t r i b u t e i s r e q u i r

E x a m p l e < l o g : s e t L o g g e r l o g g e r = ” o r g . m y o r g . M y A p p l i c a t i o n L o

i n f o , d e b u g , w a r n , e r r o r , t r a c e T a g s T h e r e i s o n e t a g f o r e a c h c o r r e s p o n d i n g l o g 4 j l o gm e s s a g e t o t h e c o r r e s p o n d i n g l o g m e t h o d .

S y n t a x

< l o g : L E V E L m e s s a g e = “ l o g m e s s a g e ” / >


R e q u i r e d a t t r i b u t e : m e s s a g e .

m e s s a g e T h e l o g m e s s a g e s t o b e i s s u e d . T h i s a t t r i b u t e i e x p r e s s i o n .

E x a m p l e < l o g : i n f o m e s s a g e = " I N F O M e s s a g e " / > < l o g : w a r n m e s s a g e = " W A R N M e s s a g e " / > < l o g : d e b u g m e s s a g e = " G r o u p g c o t a i n s $ { g . e l e m e n t C < l o g : e r r o r m e s s a g e = " E R R O R M e s s a g e " / > < l o g : t r a c e m e s s a g e = " T R A C E M e s s a g e " / >




S u p p l i e d L i b r a r y T a g s ( X S L ) T h i s t a g l i b r a r y a d d s b a s i c s u p p o r t f o r X S L t r a n s f o r m

o n t o t h e c l i e n t ’ s o u t p u t s t r e a m . T h e s e t a g s a r e i n c l u d e d i n t h e / c o m / i n f o e n g i n e / t l d s / x s l . t l d t a g l i b r a r y . T o u s e t h e s e t a g s , y o u m u s t i n c l u d e a t a g l i b d i r e c t i v e i n y o u r t a s k s i m i l a r t o t h e f o l l o w i n g :

< % @ t a g l i b u r i = " / c o m / i n f o e n g i n e / t l d s / x s l . t l d " p r e f i x = " x s l " % >

T h e s y n t a x f o r t h e s e t a g s a s s u m e s t h a t y o u h a v e s p e c x s l p r e x i n t h e t a g l i b d i r e c t i v e . I f y o u s p e c i f y a d i f f e r e n t p r e x , u s e t h p l a c e o f x s l i n t h e t a g s y n t a x .

p a r a m T a g S p e c i e s a v a l u e f o r a n X S L p a r a m e t e r t o b e s u p p l i e T h i s t a g i s e m b e d d e d w i t h i n a t r a n s f o r m t a g a n d i s o p t i o n a l . P r o v i d e s Xt r a n s f o r m a t i o n t a g s u p p o r t .

S y n t a x

< x s l : p a r a m n a m e = “ P A R A M _ N A M E ” d a t a = “ P A


R e q u i r e d a t t r i b u t e s : n a m e a n d d a t a .

n a m e T h e X S L p a r a m e t e r n a m e . T h i s a t t r i b u t e i s r e q u i r e

d a t a T h e X S L p a r a m e t e r v a l u e . T h i s a t t r i b u t e i s r e q u i r e

E x a m p l e < x s l : t r a n s f o r m g r o u p = ” $ { t o T r a n s f o r m } ”

x s l = ” / t r a n s f o r m / t o / x c e l . x s l ” f i l e N a m e = ” m y . x l s ” c o n t e n t T y p e = ” a p p l i c a t i o n / v n d . m s - e x c e l ” >

< x s l : p a r a m n a m e = ” a ” d a t a = ” b ” / > < / x s l : t r a n s f o r m >

t r a n s f o r m T a g P e r f o r m s X S L t r a n s f o r m a t i o n o n a n i n p u t g r o u p a n d o u t p u t s t r e a m . S u p p o r t s e m b e d d e d p a r a m t a g s . P r o v i d e s X S L t r a n s f o r m t a g s u p p o r t .




S y n t a x

< x s l : t r a n s f o r m x s l = “ X S L ” g r o u p = “ I E G

f i l e N a m e = “ F I L E N A M E ” c o n t e n t T< x s l : p a r a m n a m e = “ P A R A M _ N A M E ” d a t ” / > < / x s l : t r a n s f o r m >


R e q u i r e d a t t r i b u t e s : x s l .

x s l S p e c i e s t h e p a t h t o t h e X S L s t y l e s h e e t t o a p p l i s a l s o a n e x p r e s s i o n .

l e n a m e S p e c i e s t h e l e n a m e f o r t h e C o n t e n t - D i s p o s i t‘ t r a n s f o r m e d . x m l ’ ) . T h i s a t t r i b u t e i s a l s o a n e x p r e s s

c o n t e n t T y p e S p e c i e s t h e C o n t e n t - T y p e f o r t h e C o n t e n t - D i t e x t / x m l ; c h a r s e t = “ U T F - 8 ” ) T h i s a t t r i b u t e i s a l s o a n e x p r e s s i o

g r o u p T h e I n f o * E n g i n e G r o u p o b j e c t t o t r a n s l a t e ( n o T h i s a t t r i b u t e i s a l s o a n e x p r e s s i o n .

E x a m p l e < x s l : t r a n s f o r m g r o u p = ” $ { t o T r a n s f o r m } ”

x s l = ” / t r a n s f o r m / t o / x c e l . x s l ” f i l e N a m e = ” m y . x l s ” c o n t e n t T y p e = ” a p p l i c a t i o n / v n d . m s - e x c e l ” >

< x s l : p a r a m n a m e = ” a ” d a t a = ” b ” / > < / x s l : t r a n s f o r m >






1 3 D i s p l a y W e b j e c t R

D i s p l a y W e b j e c t s f o r H T M L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I m a g e W e b j e c t s f o r J P E G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

T h e f o l l o w i n g t o p i c s c o n t a i n i n f o r m a t i o n a b o u t I n f o * E n g i n e s u p p o r t s H T M L a n d J P E G f o r m a t s e a c h a r e g r o u p e d i n s e p a r a t e s e c t i o n s . E a c h i n d i vn a m e , a d e s c r i p t i o n o f i t s u s e , d e t a i l s o f i t s s y n t a x

a n d , i n m o s t c a s e s , a n e x a m p l e . B e f o r e t h e i r d e s c r i p t i o n s , p a r a m e t e r s a r e g r o u p e

• R e q u i r e d — T h e p a r a m e t e r i s a l w a y s r e q u i r e d• S e l e c t — A r e l a t i o n s h i p b e t w e e n t h e s p e c i e d

e x i s t s . F o r e x a m p l e , t h e H Y P E R L I N K a n d T E t h e D i s p l a y - T a b l e w e b j e c t a r e s e l e c t b e c a u s e i p a r a m e t e r , y o u m u s t a l s o s p e c i f y t h e T E M P L A

A p a r a m e t e r i s a l s o l i s t e d i n t h e “ S e l e c t ” c o l u m b e t w e e n t h e v a l u e s i n t h e s p e c i e d p a r a m e t e r a p a r a m e t e r . F o r e x a m p l e , i n t h e D i s p l a y - V a l u e

t h e T Y P E p a r a m e t e r d e t e r m i n e s t h e f o r m a t o f S I Z E p a r a m e t e r . T h e r e f o r e , b o t h t h e T Y P E a n t h e “ S e l e c t ” c o l u m n .

• O p t i o n a l — T h e p a r a m e t e r i s a l w a y s o p t i o n a l p a r a m e t e r .

2 8 9



D i s p l a y W e b j e c t s f o r H T M L T h e f o l l o w i n g w e b j e c t s c a n b e u s e d t o d i s p l a y o u t p u

• A p p l y - X S L o n p a g e 2 9 0 • D i s p l a y - O b j e c t o n p a g e 2 9 7 • D i s p l a y - R e s o u r c e o n p a g e 3 1 1 • D i s p l a y - S e l e c t i o n o n p a g e 3 1 2 • D i s p l a y - T a b l e o n p a g e 3 2 4 • D i s p l a y - V a l u e o n p a g e 3 3 1 • D i s p l a y - X M L o n p a g e 3 4 1 • E c h o - R e q u e s t o n p a g e 3 4 3

A p p l y - X S L

D E S C R I P T I O N

A p p l i e s a n X S L s t y l e s h e e t t o a n I n f o * E n g i n e g r o u p or e p r e s e n t a t i o n o f t h e g r o u p . T h e g e n e r a t e d o u t p u t i s o f t h e X S L s t y l e s h e e t .

S Y N T A X

 

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l X S L _ U R L C O N T E N T _ T Y P E

D B U S E R G R O U P _ I N P A S S W D X S L _ P A R A M




C O N T E N T _ T Y P E S p e c i e s t h e M I M E c o n t e n t t y p e t o b e a s s o c i a td i s p l a y e d . U s i n g h t m l t e x t a s t h e c o n t e n t t y p e rd o c u m e n t t o t h e c a l l i n g a p p l i c a t i o n o r w e b b r o T h e d e f a u l t f o r t h i s p a r a m e t e r i s t e x t / h t m l , w h i c h p r o d u c e s a n X M L - f o r m a t t e d d o c u m e n t . T h i s p a r a m e t e r i s

D B U S E R S p e c i e s t h e u s e r n a m e t o b e u s e d t o a u t h e n t i c at e m p l a t e s t o b e u s e d b y t h e w e b j e c t r e s i d e o n a p a r a m e t e r s h o u l d b e u s e d i n c o n j u n c t i o n w i t h t

T h i s p a r a m e t e r i s o p t i o n a l .

G R O U P _ I N I d e n t i e s t h e n a m e o f t h e g r o u p t o b e u s e d a s t h b e a V D B g r o u p o r a C o n t e x t g r o u p . F o r f u r t h e I n f o * E n g i n e D a t a M a n a g e m e n t o n p a g e 2 7 .

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e l a s t T h i s p a r a m e t e r i s o p t i o n a l .

P A S S W D S p e c i e s t h e p a s s w o r d c o r r e s p o n d i n g t o D B U


X S L _ P A R A M D e n e s X S L p a r a m e t e r s t h a t a r e t h e n p a s s e d t ot h e X S L _ U R L p a r a m e t e r . Y o u e n t e r t h e v a l u e i n t h e f o r m X S L _ n a m e = X S L _ v a l u e w h e r e X S L _ n a m e i s t h e n a m e o f a p a r a m e t e r i n t h e X S L s t y l e s h e e t a n d X S L _ v a l u e i s t h e v a l u e y o u w a nf o r t h e p a r a m e t e r .

T h e d e f a u l t f o r X S L _ P A R A M i s t h a t n o p a r a m M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m

D i s p l a y W e b j e c t R e f e r e n c e 2 9 1



X S L _ U R L I d e n t i e s t h e l o c a t i o n o f a n X S L s t y l e s h e e t t o a p p l g r o u p . A r e l a t i v e U R L o r a f u l l y q u a l i e d U R L c a nU R L s a r e r e l a t i v e t o t h e I n f o * E n g i n e s e r v e r t a s k t eF u l l y q u a l i e d U R L s a r e d e r e f e r e n c e d u s i n g A u t h - M a p c o n t e x t g r o u p d a t a . T h e A u t h - M a p c o n t e x t g r o u p i s s e a r c h e d f o r a u s e r n a m e ao n t h e d o m a i n n a m e f o u n d i n t h e f u l l y q u a l i e d U Rt h a t t h e f u l l y q u a l i e d U R L i s : h t t p : / / m a c h i n e . c o m / W i n d c h i l l / i n f o e n g i nc o m / c o m p a n y / c r e a t e G r o u p D a t a . x s l T h e A u t h - M a p c o n t e x t g r o u p i s s e a r c h e d f o r a u s e r n a m e w i t h h t t p : / / m a c h i n e . c o m a s a n I N S T A N C E n a m e . I f a u s e r n p a s s w o r d a r e f o u n d , B A S I C a u t h e n t i c a t i o n i n f o r m t h e U R L . I f n o u s e r n a m e a n d p a s s w o r d i s f o u n d , n oi s s e n t t o t h e r e m o t e w e b s e r v e r . I f t h e d a t a v a l u e c o n t a i n s t h e s t r i n g : / / i t i s a s s u m e d t o b e a f u l l y q u a I n t e r n e t U R L . I f t h e d a t a v a l u e d o e s n o t c o n t a i n t h el o c a l l e r e l a t i v e t o t h e c u r r e n t t a s k r o o t d i r e c t o r y .

T h i s p a r a m e t e r i s r e q u i r e d .

B r o w s e r E x a m p l e

E x a m p l e w e b j e c t T h e f o l l o w i n g A p p l y - X S L w e b j e c t f o r m a t s t h e o u d i s p l a y s t h e o u t p u t i n a b r o w s e r :

 




X S L s t y l e s h e e t T h e f o l l o w i n g X S L s t y l e s h e e t i s a p p l i e d t o a n o f “ E m p l o y e e D a t a ” w i t h e a c h e l e m e n t c o n t a i nA D D R E S S a t t r i b u t e s :

< ? x m l v e r s i o n = ' 1 . 0 ' ? > < x s l : s t y l e s h e e t

x m l n s : x s l = " h t t p : / / w w w . w 3 . o r g / X S L / T r a n s f o r mx m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / 1 .

< x s l : t e m p l a t e m a t c h = " / w c : C O L L E C T I O N / E m p l o y < h t m l > < h e a d > < t i t l e > A p p l y - X S L E x a m p l e < / t i t l e > < / h e a d < t a b l e > < t r >

< t h > n a m e < / t h > < t h > H o m e A d d r e s s < / t h > < / t r >

< x s l : f o r - e a c h s e l e c t = " w c : I N S T A N C E " > < t r >

< t d > < x s l : v a l u e - o f s e l e c t = " N A M E " / > < / t d > < t d > < x s l : v a l u e - o f s e l e c t = " A D D R E S S " / > < / t d >

< / t r > < / x s l : f o r - e a c h > < / t a b l e > < / h t m l > < / x s l : t e m p l a t e > < / x s l : s t y l e s h e e t >

B r o w s e r d i s p l a y T h e o u t p u t i s g e n e r a t e d u s i n g H T M L b y s p e c i ft e x t / h t m l . T h e r e s u l t i n g w e b b r o w s e r d i s p l a y c o nt a b l e o f n a m e s a n d a d d r e s s e s :




E x c e l E x a m p l e

E x a m p l e J S P P a g e

T h e f o l l o w i n g J S P p a g e c o n t a i n s t h e A p p l y - X S L wX S L p a r a m e t e r s , t h e n u s e s a s t y l e s h e e t t o f o r m a t t hd i s p l a y i n E x c e l : < % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = c o n t e n t T y p e = " a p p l i c a t i o n / m s - e x c e l " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l ip r e f i x = " i e " % >

< % / * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

* * D E S C R I P T I O N * B u i l d h t m l t a b l e f o r i m p o r t M i c r o s o f t W o r d , E x c e l ,

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * / / / e x e c u t e c r e a t e g r o u p t a s k t o g e t g r o u p i n f o

% >



< % / / c a l l A p p l y - X S L W e b j e c t t o t r a n s l a t e d a t a i n t o e x c e

% >

 < i e : p a r a m n a m e = " X S L _ U R L " d a t a = " c o m / c o m p a n y / E x c e< i e : p a r a m n a m e = " X S L _ P A R A M " d a t a = " C L A S S = ' E m p l o y

< i e : p a r a m n a m e = " X S L _ P A R A M " d a t a = " H E A D E R S = ' N A M E = E m p l o y e e , A D D R E S S = H 

X S L s t y l e s h e e t I n t h e e x a m p l e J S P p a g e , t h e f o l l o w i n g X S L p a r a mX S L s t y l e s h e e t :

C L A S S = ' E m p l o y e e D a t a '

H E A D E R S = ' N A M E = E m p l o y e e , A D D R E S S = H o

U S E - C O L U M N S = ' N A M E , A D D R E S S , E M A I L '

T h e p a r a m e t e r s c h a n g e t h e c l a s s , c o l u m n s u s e d , a ns t y l e s h e e t s o t h a t t h e s t y l e s h e e t c a n m a n i p u l a t e a n

T h e A p p l y - X S L w e b j e c t o n t h e J S P p a g e c a l l s t h e f




< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? > < x s l : s t y l e s h e e t

x m l n s : x s l = " h t t p : / / w w w . w 3 . o r g / 1 9 9 9 / X S L / T r a n

x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / 1 . 0< x s l : o u t p u t o m i t - x m l - d e c l a r a t i o n = " y e s " / >

< x s l : p a r a m n a m e = " C L A S S " > E M P < / x s l : p a r a m > < x s l : p a r a m n a m e = " U S E - C O L U M N S " > E M P N O , E N A M< x s l : p a r a m n a m e = " H E A D E R S " > E M P N O = E , E N A M E =

< x s l : t e m p l a t e m a t c h = " / w c : C O L L E C T I O N " > < t a b l e b o r d e r = ' 0 ' c e l l p a d d i n g = ' 0 ' c e l l s p a c i n g

s t y l e = ' b o r d e r - c o l l a p s e : c o l l a p s e ; t a b l e - l a y< c o l w i d t h = ' 2 0 0 '

s t y l e = ' m s o - w i d t h - s o u r c e : u s e r s e t ; m s o - w i d < c o l w i d t h = ' 2 0 0 '

s t y l e = ' m s o - w i d t h - s o u r c e : u s e r s e t ; m s o - w i d < c o l w i d t h = ' 2 0 0 '

s t y l e = ' m s o - w i d t h - s o u r c e : u s e r s e t ; m s o - w i d

< x s l : f o r - e a c h s e l e c t = " / / * [ n a m e ( ) = $ C L A S S ] " >< t r h e i g h t = ' 1 7 ' s t y l e = ' h e i g h t : 1 2 . 7 5 p t ' >

< x s l : c a l l - t e m p l a t e n a m e = " t a b l e - h e a d e r s " / >< / t r > < x s l : f o r - e a c h s e l e c t = " w c : I N S T A N C E " > < t r >

< x s l : f o r - e a c h s e l e c t = " * " > < x s l : c a l l - t e m p l a t e n a m e = " h t m l - t a b l e - v a

< / x s l : f o r - e a c h > < / t r > < / x s l : f o r - e a c h >

< / x s l : f o r - e a c h > < / t a b l e >

< / x s l : t e m p l a t e >

< x s l : t e m p l a t e n a m e = " h t m l - t a b l e - v a l u e " > < x s l : v a r i a b l e n a m e = " T A R G E T " s e l e c t = " n a m e ( ) "< x s l : i f t e s t = " c o n t a i n s ( $ U S E - C O L U M N S , n a m e (

< t d h e i g h t = ' 6 8 ' c l a s s = ' x l 2 7 ' s t y l e = ' h e i g h t : 2 0< x s l : v a l u e - o f s e l e c t = " . " / >

< / t d > < / x s l : i f >

< / x s l : t e m p l a t e >

< x s l : t e m p l a t e n a m e = " t a b l e - h e a d e r s " > < x s l : f o r - e a c h s e l e c t = " c h i l d : : w c : I N S T A N C E [ p o

< x s l : v a r i a b l e n a m e = " E Q U A L S " s e l e c t = " ' = ' " / > < x s l : v a r i a b l e n a m e = " D E L I M " s e l e c t = " ' , ' " / > < x s l : i f t e s t = " c o n t a i n s ( $ U S E - C O L U M N S , n a m e




< x s l : m e s s a g e > < x s l : t e x t > C o l u m n H e a d e r < / x s l : t e x t > < x s l : v a l u e - o f s e l e c t = " $ H E A D E R S " / >

< x s l : t e x t > N a m e < / x s l : t e x t > < x s l : v a l u e - o f s e l e c t = " n a m e ( ) " / > < / x s l : m e s s a g e >

< t d h e i g h t = ' 1 7 ' c l a s s = ' x l 2 4 ' w i d t h = ' 1 0 0 ' s t y l e = ' h; w i d t h : 1 0 0 p t ' >

< x s l : i f t e s t = " c o n t a i n s ( $ H E A D E R S , n a m e ( ) ) " > < x s l : v a r i a b l e n a m e = " T E M P "

s e l e c t = " s u b s t r i n g - a f t e r ( $ H E A D E ( ) ) " / >

< x s l : v a r i a b l e n a m e = " T E M P 1 " s e l e c t = " s u b s t r i n g - a f t e r ( $ T E M P ,

) " / > < x s l : v a r i a b l e n a m e = " V A L U E " s e l e c t = " s u b s t r i n

$ T E M P 1 , $ D E L I M ) " / > < x s l : v a l u e - o f s e l e c t = " $ V A L U E " / >

< / x s l : i f > < x s l : i f t e s t = " n o t ( c o n t a i n s ( $ H E A D E R S , n a m e ( )

< x s l : v a l u e - o f s e l e c t = " n a m e ( ) " / > < / x s l : i f >

< / t d >

< / x s l : i f > < / x s l : f o r - e a c h >

< / x s l : t e m p l a t e >

< / x s l : s t y l e s h e e t >

M S E x c e l d i s p l a y T o d i s p l a y t h e o u t p u t d i r e c t l y i n M S E x c e l , e x e c uU R L f o r t h e p a g e f r o m t h e E x c e l O p e n d i a l o g . F o r e x a m p l e , i f t h e E x c e l W o r k b o o k . j s p p a g e w e r e s a v e d t o < W i n d c h i l l > / c o d e b a s e / c o m / c o m p a n y / E x c e l W o r y o u m i g h t e n t e r t h e f o l l o w i n g U R L : :

h t t p : / / h o s t / W i n d c h i l l / c o m / c o m p a n y / E x c

T h e f o l l o w i n g p i c t u r e d i s p l a y s t h e r e s u l t i n g E x c e lt w o o f t h e t h r e e h e a d e r s w e r e s u p p l i e d . T h e E M A Ic o l u m n n a m e .




D i s p l a y - O b j e c t


D i s p l a y s a g r o u p o f o b j e c t s i n a g e n e r a l w a y , a l l ol a n g u a g e b e f o r e a n d a f t e r o b j e c t s a n d a t t r i b u t e s .n o t s p e c i e d , n o f o r m a t t i n g i s d o n e . I f B O R D E R g e n e r a t e d .

S Y N T A X

 < i e : p a r a m n a m e = " O B J E C T _ S E P A R A T O R " d a t a = " s e p a

< i e : p a r a m n a m e = " P O S T _ A T T R I B U T E _ N A M E _ T E X T " d< i e : p a r a m n a m e = " P O S T _ A T T R I B U T E _ T E X T " d a t a = " t < i e : p a r a m n a m e = " P O S T _ C A P T I O N _ T E X T " d a t a = " t e x t< i e : p a r a m n a m e = " P O S T _ F O O T E R _ T E X T " d a t a = " t e x t "< i e : p a r a m n a m e = " P O S T _ H E A D E R _ T E X T " d a t a = " t e x t < i e : p a r a m n a m e = " P O S T _ O B J E C T _ T E X T " d a t a = " t e x t "< i e : p a r a m n a m e = " P O S T _ T A B L E _ T E X T " d a t a = " t e x t " /< i e : p a r a m n a m e = " P O S T _ T I T L E _ T E X T " d a t a = " t e x t " / < i e : p a r a m n a m e = " P O S T _ V A L U E _ T E X T " d a t a = " t e x t " /< i e : p a r a m n a m e = " P R E _ A T T R I B U T E _ N A M E _ T E X T " d a < i e : p a r a m n a m e = " P R E _ A T T R I B U T E _ T E X T " d a t a = " t e < i e : p a r a m n a m e = " P R E _ C A P T I O N _ T E X T " d a t a = " t e x t "< i e : p a r a m n a m e = " P R E _ F O O T E R _ T E X T " d a t a = " t e x t " /< i e : p a r a m n a m e = " P R E _ H E A D E R _ T E X T " d a t a = " t e x t " / 




 

P A R A M E T E R S

N o t e A l l p a r a m e t e r s a r e o p t i o n a l .




A T T R I B U T E S p e c i e s w h i c h a t t r i b u t e s a r e s h o w n a s e a c h o bw e b j e c t , y o u c a n s p e c i f y t w o t y p e s o f a t t r i b u t e p s e u d o - a t t r i b u t e s .

A c t u a l a t t r i b u t e s a r e e x p l i c i t l y s t a t e d a s t h e v a e x a m p l e , s p e c i f y i n g d a t a = " e n a m e " i n c l u d e s t h e “ e n a m e ” a t t r it h e o b j e c t i s d i s p l a y e d . A c t u a l a t t r i b u t e v a l u e s

P s e u d o - a t t r i b u t e s , u n l i k e a c t u a l a t t r i b u t e s , a r e W M L c a r d . T h e y o f t e n l o o k l i k e t h i s i n a w e b j e

d a t a = " $ ( a t t r i b u t e ) "

A p s e u d o - a t t r i b u t e v a l u e c a n b e a c o m b i n a t i o nV a r i a b l e s u b s t i t u t i o n i s m a d e f r o m t h e a t t r i b u t

e x a m p l e , a s s u m e t h a t t h e g r o u p n a m e d i n t h e Gt h e t w o o b j e c t s : n a m e = S a m s a l = 2 0 0 a n d n a m e = C h e n s a l = 3 0 0 . T h e n , t h e p a r a m e t e r :

< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " E m p l o y e e $

g e n e r a t e s t h e d i s p l a y t e x t :

E m p l o y e e S a m i s p a i d 2 0 0 E m p l o y e e C h e n i s p a i d 3 0 0

N o t i c e t h e d o u b l e q u o t a t i o n m a r k s a r o u n d t h e p r e v i o u s l y . T h e s e q u o t e s i n d i c a t e t h a t t h e v a l u H T M L - e n c o d e d t o a l l o w f o r a n y s p e c i a l c h a r a

t h e w i r e l e s s d e v i c e d u r i n g d i s p l a y . S i n g l e q u o v a l u e c o u l d a l s o h a v e b e e n u s e d . I f d o u b l e q u o v a l u e f o r a p a r a m e t e r , u s e s i n g l e q u o t a t i o n m a v a l u e . I f s i n g l e q u o t a t i o n s ( f o r e x a m p l e , a n a p ot h e v a l u e f o r a p a r a m e t e r , u s e d o u b l e q u o t a t i o nt h e v a l u e .

F o r e x a m p l e , t o g e n e r a t e t h e f o l l o w i n g n a m e :

N A M E = ' S a m J o h n s o n ' ;

e i t h e r o f t h e f o l l o w i n g p a r a m e t e r c o m b i n a t i o nD i s p l a y - O b j e c t w e b j e c t :



< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " N A M E = ' $ ( N

T h i s p a r a m e t e r m u s t b e s p e c i e d i f D I S P L A Y _u s e d . T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o d i s p l aM u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m




A T T R I B U T E _ S E P A R A T O R S p e c i e s t h e t e x t o r H T M L t o b e u s e d b e t w e e n a t t r b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s \ n ; w h e n t h e r e i s n o b o r d e r , t h e i s " " . T h i s p a r a m e t e r i s o p t i o n a l .




B O R D E R D e t e r m i n e s t h e w i d t h , i n p i x e l s , o f t h e H T M L ti n f o r m a t i o n t o b e d i s p l a y e d .

I f t h e B O R D E R p a r a m e t e r i s s p e c i e d w i t h a v a " " , H T M L t a b l t a g s a r e g e n e r a t e d b y d e f a u l t u s i n g o t h e r p a r a md i s p l a y o b j e c t s a s r o w s i n a t a b l e a n d d i s p l a y a t

T h e f o l l o w i n g t a b l e s h o w s t h e d e f a u l t v a l u e s o b y w h e t h e r o r n o t t h e r e i s a b o r d e r s p e c i e d . T h

• D e f a u l t s w h e n t h e r e i s a b o r d e r ( B O R D E R i t h a n " " ) .

• D e f a u l t s w h e n t h e r e i s n o b o r d e r ( B O R D E R " " ) .

P a r a m e t e r H T M L D e f a u l t V a l u e U s e d w ia B o r d e r H T M L D e f V a l u e U s e dw i t h N o B o r d e r

P R E _ T A - B L E _ T E X T P O S T _ T A B L E _ T E X T

" < t a b l e b o r d e r = B O R D E R c e l l s p a c i n g = C E L L S P A C I N c e l l p a d d i n g = C E L L P A D D I N\ n " " < / t a b l e > \ n "

" " " "

P R E _ H E A D E R _ T E X T H E A D E R _ S E P A R A T O R P O S T H E A D E R _ T E X T

" < t h > " " " " < / t h > " " " "

P R E _ O B J E C T _ T E X T P O S T _ O B J E C T _ T E X T

" < t r > " " < / t r > \ n " " " "

P R E _ A T - T R I B U T E _ T E X T P O S T _ A T T R I B U T E _ T - E X T

" < t d > " " < / t d > " " " " "

P R E _ C A P T I O N _ T E X T P O S T _ C A P T I O N _ T E X T

" < c a p t i o n > " " < / c a p - t i o n > \ n "

" " " "

V A L U E _ S E P A R A T O R A T T R I B U T E _ S E P A R A T - O R O B J E C T _ S E P A R A T O R

" " " \ n " " \ n " " " "

P R E _ T I T L E _ T E X T _ T I T L E P O S T _ T I - T L E _ T E X T

" " " " " \ n " " " " " " "

T h e d e f a u l t v a l u e o f B O R D E R i s " " . D e f a u l t v a l u e s f o r p a r a m e b y w h e t h e r o r n o t t h e r e i s a b o r d e r c a n b e o v e r r p a r a m e t e r s . T h i s p a r a m e t e r i s o p t i o n a l .




C A P T I O N S p e c i e s t h e t e x t f o r a t a b l e c a p t i o n . T h e d e f a u l t f o " " . T h i s p a r a m e t e r i s o p t i o n a l .

C E L L P A D D I N G S p e c i e s t h e a m o u n t o f s p a c e , i n p i x e l s , b e t w e e n t hc o n t e n t s . T h e d e f a u l t f o r t h i s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a

C E L L S P A C I N G S p e c i e s t h e a m o u n t o f s p a c e , i n p i x e l s , a r o u n d t h et a b l e a n d b e t w e e n t h e c e l l s i n a t a b l e . T h e d e f a u l t f " " . T h i s p a r a m e t e r i s o p t i o n a l .

D I S P L A Y _ A T T R I B U T E _ N A M E D e t e r m i n e s i f t h e a t t r i b u t e n a m e i s s h o w n . T h i s p a

s p e c i c a t t r i b u t e s a r e s p e c i e d o n a n A T T R I B U T E t h i s p a r a m e t e r i s F A L S E . U s e T R U E t o e n a b l e . T h

D I S P L A Y _ A T T R I B U T E _ V A L U E D e t e r m i n e s i f t h e a t t r i b u t e v a l u e i s s h o w n . T h e d e fT R U E . U s e F A L S E t o d i s a b l e . T h i s p a r a m e t e r i s o

F O O T E R S p e c i e s t h e t e x t f o r a t a b l e f o o t e r . T h e d e f a u l t f o r " " . T h i s p a r a m e t e r i s o p t i o n a l .

G R O U P _ I N I d e n t i e s t h e n a m e o f t h e g r o u p t o b e u s e d a s a n i n p b e a V D B g r o u p o r a C o n t e x t g r o u p . F o r f u r t h e r i n fI n f o * E n g i n e D a t a M a n a g e m e n t o n p a g e 2 7 .

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e l a s t g r o uT h i s p a r a m e t e r i s o p t i o n a l .

H E A D E R _ S E P A R A T O R S p e c i e s t h e t e x t o r H T M L t o b e u s e d b e t w e e n c o l uf o r t h i s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

M A X D e n e s t h e m a x i m u m n u m b e r o f e l e m e n t s t o d i s p l

t h i s p a r a m e t e r c o n t r o l s h o w m u c h d a t a i s r e t u r n e d B y u s i n g p a r a m e t e r v a l u e s u b s t i t u t i o n f o r t h e M A Xs e r i e s o f w e b j e c t s c a n b e c o d e d t h a t a l l o w d a t a i n a m a n a g e a b l e r e s u l t s e t s . F o r m o r e i n f o r m a t i o n , s e e D y n a m i c P a r a m e t e r V a lS u b s t i t u t i o n o n p a g e 4 0 .

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o d i s p l a y a l l r e m as t a r t i n g w i t h t h e e l e m e n t i d e n t i e d i n t h e S T A R T p o p t i o n a l .




O B J E C T _ S E P A R A T O R S p e c i e s t h e t e x t o r H T M L t o b e u s e d b e t w e e n b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s \ n ; w h e n t h e r e i s n o b o r d e r i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P O S T _ A T T R I B U T E _ N A M E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r e a c f o r t h i s p a r a m e t e r i s . T h i s p a r a m e t e r i s o p t i o n a l .

P O S T _ A T T R I B U T E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r e a c a b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < / t d > ; w h e n t h e r e i s n o b o r d e f a u l t i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P O S T _ C A P T I O N _ T E X T

S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r e a c b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < / c a p t i o n > \ n ; w h e n t h e r e i s n o b o r d e r , t h e d e f a u l t i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P O S T _ F O O T E R _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r a t a p a r a m e t e r i s \ n . T h i s p a r a m e t e r i s o p t i o n a l .

P O S T _ H E A D E R _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r e a c a b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < / t h > ; w h e n t h e r e i s n o b o r d e f a u l t i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P O S T _ O B J E C T _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r e a c b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < / t r > \ n ; w h e n t h e r e i s n o b o rd e f a u l t i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P O S T _ T A B L E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r e a c i s a b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < / t a b l e > \ n ; w h e n t h e r e i s n b o r d e r , t h e d e f a u l t i s \ n \ n . T h i s p a r a m e t e r i s o p t i o n a l

P O S T _ T I T L E _ T E X T

S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r a t i td e f a u l t f o r t h i s p a r a m e t e r i s \ n ; w h e n t h e r e i s n o b o r d e r , t h e d " " . T h i s p a r a m e t e r i s o p t i o n a l .

P O S T _ V A L U E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r e a ca t t r i b u t e . T h e d e f a u l t f o r t h i s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i




P R E _ A T T R I B U T E _ N A M E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e e a c h af o r t h i s p a r a m e t e r i s . T h i s p a r a m e t e r i s o p t i o n a l .

P R E _ A T T R I B U T E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e e a c h ai s a b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < t r > ; w h e n t h e r e i s n o b o r d e r ,d e f a u l t i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P R E _ C A P T I O N _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e e a c h c b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < c a p t i o n > ; w h e n t h e r e i s n o b o r d et h e d e f a u l t i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P R E _ F O O T E R _ T E X T

S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e a t a b lt h i s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P R E _ H E A D E R _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e e a c h ci s a b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < t h > ; w h e n t h e r e i s n o b o r d e r ,d e f a u l t i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P R E _ O B J E C T _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e e a c h b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < t r > ; w h e n t h e r e i s n o b o r d e r , t hd e f a u l t i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P R E _ T A B L E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e e a c h t h e r e i s a b o r d e r , t h e d e f a u l t f o r t h i s p a r a m e t e r i s < t a b l e b o r d e r = B O R D c e l l s p a c i n g = C E L L S P A C I N G c e l l p a d d i n g = ; w h e n t h e r e i s n o b o r d e r , t h e d e f a u l t i s . T h i s p a r a m e t e r i s o p t i o n a

P R E _ T I T L E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e a t i t l e p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P R E _ V A L U E _ T E X T

S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e e a c h va t t r i b u t e . T h e d e f a u l t f o r t h i s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a




S T A R T S p e c i e s t h e n u m b e r o f t h e r s t e l e m e n t i n t h e g p a r a m e t e r i n c o n j u n c t i o n w i t h t h e M A X p a r a m r e t u r n e d t h r o u g h t h e w e b j e c t .

B y u s i n g p a r a m e t e r v a l u e s u b s t i t u t i o n f o r t h e Ms e r i e s o f w e b j e c t s c a n b e c o d e d t h a t a l l o w d a t a m a n a g e a b l e r e s u l t s e t s . F o r m o r e i n f o r m a t i o n , D y n a m i c P a r a m e t e rS u b s t i t u t i o n o n p a g e 4 0 .

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o s t a r t w i t h t hT h i s p a r a m e t e r i s o p t i o n a l .

T I T L E S p e c i e s t h e t e x t f o r a t i t l e . T h e d e f a u l t f o r t h i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

V A L U E _ S E P A R A T O R S p e c i e s t h e t e x t o r H T M L t o b e u s e d b e t w e e n c o n t a i n s m u l t i - v a l u e d a t t r i b u t e s . W h e n t h e r e i p a r a m e t e r i s ; w h e n t h e r e i s n o b o r d e r , t h e d e f a u l t , ” . T h i s p a r a m e i s o p t i o n a l .

U N D E F I N E D S e t s t h e v a l u e t o d i s p l a y f o r a n u n d e n e d v a l u e a n o n e x i s t e n t a t t r i b u t e o r a n a t t r i b u t e t h a t h a s ac o n t a i n i n g a n e m p t y s t r i n g ( " " ) i s n o t i n t e r p r e t e d a s b e i n g u n

d e f a u l t f o r t h i s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a l . E X A M P L E S

T h e f o l l o w i n g D i s p l a y - O b j e c t w e b j e c t e x a m p l e m u l t i p l e e l e m e n t s ; e a c h w i t h a n a m e , a d d r e s s a n

D E F A U L T D I S P L A Y

W e b j e c t

< i e : w e b j e c t n a m e = " D i s p l a y - O b j e c t " t y p e = " D S P "

O u t p u t




C O M M A S E P A R A T E D L I S T O F A L L A T T R I B U T

W e b j e c t

 

O u t p u t

C O M M A S E P A R A T E D L I S T O F S O M E A T T R I B UP E R L I N E

W e b j e c t 

< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " n a m e , a d d r e s s 



O u t p u t




F R E E - F O R M S U B S T I T U T I O N , O N E E L E M E

W e b j e c t

< i e : w e b j e c t n a m e = " D i s p l a y - O b j e c t " t y p e = " D S P "< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " E m p l o y e e

$ [ A D D R E S S ] & a m p ; " / 

O u t p u t




E S C A P E C H A R A C T E R S

W e b j e c t

 



N o t e O u t p u t d i s p l a y s w i t h n o < n a m e > b e c a u s e t h e < a n d > s i g n s a r e i n a s H T M L t a g s . I f " < " a n d " > " a r e d e s i r e d i n t h e o uc h a r a c t e r s & l t a n d & g t .

O u t p u t

N o t e V i e w s o u r c e t o v e r i f y u n q u o t e d < a n d > c h a r a c t e r

G e n e r a t e d H T M L

U s e r ' s < n a m e > = s j o h n s o n @ s o m e w h e r e . c o m U s e r ' s < n a m e > = h a n d e r s o n @ s o m e w h e r e . c o m U s e r ' s < n a m e > = 

U s e r ' s < n a m e > = h h a m p t o n @ s o m e w h e r e . c o m D E F A U L T T A B L E

W e b j e c t

 



O u t p u t




D I S P L A Y T A B L E W I T H T I T L E A N D C A P T I O

W e b j e c t

 < i e : p a r a m n a m e = " D I S P L A Y _ A T T R I B U T E _ N A M E " 

O u t p u t




J A V A S C R I P T T h e f o l l o w i n g e x a m p l e s h o w s h o w J a v a S c r i p t c a n D i s p l a y - O b j e c t w e b j e c t .

W e b j e c t

< s c r i p t > v a r i t e m c n t = 0 ; < / s c r i p t > < t a b l e b o r d e r = 0 c e l l s p a c i n g = 0 c e l l p a d d i n g = 0 >

< t h b g c o l o r = y e l l o w a l i g n = l e f t > & n b s p ; < / t h > < t h b g c o l o r = y e l l o w a l i g n = l e f t > N a m e < / t h > < t h b g c o l o r = y e l l o w a l i g n = l e f t > & n b s p ; < / t h > < t h b g c o l o r = y e l l o w a l i g n = l e f t > E m a i l < / t h > < t h b g c o l o r = y e l l o w a l i g n = l e f t > & n b s p ; < / t h >

 ' ) ; e l s e d o c u m e n t . w r i b g c o l o r = # D 3 D 3 D 3 > ' ) ; < / s c r i p t > " / >

 " / >

 $ [ N A M E ] < / t d > " / >


 $ [ E M A I L ] < / t d > " / >




< / t a b l e >

O u t p u t




D i s p l a y - R e s o u r c e


E x t r a c t s a n d d i s p l a y s a l o c a l i z e d s t r i n g f r o m e i t hG e t - R e s o u r c e w e b j e c t o r d i r e c t l y f r o m a r e s o u r c

S Y N T A X

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l K E Y G R O U P _ I N P A R A M

B U N D L E

B U N D L E I n d i c a t e s t h e J a v a c l a s s r e s o u r c e b u n d l e f r o m we x t r a c t e d . T h i s p a r a m e t e r i s r e q u i r e d i f n o G R O

G R O U P _ I N I n d i c a t e s t h e b u n d l e g r o u p f r o m w h i c h t h e m e s p a r a m e t e r i s r e q u i r e d i f n o B U N D L E i s s u p p l i

K E Y I n d i c a t e s t h e k e y i n t o t h e r e s o u r c e b u n d l e . T h et h e a c t u a l J a v a v a r i a b l e r e f e r e n c e n a m e . T h i s p

P A R A M S p e c i e s t h e t e x t t o b e i n s e r t e d i n t o t h e l o c a l i z ee x t r a c t e d s t r i n g c o n t a i n s a v a r i a b l e p l a c e h o l d e

T h e { 0 } w e b j e c t h a s f a i l e d .

T h e n t h e t e x t s p e c i e d f o r P A R A M r e p l a c e s t h

t h e v a l u e s p e c i e d f o r P A R A M i s “ R e t u r n - G r o b e c o m e s :

T h e R e t u r n - G r o u p w e b j e c t h a s f a i l e d .

M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m p a r a m e t e r i s " " , r e s u l t i n g i n n o s u b s t i t u t i o n b e i n g p e r fi s o p t i o n a l .




E X A M P L E S

F o r m o r e i n f o r m a t i o n o n t h e G e t - R e s o u r c e w e b j e c t u G e t - R e s o u r c e

o n p a g e 4 2 9 . W e b j e c t


d a t a = " c o m . i n f o e n g i n e . u t i l . I E R e s o u r c e " / > 



 



 

O u t p u t T h e d i s p l a y e d t e x t i s a l o c a l i z e d m e s s a g e p u l l e d f r b u n d l e .

D i s p l a y - S e l e c t i o n


G e n e r a t e s H T M L f o r m e l e m e n t s s u c h a s O P T I O N a no f N A M E , S I Z E , a n d M U L T I P L E , p r o d u c i n g a s e l e cd r o p - d o w n m e n u o r a l i s t b o x i n a b r o w s e r w i n d o w .

N o t e T h e F O R M e l e m e n t i s n o t a u t o m a t i c a l l y g e n e r a t e d b yl i s t s c o r r e c t l y , i n c l u d e t h e < F O R M > a n d < / F O R M > t a g s a s s h o w n i n t h e e x a m p

S Y N T A X

 

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l L I S T _ H E A D E R A T T R I B U T E L I S T _ H E A D E R _ V A L U E A T T R I B U T M U L T I P L E G R O U P _ I N S E L E C T E D L E A D E R

N A M E S I Z E

W I D T H A T T R I B U T E

S p e c i e s t h e n a m e o f t h e o b j e c t a t t r i b u t e w h o s a t t r i b u t e i n t h e g e n e r a t e d H T M L O P T I O N e l e ma n d w h o s e a t t r i b u t e n a m e i s u s e d a s t h e n a m e v S E L E C T e l e m e n t .

I f A T T R I B U T E _ V A L U E i s s p e c i e d , t h e n t h eS E L E C T e l e m e n t a n d t h e v a l u e a t t r i b u t e o f t h ed e t e r m i n e d b y A T T R I B U T E _ V A L U E , w h i l e tO P T I O N e l e m e n t r e m a i n s t h e v a l u e s p e c i e d b

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e a n d d i s pv a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r . T h i s

A T T R I B U T E _ V A L U E S p e c i e s t h e n a m e o f t h e w e b j e c t a t t r i b u t e w h oa t t r i b u t e i n t h e g e n e r a t e d H T M L O P T I O N e l e mf o r t h e g e n e r a t e d H T M L S E L E C T e l e m e n t ; t h A T T R I B U T E v a l u e .

I f A T T R I B U T E i s n o t s p e c i e d , t h e n A T T R I B n a m e v a l u e f o r t h e g e n e r a t e d H T M L S E L E C T i n t h e g e n e r a t e d H T M L O P T I O N e l e m e n t , w h d e t e r m i n e d b y t h e A T T R I B U T E d e f a u l t . T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e s a m s u b m i t t e d a s f o r t h e v a l u e d i s p l a y e d . T h i s p a r a




G R O U P _ I N I d e n t i e s t h e n a m e o f t h e g r o u p t o b e u s e d a s a n i n p b e a V D B g r o u p o r a C o n t e x t g r o u p . T h e d e f a u l t f o t h e l a s t g r o u p d e n e d i n t h e V D B . T h i s p a r a m e t e r i

F o r f u r t h e r i n f o r m a t i o n a b o u t g r o u p s , s e e I n f o * E n g i n e D a t a M a n a g e mo n p a g e 2 7 .

L E A D E R S p e c i e s a s t r i n g v a l u e t o p l a c e b e t w e e n m u l t i p l e a p a r a m e t e r i s s p e c i e d , t h e L E A D E R v a l u e b e c o m ea t t r i b u t e v a l u e s . T h e L E A D E R v a l u e c a n c o n s i s t oI f w i d t h i s s p e c i e d , t h e a t t r i b u t e v a l u e i s p a d d e d wu n t i l t h e w i d t h i s m e t o r e x c e e d e d . T h e d e f a u l t f o r " _ " . T h i s p a r a m e t e r i s o p t i o n a l .

L I S T _ H E A D E R S p e c i e s a n a d d i t i o n a l s e l e c t a b l e i t e m t o b e d i s p l a d r o p - d o w n l i s t o r l i s t b o x . L I S T _ H E A D E R a n d L I p a r a m e t e r s a r e t r e a t e d a s a p a i r . I f L I S T _ H E A D E L I S T _ H E A D E R _ V A L U E m u s t a l s o b e s p e c i e d . s p e c i e d f o r t h i s p a r a m e t e r .

L I S T _ H E A D E R _ V A L U E S p e c i e s t h e v a l u e o f t h e L I S T _ H E A D E R i t e m t h af o r m i s s u b m i t t e d , i f t h e L I S T _ H E A D E R i t e m i s s eL I S T _ H E A D E R p a r a m e t e r m u s t b e s p e c i e d f o r t h b e v a l i d . M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p

M U L T I P L E A c t s a s a a g , a l l o w i n g m u l t i p l e o b j e c t s t o b e s e l e c T h e d e f a u l t f o r t h i s p a r a m e t e r i s F A L S E . S p e c i f y Ts e l e c t i o n s . Y o u m u s t a l s o s e t t h e p a r a m e t e r t o T R Uo f t h e l i s t v a l u e s u s i n g t h e S E L E C T E D p a r a m e t e r .

N A M E S e t s t h e N A M E v a l u e o f t h e g e n e r a t e d H T M L S E Lf o r t h i s p a r a m e t e r i s t o u s e t h e a t t r i b u t e n a m e s p e c i

A T T R I B U T E _ V A L U E i s s p e c i e d , t h e n t h e d e f a u t h e a t t r i b u t e n a m e s p e c i e d b y A T T R I B U T E _ V A Ln o r A T T R I B U T E _ V A L U E a r e s p e c i e d , t h e n t h e dt o u s e t h e n a m e o f t h e r s t a t t r i b u t e . T h i s p a r a m e t e




S E L E C T E D S p e c i e s w h i c h a t t r i b u t e v a l u e t o u s e a s t h e d e fm e n u o r l i s t b o x . Y o u c a n s e l e c t n o v a l u e s , a s i v a l u e s . T h e d e f a u l t f o r t h i s p a r a m e t e r i s " " . T o s e t t h e d e f a u l t s e l e c t h e v a l u e s i n t h e l i s t , s e t t h e v a l u e o f t h i s p a r a m " * " . T h e M U L T I P L p a r a m e t e r m u s t b e e n a b l e d f o r a l l v a l u e s t o b e p

S I Z E S e t s t h e n u m b e r o f o p t i o n s t o b e d i s p l a y e d a t o b o x . I f n o v a l u e i s s p e c i e d , t h e d e f a u l t f o r t h i st h e d e f a u l t i s u s e d , o r o n e i t e m i s s p e c i e d , a d r I f t w o o r m o r e i t e m s a r e s p e c i e d , t h e n a l i s t b o d i s p l a y w h e n m o r e i t e m s a r e r e t u r n e d t h a n t h e d i s p l a y . T h i s p a r a m e t e r i s o p t i o n a l .

W I D T H S e t s t h e w i d t h o f t h e O P T I O N e l e m e n t i n t h e d rd e f a u l t f o r t h i s p a r a m e t e r i s t h e s i z e o f t h e a t t r i bi s s p e c i e d , t h e n e a c h a t t r i b u t e c a n h a v e a W I D a t t r i b u t e s t h a n W I D T H p a r a m e t e r s a r e s p e c i ea r e a p p l i e d o n a o n e - t o - o n e b a s i s b e g i n n i n g w ir e m a i n i n g a t t r i b u t e s u s i n g t h e d e f a u l t v a l u e . T

E X A M P L E S

T h e f o l l o w i n g D i s p l a y - S e l e c t i o n w e b j e c t e x a m p

c o n t a i n i n g m u l t i p l e e l e m e n t s ; e a c h w i t h a n a m e ,




D E F A U L T D I S P L A Y

N o t e T h e d e f a u l t f o r t h e S I Z E p a r a m e t e r r e s u l t s i n a d r o p

W e b j e c t < f o r m > 

O u t p u t

G e n e r a t e d H T M L < f o r m > < s e l e c t n a m e = ' N A M E ' > < o p t i o n v a l u e = ' S a m J o h n s o n ' > S a m J o h n s o n 1 2 3 4 M a i n

S t . s j o h n s o n @ s o m e w h e r e . c o m < / o p t < o p t i o n v a l u e = ' H a r v y A n d e r s o n ' > H a r v y A n d e r s o n 1 2 3

S t . h a n d e r s o n @ s o m e w h e r e . c o m < / o p t< o p t i o n v a l u e = ' J a m e s O ' C o n n o r ' > J a m e s O ' C o n n o r 7 7 5

S t . < / o p t i o n > < o p t i o n v a l u e = ' H a r v e y H a m p t o n ' > H a r v e y H a m p t o n 7 7

S t . h h a m p t o n @ s o m e w h e r e . c o m < / o p t< / s e l e c t > < / f o r m >




D I S P L A Y A S I N G L E A T T R I B U T E

N o t e S p e c i f y i n g a v a l u e o f " 1 " f o r t h e S I Z E p a r a m e t e r

W e b j e c t < f o r m > 

 < / f o r m >

O u t p u t

G e n e r a t e d H T M L < f o r m > < s e l e c t n a m e = ' N A M E ' s i z e = 1 > < o p t i o n v a l u e = ' S a m J o h n s o n ' > S a m J o h n s o n < / o p t < o p t i o n v a l u e = ' H a r v y A n d e r s o n ' > H a r v y A n d e r s o < o p t i o n v a l u e = ' J a m e s O ' C o n n o r ' > J a m e s O ' C o n n o < o p t i o n v a l u e = ' H a r v e y H a m p t o n ' > H a r v e y H a m p t o< / s e l e c t > < / f o r m >




D I S P L A Y S I N G L E A T T R I B U T E W I T H D I F F E R EV A L U E

T h e f o l l o w i n g e x a m p l e s h o w s t h e l i s t t h a t i s g e n e rA T T R I B U T E _ V A L U E p a r a m e t e r s p e c i e d d i f f e r i n t h e A T T R I B U T E p a r a m e t e r . I n t h i s c a s e t h e N A i n a l i s t b o x , w h i l e t h e v a l u e r e t u r n e d w h e n t h e f o r mA D D R E S S a t t r i b u t e .

W e b j e c t < f o r m > 

 < / f o r m >

O u t p u t

G e n e r a t e d H T M L < f o r m > < s e l e c t n a m e = ' A D D R E S S ' > < o p t i o n v a l u e = ' 1 2 3 4 M a i n S t . ' > S a m J o h n s o n < / o p t i o n< o p t i o n v a l u e = ' 1 2 3 4 A m b e r S t . ' > H a r v y A n d e r s o n < / o

< o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > J a m e s O ' C o n n o r < / o p t < o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > H a r v e y H a m p t o n < / o p t i< / s e l e c t > < / f o r m >




D I S P L A Y M U L T I P L E A T T R I B U T E S W I T H S

W e b j e c t

< f o r m > < i e : w e b j e c t n a m e = " D i s p l a y - S e l e c t i o n " t y p e = " D

 

 < / f o r m >

O u t p u t

G e n e r a t e d H T M L < f o r m > < s e l e c t n a m e = ' A D D R E S S ' s i z e = 6 > < o p t i o n v a l u e = ' 1 2 3 4 M a i n S t . ' > S a m J o h n s o n , 1 2

s j o h n s o n @ s o m e w h e r e . c o m < / o< o p t i o n v a l u e = ' 1 2 3 4 A m b e r S t . ' > H a r v y A n d e r s o n

h a n d e r s o n @ s o m e w h e r e . c o m < / < o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > J a m e s O ' C o n n o r , 7

< / o p t i o n > < o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > H a r v e y H a m p t o n ,

h h a m p t o n @ s o m e w h e r e . c o m < / < / s e l e c t > < / f o r m >




D I S P L A Y M U L T I P L E A T T R I B U T E S W I T H S E P A

W e b j e c t

 

 < / f o r m >

O u t p u t

N o t e E a c h a t t r i b u t e i s p a d d e d w i t h t h e L E A D E R t o m e W I D T H .

G e n e r a t e d H T M L < f o r m > < s e l e c t n a m e = ' A D D R E S S ' s i z e = 6 > < o p t i o n v a l u e = ' 1 2 3 4 M a i n S t . ' > S a m J o h n s o n _ _ _ _ _ _ _

S t . _ _ _ _ _ _ _ s j o h n s o n @ s o m e w h e r e . c o m < /< o p t i o n v a l u e = ' 1 2 3 4 A m b e r S t . ' > H a r v y A n d e r s o n _ _ _

S t . _ _ _ _ _ _ h a n d e r s o n @ s o m e w h e r e . c o m < /< o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > J a m e s O ' C o n n o r _ _ _ _ _ _

S t . _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ < / < o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > H a r v e y H a m p t o n _ _ _ _ _

S t . _ _ _ _ _ _ _ _ h h a m p t o n @ s o m e w h e r e . c o m << / s e l e c t > < / f o r m >






D I S P L A Y S I N G L E A T T R I B U T E W I T H M U L T I P L

W e b j e c t

< f o r m > 

 

 < / f o r m >

O u t p u t

G e n e r a t e d H T M L < f o r m > < s e l e c t n a m e = ' A D D R E S S ' s i z e = 6 > < o p t i o n v a l u e = ' * ' > A l l E m p l o y e e s < / o p t i o n > < o p t i o n v a l u e = ' - ' > N o E m p l o y e e s < / o p t i o n > < o p t i o n v a l u e = ' 1 2 3 4 M a i n S t . ' > S a m J o h n s o n < / o p t i o n< o p t i o n v a l u e = ' 1 2 3 4 A m b e r S t . ' > H a r v y A n d e r s o n < / o < o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > J a m e s O ' C o n n o r < / o p t i< o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > H a r v e y H a m p t o n < / o p t i< / s e l e c t > < / f o r m >




D I S P L A Y S I N G L E A T T R I B U T E W I T H P R E -

W e b j e c t

< f o r m > < i e : w e b j e c t n a m e = " D i s p l a y - S e l e c t i o n " t y p e = " D

 < / f o r m >

O u t p u t

G e n e r a t e d H T M L < f o r m > < s e l e c t n a m e = ' A D D R E S S ' s i z e = 6 > < o p t i o n v a l u e = ' 1 2 3 4 M a i n S t . ' > 1 2 3 4 M a i n S t . < / o< o p t i o n s e l e c t e d v a l u e = ' 1 2 3 4 A m b e r S t . ' > 1 2 3 4 A< o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > 7 7 5 M a i n S t . < / o p t< o p t i o n v a l u e = ' 7 7 5 M a i n S t . ' > 7 7 5 M a i n S t . < / o p t< / s e l e c t > < / f o r m >




D I S P L A Y S I N G L E A T T R I B U T E W I T H A L L O P T

W e b j e c t

< f o r m > 

 

 < / f o r m >

O u t p u t

G e n e r a t e d H T M L < f o r m > < s e l e c t n a m e = ' A D D R E S S ' s i z e = 6 m u l t i p l e > < o p t i o n s e l e c t e d v a l u e = ' 1 2 3 4 M a i n S t . ' > 1 2 3 4 M a i n S< o p t i o n s e l e c t e d v a l u e = ' 1 2 3 4 A m b e r S t . ' > 1 2 3 4 A m b e< o p t i o n s e l e c t e d v a l u e = ' 7 7 5 M a i n S t . ' > 7 7 5 M a i n S t . < o p t i o n s e l e c t e d v a l u e = ' 7 7 5 M a i n S t . ' > 7 7 5 M a i n S t . < / s e l e c t > < / f o r m >

D i s p l a y - T a b l e


D i s p l a y s a n I n f o * E n g i n e g r o u p a s a n H T M L t a b l e .

S Y N T A X

 < i e : p a r a m n a m e = " H E A D E R " d a t a = " [ h e a d e r _ t e x t | N O N E ]< i e : p a r a m n a m e = " H Y P E R _ V A L U E " d a t a = " a t t r i b u t e _ v a l u 




 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l H Y P E R L I N K A T T R I B U T E H Y P E R _ V A L U E B O R D E R P A T H _ I N F O F O O T E R T E M P L A T E _ U R L G R O U P _ I N

H E A D E R W I D T H M A X S T A R T

A T T R I B U T E S p e c i e s t h e n a m e o f t h e d a t a b a s e a t t r i b u t e s y oH E A D E R p a r a m e t e r t a k e s p r e c e d e n c e o v e r A Tt h e h e a d e r t i t l e s d i s p l a y e d a b o v e e a c h c o l u m n .i s t o d i s p l a y a l l a t t r i b u t e s c o n t a i n e d i n t h e r s t e p a r a m e t e r . I f t h e r s t e l e m e n t d o e s n ' t c o n t a i n t A T T R I B U T E p a r a m e t e r s m u s t b e u s e d t o s p e cM u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m

B O R D E R

D e t e r m i n e s t h e w i d t h , i n p i x e l s , o f t h e H T M L tg r o u p o f i n f o r m a t i o n t o b e d i s p l a y e d . I f B O R Da r e c r e a t e d . I f B O R D E R i s s p e c i e d w i t h a v a l u " " , n o b o r d e r i s d r a wB O R D E R i s n o t s p e c i e d , t h e d e f a u l t v a l u e i s 1

F O O T E R S p e c i e s t h e i n f o r m a t i o n t o b e d i s p l a y e d a t t h e t h e v a l u e o f t h i s p a r a m e t e r c a n b e a n y t e x t . T h e d e f a u l t b e h a v i o r f p a r a m e t e r i s t h a t n o f o o t e r i s d i s p l a y e d . T h i s p

G R O U P _ I N I d e n t i e s t h e n a m e o f t h e g r o u p t o b e u s e d a s a n b e a V D B g r o u p o r a C o n t e x t g r o u p . F o r f u r t h e I n f o * E n g i n e D a t a M a n a g e m e n t o n p a g e 2 7 . T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e l a s t T h i s p a r a m e t e r i s o p t i o n a l .




H E A D E R S p e c i e s t h e h e a d e r t i t l e o r l i s t o f h e a d e r t i t l e s t o b e a c h c o l u m n . T h i s p a r a m e t e r t a k e s p r e c e d e n c e o v d e t e r m i n i n g t h e h e a d e r t i t l e s . I f H E A D E R i s s e t t o a r e d i s p l a y e d .

W h i l e m u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r aH E A D E R v a l u e s m u s t m a t c h t h e n u m b e r o f A T T R p a r a m e t e r i s o p t i o n a l .

H Y P E R _ V A L U E S p e c i e s t h e a t t r i b u t e s u s e d t o g e n e r a t e C G I - d a t a fa r e g e n e r a t e d f o r t h e a t t r i b u t e s s p e c i e d b y t h e H Y A l l t h e a t t r i b u t e s a r e a d d e d t o a l l t h e h y p e r l i n k v a l uv a l u e s c a n b e s p e c i e d . I f n o v a l u e s a r e s p e c i e d , t a t t r i b u t e s s p e c i e d b y t h e H Y P E R L I N K p a r a m e t e c a u s e s a C G I - d a t a s t r i n g t o b e a d d e d t o t h e g e n e r a t e d h y p e r l i n k o f t h e f o< a t t r i b u t e _ n a m e > = < a t t r i b u t e _ v a l u e > . H Y P E R L I N K m u s t b e s p e c i e d i n o r d e r t o u s e t h i s p a r a m e t e r .

H Y P E R L I N K S p e c i e s a l i s t o f a t t r i b u t e s t h a t s h o u l d h a v e h y p e r t h e m . I f a n y H Y P E R L I N K p a r a m e t e r s a r e s p e c i eT E M P L A T E _ U R L f o r e a c h a t t r i b u t e s p e c i e d b y t

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t h a t n o h y p e r l i n k sv a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r .

M A X D e n e s t h e m a x i m u m n u m b e r o f e l e m e n t s t o d i s p l t h i s p a r a m e t e r a l l o w s c o n t r o l o v e r h o w m u c h d a t a w e b j e c t .

B y u s i n g p a r a m e t e r v a l u e s u b s t i t u t i o n f o r t h e M A Xs e r i e s o f w e b j e c t s c a n b e c o d e d t h a t a l l o w t h e d a t a ii n m a n a g e a b l e r e s u l t s e t s . F o r m o r e i n f o r m a t i o n , s D y n a m i c P a r a m e t e r V a l u e S u b s t i t u t i o n o n p a g e 4 0 .

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o d i s p l a y a l l r e m as t a r t i n g w i t h t h e e l e m e n t i d e n t i e d i n t h e S T A R T p o p t i o n a l .




P A T H _ I N F O S p e c i e s a d d i t i o n a l p a t h i n f o r m a t i o n t o i n s e r t w i t h t h e T E M P L A T E _ U R L p a r a m e t e r . T h i s s C G I - e n c o d e d t o p r e v e n t t h e g e n e r a t i o n o f i n v as p e c i e d , n o a d d i t i o n a l t e x t i s a d d e d t o t h e g e n o f v a l u e s s p e c i e d f o r t h i s p a r a m e t e r m u s t e q u s p e c i e d w i t h t h e H Y P E R L I N K p a r a m e t e r . A nT h e v a l u e s o f t h i s p a r a m e t e r a r e a s s o c i a t e d w i tv a l u e s i n t h e o r d e r e n c o u n t e r e d . H Y P E R L I N Ku s e t h i s p a r a m e t e r . M u l t i p l e v a l u e s c a n b e s p e c

S T A R T S p e c i e s t h e n u m b e r o f t h e r s t e l e m e n t i n t h e g p a r a m e t e r i n c o n j u n c t i o n w i t h t h e M A X p a r a m r e t u r n e d t h r o u g h t h e w e b j e c t .

B y u s i n g p a r a m e t e r v a l u e s u b s t i t u t i o n f o r t h e Ms e r i e s o f w e b j e c t s c a n b e c o d e d t h a t a l l o w t h e d i n m a n a g e a b l e r e s u l t s e t s . F o r m o r e i n f o r m a t i o D y n a m i c P a r a m e t V a l u e S u b s t i t u t i o n o n p a g e 4 0 .

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o s t a r t w i t h t hT h i s p a r a m e t e r i s o p t i o n a l .

T E M P L A T E _ U R L S p e c i e s t h e b a s e U R L o r l i s t o f b a s e U R L s t o bh y p e r l i n k s f o r t h e a t t r i b u t e s s p e c i e d w i t h t h e Hm u s t b e a U R L f o r e v e r y a t t r i b u t e s p e c i e d w i t

T h e v a l u e s o f t h i s p a r a m e t e r a r e a s s o c i a t e d w i tv a l u e s i n t h e o r d e r e n c o u n t e r e d . I f a T E M P L A c o n t a i n s t h e s t r i n g “ m a i l t o : ” , t h e n t h e a s s o c i a t e d H Y P E R Lv a l u e i s a s s u m e d t o b e a n e m a i l a d d r e s s , a n d a n m a i l t o U R L i s c o n s t r u c t e d .

H Y P E R L I N K m u s t b e s p e c i e d i n o r d e r t o u s e p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r .

W I D T H S p e c i e s a l i s t o f t h e w i d t h s o f e a c h a t t r i b u t e c o p r e - f o r m a t t e d t e x t t a b l e , H T M L d o e s n o t a l l o wd a t a . T h e d e f a u l t v a l u e o f t h i s o p t i o n a l p a r a m e

v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r . T h i s

E X A M P L E S

T h e f o l l o w i n g D i s p l a y - T a b l e w e b j e c t e x a m p l e s m u l t i p l e e l e m e n t s ; e a c h w i t h a n a m e , a d d r e s s a n




D E F A U L T D I S P L A Y I n t h e f o l l o w i n g e x a m p l e , a l l o f t h e i n f o r m a t i o n i s v a l u e s f o r t h e t a b l e :

W e b j e c t


O u t p u t


< t a b l e b o r d e r = 1 > < t r > < t h > N A M E < / t h > < t h > A D D R E S S < / t h > < t h > E M A I L< t r > < t d > S a m J o h n s o n < / t d > < t d > 1 2 3 4 M a i n

S t . < / t d > < t d > s j o h n s o n @ s o m e w h e r e . c o m < /< t r > < t d > H a r v y A n d e r s o n < / t d > < t d > 1 2 3 4 A m b e r

S t . < / t d > < t d > h a n d e r s o n @ s o m e w h e r e . c o m < < t r > < t d > J a m e s O ' C o n n o r < / t d > < t d > 7 7 5 M a i n

S t . < / t d > < t d > & n b s p ; < / t d > < / t r >< t r > < t d > H a r v e y H a m p t o n < / t d > < t d > 7 7 5 M a i n

S t . < / t d > < t d > h h a m p t o n @ s o m e w h e r e . c o m < < / t a b l e >




N O B O R D E R S , N O H E A D E R S

W e b j e c t

 



O u t p u t


 S a m J o h n s o n 1 2 3 4 M a i n S t . s j o h n s o n @ s o m e w h e r e . c o m

H a r v y A n d e r s o n 1 2 3 4 A m b e r S t . h a n d e r s o n @ s o m e w h e r e . c o m J a m e s O ' C o n n o r 7 7 5 M a i n S t . & n b s p ; H a r v e y H a m p t o n 7 7 5 M a i n S t . h h a m p t o n @ s o m e w h e r e . c o m 




M U L T I P L E C O L U M N S T h e f o l l o w i n g e x a m p l e s h o w s a t a b l e w i t h m u l t i p l e p a r a m e t e r s p e c i e s t h e i n f o r m a t i o n t o d i s p l a y w i t hd e l i m i t e r . T h e B O R D E R p a r a m e t e r o v e r r i d e s t h e dW e b j e c t

 

O u t p u t

M U L T I P L E C O L U M N S W I T H A L T E R N A T E N A T h e f o l l o w i n g e x a m p l e s h o w s t h e h e a d e r w i t h a d i p a r a m e t e r o v e r r i d e s t h e d e f a u l t . A c o m m a i s u s e d at e x t f o l l o w s t h e t a b l e .

W e b j e c t 

< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " a d d r e s s , e m a i l< i e : p a r a m n a m e = " H E A D E R "

d a t a = " E m a i l A d d r e s s , H o m e A d d r e s s " d e l i m = " 

O u t p u t




H Y P E R L I N K E D C O L U M N S I n t h e f o l l o w i n g e x a m p l e , t h e H Y P E R L I N K p at h a t c o n t a i n h y p e r l i n k s . T h e W I D T H p a r a m e t e

W e b j e c t

 < i e : p a r a m n a m e = " T E M P L A T E _ U R L "

d a t a = " m a i l t o : a b c @ s o m e c o m p a n 

O u t p u t

D i s p l a y - V a l u e


D i s p l a y s t h e v a l u e o f a n a t t r i b u t e , o r s e t o f a t t r i b uH T M L e l e m e n t s .

S Y N T A X



 < i e : p a r a m n a m e = " T Y P E " d a t a = " [ H T M L | R A D I O | F I L




T E X T | T E X T A R E A | H I D D E N | C H E C K B O X | P A S S W



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l A T T R I B U T E N A M E G R O U P _ I N

P R O M P T P R E _ T A B L E _ T E X T S I Z E P O S T _ T A B L E _ T E X T T Y P E U N D E F I N E D

A T T R I B U T E I d e n t i e s t h e n a m e o f t h e d a t a b a s e a t t r i b u t e s t o d i s

t h e a t t r i b u t e s a r e s p e c i e d d e t e r m i n e s t h e o r d e r i n wR e f e r t o t h e t a b l e i n t h e T Y P E p a r a m e t e r d e s c r i p t i ow h i c h t h i s p a r a m e t e r c a n b e u s e d . M u l t i p l e v a l u e s p a r a m e t e r . T h i s p a r a m e t e r i s r e q u i r e d .


T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e l a s t g r o uT h i s p a r a m e t e r i s o p t i o n a l .

N A M E A s s i g n s a f o r m n a m e t o t h e g e n e r a t e d F O R M e l e m n a m e i n t h e n e x t J S P p a g e t o s u p p l y a v a l u e ( s u c h a T h e d e f a u l t f o r t h i s p a r a m e t e r i s t h e a t t r i b u t e n a m ed i s p l a y e d . R e f e r t o t h e t a b l e i n t h e T Y P E p a r a m e t ev a l u e s w i t h w h i c h t h i s p a r a m e t e r c a n b e u s e d .

P O S T _ T A B L E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d a f t e r e a c h g r f o r t h i s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

P R E _ T A B L E _ T E X T S p e c i e s t h e t e x t o r H T M L g e n e r a t e d b e f o r e e a c h

d e f a u l t f o r t h i s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a l . P R O M P T

S p e c i e s a d e s c r i p t i v e s t r i n g o f t e x t t h a t y o u w a n t ta t t r i b u t e v a l u e . T h e d e f a u l t f o r t h i s p a r a m e t e r i s t h v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r . R e f e r t o p a r a m e t e r d e s c r i p t i o n f o r t h e T Y P E v a l u e s w i t h w b e u s e d .




S I Z E S e t s t h e l e n g t h o f t h e t e x t e l d u s e d t o d i s p l a y t h

I f t h e S I Z E p a r a m e t e r i s u s e d t o s p e c i f y t h e s i z e p a r a m e t e r , t h e n t h e v a l u e o f t h e S I Z E p a r a m e t f o r m a t d a t a = " c o l u m n s X r o w s " ( f o r e x a m p l e , d a t a = " 1 0 x 4 " ) .

I f y o u u s e t h e S I Z E p a r a m e t e r t o l i m i t t h e m a x i s u c h a T E X T o r P A S S W O R D i n t h e T Y P E p a r t h e v a l u e u s i n g t h e f o r m a t d a t a = " w i n d o w s i z e / m a x i m u m s i " , w h e r e t h e w i n d o w s i z e i s t h e m a x i m u m n u m b e r o f c h a r a c t e re l e m e n t a n d t h e m a x i m u m s i z e i s t h e m a x i m u m n u m b e r o f c ha c c e p t f o r t h a t e l e m e n t . F o r e x a m p l e , a s s u m e t w i n d o w s i z e i s 1 0 a n d y o u r m a x i m u m s i z e i s 2 0 ; t h e r e s u l t i n g p a r a m e t e r w o



R e f e r t o t h e t a b l e i n t h e T Y P E p a r a m e t e r d e s c r w h i c h t h i s p a r a m e t e r c a n b e u s e d . M u l t i p l e v a p a r a m e t e r . T h e d e f a u l t f o r t h i s p a r a m e t e r i s 1 1




T Y P E S p e c i e s h o w t o d i s p l a y t h e v a l u e o f t h e A T T R I B Ua r e H T M L , P L A I N , T E X T , T E X T A R E A , H I D D E

• C H E C K B O X – D i s p l a y s d a t a w i t h a c h e c k b o x t i n c o n j u n c t i o n w i t h a f o r m .

• F I L E – A l l o w s t h e u s e r t o s e l e c t l e s i n o r d e r t o s a f o r m . M u s t b e u s e d i n c o n j u n c t i o n w i t h a f o r m .

• H I D D E N – C r e a t e s a h i d d e n f o r m e l e m e n t w h i c p a s s e s t h e v a l u e o f t h e a t t r i b u t e . M u s t b e u s e d i n

• H T M L – E n c o d e s a n o u t p u t s t r i n g i n H T M L . • P A S S W O R D – S i m i l a r t o T E X T . H o w e v e r , w h a

t h e u s e r . M u s t b e u s e d i n c o n j u n c t i o n w i t h a f o r m• P L A I N – D i s p l a y s a n a t t r i b u t e v a l u e a s t e x t t h a t • R A D I O – D i s p l a y s d a t a w i t h a r a d i o b u t t o n t o t h

l i k e c h e c k b o x e s ; h o w e v e r r a d i o b u t t o n s m a y b e m b e u s e d i n c o n j u n c t i o n w i t h a f o r m .

• T E X T – D i s p l a y s a n a t t r i b u t e v a l u e i n a t e x t b o x b e u s e d i n c o n j u n c t i o n w i t h a f o r m .

• T E X T A R E A – D i s p l a y s m u l t i p l e r o w s . H o w e v a n d c o l u m n s m u s t b e s p e c i e d i n t h e S I Z E p a r a m b e u s e d i n c o n j u n c t i o n w i t h a f o r m .

T h e d e f a u l t f o r t h i s o p t i o n a l p a r a m e t e r i s P L A I N .

T h e f o l l o w i n g t a b l e s h o w s w h i c h p a r a m e t e r s a r e uT Y P E :

A T T R I B U T E N A M E P R O M P T S I Z E C H E C K B O X X X F I L E X H I D D E N X X H T M L X P A S S W O R D X X X X R A D I O X X T E X T X X X X

T E X T A R E A X X X U N D E F I N E D

S e t s t h e v a l u e t o d i s p l a y f o r a n u n d e n e d v a l u e . A na n o n e x i s t e n t a t t r i b u t e o r a n a t t r i b u t e t h a t h a s a n u lc o n t a i n i n g a n e m p t y s t r i n g ( " " ) i s n o t i n t e r p r e t e d a s b e i n g u n d e nd e f a u l t f o r t h i s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a l .




E X A M P L E S

T h e f o l l o w i n g D i s p l a y - V a l u e w e b j e c t e x a m p l e s

m u l t i p l e e l e m e n t s ; e a c h w i t h a n a m e , a d d r e s s a n N o t e T h e F O R M e l e m e n t i s n o t a u t o m a t i c a l l y g e n e r a t el i s t s c o r r e c t l y , i n c l u d e t h e < F O R M > a n d < / F O R M > t a g s a s s h o w n i n t h e e x

D E F A U L T D I S P L A Y O F M U L T I P L E A T T R I B

W e b j e c t < f o r m > 

< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " c r e a t e d g r o < / f o r m >

O u t p u t

G e n e r a t e d H T M L < f o r m > E M A I L : s j o h n s o n @ s o m e w h e r e . c o m N A M E M A I L : h a n d e r s o n @ s o m e w h e r e . c o m N A E M A I L : N / A N A M E : J a m e s O ' C o n n o E M A I L : h h a m p t o n @ s o m e w h e r e . c o m N A < / f o r m >




M U L T I P L E A T T R I B U T E S W I T H P R O M P T S A N N A M E S

T h e f o l l o w i n g e x a m p l e d i s p l a y s t h e N A M E a n d A t h e i r P R O M P T v a l u e .


< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " N A M E , A D D R E 

 < / f o r m >

O u t p u t

G e n e r a t e d H T M L < f o r m > N a m e P r o m p t A d d r e s s P r o m p t < i n p u t t yn a m e = " A d d r e s s F i e l d " v a l u e = " 1 2 3 4 M a i n S t . "

N a m e P r o m p t A d d r e s s P r o m p t < i n p u t t

n a m e = " A d d r e s s F i e l d " v a l u e = " 1 2 3 4 A m b e r S t . " N a m e P r o m p t A d d r e s s P r o m p t < i n p u t tn a m e = " A d d r e s s F i e l d " v a l u e = " 7 7 5 M a i n S t . " s

N a m e P r o m p t A d d r e s s P r o m p t < / f o r m >




S I N G L E A T T R I B U T E , T Y P E = P L A I N

W e b j e c t

< f o r m > i e : w e b j e c t n a m e = " D i s p l a y - V a l u e " t y p e = " D S P " >

 

 < / f o r m >

O u t p u t


< f o r m > S a m J o h n s o n H a r v y A n d e r s o n J a m e s O ' C o n n o r H a r v < / f o r m >

M U L T I P L E A T T R I B U T E S W I T H P R O M P T S T Y P E = T E X T


< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " N A M E , A D 

 < / f o r m >

O u t p u t




M U L T I P L E A T T R I B U T E S W I T H P R O M P T S , S P T Y P E = T E X T


 

 < f o r m >

O u t p u t

M U L T I P L E A T T R I B U T E S W I T H P R O M P T S , S P M U L T I P L E T Y P E V A L U E S

W e b j e c t

< f o r m > 

 

 < / f o r m >

O u t p u t




M U L T I P L E A T T R I B U T E S W I T H P R O M P T S T Y P E = C H E C K B O X


 

 < / f o r m >

O u t p u t




M U L T I P L E A T T R I B U T E S W I T H P R O M P T S , T Y

W e b j e c t


 

 < / f o r m >

O u t p u t




S I N G L E A T T R I B U T E W I T H P R O M P T , T Y P E

W e b j e c t


 

 < / f o r m >

O u t p u t

D i s p l a y - X M L


D i s p l a y s a n X M L f o r m a t t e d p a g e o f t h e s p e c i e dV D B . T h e w e b j e c t p r o v i d e s a n a l i a s f o r a d i r e c t co u t p u t o f t h e w e b j e c t i s i d e n t i c a l t o u s i n g t h e U R

h t t p : / / m a c h i n e / W i n d c h i l l / s e r v l e t / I E / t T h i s U R L a s s u m e s t h a t t h e I n f o * E n g i n e a p p l i c a/ W i n d c h i l l / s e r v l e t / I E / t a s k s .

N o t e D o n o t i n c l u d e a n y H T M L t a g s o n t h e J S P p a g e c oi n c l u d e o n l y o n e o c c u r r e n c e o f t h e w e b j e c t o n a p at h e J S P p a g e c o r r u p t s t h e X M L s y n t a x .

S Y N T A X



 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N




R e q u i r e d S e l e c t O p t i o n a l M O D E


M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r p a r a m e t e r i s t o u s e a l l g r o u p s i n t h e V D B . T h i s p a r

M O D E S p e c i e s w h e t h e r m e t a d a t a i s i n c l u d e d i n t h e g e n eS p e c i f y i n g F U L L i n c l u d e s m e t a d a t a a t a l l l e v e l s o

T h e d e f a u l t f o r t h i s p a r a m e t e r i s B R I E F . T h i s p a r a mE X A M P L E S

T h e f o l l o w i n g D i s p l a y - X M L w e b j e c t e x a m p l e a s s u mm u l t i p l e e l e m e n t s ; e a c h w i t h a n a m e , a d d r e s s a n d e m

F o r a n e x a m p l e t h a t s h o w s t h e X M L o u t p u t u s i n g M S e t - M e t a d a t a w e b j e c t o n p a g e 3 9 4 .

W e b j e c t < % @ p a g e l a n g u a g e = " j a v a "

s e s s i o n = " f a l s e " e r r o r P a g e = " . . / I E E r r o r . j s p " % >

< % @ t a g l i b u r i = h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b / c o r e p r e f i x = " i e " % >

 




G e n e r a t e d X M L < ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? > < w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m /< E m p l o y e e D a t a N A M E = " c r e a t e d g r o u p " T Y P E = " O b j e





< N A M E > J a m e s O & a p o s ; C o n n o r < / N A M E > < A D D R E S S > 7 7 5 M a i n S t . < / A D D R E S S >

< E M A I L > < / E M A I L > < / w c : I N S T A N C E > < w c : I N S T A N C E >



E c h o - R e q u e s t

D E S C R I P T I O N D i s p l a y s t h e v a l u e s a n d m e t a d a t a o f t h e c u r r e n t gi n H T M L f o r m a t . A l l V D B g r o u p s a n d c o n t e x t g a r e f o r m a t t e d .

T h i s w e b j e c t c a n a l s o b e u s e d t o v e r i f y t h a t t h e I n p r o p e r l y w i t h o u t c o n n e c t i n g t o a n y a d a p t e r .

S Y N T A X



P A R A M E T E R S

N o p a r a m e t e r s a r e r e q u i r e d b e c a u s e t h e E c h o - R ed i s p l a y o b j e c t s . I n s t e a d , i t d i s p l a y s t h e w e b j e c t p a s t h e e n v i r o n m e n t a n d t h e f o r m v a r i a b l e s . W e b ju s u a l a n d t h e i r r e s u l t i n g v a l u e s a r e d i s p l a y e d i n a






I m a g e W e b j e c t s f o r J P E G T h e f o l l o w i n g w e b j e c t s c a n b e u s e d t o d i s p l a y i m

• B a r - G r a p h o n p a g e 3 4 5 • L i n e - G r a p h o n p a g e 3 4 9 • P i e - C h a r t o n p a g e 3 5 3

B a r - G r a p h


T a k e s a s i n p u t a n I n f o * E n g i n e g r o u p c o n t a i n i n g p r o d u c e s a J P E G i m a g e a s o u t p u t .

S Y N T A X

 < i e : p a r a m n a m e = " B A C K D R O P _ C O L O R " d a t a = " h t m l _ < i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " i n p u t _ g r o u p n a m< i e : p a r a m n a m e = " H E I G H T " d a t a = " i n t e g e r _ h e i g h t " / < i e : p a r a m n a m e = " I N S E T _ B O T T O M " d a t a = " i n t e g e r _ i < i e : p a r a m n a m e = " I N S E T _ L E F T " d a t a = " i n t e g e r _ i n s e < i e : p a r a m n a m e = " I N S E T _ R I G H T " d a t a = " i n t e g e r _ i n s < i e : p a r a m n a m e = " L A B E L _ A N G L E " d a t a = " i n t e g e r _ a n < i e : p a r a m n a m e = " S C A L E _ I N C R E M E N T " d a t a = " d o u b l 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R A P H B A C K D R O P _ C O L O RG R O U P _ I N B A C K G R O U N D _ C O

C O L O R D E C I M A L _ P L A C E S H E I G H T I N S E T _ B O T T O M






H E I G H T S p e c i e s t h e i n t e g e r h e i g h t o f t h e g e n e r a t e d i m

I N S E T _ B O T T O M S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a dT h e d e f a u l t v a l u e i s 1 0 .

I N S E T _ L E F T S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a dT h e d e f a u l t v a l u e i s 1 0 .

I N S E T _ R I G H T S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a dT h e d e f a u l t v a l u e i s 1 0 .

I N S E T _ T O P S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a dd e f a u l t v a l u e i s 1 0 .

I N S E T S S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a dI f t h i s p a r a m e t e r i s s p e c i e d i t o v e r r i d e s t h e p r I N S E T _ R I G H T , I N S E T _ T O P a n d I N S E T _ B O

L A B E L S p e c i e s t h e n a m e o f t h e c o l u m n c o n t a i n i n g s t g e n e r a t e d . T h e d e f a u l t i s n o t t o d i s p l a y l a b e l s .

L A B E L _ A N G L E S p e c i e s t h e i n t e g e r a n g l e a t w h i c h t o d i s p l a y ta v o i d o v e r l a p p i n g l a b e l s w h e n o n e o r m o r e a r ev a l u e i s 0 .

S C A L E _ I N C R E M E N T S p e c i e s a o a t i n g p o i n t n u m b e r g o v e r n i n g h o a x i s . I f s p e c i e d , s c a l e s s t a r t a t 0 a n d a p p e a r e v u n t i l t h e l a r g e s t d a t a p o i n t i n t h e d a t a t o b e g r a pd i s p l a y a s c a l e .

T E X T _ C O L O R

S p e c i e s t h e c o l o r , i n # R R G G B B f o r m a t , o f t e i m a g e . T h e d e f a u l t v a l u e i s b l a c k .

W I D T H S p e c i e s t h e i n t e g e r w i d t h o f t h e g e n e r a t e d i m a




E X A M P L E

G i v e n t h e f o l l o w i n g i n p u t d a t a ( i n G R O U P _ I N n a m e

N a m e S a l e s j o e 7 0 0 0 f r e d 5 0 0 0 k i n g 1 5 0 0 0 b i l l 2 5 0 0 f r a n k 7 5 0 0

a n d t h e f o l l o w i n g J S P :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " t r u e " c o n t e n t T y p e = " i m a g e / j p e g "

% > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i% > 

 



R e s u l t s i n t h e f o l l o w i n g i m a g e :




L i n e - G r a p h



S Y N T A X

 < i e : p a r a m n a m e = " B A C K D R O P _ C O L O R " d a t a = " h t m l _ < i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " i n p u t _ g r o u p n a m< i e : p a r a m n a m e = " H E I G H T " d a t a = " i n t e g e r _ h e i g h t " / < i e : p a r a m n a m e = " I N S E T _ B O T T O M " d a t a = " i n t e g e r _ i < i e : p a r a m n a m e = " I N S E T _ L E F T " d a t a = " i n t e g e r _ i n s e < i e : p a r a m n a m e = " I N S E T _ R I G H T " d a t a = " i n t e g e r _ i n s 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R A P H B A C K D R O P _ C O L OG R O U P _ I N B A C K G R O U N D _X C O L O R

D E C I M A L _ P L A C E S

H E I G H T I N S E T _ B O T T O M I N S E T _ L E F T I N S E T _ R I G H T I N S E T _ T O P I N S E T S M A X Y M I N Y




R e q u i r e d S e l e c t O p t i o n a l T E X T _ C O L O R W I D T H X S C A L E _ I N C R E M E N T Y S C A L E _ I N C R E M E N T

B A C K D R O P _ C O L O R S p e c i e s t h e c o l o r , i n # R R G G B B f o r m a t , o f t h e b a i m a g e . T h e d e f a u l t v a l u e i s l i g h t G r a y ( # 8 6 8 6 8 6 ) .

B A C K G R O U N D _ C O L O R S p e c i e s t h e c o l o r , i n # R R G G B B f o r m a t , o f t h e b a i m a g e . T h e d e f a u l t v a l u e i s w h i t e .

C O L O R S p e c i e s t h e c o l o r , i n # R R G G B B f o r m a t , t h a t t h e gr e n d e r e d i n . T h i s p a r a m e t e r m a y b e m u l t i - v a l u e d . t h e c o l o r s s p e c i e d a r e u s e d i n o r d e r a n d a l l v a l u e s d a t a i n t h e i n p u t g r o u p h a s b e e n g r a p h e d . F o r e x a m p a r a m e t e r s a s t h e f o l l o w i n g :

< i e : p a r a m n a m e = " C O L O R " d a t a = " # F F 0 0 0 0 , # 0 0 0 0 F F " d e

c a u s e s a l t e r n a t i n g r e d a n d b l u e .

T h e d e f a u l t v a l u e i s # 0 0 0 0 C 8 .

D E C I M A L _ P L A C E S

S p e c i e s a n i n t e g e r t h a t g o v e r n s h o w m a n y d e c i m d i s p l a y e d o n s c a l e s . T h i s p a r a m e t e r i s i g n o r e d i f n Y S C A L E _ I N C R E M E N T o r X S C A L E _ I N C R E M

G R A P H S p e c i e s t h e n a m e o f t h e c o l u m n ( s ) c o n t a i n i n g t h e p a r a m e t e r c a n b e m u l t i - v a l u e d

G R O U P _ I N S p e c i e s t h e n a m e o f t h e i n p u t g r o u p c o n t a i n i n g d a

H E I G H T S p e c i e s t h e i n t e g e r h e i g h t o f t h e g e n e r a t e d i m a g e

I N S E T _ B O T T O M S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a d t h eT h e d e f a u l t v a l u e i s 1 0 .

I N S E T _ L E F T S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a d t h eT h e d e f a u l t v a l u e i s 1 0 .




I N S E T _ R I G H T S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a dT h e d e f a u l t v a l u e i s 1 0 .

I N S E T _ T O P S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a dd e f a u l t v a l u e i s 1 0 .

I N S E T S S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a dI f t h i s p a r a m e t e r i s s p e c i e d i t o v e r r i d e s t h e p r I N S E T _ R I G H T , I N S E T _ T O P a n d I N S E T _ B O

M A X Y S p e c i e s t h e l a r g e s t v a l u e f o u n d i n t h e d a t a s e t

M I N Y S p e c i e s t h e s m a l l e s t v a l u e f o u n d i n t h e d a t a s e

T E X T _ C O L O R S p e c i e s t h e c o l o r , i n # R R G G B B f o r m a t , o f t e i m a g e . T h e d e f a u l t v a l u e i s b l a c k .


X S p e c i e s t h e n a m e o f t h e c o l u m n c o n t a i n i n g t h X a x i s .

X S C A L E _ I N C R E M E N T S p e c i e s a o a t i n g p o i n t n u m b e r g o v e r n i n g h o X a x i s . I f s p e c i e d , s c a l e s s t a r t a t t h e s m a l l e s t XX S C A L E _ I N C R E M E N T u n t i l t h e l a r g e s t X v aa s c a l e o n t h e X a x i s .

Y S C A L E _ I N C R E M E N T S p e c i e s a o a t i n g p o i n t n u m b e r g o v e r n i n g h o a x i s . I f s p e c i e d , s c a l e s s t a r t a t M I N Y o r t h e s ms e t a n d a p p e a r e v e r y Y S C A L E _ I N C R E M E N T p o i n t f o u n d i n t h e d a t a s e t . T h e d e f a u l t i s t o n o t

E X A M P L E

G i v e n t h e f o l l o w i n g i n p u t d a t a ( i n G R O U P _ I N v

X G 1 G 2 0 . 0 1 0 0 . 0 2 0 0 . 0 1 . 0 2 0 0 . 0 5 0 . 0 2 . 0 3 0 0 . 0 4 0 0 . 0 3 . 0 1 5 0 . 0 0 . 0




X G 1 G 2 4 . 0 5 0 . 0 1 0 . 0 5 . 0 4 0 0 . 0 3 0 . 0 6 . 0 3 7 5 . 0 4 0 . 0


< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " t r u e " c o n t e n t T y p e = " i m a g e / j p e g " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i% > 

 

 




I f t i t l e s a n d a l e g e n d a r e r e q u i r e d , t h e y s h o u l d b e g e n J S P t h a t i n c l u d e s t h i s i m a g e .




P i e - C h a r t



S Y N T A X

 < i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " i n p u t _ g r o u p n a m< i e : p a r a m n a m e = " H E I G H T " d a t a = " i n t e g e r _ h e i g h t " / < i e : p a r a m n a m e = " I N S E T _ B O T T O M " d a t a = " i n t e g e r _ i < i e : p a r a m n a m e = " I N S E T _ L E F T " d a t a = " i n t e g e r _ i n s e < i e : p a r a m n a m e = " I N S E T _ R I G H T " d a t a = " i n t e g e r _ i n s 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R A P H B A C K G R O U N D _ C O LG R O U P _ I N C O L O R

D E C I M A L _ P L A C E S H E I G H T I N S E T _ B O T T O M I N S E T _ L E F T I N S E T _ R I G H T I N S E T _ T O P I N S E T S L A B E L T E X T _ C O L O R W I D T H

B A C K G R O U N D _ C O L O R S p e c i e s t h e c o l o r , i n # R R G G B B f o r m a t , o f t h i m a g e . T h e d e f a u l t v a l u e i s w h i t e .




C O L O R S p e c i e s t h e c o l o r , i n # R R G G B B f o r m a t , t h a t t h e g b e r e n d e r e d i n . T h i s p a r a m e t e r m a y b e m u l t i - v a l u et h e c o l o r s s p e c i e d a r e u s e d i n o r d e r a n d a l l v a l u e s d a t a i n t h e i n p u t g r o u p h a s b e e n g r a p h e d . F o r e x a m p a r a m e t e r s s u c h a s t h e f o l l o w i n g :

< i e : p a r a m n a m e = " C O L O R " d a t a = " # F F 0 0 0 0 , # 0 0 0 0 F F " d e

c a u s e s a l t e r n a t i n g r e d a n d b l u e .

O p t i o n a l l y e a c h i n p u t g r o u p c a n c o n t a i n a c o l u m n t h e c o l o r t o u s e f o r e a c h d a t a p o i n t i n t h e i n p u t g r o uo v e r r i d e s d a t a c o n t a i n e d i n t h e i n p u t g r o u p .

T h e d e f a u l t v a l u e i s w h i t e .

D E C I M A L _ P L A C E S S p e c i e s a n i n t e g e r t h a t g o v e r n s h o w m a n y d e c i m a p e r c e n t v a l u e s o f l a b e l s . T h i s p a r a m e t e r i s i g n o r e dL A B E L . D e f a u l t v a l u e i s 0 .

G R A P H S p e c i e s t h e n a m e o f t h e c o l u m n c o n t a i n i n g t h e d a

G R O U P _ I N S p e c i e s t h e n a m e o f t h e i n p u t g r o u p c o n t a i n i n g d a

H E I G H T S p e c i e s t h e i n t e g e r h e i g h t o f t h e g e n e r a t e d i m a g e

I N S E T _ B O T T O M S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a d t h eT h e d e f a u l t v a l u e i s 1 0 .

I N S E T _ L E F T S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a d t h eT h e d e f a u l t v a l u e i s 1 0 .

I N S E T _ R I G H T S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a d t h e T h e d e f a u l t v a l u e i s 1 0 .

I N S E T _ T O P

S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a d t h ed e f a u l t v a l u e i s 1 0 .

I N S E T S S p e c i e s a n i n t e g e r v a l u e t o u s e a s i n s e t s t o p a d t h eI f t h i s p a r a m e t e r i s s p e c i e d i t o v e r r i d e s t h e p r e s e nI N S E T _ R I G H T , I N S E T _ T O P a n d I N S E T _ B O T T




L A B E L S p e c i e s t h e n a m e o f t h e c o l u m n c o n t a i n i n g s t rt h e p i e . L a b e l s a r e o f t h e f o r m < t e x t > ( X X % ) w h e r e < t e x t > i s t h e v a l u e f o r t h e d a t a p o i n t b e i n g g r a p h e d a n d X X i s t h e p e r c e n t o f t h e t o t a l d p o i n t r e p r e s e n t s . T h e d e f a u l t i s n o t t o d i s p l a y l

T E X T _ C O L O R S p e c i e s t h e c o l o r , i n # R R G G B B f o r m a t , o f t e i m a g e . T h e d e f a u l t v a l u e i s b l a c k .


E X A M P L E

G i v e n t h e f o l l o w i n g i n p u t d a t a ( i n G R O U P _ I N n

N a m e S a l e s j o e 7 0 0 0 f r e d 5 0 0 0 k i n g 1 5 0 0 0 b i l l 2 5 0 0 f r a n k 7 5 0 0


< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " t r u e " c o n t e n t T y p e = " i m a g e / j p e g " % >

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g

 

 










1 4 T a s k W e b j e c t R e

A d m i n i s t r a t i v e W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G r o u p W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . M a n a g e m e n t W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .M e s s a g e W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . W e b E v e n t S e r v i c e W e b j e c t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

T h e f o l l o w i n g t o p i c s c o n t a i n i n f o r m a t i o n a b o u t

i n d i v i d u a l l i s t i n g c o n t a i n s t h e w e b j e c t n a m e , a d s y n t a x , d e s c r i p t i o n s o f a l l p a r a m e t e r s , a n d , i n m o

B e f o r e t h e i r d e s c r i p t i o n s , p a r a m e t e r s a r e g r o u p e d i n t h e

• R e q u i r e d — T h e p a r a m e t e r i s a l w a y s r e q u i r e d• S e l e c t — A r e l a t i o n s h i p b e t w e e n t h e s p e c i e d

p a r a m e t e r e x i s t s . F o r e x a m p l e , t h e E L E M E N Tt h e C r e a t e - G r o u p w e b j e c t a r e s e l e c t b e c a u s e a tr e q u i r e d .

A p a r a m e t e r i s a l s o l i s t e d i n t h e “ S e l e c t ” c o l u m b e t w e e n t h e v a l u e s i n t h e s p e c i e d p a r a m e t e r a

F o r e x a m p l e , i n t h e C r e a t e - O b j e c t w e b j e c t , t h e p a r a m e t e r d e t e r m i n e s w h i c h P U T _ p a r a m e t e r t h e T Y P E a n d P U T _ p a r a m e t e r s a r e l i s t e d i n t h

• O p t i o n a l — T h e p a r a m e t e r i s a l w a y s o p t i o n a l p a r a m e t e r .

3 5 7



A d m i n i s t r a t i v e W e b j e c t s T h e f o l l o w i n g w e b j e c t s p r o v i d e a q u i c k w a y t o p e r f o

t a s k s , s u c h a s g a t h e r i n g s i m p l e s t a t i s t i c s o r c a u s i n g sr u n t i m e :

• G e t - S t a t i s t i c s o n p a g e 3 5 8 • R e l o a d - P r o p e r t i e s o n p a g e 3 5 9

A l l a d m i n i s t r a t i v e w e b j e c t s u s e t h e A D M t y p e a t t r i b u t e v a l u e i n t h e w e b j e c t t a g .

G e t - S t a t i s t i c s


R e t u r n s a g r o u p c o n t a i n i n g s i m p l e s t a t i s t i c a l i n f o r m p r o c e s s . T h e r e t u r n e d g r o u p c o n t a i n s t h e f o l l o w i n g s

• s e r v i c e N a m e — N a m e o f t h e s e r v i c e • s e r v i c e T y p e — T y p e o f s e r v i c e . V a l i d s e r v i c e t y p e s a r e t

a d a p t e r . • a c t i v e T h r e a d s — N u m b e r o f a c t i v e l y r u n n i n g t h r e a d s , n o

c u r r e n t t h r e a d . • h a n d l e d R e q u e s t s — N u m b e r o f r e q u e s t s h a n d l e d . • a v e r a g e R e s p o n s e — A v e r a g e t i m e i n m i l l i s e c o n d s i t h a s t a

t o a r e q u e s t .

R e q u e s t s t o e x e c u t e a d m i n i s t r a t i v e w e b j e c t s a r e n o

N o t e T h i s w e b j e c t i s o n l y s u p p o r t e d b y p r o c e s s e s l i s t e n i n g o u t - o f - p r o c e s s a d a p t e r o r a t a s k p r o c e s s o r .

S Y N T A X

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l I N S T A N C E




I N S T A N C E S p e c i e s t h e n a m e o f t h e p r o c e s s i n w h i c h t h i s wt h a t i s r u n n i n g o u t - o f - p r o c e s s o r a t a s k p r o c e s s


E X A M P L E

 

R e l o a d - P r o p e r t i e s

D E S C R I P T I O N R e l o a d s p r o p e r t i e s a s s o c i a t e d w i t h e i t h e r t h e c u r s e r v i c e N a m e o r a s p e c i c s e r v i c e N a m e . T h i s w e b j e c t c a n b e e x e c u t e d i n a d a p t e r s , t a s k p r o c e s s o r s , o r J S P p a g e s . I f t h e w e p a g e , t h e p r o p e r t i e s a r e r e l o a d e d b y a s e r v i c e r u n a s I e S e r v l e t , S o a p R P C R o u t e r , o r J S P p r o p e r t i e s .

S Y N T A X

 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l I N S T A N C E S E R V I C E _ N A M E

I N S T A N C E S p e c i e s t h e n a m e o f t h e p r o c e s s i n w h i c h t h i s wt h a t i s r u n n i n g o u t - o f - p r o c e s s o r a t a s k p r o c e s s


T a s k W e b j e c t R e f e r e n c e 3 5 9



S E R V I C E _ N A M E S p e c i e s t h e n a m e o f t h e s e r v i c e w h o s e p r o p e r t i e s p a r a m e t e r i s o m i t t e d , t h e n t h e w e b j e c t r e l o a d s t h e r u n n i n g s e r v i c e . I f t h e v a l u e s p e c i e d f o r S E R V I C s e r v i c e , t h e n c o m . i n f o e n g i n e . a u . N o S u c h S e r v i c e E i s t h r o w n .


G r o u p W e b j e c t s T h e f o l l o w i n g w e b j e c t s c o m p a r e , c o m b i n e , o r s o r t o n e o r m o r e e x i s t i n g g r od a t a t h a t h a v e b e e n g e n e r a t e d a s a r e s u l t o f q u e r y , a c t i o n , o r o t h e r g r o u p w e

• C h a n g e - G r o u p o n p a g e 3 6 0 • C o n c a t - G r o u p s o n p a g e 3 6 2 • C o p y - G r o u p o n p a g e 3 6 4 • C r e a t e - G r o u p o n p a g e 3 6 6 • D i f f - G r o u p s o n p a g e 3 7 2 • E x t r a c t - G r o u p o n p a g e 3 7 5 • F o r m a t - G r o u p o n p a g e 3 7 7 • I n t e r s e c t - G r o u p s o n p a g e 3 8 0 • J o i n - G r o u p s o n p a g e 3 8 3 • M e r g e - G r o u p s o n p a g e 3 8 7 • R e t u r n - G r o u p s o n p a g e 3 9 0 • S e t - I d e n t i t y o n p a g e 3 9 2 • S e t - M e t a d a t a o n p a g e 3 9 4 • S o r t - G r o u p o n p a g e 3 9 8 • S u b s e t - G r o u p o n p a g e 4 0 3 • S u m m a r i z e - G r o u p s o n p a g e 4 0 6 • T r a n s l a t e - G r o u p o n p a g e 4 0 7 • U n i o n - G r o u p s o n p a g e 4 1 3 • X O R - G r o u p s o n p a g e 4 1 5

A l l g r o u p w e b j e c t s u s e t h e G R P t y p e a t t r i b u t e v a l u e i n t h e w e b j e c t t a g .

C h a n g e - G r o u p


C h a n g e s t h e n a m e o f o n e o r m o r e a t t r i b u t e s i n a g r o uc o n t a i n s t h e c h a n g e d a t t r i b u t e s a n d a l l a t t r i b u t e s n o t




S Y N T A X



 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N G R O U P _ O U T R E N A M E

G R O U P _ I N S p e c i e s t h e n a m e o f t h e g r o u p w i t h i n f o r m a t i p a r a m e t e r i s r e q u i r e d .

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e r e s u l t i n g g r o u p w i t h rG R O U P _ O U T i s s p e c i e d , t h e o r i g i n a l g r o u p ia n d i s n o l o n g e r a v a i l a b l e i n t h e V D B . T h e d e f aa t t r i b u t e c h a n g e s t o b e m a d e i n t h e o r i g i n a l g r o

R E N A M E S p e c i e s t h e a t t r i b u t e n a m e t o b e c h a n g e d . S p er e n a m i n g a n a t t r i b u t e . F o r e x a m p l e , t o c h a n g e o b j e c t C l a s s t o X Y Z c l a s s , t h e f o l l o w i n g R E N A M E p a r a m e t e r w o

< i e : p a r a m n a m e = " R E N A M E " d a t a = " ' o b j e c t C l a s s ' =

A s s h o w n a b o v e , t h e v a l u e o f t h e R E N A M E p ad o u b l e q u o t e s . T h e o l d n a m e a n d t h e n e w n a m ee n c l o s e d i n s i n g l e q u o t e s . A t t r i b u t e n a m e s a r e i s i g n o r e d w h e n t h e p a r a m e t e r s e a r c h e s f o r t h e


E X A M P L E

T h e w e b j e c t c h a n g e s t h e a t t r i b u t e n a m e s i n t h e i n

a n d a d d s t h e “ r e s u l t s ” g r o u p t o t h e l o c a l o u t p u t g < % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % >

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t

< ! - - C r e a t e s i n p u t g r o u p n a m e d c r e a t e d g r o u p . - - >





< ! - - R e n a m e s a t t r i b u t e s i n a g r o u p . - - >



 < i e : p a r a m n a m e = " R E N A M E " d a t a = " ' A D D R E S S ' = ' H o m e A



T h e X M L o u t p u t f r o m e x e c u t i n g t h e e x a m p l e i s t h e f

< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? > < w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o< E m p l o y e e D a t a N A M E = " r e s u l t s " T Y P E = " O b j e c t " S T A T U

< w c : I N S T A N C E > < F u l l N a m e > S a m J o h n s o n < / F u l l N a m e > < H o m e A d d r e s s > 1 2 3 4 M a i n S t . < / H o m e A d d r e s s > < e m a i l > s j o h n s o n @ s o m e w h e r e . c o m < / e m a i l >


< F u l l N a m e > H a r v y A n d e r s o n < / F u l l N a m e > < H o m e A d d r e s s > 1 2 3 4 A m b e r S t . < / H o m e A d d r e s s > < e m a i l > h a n d e r s o n @ s o m e w h e r e . c o m < / e m a i l >


< F u l l N a m e > J a m e s O & a p o s ; C o n n o r < / F u l l N a m e >

< H o m e A d d r e s s > 7 7 5 M a i n S t . < / H o m e A d d r e s s > < e m a i l > < / e m a i l >


< F u l l N a m e > H a r v e y H a m p t o n < / F u l l N a m e > < H o m e A d d r e s s > 7 7 5 M a i n S t . < / H o m e A d d r e s s > < e m a i l > h h a m p t o n @ s o m e w h e r e . c o m < / e m a i l >


C o n c a t - G r o u p s D E S C R I P T I O N

L i n k s t w o g r o u p s o f d a t a t o g e t h e r i n a s e r i e s , a l l o w i na p p e a r f r o m b o t h g r o u p s .




F o r e x a m p l e , g r o u p A c o n t a i n s t h e e l e m e n t s u , v e l e m e n t s x , y , a n d z . T h e C o n c a t - G r o u p s w e b j e c a n d B t o g e t h e r , o n e a f t e r t h e o t h e r , t o f o r m g r o u pt h e e l e m e n t s u , v , x , x , y , a n d z .

S Y N T A X

 < i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " g r o u p _ n a m e 1 " / 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N C L A S S G R O U P _ O U T

C L A S S S p e c i e s t h e t y p e o f t h e o b j e c t s c o n t a i n e d i n t h b y t h e G R O U P _ O U T p a r a m e t e r . F o r e x a m p l eC L A S S = M y C l a s s N a m e a n d G R O U P _ O U T = d a t a _ 1 , t h e n t h e X M L r e p r e s e n t a t i o n o f t h e o u t p u t g r o u p c o n t a i n s t h e

< M y C l a s s N a m e N A M E = " d a t a _ 1 " T Y P E = " O b j e c t " S T

< / M y C l a s s N a m e >

T h e d e f a u l t f o r t h i s p a r a m e t e r i s “ U n k n o w n - C o p t i o n a l .

G R O U P _ I N S p e c i e s t h e t w o o r m o r e g r o u p s t h a t a r e u s e d i p a r a m e t e r i s r e q u i r e d .

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e r e s u l t i n g g r o u p . T h i s

E X A M P L E

T h e f o l l o w i n g e x a m p l e l i n k s t h e t w o s p e c i e d g r< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % >


< ! - - F o r m a g r o u p b y c o n c a t e n a t i n g t w o g r o u p s - - >









 



C o p y - G r o u p


C o p i e s a g r o u p t o a n e w g r o u p o f a d i f f e r e n t n a m e . F

m i g h t c o p y a l l t h e d a t a i n g r o u p “ A ” , c r e a t i n g a n e w gt h e s a m e i n f o r m a t i o n .

S Y N T A X

 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N G R O U P _ O U T

G R O U P _ I N S p e c i e s t h e n a m e o f t h e g r o u p t o b e c o p i e d . T h i s p

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e n e w g r o u p t h a t i s c r e a t e d .i d e n t i c a l t o t h e G R O U P _ I N n a m e . T h i s p a r a m e t e r

E X A M P L E

T h e f o l l o w i n g e x a m p l e c o p i e s t h e i n p u t g r o u p n a m e“ r e s u l t s ” g r o u p a n d r e t u r n s b o t h g r o u p s ( u s i n g t h e R l o c a l o u t p u t g r o u p c o l l e c t i o n :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i

p r e f i x = " i e " % >

< ! - - C o p i e s a g r o u p t o a n e w g r o u p . - - >





 



 



T h e X M L o u t p u t f r o m e x e c u t i n g t h e e x a m p l e i s t






< N A M E > J a m e s O & a p o s ; C o n n o r < / N A M E > < A D D R E S S > 7 7 5 M a i n S t . < / A D D R E S S > < E M A I L > < / E M A I L >



< / w c : I N S T A N C E > < / E m p l o y e e D a t a > < E m p l o y e e D a t a N A M E = " r e s u l t s " T Y P E = " O b j e c t " S T



< N A M E > H a r v y A n d e r s o n < / N A M E >




< A D D R E S S > 1 2 3 4 A m b e r S t . < / A D D R E S S > < E M A I L > h a n d e r s o n @ s o m e w h e r e . c o m < / E M A I L >

< / w c : I N S T A N C E >

< w c : I N S T A N C E > < N A M E > J a m e s O & a p o s ; C o n n o r < / N A M E > < A D D R E S S > 7 7 5 M a i n S t . < / A D D R E S S > < E M A I L > < / E M A I L >




C r e a t e - G r o u p


C r e a t e s a d a t a g r o u p f r o m e m b e d d e d p a r a m e t e r s o r ft h e X M L s o u r c e c o n f o r m s t o t h e I n f o * E n g i n e s c h e m i t d i r e c t l y . O t h e r w i s e , t h i s w e b j e c t a l l o w s a n X S L s t yt o t r a n s l a t e t h e s o u r c e f o r m t o t h e I n f o * E n g i n e s c h e m

T h e C r e a t e - G r o u p w e b j e c t a c c e p t s a n X M L _ U R L p

p a r a m e t e r c a n b e a f u l l y s p e c i e d H T T P U R L . I f s o , H T T P c o n n e c t i o n t o a r e m o t e w e b s e r v e r , d e l i v e r s t ht h e r e s p o n s e f r o m t h e r e m o t e s e r v e r . T h e r e s p o n s e i ss t r e a m . I d e a l l y , t h e r e m o t e w e b s e r v e r r e t u r n s a n X Ma s a c o l l e c t i o n o f I n f o * E n g i n e g r o u p s ( t h e s a m e f o r mI n f o * E n g i n e t a s k p r o c e s s o r ) .

I n c a s e s w h e r e t h e f o r m a t o f t h e X M L s t r e a m i s n o t t t h e I n f o * E n g i n e t a s k p r o c e s s o r , C r e a t e - G r o u p a c c e ps p e c i f y i n g a n X S L s t y l e s h e e t t h a t c a n b e a p p l i e d t o t rI n f o * E n g i n e f o r m a t . F o r a l i s t o f t h e X M L I n f o * E n g U n d e r s t a n d i n g X M L O u t p u t f o r I n f o * E n g i n e G r o u p .

Y o u c a n u s e t h e C r e a t e - G r o u p w e b j e c t t o c r e a t e a n e mo n l y t h e G R O U P _ O U T p a r a m e t e r a n d n o E L E M E N c r e a t e s a n e m p t y g r o u p .

S Y N T A X

 




< i e : p a r a m n a m e = " D E L I M I T E R " d a t a = " d e l i m i t e r _ c h a< i e : p a r a m n a m e = " E L E M E N T " d a t a = " k e y _ v a l u e _ p a i r s 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l E L E M E N T C L A S S G R O U P _ O U T D B U S E R

X M L _ U R L D E L I M I T E R X S L _ P A R A M P A S S W D X S L _ U R L


< M y C l a s s N a m e N A M E = " d a t a _ 1 " T Y P E = " O b j e c t " S T< / M y C l a s s N a m e >


D B U S E R S p e c i e s t h e u s e r n a m e t o b e u s e d t o a u t h e n t i c at e m p l a t e s t o b e u s e d b y t h e w e b j e c t r e s i d e o n a p a r a m e t e r s h o u l d b e u s e d i n c o n j u n c t i o n w i t h t


D E L I M I T E R S p e c i e s t h e c h a r a c t e r u s e d t o d e l i m i t k e y a n d E L E M E N T p a r a m e t e r .

I f y o u a r e u s i n g a s u b s t i t u t i o n s t r i n g c o n t a i n i n gE L E M E N T p a r a m e t e r , y o u s h o u l d n o t s p e c i f y s e p a r a t i n g m u l t i p l e e l e m e n t s o r v a l u e s a s t h e d w e b j e c t . I f y o u d o u s e t h e s a m e c h a r a c t e r , t h e r v a l u e s m a y b e d i f f e r e n t f r o m w h a t y o u e x p e c t d e s c r i b e d i n D y n a m i c P a r a m e t e r V a l u e S u b s t i t u t i o n .

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t h e c o l o n ( : ) . T




E L E M E N T S p e c i e s a d e l i m i t e d s e t o f k e y a n d v a l u e p a i r s t o a b y t h e G R O U P _ O U T p a r a m e t e r . E a c h k e y a n d v a k e y = v a l u e . E a c h E L E M E N T p a r a m e t e r c r e a t e s a n i n s w i t h t h e a t t r i b u t e s p e c i e d b y t h e k e y v a l u e a n d t h e v a l u e s p e c i e d bv a l u e p o r t i o n o f t h e k e y a n d v a l u e p a i r .

M u l t i p l e E L E M E N T p a r a m e t e r s c a n b e s p e c i e d t o f o b j e c t s i n t h e g r o u p . A t l e a s t o n e E L E M E N T p at h i s w e b j e c t i f n o X M L _ U R L p a r a m e t e r i s s p e c i e E L E M E N T p a r a m e t e r s a r e s p e c i e d , t h e r e s u l t i n g r o w s c r e a t e d b y t h e X M L s o u r c e l e a n d t h e E L E M

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e r e s u l t i n g g r o u p . T h e G R Oi s r e q u i r e d o n l y w h e n t h e X M L _ U R L p a r a m e t e r i sX M L _ U R L p a r a m e t e r i s s p e c i e d , t h e X M L s t r e a mo n e o r m o r e g r o u p s . T h e n a m e s o f t h e s e g r o u p s c a ns t r e a m , s o i t i s n o t n e c e s s a r y t o p r o v i d e a G R O U P _a n a m e f o r t h e g r o u p ( s ) i n t h i s c a s e .

P A S S W D S p e c i e s t h e p a s s w o r d c o r r e s p o n d i n g t o D B U S E R





X M L _ U R L I d e n t i e s t h e l o c a t i o n o f a n X M L s o u r c e l e f r oA r e l a t i v e U R L o r a f u l l y q u a l i e d U R L c a n b e a r e r e l a t i v e t o t h e I n f o * E n g i n e S e r v e r t a s k t e m i s e x p e c t e d t o b e i n I n f o * E n g i n e f o r m a t ; t h e s a t h e I n f o * E n g i n e t a s k p r o c e s s o r . I f t h e c o n t e n t sX M L _ U R L p a r a m e t e r i s n o t i n I n f o * E n g i n e f oc a n b e u s e d t o s p e c i f y a n X S L s t y l e s h e e t t h a t c s o u r c e i n t o I n f o * E n g i n e f o r m a t . I n a n y c a s e , t h b y X S L ) c a n c o n t a i n d e n i t i o n s f o r m o r e t h a n C r e a t e - G r o u p p a r s e s a l l o f t h e m a n d a d d t h e m t

F u l l y q u a l i e d U R L s a r e d e r e f e r e n c e d u s i n g t h A u t h - M a p c o n t e x t g r o u p d a t a . T h e A u t h - M a p i s s e a r c h e d f o r a u s e r n a m e a n d p a s sd o m a i n n a m e f o u n d i n t h e f u l l y q u a l i e d U R L

q u a l i e d U R L i s : h t t p : / / m a c h i n e . c o m / i n f o e n g i n e / s e r v l e t / I E / t a s k s / t h e n t h e A u t h - M a p c o n t e x t g r o u p i s s e a r c h e d f o r a u s e r nt h a t h a s a n I N S T A N C E n a m e o f h t t p : / / m a c h i n e . c o m . I f a u s e r n a m e a p a s s w o r d i s f o u n d , B A S I C a u t h e n t i c a t i o n i s u si s f o u n d , n o a u t h e n t i c a t i o n i n f o r m a t i o n i s s e n t

I f t h e d a t a v a l u e c o n t a i n s t h e : / / s t r i n g , i t i s a s s u m e d t o b e a f ui n t e r n e t U R L . I f t h e d a t a v a l u e d o e s n o t c o n t a i nl o c a l l e r e l a t i v e t o t h e c u r r e n t t a s k r o o t d i r e c t o

I f t h e d a t a v a l u e i s i n p u t : t h e w e b j e c t r e a d s a n X M L o b j e c

B L O B i n p u t s t r e a m . T h i s a l l o w s X M L o b j e c t s a n d c o n v e r t e d i n t o g r o u p s b y C r e a t e - G r o u p .

X S L _ P A R A M D e n e s X S L p a r a m e t e r s t h a t a r e t h e n p a s s e d t ot h e X S L _ U R L p a r a m e t e r . Y o u e n t e r t h e v a l u e i n t h e f o r m X S L _ n a m e = X S L _ v a l u e , w h e r e X S L _ n a m e i s t h e n a m e o f a p a r a m e t e r i n t h e X S L s t y l e s h e e t a n d X S L _ v a l u e i s t h e v a l u e y o u w a nf o r t h e p a r a m e t e r .

T h e d e f a u l t f o r X S L _ P A R A M i s t h a t n o p a r a m M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m







< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? >

< w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m / < E m p l o y e e D a t a N A M E = " c r e a t e d g r o u p " T Y P E = " O b j e < w c : I N S T A N C E >

< N A M E > S a m J o h n s o n < / N A M E > < A D D R E S S > 1 2 3 4 M a i n S t . < / A D D R E S S > < E M A I L > s j o h n s o n @ s o m e w h e r e . c o m < / E M A I L >



< / w c : I N S T A N C E >

< w c : I N S T A N C E > < N A M E > J a m e s O & a p o s ; C o n n o r < / N A M E > < A D D R E S S > 7 7 5 M a i n S t . < / A D D R E S S > < E M A I L > < / E M A I L >




E X A M P L E : E X T E R N A L G R O U P C R E A T I O

T h e f o l l o w i n g e x a m p l e o f C r e a t e - G r o u p e x e c u t eS e r v e r a n d a d d s i t s o u t p u t g r o u p s t o t h e l o c a l o u t

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t

< ! - - C r e a t e o n e o r m o r e l o c a l g r o u p s f r o m t h e o u t pI n f o * E n g i n e t a s k

 




D i f f - G r o u p s


C o m p u t e s t h e d i f f e r e n c e o f t w o g r o u p s a n d p l a c e s t hg r o u p .

I n g e n e r a l , a n e l e m e n t i s d i f f e r e n t f o r t w o g r o u p s i f i tn o t b o t h g r o u p s . F o r e x a m p l e , i f a n e l e m e n t x e x i s t s ii t i s n o t p l a c e d i n t h e o u t p u t g r o u p . A d d i t i o n a l l y , i f a b u t n o t i n g r o u p B , t h e n i t i s p l a c e d i n t h e o u t p u t g r o u e x i s t s i n g r o u p B b u t n o t i n g r o u p A t h e n i t i s n o t p l a c t h e i t e m s u n i q u e t o g r o u p A a r e p l a c e d i n t h e o u t p u t .

S Y N T A X

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l D I F F B Y C A S E _ I G N O R E G R O U P _ I N C L A S S G R O U P _ O U T C O M P A R I S O N

S O R T B Y S O R T E D

C A S E _ I G N O R E A c t s a s a a g f o r c a s e . I f T R U E i s s p e c i e d , c a s e i s s p e c i e d , t h e n c a s e i s s i g n i c a n t . T h e d e f a u l t f o r t hT h i s p a r a m e t e r i s o p t i o n a l .







C O M P A R I S O N D e s c r i b e s h o w t o c o m p a r e t h e t w o g r o u p s : e i t hc o m p a r i s o n , o r N U M E R I C f o r a s t r i c t l y n u m e t h i s p a r a m e t e r i s A L P H A . T h i s p a r a m e t e r i s o p

D I F F B Y I d e n t i e s t h e n a m e o f t h e a t t r i b u t e t h a t i s u s e d id e t e r m i n e w h e t h e r t h e y a r e d i f f e r e n t . I f t h e g r oe l e m e n t s w i t h a t t r i b u t e s o f t h e s a m e n a m e , t h e s p e c i e d . O t h e r w i s e , y o u m u s t s p e c i f y t w o D I Fn a m e s o f t h e a t t r i b u t e s f r o m e a c h r e s p e c t i v e g r

T h e a t t r i b u t e n a m e p l a c e d i n t h e o u t p u t g r o u p iD I F F B Y p a r a m e t e r u s e d . T h i s p a r a m e t e r i s r e

G R O U P _ I N S p e c i e s t h e t w o g r o u p s t h a t a r e c o m p a r e d f o r

r e q u i r e d . G R O U P _ O U T

S p e c i e s t h e n a m e o f t h e s i n g l e r e s u l t i n g g r o u pr e q u i r e d .

S O R T B Y S p e c i e s t h e n a m e o f t h e a t t r i b u t e o n w h i c h t h ei n c l u d e t h i s p a r a m e t e r , t h e r e s u l t s a r e n o t s o r t e

S O R T E D D e t e r m i n e s h o w v a l u e s i n t h e r e s u l t i n g g r o u p ai n t h e S O R T B Y p a r a m e t e r d e t e r m i n e s w h i c h vt o s o r t i n a s c e n d i n g o r d e r o r s p e c i f y D E S C t o s d e f a u l t f o r t h i s p a r a m e t e r i s A S C . T h i s p a r a m e




E X A M P L E

T h e f o l l o w i n g e x a m p l e u s e s t h e C r e a t e - G r o u p w e b j e

b e t w e e n t h e N A M E a t t r i b u t e i n t h e g r o u p s u s i n g t h e c r e a t e s t h e o u t p u t g r o u p n a m e d “ D I F F - R E S U L T S ” l o c a l o u t p u t g r o u p c o l l e c t i o n :

% @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i

p r e f i x = " i e " % >

< ! - - C r e a t e G r o u p c o n t a i n i n g t h e d i f f e r e n c e b e t w e e n t g r o u p s - - >

 



< i e : p a r a m n a m e = " E L E M E N T " d a t a = " N A M E = J a m e s O ' C o n n o r : A D D R E S S = 7 7 5 M a i n S t . : E M A I L = " /







 < i e : p a r a m n a m e = " E L E M E N T " d a t a = " N A M E = S a m

J o h n s o n : P O S I T I O N = E n g i n e e r : P H O N E = 5 5 5 - 1 1 1 - < i e : p a r a m n a m e = " E L E M E N T " d a t a = " N A M E = H a r v y

A n d e r s o n : P O S I T I O N = M a r k e t i n g : P H O N E = 5 5 5 - 2 2 2 

 < i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " C R E A T E - R E S U L T S 


< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? > < w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m / < N e w E m p l o y e e s N A M E = " D I F F - R E S U L T S " T Y P E = " O b

< w c : I N S T A N C E > < N A M E > H a r v e y H a m p t o n < / N A M E > < A D D R E S S > 7 7 5 M a i n S t . < / A D D R E S S > < E M A I L > h h a m p t o n @ s o m e w h e r e . c o m < / E M A I L >

< / w c : I N S T A N C E > < / N e w E m p l o y e e s > < / w c : C O L L E C T I O N >

E x t r a c t - G r o u p D E S C R I P T I O N

S e a r c h e s f o r o n e o r m o r e a t t r i b u t e n a m e s a n d v a lg r o u p . T h i s f o r m s a t y p e o f s u b s e t o f a g r o u p o f as e a r c h i n g f o r a s u b s e t o f o b j e c t s ( n o t a t t r i b u t e s o S u b s e t - G r o u p o n p a g e 4 0 3 .

W h e n u s e d i n c o m b i n a t i o n w i t h t h e E X T R A C T o f a t t r i b u t e s a r e e x t r a c t e d f r o m t h e s p e c i e d s u b E L E M E N T _ O F F S E T p a r a m e t e r i s o m i t t e d , i t s vs u b s e t o f e l e m e n t s r e t u r n e d b e g i n w i t h t h e r s t e lt h e E L E M E N T _ C O U N T p a r a m e t e r i s o m i t t e d , i t s v a l u e d e f a ut h e i n p u t g r o u p ( t h u s , t h e s u b s e t o f e l e m e n t s r e t ut h e i n p u t g r o u p , s t a r t i n g f r o m t h e o n e s p e c i e d b E L E M E N T _ O F F S E T + E L E M E N T _ C O U N T e i n t h e i n p u t g r o u p , t h e o u t p u t g r o u p c o n t a i n s f e we l e m e n t s ( i t c o n t a i n s a s m a n y e l e m e n t s a s r e m a i nw i t h E L E M E N T _ O F F S E T ) . I f t h e E X T R A C T pa t t r i b u t e s o f e a c h s e l e c t e d e l e m e n t a r e r e t u r n e d . E L E M E N T _ O F F S E T , o r E L E M E N T _ C O U N T a l l t h r e e a r e o m i t t e d , a n e x c e p t i o n i s t h r o w n .

S Y N T A X 

 < i e : p a r a m n a m e = " E X T R A C T " d a t a = " a t t r i b u t e _ n a m e " < i e : p a r a m n a m e = " G R O U P _ O U T " d a t a = " o u t p u t _ g r o u p



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N E L E M E N T _ C O U N T C L A S S G R O U P _ O U T E L E M E N T _ O F F S E T E X T R

E X T R A C T

C L A S S S p e c i e s t h e t y p e o f t h e o b j e c t s c o n t a i n e d i n t h e o u b y t h e G R O U P _ O U T p a r a m e t e r . F o r e x a m p l e i f a C L A S S = M y C l a s s N a m e a n d G R O U P _ O U T = d a t a _ 1 , t h e n t h e X M L

r e p r e s e n t a t i o n o f t h e o u t p u t g r o u p c o n t a i n s t h e f o l < M y C l a s s N a m e N A M E = " d a t a _ 1 " T Y P E = " O b j e c t " S T A T U

< / M y C l a s s N a m e >

T h e d e f a u l t f o r t h i s p a r a m e t e r i s “ U n k n o w n - C l a s s o p t i o n a l .

E L E M E N T _ C O U N T A l l o w s t h e w e b j e c t t o r e t u r n a s u b s e t o f e l e m e n t s f a l l o w i n g t h i s w e b j e c t t o b e u s e d i n s i m u l a t i n g p a g ew h e r e t r u e p a g e - m o d e i s n o t s u p p o r t e d b y a b a c k - eT h i s p a r a m e t e r s p e c i e s t h e n u m b e r o f e l e m e n t s t oi s t h e s i z e o f t h e i n p u t g r o u p .

E L E M E N T _ O F F S E T A l l o w s t h e w e b j e c t t o r e t u r n a s u b s e t o f e l e m e n t s f a l l o w i n g t h i s w e b j e c t t o b e u s e d i n s i m u l a t i n g p a g ew h e r e t r u e p a g e - m o d e i s n o t s u p p o r t e d b y a b a c k - eT h i s p a r a m e t e r s p e c i e s t h e i n d e x o f t h e e l e m e n t a tT h e d e f a u l t v a l u e i s 0 .

E X T R A C T S p e c i e s t h e n a m e o f t h e a t t r i b u t e t o b e e x t r a c t e d . s p e c i e d f o r t h i s p a r a m e t e r . T h i s p a r a m e t e r i s r e q u

E X T R A C T _ M O D E S p e c i e s t h e e x t r a c t m o d e . T h e v a l u e c a n b e e i t h e N O M A T C H . W h e n E X T R A C T _ M O D E i s M A T C o n t h e E X T R A C T p a r a m e t e r a r e i n c l u d e d i n t h e o uE X T R A C T _ M O D E i s N O M A T C H , a l l b u t t h e s p eE X T R A C T p a r a m e t e r a r e i n c l u d e d i n t h e o u t p u t g o p t i o n a l . I f n o t s p e c i e d , t h e d e f a u l t m o d e o f M A T

G R O U P _ I N S p e c i e s t h e n a m e o f t h e i n p u t g r o u p . T h i s p a r a m e




G R O U P _ O U T S p e c i e s t h e n a m e o f t h e e x t r a c t i o n o f a t t r i b u t e p a r a m e t e r i s r e q u i r e d .

E X A M P L E

T h e f o l l o w i n g e x a m p l e s e a r c h e s f o r t h e s p e c i e d p u t s t h e m i n t o a n e w g r o u p n a m e d “ e x t r a c t r e s u l t


p r e f i x = " i e " % >

< ! - - E x t r a c t a t t r i b u t e s f r o m a g r o u p . - - >


 

F o r m a t - G r o u p


F o r m a t s s p e c i c g r o u p s o f i n f o r m a t i o n b y a d d i n i n f o r m a t i o n . F o r e x a m p l e , t h i s w e b j e c t c o u l d b e t h e b e g i n n i n g o f e a c h i t e m i n a g r o u p o f s a l a r y a mu s e d t o c o m b i n e m u l t i p l e a t t r i b u t e s i n t o o n e l o n g

S Y N T A X

 

< i e : p a r a m n a m e = " F O R M A T " d a t a = " f o r m a t _ s p e c i f i e r< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " i n p u t _ g r o u p _ n 






P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l A T T R I B U T E C L A S S F O R M A T L O C A L E G R O U P _ I N G R O U P _ O U T

A T T R I B U T E I d e n t i e s t h e s t r i n g o f d a t a i n a g r o u p t o b e f o r m a t t a t t r i b u t e s t h a t a r e u s e d i n c r e a t i n g t h e G R O U P _ O Ue x p l i c i t l y s p e c i e d i n A T T R I B U T E p a r a m e t e r s a rG R O U P _ O U T .

M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r

C L A S S S p e c i e s t h e t y p e o f t h e o b j e c t s c o n t a i n e d i n t h e o u b y t h e G R O U P _ O U T p a r a m e t e r . F o r e x a m p l e i f a C L A S S = M y C l a s s N a m e a n d G R O U P _ O U T = d a t a _ 1 , t h e n t h e X M L r e p r e s e n t a t i o n o f t h e o u t p u t g r o u p c o n t a i n s t h e f o l

< M y C l a s s N a m e N A M E = " d a t a _ 1 " T Y P E = " O b j e c t " S T A T U< / M y C l a s s N a m e >


F O R M A T S p e c i e s h o w t o f o r m a t t h e s t r i n g o f d a t a s p e c i e d p a r a m e t e r . T h e v a l u e o f t h e F O R M A T p a r a m e t e r mJ a v a c l a s s j a v a . t e x t . M e s s a g e F o r m a t . E a c h r o w o f t h e G R O U P _ h a s a s m a n y a t t r i b u t e s a s t h e r e a r e F O R M A T p a r a m

E a c h F O R M A T p a r a m e t e r c a n i n c l u d e s u b s t i t u t i o { n } , w h e r e n i s a n o n - n e g a t i v e i n t e g e r . T h e s e s t r i n g s a r eG R O U P _ O U T b y t h e n e x t u n c o n s u m e d a t t r i b u t e w n . T h e o f f s e t i s r e l a t i v e t o t h e r s t u n c o n s u m e d A T T Ro f p r o c e s s i n g o f t h e F O R M A T p a r a m e t e r .

F o r e x a m p l e , i f n i s 0 , t h e v e r y n e x t u n c o n s u m e d A T T R I B

s u b s t i t u t e d . I f n i s 1 , t h e s e c o n d u n c o n s u m e d a t t r i b u t e v a l u n i s 2 , t h e t h i r d u n c o n s u m e d a t t r i b u t e v a l u e i s s u b s t i tF O R M A T p a r a m e t e r h a s b e e n p r o c e s s e d c o m p l e t es u b s t i t u t e d b y i t a r e m a r k e d a s c o n s u m e d .

M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r

G R O U P _ I N S p e c i e s t h e g r o u p t o b e f o r m a t t e d . T h i s p a r a m e t e




G R O U P _ O U T S p e c i e s t h e f o r m a t t e d g r o u p . T h i s p a r a m e t e r

L O C A L E A s t r i n g r e p r e s e n t a t i o n o f t h e J a v a c l a s s l o c a l e e n - U S ( I S O l a n g u a g n a m e , d a s h , I S O c o u n t r y c o d e ) . I f n o t s p e c i e dd e f a u l t l o c a l e d e n e d f o r t h e p l a t f o r m o n w h i c h p a r a m e t e r i s o p t i o n a l .

E X A M P L E

T h e f o l l o w i n g e x a m p l e f o r m a t s d a t a i n t h e c u r r e s t r i n g s . T h e f o r m a t t e d d a t a i s p l a c e d i n a n o u t p u tw i t h a s p e c i e d J a v a c l a s s l o c a l e o f “ e n - U S ” :



< ! - - F o r m a t e l e m e n t s o f a g r o u p . - - >


 < i e : p a r a m n a m e = " F O R M A T " d a t a = " N a m e : { 0 } l i v e 






I n t e r s e c t - G r o u p s


I d e n t i e s t h e i n t e r s e c t i o n o f t w o g r o u p s a n d p l a c e s t he x a m p l e , s a y t h a t g r o u p A c o n t a i n s t h e e l e m e n t s u , v t h e e l e m e n t s x , y , a n d z . T h i s w e b j e c t i d e n t i e s t h e c og r o u p s a n d u s e s t h e r e s u l t s o f a n i n t e r s e c t i o n t o f o r m e x a m p l e w o u l d c o n t a i n o n l y t h e e l e m e n t x .

S Y N T A X

 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N C A S E _ I G N O R E G R O U P _ O U T C L A S S I N T E R S E C T B Y C O M P A R I S O N









C O M P A R I S O N D e s c r i b e s h o w t o c o m p a r e t h e t w o g r o u p s : e i t hc o m p a r i s o n , o r N U M E R I C f o r a s t r i c t l y n u m e t h i s p a r a m e t e r i s A L P H A . T h i s p a r a m e t e r i s o p

G R O U P _ I N S p e c i e s t h e n a m e s o f t w o i n p u t g r o u p s t h a t a r i n t e r s e c t i o n .

T o s p e c i f y t w o g r o u p n a m e s , y o u c a n i n c l u d e t f o r t h e G R O U P _ I N p a r a m e t e r . F o r e x a m p l e :

 


G R O U P _ O U T S p e c i e s t h e n a m e o f t h e r e s u l t s o f c o m p u t i n g g r o u p s . T h i s p a r a m e t e r i s r e q u i r e d .

I N T E R S E C T B Y I d e n t i e s t h e a t t r i b u t e t o b e u s e d f o r c o m p a r i s o p e r f o r m e d , t h e n a m e d a t t r i b u t e o f t h e r s t n a m t h e n a m e d a t t r i b u t e o f t h e s e c o n d n a m e d g r o u pt h e n t h e e l e m e n t f r o m t h e r s t g r o u p i s p l a c e d i O t h e r w i s e , i t i s d i s c a r d e d .

T h e a t t r i b u t e n a m e p l a c e d i n t h e o u t p u t g r o u p iI N T E R S E C T B Y p a r a m e t e r u s e d . I f a l l t h e g r o a r e t h e s a m e n a m e , t h e n o n l y o n e n e e d b e s p e c iI N T E R S E C T B Y p a r a m e t e r s h a v e d i f f e r e n t n as p e c i e d h e r e .



S O R T E D D e t e r m i n e s h o w v a l u e s i n t h e r e s u l t i n g g r o u p ai n t h e S O R T B Y p a r a m e t e r d e t e r m i n e s w h i c h v

t o s o r t i n a s c e n d i n g o r d e r o r s p e c i f y D E S C t o s d e f a u l t f o r t h i s p a r a m e t e r i s A S C . T h i s p a r a m e




E X A M P L E

T h e f o l l o w i n g e x a m p l e c r e a t e s t w o g r o u p s u s i n g t h e C r e a t e G r o u p a n d

C r e a t e G r o u p H r t a s k t a g s , a n d t h e n n d s t h e i n t e r s e c t i o n b e ta t t r i b u t e i n t h e g r o u p s u s i n g t h e I n t e r s e c t - G r o u p s w eg r o u p n a m e d “ r e s u l t s ” a n d a d d s t h e g r o u p t o t h e l o c a


< ! - - C r e a t e a g r o u p n a m e d c r e a t e d g r o u p . - - > 

< ! - - C r e a t e a g r o u p n a m e d c r e a t e d h r g r o u p . - - > 

< ! - - F o r m a g r o u p b y i n t e r s e c t i n g t h e t w o g r o u p s . - - >

 

 T h e X M L o u t p u t f r o m e x e c u t i n g t h e e x a m p l e i s t h e f

< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? > < w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o < N A M E > H a r v y A n d e r s o n < / N A M E > M a r k e t i n g 5 5 5 - 2 2 2 - 2 2 2 2 


< N A M E > J a m e s O & a p o s ; C o n n o r < / N A M E > M a n a g e m e n t 


< N A M E > S a m J o h n s o n < / N A M E > E n g i n e e r 5 5 5 - 1 1 1 - 1 1 1 1 




< / w c : I N S T A N C E > < / w c : C O L L E C T I O N >

J o i n - G r o u p s


J o i n s s i m i l a r i n f o r m a t i o n f r o m t w o d i f f e r e n t g r o J O I N _ T Y P E p a r a m e t e r t o M A X , d i s s i m i l a r i n f oa l s o i n c l u d e d i n t h e n e w g r o u p .

N o t e T h e d i f f e r e n c e b e t w e e n t h e J o i n - G r o u p s w e b j e c t a

d e p e n d s o n h o w d u p l i c a t e i n f o r m a t i o n i s t r e a t e d . i s t h a t d u p l i c a t e d i n f o r m a t i o n i s e l i m i n a t e d . M e r d u p l i c a t e s t o b e p r e s e r v e d .

S Y N T A X

 = " G R P < i e : p a r a m n a m e = " C O M P A R I S O N " d a t a = " [ A L P H A | N U< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " i n p u t _ g r o u p s " / 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N C A S E _ I G N O R E

G R O U P _ O U T C L A S S J O I N B Y C O M P A R I S O N J O I N _ T Y P E S O R T B Y S O R T E D U N D E F I N E D





C L A S S S p e c i e s t h e t y p e o f t h e o b j e c t s c o n t a i n e d i n t h e o u b y t h e G R O U P _ O U T p a r a m e t e r . F o r e x a m p l e , i f aC L A S S = M y C l a s s N a m e a n d G R O U P _ O U T = d a t a _ 1 , t h e n t h e X M L r e p r e s e n t a t i o n o f t h e o u t p u t g r o u p c o n t a i n s t h e f o l



C O M P A R I S O N D e s c r i b e s h o w t o c o m p a r e t h e t w o g r o u p s : e i t h e r Ac o m p a r i s o n , o r N U M E R I C f o r a s t r i c t l y n u m e r i c c t h i s p a r a m e t e r i s A L P H A . T h i s p a r a m e t e r i s o p t i o n

G R O U P _ I N S p e c i e s t h e n a m e s o f t h e t w o g r o u p s t o b e u s e d i n s p e c i f y t w o g r o u p n a m e s , y o u c a n i n c l u d e t w o l i n et h e G R O U P _ I N p a r a m e t e r . F o r e x a m p l e :


T h e o r d e r o f t h e g r o u p s l i s t e d i n t h e p a r a m e t e r d e t et h e g r o u p s a r e j o i n e d .


G R O U P _ O U T S p e c i e s t h e n a m e o f t h e r e s u l t s o f c o m p u t i n g t h e jT h i s p a r a m e t e r i s r e q u i r e d .

J O I N B Y I d e n t i e s t h e a t t r i b u t e o r c o l u m n n a m e t o b e u s e d f j o i n i s p e r f o r m e d , a n e l e m e n t o f t h e r s t n a m e d g r o o f t h e s e c o n d n a m e d g r o u p i f t h e y c o n t a i n a t t r i b u t e

p a r a m e t e r ( s ) w i t h m a t c h i n g v a l u e s . I f t h e a t t r i b u t e s u s e d f o r t h e c o m p a r i s o n i n b o t h g r ot h e n i n c l u d e o n l y o n e J O I N B Y p a r a m e t e r . I f t h e a c o m p a r i s o n d o n o t h a v e t h e s a m e n a m e , t h e n i n c l u T h e a t t r i b u t e n a m e p l a c e d i n t h e o u t p u t g r o u p i s t h eJ O I N B Y p a r a m e t e r u s e d .





J O I N _ T Y P E S p e c i e s t h a t a M A X j o i n i s t o b e p e r f o r m e d . Wa n y i n f o r m a t i o n t h a t i s n o t s i m i l a r w i t h i n t h e t wo m i t t e d f r o m t h e o u t p u t . W h e n J O I N _ T Y P E i sa l l i n f o r m a t i o n f r o m b o t h g r o u p s b e i n g j o i n e d .U N D E F I N E D v a l u e i s u s e d . F o r m o r e i n f o r m a J o i n - G r o u p s o n p 3 8 3 .



S O R T E D D e t e r m i n e s h o w v a l u e s i n t h e r e s u l t i n g g r o u p a

i n t h e S O R T B Y p a r a m e t e r d e t e r m i n e s w h i c h vt o s o r t i n a s c e n d i n g o r d e r o r s p e c i f y D E S C t o s d e f a u l t f o r t h i s p a r a m e t e r i s A S C . T h i s p a r a m e

U N D E F I N E D S e t s t h e v a l u e t o u s e i f n o a t t r i b u t e v a l u e e x i s t s p a r a m e t e r i s " " . T h i s p a r a m e t e r i s o p t i o n a l .

E X A M P L E S

T h e r e a r e t w o e x a m p l e s f o r t h e J o i n - G r o u p s w e ba n d t h e s e c o n d s u p p l e m e n t s t h e d e n i t i o n o f t h e J

T h e f o l l o w i n g e x a m p l e c r e a t e s t w o g r o u p s a n d t a t t r i b u t e u s i n g t h e J o i n - G r o u p s w e b j e c t . I t c r e a t ea n d a d d s t h e g r o u p t o t h e l o c a l o u t p u t g r o u p c o l l e




< ! - - F o r m a g r o u p b y j o i n i n g t w o g r o u p s - - >

 




 



T h i s e x a m p l e s h o w s t h e r e s u l t s o f c o m b i n i n g G r o u p t h e J o i n - G r o u p s w e b j e c t . T h e r s t t w o t a b l e s s h o w t h N o t i c e t h a t t h e i n f o r m a t i o n i n C o l u m n 3 , R o w 3 i s n o

T a b l e 1 G r o u p A

C 1 C 2 C 3 R o w 1 a 1 b 1 c 1 R o w 2 a 2 b 2 c 2 R o w 3 a 3 b 3 c 3

T a b l e 2 G r o u p B

C 3 C 4 C 5 R o w 1 c 1 d 1 e 1 R o w 2 c 2 d 2 e 2 R o w 3 c 4 d 4 e 4

A s s u m e t h a t t h e f o l l o w i n g w e b j e c t e x e c u t e s :



 



T a b l e 3 R e s u l t s W i t h o u t t h e J O I N _ T Y P E P a r a m

C 1 C 2 C 3 C 4 C 5 R o w 1 a 1 b 1 c 1 d 1 e 1

R o w 2 a 2 b 2 c 2 d 2 e 2 T h i s w e b j e c t d o e s n o t u s e t h e J O I N _ T Y P E p a r a m e t ef r o m G r o u p A p r e c e d e s t h e c o l u m n s f r o m G r o u p B a 3 i n G r o u p s A a n d B i s n o t i n c l u d e d .

 




 



T h e r e s u l t w h e n t h e J O I N _ T Y P E p a r a m e t e r i s s po f i n f o r m a t i o n a r e i n c l u d e d .

I n t h i s e x a m p l e , G r o u p A ( w h i c h h a d v a l u e s f o r Rt h o s e v a l u e s i n c l u d e d i n R o w 3 . G r o u p B ( w h i c h a n d C 5 ) h a s t h o s e v a l u e s i n c l u d e d i n R o w 4 . T h e i n f o r m a t i o n t h a t i s d i s s i m i l a r b e t w e e n t h e g r o u p " " .

T a b l e 4 R e s u l t s W i t h t h e J O I N _ T Y P E P a r a m

C 1 C 2 C 3 C 4 C 5 R o w 1 a 1 b 1 c 1 d 1 e 1 R o w 2 a 2 b 2 c 2 d 2 e 2 R o w 3 a 3 b 3 c 3 " " " " R o w 4 " " " " c 4 d 4 e 4

J o i n i n g G r o u p B w i t h G r o u p A r e s u l t s i n t h e s a m T h e C 3 c o l u m n i s d e r i v e d f r o m G r o u p B . D a t a f r t h e d a t a f r o m G r o u p A . I f G r o u p B i s j o i n e d w i t h

T a b l e 5 R e s u l t s W i t h t h e J O I N _ T Y P E P a r a m

C 3 C 4 C 5 C 1 C 2 R o w 1 c 1 d 1 e 1 a 1 b 1 R o w 2 C 2 d 2 e 2 a 2 b 2 R o w 3 C 3 " " " " a 3 b 3 R o w 4 C 4 d 4 e 4 " " " "

M e r g e - G r o u p s


C o m b i n e s t w o g r o u p s i n t o o n e a n d a l l o w s d u p l i ci n o n e o r b o t h g r o u p s .

N o t e T h e d i f f e r e n c e b e t w e e n t h e J o i n - G r o u p s w e b j e c t ad e p e n d s o n h o w d u p l i c a t e i n f o r m a t i o n i s t r e a t e d . i s t h a t d u p l i c a t e d i n f o r m a t i o n i s e l i m i n a t e d . M e r d u p l i c a t e s t o b e p r e s e r v e d .




S Y N T A X



 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N C A S E _ I G N O R E G R O U P _ O U T C L A S S

C O M P A R I S O N S O R T B Y S O R T E D





C O M P A R I S O N D e s c r i b e s h o w t o c o m p a r e t h e t w o g r o u p s : e i t h e r A

c o m p a r i s o n o r N U M E R I C f o r a s t r i c t l y n u m e r i c c ot h i s o p t i o n a l p a r a m e t e r i s A L P H A .






R e t u r n - G r o u p s


R e t u r n s m u l t i p l e g r o u p s f r o m a t a s k . T h e s e g r o u p s ct a s k s o r J S P p a g e s .

B y d e f a u l t , o n l y t h e l a s t g r o u p t h a t i s c r e a t e d i s a v a i l a

S Y N T A X

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N

G R O U P _ I N S p e c i e s t h e n a m e s o f t h e m u l t i p l e g r o u p s t o r e t u r nc a n b e s p e c i e d t o r e t u r n a l l g r o u p s p r o d u c e d b y a t

T o s p e c i f y m u l t i p l e g r o u p n a m e s , y o u c a n i n c l u d e v a l u e s f o r t h e G R O U P _ I N p a r a m e t e r . F o r e x a m p l

 


E X A M P L E

T h e f o l l o w i n g e x a m p l e c r e a t e s t w o g r o u p s u s i n g t h e C r e a t e G r o u p a n d C r e a t e G r o u p H r t a s k t a g s a n d t h e n r e t u r n s t h e g r o u p s u s i n g tw e b j e c t :


p r e f i x = " i e " % >



< ! - - R e t u r n m u l t i p l e g r o u p s . - - >




 

T h e X M L o u t p u t f r o m e x e c u t i n g t h e R e t u r n G r o u p s . x m l l e i s t h e f o l l o w i






< N A M E > J a m e s O & a p o s ; C o n n o r < / N A M E > < A D D R E S S > 7 7 5 M a i n S t . < / A D D R E S S > < E M A I L > < / E M A I L > < / w c : I N S T A N C E >

< w c : I N S T A N C E >


< / w c : I N S T A N C E > < / E m p l o y e e D a t a > < E m p l o y e e H r D a t a N A M E = " c r e a t e h r g r o u p " T Y P E = " O

< w c : I N S T A N C E > < N A M E > S a m J o h n s o n < / N A M E > E n g i n e e r 5 5 5 - 1 1 1 - 1 1 1 1 


< N A M E > H a r v y A n d e r s o n < / N A M E > M a r k e t i n g 5 5 5 - 2 2 2 - 2 2 2 2 


< N A M E > J a m e s O & a p o s ; C o n n o r < / N A M E > M a n a g e m e n t 




< / w c : I N S T A N C E > < / E m p l o y e e H r D a t a > < / w c : C O L L E C T I O N >

S e t - I d e n t i t y


A d d s a t t r i b u t e s a n d m e t a - a t t r i b u t e s t o e v e r y e l e m e n s p e c i f y t h e U F I D ( u n i q u e f e d e r a t i o n i d e n t i e r ) a n d oT a s k d e l e g a t i o n c a n t h e n b e e a s i l y a p p l i e d t o t h e g r o uo f t h e G R O U P _ I N p a r a m e t e r o f t h e D i s p a t c h - T a s k s

S Y N T A X

 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N D O M A I N C L A S S

D O M A I N _ A T T R I B U T E C L A S S _ A T T R U F I D G U I D

G U I D _ A T T R I B U T E L O C A L _ I D L O C A L _ I D _ A T T R I B U T E U F I D _ A T T R I B U T E

C L A S S S p e c i e s a l o g i c a l o b j e c t c l a s s n a m e . T h i s v a l u e i s o f t h e i n p u t g r o u p a s t h e v a l u e o f a n a t t r i b u t e w h o s C L A S S _ A T T R I B U T E . T h i s p a r a m e t e r m a y b e s p t h e n u m b e r o f v a l u e s i s l e s s t h a n t h e n u m b e r o f e l e mt h e l a s t v a l u e s p e c i e d i s r e u s e d a s m a n y t i m e s a s n t h e r e m a i n i n g e l e m e n t s . I f t h i s p a r a m e t e r i s o m i t t e

a d d e d t o a n y e l e m e n t s o f t h e i n p u t g r o u p . T h i s p a r aC L A S S _ A T T R I B U T E

S p e c i e s t h e n a m e o f t h e a t t r i b u t e i n w h i c h l o g i c a l C L A S S i s s t o r e d . T h e d e f a u l t v a l u e o f t h i s p a r a m e c l a s s . I f t h e C L A S S p a r a m e t e r i s o m i t t e d , C L A S S _ A T T R I B U T E i s i g no p t i o n a l .




D O M A I N S p e c i e s t h e d o m a i n n a m e o f a n i n f o r m a t i o n r c o m b i n e d w i t h L O C A L _ I D a n d G U I D t o f o r m i d e n t i e r ) v a l u e t h a t i s a d d e d t o e a c h e l e m e n t o p a r a m e t e r m a y b e s p e c i e d m o r e t h a n o n c e . I f t h a n t h e n u m b e r o f e l e m e n t s i n t h e i n p u t g r o u p r e u s e d a s m a n y t i m e s a s n e c e s s a r y t o a c c o m m ot h i s p a r a m e t e r i s o m i t t e d , t h e n e i t h e r t h e D O M p a r a m e t e r m u s t b e s p e c i e d .

D O M A I N _ A T T R I B U T E S p e c i e s t h e n a m e o f a n a t t r i b u t e t h a t e a c h e l e mT h e v a l u e o f e a c h s u c h a t t r i b u t e i d e n t i e s t h e d r e p o s i t o r y . E a c h v a l u e i s c o m b i n e d w i t h L O C AU F I D ( u n i q u e f e d e r a t i o n i d e n t i e r ) v a l u e t h a t i

i n p u t g r o u p . I f t h i s p a r a m e t e r i s o m i t t e d , t h e n e p a r a m e t e r m u s t b e s p e c i e d .

G R O U P _ I N S p e c i e s t h e n a m e o f a g r o u p t o w h i c h c l a s s a n w h i c h i s m o d i e d i n p l a c e ( t h i s w e b j e c t h a s n o T h i s p a r a m e t e r i s r e q u i r e d .

G U I D S p e c i e s t h e g l o b a l l y u n i q u e i d e n t i e r o f a n i n fv a l u e i s c o m b i n e d w i t h L O C A L _ I D a n d D O M f e d e r a t i o n i d e n t i e r ) v a l u e t h a t i s a d d e d t o e a c hT h i s p a r a m e t e r m a y b e s p e c i e d m o r e t h a n o n cl e s s t h a n t h e n u m b e r o f e l e m e n t s i n t h e i n p u t g rr e u s e d a s m a n y t i m e s a s n e c e s s a r y t o a c c o m m oI f t h i s p a r a m e t e r i s o m i t t e d , a n d G U I D _ A T T R g l o b a l l y u n i q u e i d e n t i e r i s d e r i v e d f r o m t h e D i s o p t i o n a l .

G U I D _ A T T R I B U T E S p e c i e s t h e n a m e o f a n a t t r i b u t e c o n t a i n e d i n eE a c h s u c h v a l u e p r o v i d e s t h e g l o b a l l y u n i q u e ir e p o s i t o r y . T h i s v a l u e i s c o m b i n e d w i t h L O C Aa U F I D ( u n i q u e f e d e r a t i o n i d e n t i e r ) v a l u e t h at h e i n p u t g r o u p . I f t h i s p a r a m e t e r i s o m i t t e d , a ng l o b a l l y u n i q u e i d e n t i e r i s d e r i v e d f r o m t h e D i s o p t i o n a l .




L O C A L _ I D S p e c i e s t h e r e p o s i t o r y - s p e c i c i d e n t i e r o f t h e o b e l e m e n t o f t h e i n p u t g r o u p . T h i s v a l u e i s c o m b i n e dt o f o r m a U F I D ( u n i q u e f e d e r a t i o n i d e n t i e r ) v a l u ee l e m e n t o f t h e i n p u t g r o u p . T h i s p a r a m e t e r m a y b e t h e n u m b e r o f v a l u e s s p e c i e d i s l e s s t h a n t h e n u m bg r o u p , t h e n o n l y t h o s e e l e m e n t s w i t h a s s i g n e d v a l u p a r a m e t e r i s o m i t t e d , a n d b o t h L O C A L _ I D _ A T T Ro m i t t e d , t h e n n o U F I D a t t r i b u t e i s a d d e d t o a n y e l e T h i s p a r a m e t e r i s o p t i o n a l .

L O C A L _ I D _ A T T R I B U T E S p e c i e s t h e n a m e o f a n a t t r i b u t e c o n t a i n e d i n e a c hg r o u p . E a c h s u c h v a l u e p r o v i d e s t h e r e p o s i t o r y - s p r e p r e s e n t e d b y t h e e l e m e n t t h a t c o n t a i n s i t . T h i s v a

a n d D O M A I N t o f o r m a U F I D ( u n i q u e f e d e r a t i o n a d d e d t o e a c h e l e m e n t o f t h e i n p u t g r o u p . I f t h i s p a L O C A L _ I D a n d U F I D a r e a l s o o m i t t e d , t h e n n o U Fe l e m e n t s o f t h e i n p u t g r o u p . T h i s p a r a m e t e r i s o p t i

U F I D D i r e c t l y s p e c i e s t h e v a l u e t h a t i s a d d e d a s a U F I D i n p u t g r o u p . T h i s p a r a m e t e r m a y b e s p e c i e d m o r eo f v a l u e s s p e c i e d i s l e s s t h a n t h e n u m b e r o f e l e m et h e n o n l y t h o s e e l e m e n t s w i t h a s s i g n e d v a l u e s h a v i s o m i t t e d , a n d b o t h L O C A L _ I D a n d L O C A L _ I D _o m i t t e d , t h e n n o U F I D a t t r i b u t e i s a d d e d t o a n y e l e

T h i s p a r a m e t e r i s o p t i o n a l . U F I D _ A T T R I B U T E

S p e c i e s t h e n a m e o f t h e a t t r i b u t e t h a t i s a d d e d t o e g r o u p t o i d e n t i f y e a c h e l e m e n t ' s U F I D . T h e d e f a u li s o b i d . T h i s p a r a m e t e r i s o p t i o n a l .

S e t - M e t a d a t a


R e g i s t e r s m e t a d a t a v a l u e s f o r g r o u p s , f o r i n d i v i d u a l

f o r a t t r i b u t e s w i t h i n e l e m e n t s . T h i s m e t a d a t a c a n t h ea p p l i c a t i o n s , w h i c h c a n a f f e c t t h e p r o c e s s i n g o f g r o u

N o t e T h e S e t - M e t a d a t a w e b j e c t d o e s n o t g e n e r a t e a n e w o um o d i e s t h e g r o u p s p e c i e d b y i t s G R O U P _ I N p a r a m e




S Y N T A X



< i e : p a r a m n a m e = " A T T R I B U T E " d a t a = " n a m e _ o f _ a t t r i< i e : p a r a m n a m e = " E L E M E N T " d a t a = " i n d e x _ o f _ e l e m e < i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " i n p u t _ g r o u p _ n < i e : p a r a m n a m e = " N A M E " d a t a = " n a m e _ o f _ m e t a _ a t t r i

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N S C O P E V A L U E N A M E E L E M E N T

A T T R I B U T E

A T T R I B U T E I d e n t i e s t h e a t t r i b u t e f o r w h i c h t h e m e t a d a t a i

I f S C O P E i s A T T R I B U T E , t h e n y o u m u s t s p e cA T T R I B U T E p a r a m e t e r s i n o r d e r t o i d e n t i f y t m e t a d a t a i s s e t .

E L E M E N T I d e n t i e s t h e e l e m e n t f o r w h i c h t h e m e t a d a t a i sc a n b e a s i m p l e i n t e g e r t h a t s p e c i e s t h e i n d e x oo r c a n b e s p e c i e d a s n a m e = v a l u e w h e r e n a m e i s t h e n a m e o f a n a t t ra n d v a l u e i s t h e c o r r e s p o n d i n g v a l u e o f t h e a t t r i b u p a i r a r e s p e c i e d , t h e w e b j e c t l o c a t e s t h e r s t e l w i t h t h e s p e c i e d n a m e a n d v a l u e , a n d i t s e t s t h

T h e v a l u e o f E L E M E N T c a n a l s o b e s p e c i e d ae l e m e n t s o f t h e g r o u p a r e s e l e c t e d .

I f t h e S C O P E p a r a m e t e r i s E L E M E N T , t h e n y o p a r a m e t e r . I f t h e S C O P E p a r a m e t e r i s A T T R I B b o t h t h e E L E M E N T a n d A T T R I B U T E p a r a m ea t t r i b u t e f o r w h i c h t h e m e t a d a t a i s s e t .

G R O U P _ I N S p e c i e s t h e n a m e o f t h e g r o u p f o r w h i c h m e t a p a r a m e t e r i s r e q u i r e d .

N A M E S p e c i e s t h e n a m e o f t h e m e t a d a t a a t t r i b u t e t h aV A L U E p a r a m e t e r p a i r s c a n b e s p e c i e d i n o r da t t r i b u t e s i n a s i n g l e c a l l t o t h e w e b j e c t . T h i s p a




V A L U E S p e c i e s t h e m e t a d a t a v a l u e a s s o c i a t e d w i t h t h e c on a m e d i n t h e N A M E p a r a m e t e r . M u l t i p l e N A M E am a y b e s p e c i e d i n o r d e r t o s e t m u l t i p l e m e t a d a t a at h e w e b j e c t .

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t h e n u l l c h a r a c t e r .

S C O P E S p e c i e s t h e m e t a d a t a s c o p e . V a l i d v a l u e s f o r t h i s p

• G R O U P – S e t s t h e m e t a d a t a f o r t h e g r o u p a s a w • E L E M E N T – S e t s t h e m e t a d a t a f o r a p a r t i c u l a r e

I f S C O P E i s s p e c i e d a s E L E M E N T , t h e n t h e E L a l s o b e s p e c i e d .

• A T T R I B U T E – S e t s t h e m e t a d a t a f o r a n p a r t i c u lw i t h i n t h e g r o u p . I f S C O P E i s s p e c i e d a s A T T R E L E M E N T a n d A T T R I B U T E p a r a m e t e r s m u s t a

T h e d e f a u l t v a l u e f o r t h i s p a r a m e t e r i s G R O U P .

E X A M P L E

T h e f o l l o w i n g e x a m p l e J S P p a g e r e g i s t e r s m e t a d a t a m e t a _ d a t a a n d a v a l u e o f m e t _ v a l u e o n t h e g r o u p n a m e d “ c r e a t e d g r o u p ” a

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " X M L _ I E E r r o r . j s p " c o n t e n t T y p e = " t e x t /



 



 

T h e f o l l o w i n g S e t M e t a d a t a L e v e l s . j s p l e s e t s m e t a d a t a f o r a l l t h r e S C O P E v a l u e s a n d d i s p l a y s t h e X M L o u t p u t u s i n g D

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " .





 < i e : p a r a m n a m e = " E L E M E N T " d a t a = " N A M E = S a m J o h n

A D D R E S S = 1 2 3 4 M a i n S t . : E M A I L = s j o h n s o n @ s o m< i e : p a r a m n a m e = " E L E M E N T " d a t a = " N A M E = H a r v y A n

A D D R E S S = 1 2 3 4 A m b e r S t . : E M A I L = h a n d e r s o n @ 

 



 



 



 



T h e X M L o u t p u t f r o m e x e c u t i n g t h e e x a m p l e i s

< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? > - < w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m /

- 

- < N A M E > S a m J o h n s o n




- < w c : M e t a > < t e s t a t t r i b u t e > a t t r i b u t e m e t a d a t a < / t e s t a t t r i b u t e

< / w c : M e t a >

< / N A M E > < A D D R E S S > 1 2 3 4 M a i n S t . < / A D D R E S S > < E M A I L > s j o h n s o n @ s o m e w h e r e . c o m < / E M A I L > - < w c : M e t a >

< t e s t e l e m e n t > e l e m e n t m e t a d a t a < / t e s t e l e m e n t > < / w c : M e t a >

< / w c : I N S T A N C E > - < w c : I N S T A N C E >

- < N A M E > H a r v y A n d e r s o n


< / w c : M e t a > < / N A M E > < A D D R E S S > 1 2 3 4 A m b e r S t . < / A D D R E S S > < E M A I L > h a n d e r s o n @ s o m e w h e r e . c o m < / E M A I L >

< / w c : I N S T A N C E > - < w c : I N S T A N C E >

- < N A M E > & l t ; & g t ; ' & a m p ; & q u o t ;


< / w c : M e t a >

< / N A M E > < E M A I L > j o c o n n o r @ s o m e w h e r e . c o m < / E M A I L >

< / w c : I N S T A N C E > - < w c : M e t a >

< C l a s s > U n k n o w n - C l a s s - N a m e < / C l a s s > < t e s t g r o u p > g r o u p m e t a d a t a < / t e s t g r o u p > < S t a t u s > 0 < / S t a t u s >

< / w c : M e t a > 

< / w c : C O L L E C T I O N >

S o r t - G r o u p D E S C R I P T I O N

S o r t s t h e i n f o r m a t i o n i n a g r o u p o f o b j e c t s b y o n e o r mi n a g r o u p c o n t a i n i n g e m p l o y e e n a m e s , n u m b e r s , a n w e b j e c t c a n b e u s e d t o s p e c i f y a n a l p h a n u m e r i c o r d ee i t h e r n a m e , n u m b e r , s a l a r y , o r a c o m b i n a t i o n o f a n y




S Y N T A X



 < i e : p a r a m n a m e = " C O M P A R I S O N " d a t a = " [ A L P H A | N U 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N C A S E _ I G N O R E G R O U P _ O U T C L A S S S O R T B Y C O M P A R I S O N

S O R T E D

C A S E _ I G N O R E A c t s a s a a g f o r c a s e . I f T R U E i s s p e c i e d , c a ss p e c i e d , t h e n c a s e i s s i g n i c a n t . T h e d e f a u l t f M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m




C O M P A R I S O N D e s c r i b e s h o w t o c o m p a r e t h e a t t r i b u t e v a l u e sa l p h a - n u m e r i c c o m p a r i s o n o r N U M E R I C f o r a

T h e d e f a u l t f o r t h i s p a r a m e t e r i s A L P H A . M u l t h i s p a r a m e t e r . T h i s p a r a m e t e r i s o p t i o n a l .

G R O U P _ I N S p e c i e s t h e g r o u p t o b e s o r t e d . T h i s p a r a m e t e

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e s o r t e d g r o u p . T h i s p a




S O R T B Y I d e n t i e s t h e e l d o r c o l u m n n a m e t o b e u s e d f o r s o s o r t b e f o r e a l l n u m b e r s a n d l e t t e r s i n a s c e n d i n g s o ra n d l e t t e r s i n d e s c e n d i n g s o r t i n g . M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r .f o r S O R T B Y t h a n f o r S O R T E D , C O M P A R I S O N ,t h e l a s t v a l u e s p e c i e d f o r S O R T E D , C O M P A R I S u s e d a g a i n s t t h e r e m a i n i n g S O R T B Y v a l u e s . T h i s

S O R T E D D e s c r i b e s h o w t o o r d e r t h e o u t p u t o f t h e t w o g r o u p o r d e r o f o u t p u t o r D E S C f o r a d e s c e n d i n g o r d e r o f p a r a m e t e r i s A S C . M u l t i p l e v a l u e s c a n b e s p e c i e d p a r a m e t e r i s o p t i o n a l .

E X A M P L E : S I N G L E - C O L U M N S O R T I N G

T h e f o l l o w i n g e x a m p l e s o r t s t h e g r o u p n a m e d “ c r e aa l p h a b e t i c a l l y , i n a s c e n d i n g o r d e r , i g n o r i n g c a s e , a n d a t a i n a n o u t p u t g r o u p n a m e d “ r e s u l t s ” :


< ! - - S o r t t h e e l e m e n t s i n a g r o u p . - - >


 



E X A M P L E : M U L T I - C O L U M N S O R T I N G

T h e f o l l o w i n g S o r t - G r o u p w e b j e c t e x a m p l e s h o w s s

F i r s t , a g r o u p i s c r e a t e d , c o n t a i n i n g e m p l o y e e l a s t n a


 < i e : p a r a m n a m e = " E L E M E N T " d a t a = " D E P T = 3 0 0 : N A M E = S< i e : p a r a m n a m e = " E L E M E N T " d a t a = " D E P T = 3 0 0 : N A M E = J




< i e : p a r a m n a m e = " E L E M E N T " d a t a = " D E P T = 2 0 0 : N A M< i e : p a r a m n a m e = " E L E M E N T " d a t a = " D E P T = 1 0 0 : N A M< i e : p a r a m n a m e = " E L E M E N T " d a t a = " D E P T = 3 0 0 : N A M




T h e r e s u l t i n g o u t p u t g r o u p n a m e d “ e m p l o y e e s ” f o r m :

D E P T N A M E 3 0 0 S m i t h 3 0 0 J o h n s o n 2 0 0 R e i l l y 1 0 0 S i n c l a i r 3 0 0 M i c h a e l s 5 0 0 K i n g

T h e g r o u p “ e m p l o y e e s ” i s t h e n s o r t e d b y d e p a r t m

 




T h e o u t p u t g r o u p n a m e d “ r e s u l t s ” w o u l d d i s p l a y

D E P T N A M E 1 0 0 S i n c l a i r 2 0 0 R e i l l y 3 0 0 S m i t h 3 0 0 J o h n s o n

3 0 0 M i c h a e l s 5 0 0 K i n g

N o t e T h e e m p l o y e e n a m e s i n D e p a r t m e n t 3 0 0 a r e i n n o




T h e g r o u p “ e m p l o y e e s ” i s t h e n s o r t e d b y d e p a r t m e n a s c e n d i n g o r d e r .

 




T h e o u t p u t g r o u p n a m e d “ r e s u l t s ” w o u l d d i s p l a y i n t

D E P T N A M E

1 0 0 S i n c l a i r

2 0 0 R e i l l y 3 0 0 J o h n s o n 3 0 0 M i c h a e l s 3 0 0 S m i t h 5 0 0 K i n g

N o t e T h e e m p l o y e e n a m e s i n D e p a r t m e n t 3 0 0 a r e n o w l i s t eo r d e r .

T h e g r o u p “ e m p l o y e e s ” i s t h e n s o r t e d b y d e p a r t m e n n a m e , d e s c e n d i n g .

 < i e : p a r a m n a m e = " S O R T B Y " d a t a = " D E P T , N A M E " d e l i m =




T h e o u t p u t g r o u p n a m e d “ r e s u l t s ” w o u l d d i s p l a y i n t

D E P T N A M E 1 0 0 S i n c l a i r 2 0 0 R e i l l y 3 0 0 S m i t h 3 0 0 M i c h a e l s 3 0 0 J o h n s o n




D E P T N A M E 5 0 0 K i n g

N o t e T h e e m p l o y e e n a m e s i n D e p a r t m e n t 3 0 0 a r e n o w o r d e r .

S u b s e t - G r o u p


U s e s p a t t e r n m a t c h i n g o n s i n g l e o r m u l t i p l e p a r aa s p e c i e d p a t t e r n a s a w h o l e o r t o s e e i f a s u b s t r i s p e c i e d p a t t e r n . M a t c h i n g i s d o n e u s i n g r e g u l a rS t a n d a r d ) . C a s e c a n b e i g n o r e d .

S Y N T A X

 < i e : p a r a m n a m e = " F I L T E R _ M O D E " d a t a = " [ M A T C H | N< i e : p a r a m n a m e = " F I L T E R _ T Y P E " d a t a = " [ I E | R E G E X

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l F I L T E R C A S E _ I G N O R E G R O U P _ I N C L A S S G R O U P _ O U T F I L T E R _ M O D E

F I L T E R _ T Y P E

C A S E _ I G N O R E A c t s a s a a g f o r c a s e . I f T R U E i s s p e c i e d , c a s f o r m a t c h e s . I f F A L S E i s s p e c i e d , t h e n c a s e i s p a r a m e t e r i s F A L S E . T h i s p a r a m e t e r i s o p t i o n






G R O U P _ O U T S p e c i e s t h e n a m e o f t h e o u t p u t g r o u p i n t o w h i p a r a m e t e r i s r e q u i r e d .

E X A M P L E

T h e f o l l o w i n g e x a m p l e u s e s p a t t e r n m a t c h i n g t o p a t t e r n a s a w h o l e o r t o s e e i f a s u b s t r i n g w i t h i n a p a t t e r n . T h e r s t S u b s e t - G r o u p w e b j e c t p a s s e s i tF I L T E R , p l a c i n g t h o s e i t e m s i n a n o u t p u t g r o u p S u b s e t - G r o u p w e b j e c t p a s s e s i t e m s w h i c h d o n o p l a c i n g t h o s e i t e m s i n a o u t p u t g r o u p n a m e d “ n o


p r e f i x = " i e " % >

< ! - - F o r m a n e w g r o u p t h a t i s a s u b s e t o f a g r o u p . -


 < i e : p a r a m n a m e = " F I L T E R _ T Y P E " d a t a = " R E G E X P " /





 < i e : p a r a m n a m e = " F I L T E R _ T Y P E " d a t a = " R E G E X P " / 



 






S u m m a r i z e - G r o u p s


P r o v i d e s d e s c r i p t i v e i n f o r m a t i o n a b o u t g r o u p s .

S Y N T A X

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N C L A S S G R O U P _ O U T




G R O U P _ I N S p e c i e s t h e g r o u p s t o b e s u m m a r i z e d . M u l t i p l e v at h i s p a r a m e t e r . T h i s p a r a m e t e r i s r e q u i r e d .

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e r e s u l t s o f s u m m a r i z i n g t h o r r o w h a s t h e f o l l o w i n g a t t r i b u t e s : N A M E – t h e n a m e o f t h e G R O U P _ I N

T Y P E – t h e t y p e o f t h e g r o u p ( U n k n o w n , O b j e c t , SS I Z E – c u r r e n t l y 0 C O U N T – t h e n u m b e r o f e l e m e n t s i n t h e g r o u p M I M E T Y P E – c u r r e n t l y a n e m p t y s t r i n g M E S S A G E – t h e m e s s a g e , i f a n y , a s s o c i a t e d w i t h S T A T U S – t h e i n t e g e r s t a t u s a s s o c i a t e d w i t h t h e g





E X A M P L E

T h e f o l l o w i n g e x a m p l e u s e s S u m m a r i z e - G r o u p s

a b o u t t h e s p e c i e d G R O U P _ I N a n d p l a c e s t h e r e n a m e d “ r e s u l t ” :


p r e f i x = " i e " % >

< ! - - S u m m a r i z e t h e c o n t e n t s o f a s e t o f g r o u p s . - -

 

< i e : w e b j e c t n a m e = " S u m m a r i z e - G r o u p s " t y p e = " G R P < i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " c r e a t e d g r o u p< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " c r e a t e h r g r o u 



T r a n s l a t e - G r o u p


A l l o w s t r a n s l a t i o n o f d a t a f r o m a s p e c i e d I n f o * o f t h e f o l l o w i n g w a y s : • R e n a m e a t t r i b u t e s w i t h i n e l e m e n t s i n t h e g r o u• T r a n s l a t e d a t a t y p e s o f a t t r i b u t e v a l u e s i n t h e o• R e m o v e a t t r i b u t e s f r o m e l e m e n t s i n t h e o u t p u • A p p l y a n X S L s t y l e s h e e t t o t h e I n f o * E n g i n e d

G R O U P _ I N p a r a m e t e r .

T h i s w e b j e c t c a n b e u s e d f o r g e n e r a l i z e d s c h e m a

S Y N T A X

 < i e : p a r a m n a m e = " G R O U P _ O U T " d a t a = " G R O U P _ O U T _ 




< i e : p a r a m n a m e = " T Y P E _ T R A N S _ T A B L E " d a t a = " g r o u p _ n a< i e : p a r a m n a m e = " X S L _ P A R A M " d a t a = " n a m e _ v a l u e _ p a i r "

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N C O P Y _ U N T R A N S L A T E D C L AG R O U P _ O U T D E F A U L T _ T A B L E D B U S

N A M E _ T R A N S _ T A B L E P A S S W D T Y P E _ T R A N S _ T A B L E X S L _ P A R A

X S L _ U R L




C O P Y _ U N T R A N S L A T E D

S p e c i e s t h e a c t i o n t o b e t a k e n a g a i n s t a t t r i b u t e s f oe l e m e n t s t h a t a r e n o t m a t c h e d b y a t t r i b u t e s o f t h e st h e N A M E _ T R A N S _ T A B L E o r T Y P E _ T R A N S _v a l u e o f t h e p a r a m e t e r i s s p e c i e d a s Y E S , t h e n t h eo f a G R O U P _ I N e l e m e n t w h i c h d o e s n o t m a t c h t h i n t h e N A M E _ T R A N S _ T A B L E o r T Y P E _ T R A N G R O U P _ O U T e l e m e n t u n m o d i e d . I f C O P Y _ U Ns p e c i e d , i t s v a l u e d e f a u l t s t o N O , i n w h i c h c a s e a ni n c l u d e d i n t h e G R O U P _ O U T e l e m e n t .

I f y o u s p e c i f y t h e C O P Y _ U N T R A N S L A T E D p a r as p e c i f y e i t h e r t h e N A M E _ T R A N S _ T A B L E o r t h e p a r a m e t e r .

D B U S E R S p e c i e s t h e u s e r n a m e t o b e u s e d t o a u t h e n t i c a t e t ot e m p l a t e s t o b e u s e d b y t h e w e b j e c t r e s i d e o n a r e m p a r a m e t e r s h o u l d b e u s e d i n c o n j u n c t i o n w i t h t h e P





D E F A U L T _ T A B L E S p e c i e s t h e n a m e o f a g r o u p t h a t p r o v i d e s d e f at o t h e G R O U P _ O U T g r o u p . T h e g r o u p i s a s s u e l e m e n t . I f m o r e t h a n o n e e l e m e n t i s c o n t a i n e da d d i t i o n a l e l e m e n t s a r e i g n o r e d . E a c h a t t r i b u t d e f a u l t n a m e a n d v a l u e .

A f t e r t h e N A M E _ T R A N S _ T A B L E a n d T Y P Eh a v e b e e n a p p l i e d t o e a c h e l e m e n t o f t h e G R O a n e l e m e n t o f t h e G R O U P _ O U T g r o u p , t h e G Rc h e c k e d f o r a t t r i b u t e s h a v i n g n a m e s m a t c h i n g D E F A U L T _ T A B L E . F o r e a c h a t t r i b u t e d e n e dd o e s n o t h a v e a m a t c h i n g n a m e i n t h e G R O U P _t h e D E F A U L T _ T A B L E i s a d d e d t o t h e G R O U i f t h e D E F A U L T _ T A B L E c o n t a i n s a n a t t r i b u t

n a m e d “ U n k n o w n ” , a n d a f t e r t r a n s l a t i o n a G R c o n t a i n a n a t t r i b u t e n a m e d “ F a c t o r y ” , t h e n a n aa n d v a l u e “ U n k n o w n ” a r e a d d e d .

I f y o u s p e c i f y t h e D E F A U L T _ T A B L E p a r a m ee i t h e r t h e N A M E _ T R A N S _ T A B L E o r t h e T Y

G R O U P _ I N S p e c i e s t h e g r o u p t o c o n v e r t t o X M L a n d t o w a p p l i e d . T h i s p a r a m e t e r i s r e q u i r e d .

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e r e s u l t s o f t r a n s l a t i n g t

i s r e q u i r e d .




N A M E _ T R A N S _ T A B L E S p e c i e s t h e n a m e o f a g r o u p t h a t d e n e s a n a t t r i b u T h e g r o u p i s a s s u m e d t o c o n t a i n e x a c t l y o n e e l e m ee l e m e n t i s c o n t a i n e d w i t h i n t h e g r o u p , t h e n t h e a d d T h e n a m e o f e a c h a t t r i b u t e o f t h e e l e m e n t i d e n t i e st r a n s l a t e d . T h e v a l u e o f e a c h a t t r i b u t e s p e c i e s t h ei f a n a t t r i b u t e i n t h e N A M E _ T R A N S _ T A B L E g r o a n d t h e v a l u e “ P a r t N u m b e r ” , t h e n e v e r y a t t r i b u t e nG R O U P _ I N g r o u p i s r e n a m e d t o “ P a r t N u m b e r ” i n

N A M E _ T R A N S _ T A B L E a n d T Y P E _ T R A N S _ T t o g e t h e r t o c h a n g e b o t h t h e n a m e s a n d d a t a t y p e s ov a l u e s . W h e n b o t h p a r a m e t e r s a r e s p e c i e d , i t i s i mt h a t t h e a t t r i b u t e n a m e s s p e c i e d b y T Y P E _ T R A Na t t r i b u t e s i n t h e G R O U P _ O U T g r o u p , a f t e r N A M E

b e e n a p p l i e d . I f T Y P E _ T R A N S _ T A B L E s p e c i e so c c u r i n t h e G R O U P _ I N g r o u p , b u t o n e o r m o r e o fu s i n g N A M E _ T R A N S _ T A B L E , t h e n t h e s e a t t r i b G R O U P _ O U T g r o u p w i t h t h e i r n a m e s u n c h a n g e d u s i n g T Y P E _ T R A N S _ T A B L E i n t o d i f f e r e n t d a t a

T h e N A M E _ T R A N S _ T A B L E a n d T Y P E _ T R A N c a n b e s p e c i e d i n a d d i t i o n t o t h e X S L _ U R L p a r a mX S L - b a s e d t r a n s l a t i o n i s e x e c u t e d r s t ; t h e N A M ET Y P E _ T R A N S _ T A B L E b a s e d t r a n s l a t i o n s a r e t h p r o d u c e d b y t h e X S L - b a s e d t r a n s l a t i o n . T h u s , t h e i n t h e N A M E _ T R A N S _ T A B L E i d e n t i f y a t t r i b u t e

t h e X S L - b a s e d t r a n s l a t i o n , n o t a t t r i b u t e s o f t h e o r iI n a l l c a s e s , t h e a t t r i b u t e n a m e s s p e c i e d i n T Y P E _a t t r i b u t e s o f t h e n a l G R O U P _ O U T g r o u p .

P A S S W D S p e c i e s t h e p a s s w o r d c o r r e s p o n d i n g t o D B U S E R





T Y P E _ T R A N S _ T A B L E S p e c i e s t h e n a m e o f a g r o u p t h a t d e n e s a n a t tt r a n s l a t i o n t a b l e . T h e g r o u p i s a s s u m e d t o c o n tm o r e t h a n o n e e l e m e n t i s c o n t a i n e d w i t h i n t h e e l e m e n t s a r e i g n o r e d . T h e n a m e o f e a c h a t t r i b ua t t r i b u t e i n t h e G R O U P _ O U T g r o u p w h o s e v a v a l u e o f e a c h a t t r i b u t e s p e c i e s t h e d e s i r e d d a ta t t r i b u t e i n t h e T Y P E _ T R A N S _ T A B L E g r o u pt h e v a l u e “ I n t e g e r ” , t h e n e v e r y v a l u e o f e v e r y at h e G R O U P _ O U T g r o u p i s c o n v e r t e d t o t h e d at y p e s c u r r e n t l y s u p p o r t e d a r e : B Y T E – 8 - b i t v a l u e . D O U B L E – d o u b l e p r e c i s i o n o a t i n g p o i n t v a F L O A T – s i n g l e p r e c i s i o n o a t i n g p o i n t v a l u e I N T E G E R – i n t e g e r v a l u e w i t h d e f a u l t r a n g e . L O N G – i n t e g e r v a l u e w i t h l o n g r a n g e . S H O R T – i n t e g e r v a l u e w i t h s h o r t r a n g e . S T R I N G – c h a r a c t e r s t r i n g v a l u e .

N A M E _ T R A N S _ T A B L E a n d T Y P E _ T R A N St o g e t h e r t o c h a n g e b o t h t h e n a m e s a n d d a t a t y pv a l u e s . W h e n b o t h p a r a m e t e r s a r e s p e c i e d , t h b y T Y P E _ T R A N S _ T A B L E i d e n t i f y a t t r i b u t e a f t e r N A M E _ T R A N S _ T A B L E h a s b e e n a p p l is p e c i e s n a m e s o f a t t r i b u t e s t h a t o c c u r i n t h e G m o r e o f t h e s e a r e n o t t r a n s l a t e d u s i n g N A M E _ a t t r i b u t e s a r e c o p i e d t o t h e G R O U P _ O U T g r o u b u t t h e i r v a l u e s a r e t r a n s l a t e d u s i n g T Y P E _ T R d a t a t y p e s .

T h e N A M E _ T R A N S _ T A B L E a n d T Y P E _ T R c a n b e s p e c i e d i n a d d i t i o n t o t h e X S L _ U R L p X S L - b a s e d t r a n s l a t i o n i s e x e c u t e d r s t . T h e N AT Y P E _ T R A N S _ T A B L E b a s e d t r a n s l a t i o n s a r p r o d u c e d b y t h e X S L - b a s e d t r a n s l a t i o n . T h u s ,i n t h e N A M E _ T R A N S _ T A B L E i d e n t i f y a t t r i bt h e X S L - b a s e d t r a n s l a t i o n , n o t a t t r i b u t e s o f t h eI n a l l c a s e s , t h e a t t r i b u t e n a m e s s p e c i e d i n T Y a t t r i b u t e s o f t h e n a l G R O U P _ O U T g r o u p .




X S L _ P A R A M D e n e s X S L p a r a m e t e r s t h a t a r e t h e n p a s s e d t o t h e t h e X S L _ U R L p a r a m e t e r . E n t e r t h e v a l u e f o r t h e Xi n t h e f o r m X S L _ n a m e = X S L _ v a l u e , w h e r e X S L _ n a m e i s t h e n a m e o f a p a r a m e t e r i n t h e X S L s t y l e s h e e t a n d X S L _ v a l u e i s t h e v a l u e y o u w a n t s e tf o r t h e p a r a m e t e r .

T h e d e f a u l t f o r X S L _ P A R A M i s t h a t n o p a r a m e t e r M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r

X S L _ U R L I d e n t i e s t h e l o c a t i o n o f a n X S L s t y l e s h e e t t o a p p l yt h e G R O U P _ I N p a r a m e t e r . A r e l a t i v e U R L o r a f u s p e c i e d . R e l a t i v e U R L s a r e r e l a t i v e t o t h e I n f o * E r o o t . T h e X S L s t y l e s h e e t s h o u l d b e c o n s t r u c t e d t o X M L f o r m a t ( t h e f o r m a t s h o w n i n a l l e x a m p l e s i n b y t h e D i s p l a y - X M L w e b j e c t ) . T h e s t y l e s h e e t m u sX M L f o r m a t .

T h e N A M E _ T R A N S _ T A B L E a n d T Y P E _ T R A N c a n b e s p e c i e d i n a d d i t i o n t o t h e X S L _ U R L p a r a mX S L - b a s e d t r a n s l a t i o n i s e x e c u t e d r s t ; t h e N A M ET Y P E _ T R A N S _ T A B L E b a s e d t r a n s l a t i o n s a r e t h p r o d u c e d b y t h e X S L - b a s e d t r a n s l a t i o n .

F u l l y q u a l i e d U R L s a r e d e r e f e r e n c e d u s i n g A u t h - M a p c o n t e x t g r o u p d a t a . T h e A u t h - M a p i s s e a r c h e d f o r a u s e r n a m e a n d p a s s w o r d bn a m e f o u n d i n t h e f u l l y q u a l i e d U R L . F o r e x a m p l

i s h t t p : / / m a c h i n e . c o m / s e r v l e t / I E / c r e a t e G , t h e A u t h - M a p c o n t e x t g r o u p i s s e a r c h e d f o r a u s e r n a m e ah a s a n I N S T A N C E n a m e o f h t t p : / / m a c h i n e . c o m . I f a u s e r n a m e a n d p a s s w o r d a r e f o u n d , B A S I C a u t h e n t i c a t i o n i n a c c e s s i n g t h e U R L . I f n o u s e r n a m e a n d p a s s w o r d ai n f o r m a t i o n i s s e n t t o t h e r e m o t e w e b s e r v e r .

I f t h e d a t a v a l u e c o n t a i n s t h e : / / s t r i n g , i t i s a s s u m e d t o b e a f u l l y i n t e r n e t U R L . I f t h e d a t a v a l u e d o e s n o t c o n t a i n t h e : / / s t r i n g , t h e s t y l e s h e e ti s a s s u m e d t o b e a l o c a l l e r e l a t i v e t o t h e c u r r e n t t a


E X A M P L E T h e f o l l o w i n g e x a m p l e t r a n s l a t e s t h e d a t a f r o m t h e g b y r e n a m i n g t h e a t t r i b u t e s . T h e r e s u l t i n g d a t a i s p l a c“ R e n a m e d G r o u p ” :


p r e f i x = " i e " % >




< ! - - C r e a t e a t e s t G r o u p - - >


< ! - - C r e a t e a t t r i b u t e t r a n s l a t i o n G r o u p - - >


d a t a = " N A M E = F u l l N a m e : E M A I L = E m a i l A d

< ! - - T r a n s l a t e t h e a t t r i b u t e n a m e s - - >

< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " c r e a t e d g r o u p

< ! - - T r a n s l a t e s o m e o f t h e a t t r i b u t e n a m e s - - >

< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " c r e a t e d g r o u p< i e : p a r a m n a m e = " N A M E _ T R A N S _ T A B L E " d a t a = " N e

U n i o n - G r o u p s


I d e n t i e s t h e u n i o n o f t w o g r o u p s a n d p l a c e s t h e e x a m p l e , g r o u p A c o n t a i n s t h e e l e m e n t s u , v , a n de l e m e n t s x , y , a n d z . T h e U n i o n - G r o u p s w e b j e c t g r o u p A o r g r o u p B o r b o t h a n d u s e s t h e r e s u l t s t o

e x a m p l e , w o u l d c o n t a i n t h e e l e m e n t s u , v , x , y , a S Y N T A X

 < i e : p a r a m n a m e = " C O M P A R I S O N " d a t a = " [ A L P H A | N U< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " i n p u t _ g r o u p s " / 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N C A S E _ I G N O R E G R O U P _ O U T C L A S S U N I O N B Y C O M P A R I S O N





T h e d e f a u l t f o r t h i s o p t i o n a l p a r a m e t e r i s “ U n k n o w

C O M P A R I S O N D e s c r i b e s h o w t o c o m p a r e t h e t w o g r o u p s : e i t h e r Ac o m p a r i s o n o r N U M E R I C f o r a s t r i c t l y n u m e r i c c ot h i s p a r a m e t e r i s A L P H A . T h i s p a r a m e t e r i s o p t i o n

G R O U P _ I N S p e c i e s t h e n a m e s o f t h e t w o g r o u p s t o b e u s e d i n

T o s p e c i f y t w o g r o u p n a m e s , y o u c a n i n c l u d e t w o lf o r t h e G R O U P _ I N p a r a m e t e r . F o r e x a m p l e :



G R O U P _ O U T S p e c i e s t h e n a m e o f t h e r e s u l t s o f c o m p u t i n g t h e uT h i s p a r a m e t e r i s r e q u i r e d .






U N I O N B Y I d e n t i e s t h e e l d o r c o l u m n n a m e t o b e u s e d f oi s r e q u i r e d .

E X A M P L E

T h e f o l l o w i n g e x a m p l e n d s t h e u n i o n o f t h e t w o N A M E a t t r i b u t e , c o m p a r e s t h e m a l p h a b e t i c a l l y n a m e d “ r e s u l t s ” :


p r e f i x = " i e " % >

< ! - - F o r m a n e w g r o u p f r o m t h e U n i o n o f m u l t i p l e g

 

 < i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " c r e a t e d g r o u p 

X O R - G r o u p s


I d e n t i e s t h e s y m m e t r i c d i f f e r e n c e o r t h e ' e x c l u se x a m p l e , g r o u p A c o n t a i n s t h e e l e m e n t s u , v , a n de l e m e n t s x , y , a n d z . T h e X O R - G r o u p s w e b j e c t i g r o u p s A a n d B a n d u s e s t h e r e s u l t s t o f o r m g r o u pe i t h e r g r o u p A o r g r o u p B , b u t n o t i n b o t h g r o u p s e x a m p l e , w o u l d c o n t a i n t h e e l e m e n t s u , v , y , a n d




S Y N T A X



 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N C A S E _ I G N O R E G R O U P _ O U T C L A S S X O R B Y C O M P A R I S O N






C O M P A R I S O N

D e s c r i b e s h o w t o c o m p a r e t h e t w o g r o u p s : e i t h e r Ac o m p a r i s o n o r N U M E R I C f o r a s t r i c t l y n u m e r i c c ot h i s p a r a m e t e r i s A L P H A . T h i s p a r a m e t e r i s o p t i o n




G R O U P _ I N S p e c i e s t h e n a m e s o f t h e t w o g r o u p s t o b e u s e d i f f e r e n c e .

T o s p e c i f y t w o g r o u p n a m e s , y o u c a n i n c l u d e t f o r t h e G R O U P _ I N p a r a m e t e r . F o r e x a m p l e :



G R O U P _ O U T S p e c i e s t h e n a m e o f t h e r e s u l t s o f c o m p u t i n g t p a r a m e t e r i s r e q u i r e d .

S O R T B Y

S p e c i e s t h e n a m e o f t h e a t t r i b u t e o n w h i c h t h ei n c l u d e t h i s p a r a m e t e r , t h e r e s u l t s a r e n o t s o r t e


X O R B Y I d e n t i e s t h e a t t r i b u t e n a m e t o b e u s e d f o r c o m c o m p a r e d c o n t a i n e l e m e n t s w i t h a t t r i b u t e s o f tX O R B Y v a l u e c a n b e s p e c i e d . O t h e r w i s e , y o p a r a m e t e r s t o p r o v i d e t h e n a m e s o f t h e a t t r i b u tt h a t a r e c o m p a r e d .

T h e a t t r i b u t e n a m e p l a c e d i n t h e o u t p u t g r o u p iX O R B Y p a r a m e t e r u s e d .


E X A M P L E

T h e f o l l o w i n g e x a m p l e n d s t h e e x c l u s i v e o r o f t h e t w o s p e c i e d i n g r o u p s , a n d p l a c e s t h e r e s u l t i n g d a t a i n a n o u t p u t


p r e f i x = " i e " % >

< ! - - F o r m a n e w g r o u p f r o m t h e " e x c l u s i v e o r " o f t w o g r o u p s - - >

 




 

 



M a n a g e m e n t W e b j e c t s T h e f o l l o w i n g w e b j e c t s p r o v i d e s o m e c o m m o n f u n c p r o p e r t i e s , m a p p i n g c r e d e n t i a l s , a n d t h r o w i n g e x c e m a n a g i n g y o u r J S P p a g e s o r t a s k s :

• D i s p a t c h - T a s k s o n p a g e 4 1 8 • G e n e r a t e - W S D L o n p a g e 4 2 5 • G e t - P r o p e r t i e s o n p a g e 4 2 8 • G e t - R e s o u r c e o n p a g e 4 2 9 • L i s t - R e p o s i t o r i e s o n p a g e 4 3 1 • L o o k u p - S e r v i c e s o n p a g e 4 3 2 • M a p - C r e d e n t i a l s o n p a g e 4 3 3 • Q u e r y - S c h e m a o n p a g e 4 3 5 • Q u e r y - T y p e H i e r a r c h y o n p a g e 4 3 6

• T h r o w - E x c e p t i o n o n p a g e 4 3 8 • W r i t e - L o g o n p a g e 4 4 0

A l l m a n a g e m e n t w e b j e c t s u s e t h e M G T t y p e a t t r i b u t e v a l u e i n t h e w e b j e c t t a g .

D i s p a t c h - T a s k s


S e l e c t s a t a s k t h a t i s c a p a b l e o f e x e c u t i n g a s p e c i e d t h e s p e c i e d t y p e r e s i d i n g a t t h e s p e c i e d l o c a t i o n . T

d e v e l o p m e n t o f a p p l i c a t i o n s t h a t o p e r a t e u p o n i n f o rm u l t i p l e h o s t s o r c o m p r i s e d o f m u l t i p l e o b j e c t t y p e s

S Y N T A X

 

 < i e : p a r a m n a m e = " D E F A U L T _ D O M A I N " d a t a = " d o m a i n _ n a m




 < i e : p a r a m n a m e = " G R O U P _ V D B " d a t a = " g r o u p _ n a m e " /

< i e : p a r a m n a m e = " I D _ A T T R I B U T E " d a t a = " a t t r _ n a m e < i e : p a r a m n a m e = " I D _ M E T A _ A T T R I B U T E " d a t a = " m e t < i e : p a r a m n a m e = " T A S K S " d a t a = " g r o u p _ n a m e _ o r _ u r 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l A C T I O N A C C E S S C L I M B E R G R O U P _ I N I D _ A T T R I B U T E G R O U T A S K S I D _ M E T A _ A T T R I B U T E M A X

T Y P E _ A T T R I B U T E P A R A M T Y P E _ M E T A _ A T T R I B U T E

A C C E S S S p e c i e s t h e r e q u i r e d a c c e s s c o n g u r a t i o n o f t ho f t h i s D i s p a t c h - T a s k s i n v o c a t i o n . T h i s p a r a m t h e v a l u e o f t h e A C T I O N p a r a m e t e r h a s b e e n s I t b e h a v e s i d e n t i c a l l y t o t h e a c c e s s a t t r i b u t e o n a t a s k p a g e d i r e c t i v e . T h e v a l u e c a n b e a p i p e - d e l i m i t e d l i s t o f a c c e s s v a l ut h e d e f a u l t t a s k a c c e s s o f t h e s y s t e m i s u s e d . F oa c c e s s a t t r i b u t e , s e e p a g e D i r e c t i v e o n p a g e 2 3 7 .

A C T I O N S p e c i e s t h e n a m e o f t h e l o g i c a l a c t i o n t h a t i s ps e l e c t e d a n d e x e c u t e d . A C T I O N i s t h e p r i m a r yt a s k s t o b e e x e c u t e d . T h i s p a r a m e t e r i s r e q u i r e

C L I M B E R I d e n t i e s t h e n a m e o f a J a v a c l a s s w h i c h c l i m b so f t a s k d e l e g a t e s . I f s p e c i e d , t h e p a r a m e t e r c o

w e b j e c t u n t i l i t e i t h e r s u c c e e d s i n n d i n g t h e a pr e a c h e s t h e t o p o f t h e h i e r a r c h y . I f t h e t o p o f t h n d i n g a t a s k d e l e g a t e , a n e x c e p t i o n i s t h r o w n .

D E F A U L T _ D O M A I N S p e c i e s a d e f a u l t d o m a i n t o u s e i n s t e a d o f d e r io f t h e l o c a l v i r t u a l m a c h i n e i n c a s e s w h e r e o b j em e t a d a t a t h a t i d e n t i e s t h e i r d o m a i n s .




D E F A U L T _ T Y P E S p e c i e s a d e f a u l t t y p e n a m e t o u s e i n s t e a d o f c o m . p t c . o b j e c t i n c a s e s w h e r e o b j e c t s d o n ’ t h a v e a t t r i b u t e s o f m e t a d a t a t h a

G R O U P _ I N S p e c i e s t h e n a m e o f t h e g r o u p c o n t a i n i n g t h e o b j ea c t i o n s p e c i e d b y A C T I O N i s t a k e n . M u l t i p l e v a l p a r a m e t e r , r e s u l t i n g i n m o r e t h a n o n e g r o u p o f o b j A C T I O N . T h i s p a r a m e t e r i s r e q u i r e d .

G R O U P _ V D B P r o v i d e s t h e n a m e s o f o n e o r m o r e g r o u p s t h a t a r e t h e c a l l e d t a s k s i n t h e i r V D B s . T h e s e n a m e s p o p u lt a s k s ’ V D B s w i t h a n i n i t i a l s e t o f g r o u p s o t h e r t h a nG R O U P _ I N p a r a m e t e r s .

I D _ A T T R I B U T E S p e c i e s t h e n a m e o f t h e a t t r i b u t e t h a t e v e r y e l e m ec o n t a i n s a n d t h a t s p e c i e s e a c h r e s p e c t i v e e l e m e n tF o r e x a m p l e , i f t h e v a l u e o f t h i s p a r a m e t e r i s O B I De v e r y e l e m e n t o f t h e i n p u t g r o u p c o n t a i n s a n a t t r i b t h e v a l u e o f e a c h s u c h a t t r i b u t e i d e n t i e s t h e u n i q u e l e m e n t c o n t a i n i n g i t .

I f s p e c i e d , I D _ A T T R I B U T E t a k e s p r e c e d e n c e o I D _ M E T A _ A T T R I B U T E . I f n e i t h e r I D _ A T T R I BI D _ M E T A _ A T T R I B U T E i s s p e c i e d , a n i n t e r n a l e l e m e n t ’ s u n i q u e o b j e c t i d e n t i e r . I f a n e l e m e n t i s

t h e n t h e A P I r e t u r n s t h e W i n d c h i l l t y p e i d e n t i e r o I f e i t h e r I D _ A T T R I B U T E o r I D _ M E T A _ A T T R I Br e s o l v e a n e l e m e n t ’ s u n i q u e o b j e c t i d e n t i e r a n i n t t h e u n i q u e o b j e c t i d e n t i e r .




I D _ M E T A _ A T T R I B U T E S p e c i e s t h e n a m e o f t h e m e t a d a t a i t e m t h a t e v c o n t a i n s a n d t h a t s p e c i e s e a c h r e s p e c t i v e e l e mF o r e x a m p l e , i f t h e v a l u e o f t h i s p a r a m e t e r i s c o m . i n f o e n g i n e . o b , t h e n i t i s a s s u m e d t h a t e v e r y e l e m e n t o f t h e i n p i t e m n a m e d c o m . i n f o e n g i n e . o b i d , a n d t h e v a l u e o f e a c h s u ci d e n t i e s t h e u n i q u e o b j e c t i d e n t i e r o f t h e e l e m

I f b o t h I D _ M E T A _ A T T R I B U T E a n d I D _ A T TI D _ A T T R I B U T E t a k e s p r e c e d e n c e o v e r t h e I Dn e i t h e r I D _ A T T R I B U T E n o r I D _ M E T A _ A T TA P I i s c a l l e d t o o b t a i n t h e e l e m e n t ’ s u n i q u e o b a W i n d c h i l l t y p e i n s t a n c e , t h e n t h e A P I r e t u r n so f t h e o b j e c t .

I f e i t h e r I D _ A T T R I B U T E o r I D _ M E T A _ A T Tr e s o l v e a n e l e m e n t ’ s u n i q u e o b j e c t i d e n t i e r , a t h e u n i q u e o b j e c t i d e n t i e r .

M A X _ C O N C U R R E N T S p e c i e s t h e m a x i m u m n u m b e r o f s e l e c t e d t a s ke x e c u t e c o n c u r r e n t l y . I f t h i s p a r a m e t e r i s n o t s s e l e c t e d , t h e y a r e e x e c u t e d s e q u e n t i a l l y . T h e dT h i s p a r a m e t e r i s o p t i o n a l .

P A R A M S p e c i e s a d d i t i o n a l p a r a m e t e r s t o b e p a s s e d t o e x e c u t e d . E a c h v a l u e o f t h i s p a r a m e t e r i s s p e c n a m e = v a l u e p a i r ,

w h e r e n a m e i s t h e n a m e o f t h e a d d i t i o n a l p a r a m e t e r s e l e c t e d t a s k , a n d v a l u e i s t h e v a l u e o f t h e p a r a m e t e r .

I f P A R A M i s n o t s p e c i e d , n o a d d i t i o n a l p a r a mt a s k . M u l t i p l e v a l u e s m a y b e s p e c i e d f o r t h i s po p t i o n a l .




T A S K S S p e c i e s e i t h e r a n L D A P U R L o r t h e n a m e o f a g r o

I f a n L D A P U R L i s s p e c i e d , t h e n t h e U R L i d e n t i t h e n o d e w i t h i n t h e a s s o c i a t e d d i r e c t o r y t h a t e s t a b lt a s k d e n i t i o n s . T a s k s a r e s e l e c t e d f r o m t h e t r e e o n( f r o m t h e A C T I O N p a r a m e t e r ) , o b j e c t t y p e ( o b t a i nT Y P E _ A T T R I B U T E o r T Y P E _ M E T A _ A T T R I B ( o b t a i n e d f r o m t h e d o m a i n c o m p o n e n t o f t h e o b j e c b a s e d o n I D _ A T T R I B U T E o r I D _ M E T A _ A T T R I

I f a g r o u p n a m e i s s p e c i e d , t h e n t h e g r o u p r e p r e s ed e n i t i o n s . E a c h e l e m e n t o f t h e g r o u p s p e c i e s o n es u c h d e n i t i o n i s a s s u m e d t o c o n t a i n a t t r i b u t e s n a m

• A C T I O N – S p e c i e s t h e l o g i c a l n a m e o f t h e a c t i

d e n i t i o n . T h i s a t t r i b u t e i s c o m p a r e d t o t h e A C T w e b j e c t . I f t h e y d o n o t m a t c h , t h e n t h e d e n i t i o n i n v o c a t i o n o f t h e w e b j e c t .

• T Y P E – S p e c i e s t h e o b j e c t t y p e t o w h i c h t h i s d ea t t r i b u t e i s c o m p a r e d t o t h e o b j e c t t y p e o b t a i n e d i n p u t g r o u p . I f t h e y d o n o t m a t c h , t h e n t h e d e n i tt h e e l e m e n t . I f t h e v a l u e o f t h i s a t t r i b u t e i s “ * ” , t ha l l o b j e c t t y p e s .

• D O M A I N – S p e c i e s t h e f u l l y q u a l i e d d o m a i n d e n i t i o n a p p l i e s . T h i s a t t r i b u t e i s c o m p a r e d t o to b t a i n e d f r o m t h e u n i q u e o b j e c t i d e n t i e r o f e a c h

g r o u p . I f t h e y d o n o t m a t c h , t h e n t h e d e n i t i o n d e l e m e n t . I f t h e v a l u e o f t h i s a t t r i b u t e i s “ * ” , t h e d d o m a i n s .

• T A S K – S p e c i e s t h e U R L o f t h e I n f o * E n g i n e t aa c t i o n a s s o c i a t e d w i t h t h i s d e n i t i o n .

• P R O C E S S O R – S p e c i e s t h e n a m e o f t h e I n f o * Et h a t i s c a p a b l e o f e x e c u t i n g t h e t a s k i d e n t i e d b y t h i s a t t r i b u t e i s n o t s p e c i e d i n a t a s k d e n i t i o n , t hi d e n t i e d b y t h e T A S K a t t r i b u t e c a n b e a c c e s s e d





T Y P E _ A T T R I B U T E S p e c i e s t h e n a m e o f t h e a t t r i b u t e t h a t e v e r y e lc o n t a i n s a n d t h a t s p e c i e s e a c h r e s p e c t i v e e l e mi f t h e v a l u e o f t h i s p a r a m e t e r i s C L A S S , t h e n i t o f t h e i n p u t g r o u p c o n t a i n s a n a t t r i b u t e n a m e d s u c h a t t r i b u t e i d e n t i e s t h e o b j e c t t y p e o f t h e e l

I f b o t h T Y P E _ A T T R I B U T E a n d T Y P E _ M E Ts p e c i e d , t h e n T Y P E _ A T T R I B U T E t a k e s p r e T Y P E _ M E T A _ A T T R I B U T E . I f n e i t h e r T Y P T Y P E _ M E T A _ A T T R I B U T E i s s p e c i e d , t h e no b t a i n t h e t y p e i d e n t i e r . I f t h e e l e m e n t i s a W i r e t u r n s t h e W i n d c h i l l t y p e i d e n t i e r o f t h e o b j e

I f e i t h e r T Y P E _ A T T R I B U T E o r T Y P E _ M E T Af a i l t o r e s o l v e a n e l e m e n t ’ s t y p e i d e n t i e r a n i n t h e t y p e i d e n t i e r .

T Y P E _ M E T A _ A T T R I B U T E S p e c i e s t h e n a m e o f t h e m e t a d a t a i t e m t h a t e v c o n t a i n s a n d t h a t s p e c i e s e a c h r e s p e c t i v e e l e mi f t h e v a l u e o f t h i s p a r a m e t e r i s c o m . i n f o e n g i n e . o b j e c t T y , t h e n i t i s a s s u m e d t h a t e v e r y e l e m e n t o f t h e i n p u t g r o ui t e m n a m e d c o m . i n f o e n g i n e . o b j e c t T y p e , a n d t h e v a l u e o f e a c m e t a d a t a o b j e c t i d e n t i e s t h e o b j e c t t y p e o f t h e

I f b o t h T Y P E _ M E T A _ A T T R I B U T E a n d T Y Pt h e n T Y P E _ A T T R I B U T E t a k e s p r e c e d e n c e o v

I f n e i t h e r T Y P E _ A T T R I B U T E n o r T Y P E _ M Et h e n a n i n t e r n a l A P I i s c a l l e d t o o b t a i n t h e t y p e W i n d c h i l l t y p e i n s t a n c e , t h i s A P I r e t u r n s t h e Wo b j e c t .

I f e i t h e r T Y P E _ A T T R I B U T E o r T Y P E _ M E T Af a i l t o r e s o l v e a n e l e m e n t ’ s t y p e i d e n t i e r a n i n t h e t y p e i d e n t i e r .

E X A M P L E

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " t r u e " e r r o r P a g e V e c t o r , j a v a . u t i l . E n u m e r a t i o n , c o m . i n f o e n g i n e . S A K .

< % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g< h t m l > < h e a d > < t i t l e > D i s p a t c h T a s k s < / t i t l e > < / h e a d > 








G e n e r a t e - W S D L


G e n e r a t e s W e b S e r v i c e D e n i t i o n L a n g u a g e ( W t a s k s f o r u s e b y S O A P c l i e n t s . W S D L i s a n X M Lc l i e n t / s e r v e r i n t e r f a c e s .

F o r t h e I n f o * E n g i n e S O A P s e r v i c e t o p e r f o r m i n b i n d t o t h e s e r v i c e u s i n g t h e H T T P U R L s p e c i e t h e g e n e r a t e d W S D L , s i n c e i t c o n t a i n s a d d i t i o n at h e u n d e r l y i n g S O A P s e r v i c e .

T h e g e n e r a t e d W S D L c o n t a i n s S O A P i n f o r m a t i s e r v l e t t h a t a l l o w s i t t o p r o p e r l y r o u t e r e q u e s t s . Ta s i n g l e s e r v i c e n a m e d I E S o a p S e r v l e t b o u n d t o a p o r t n a m e d I E S o a p P o r t , a n d

d e s c r i b e s a l l m e t h o d s a n d m e t h o d s i g n a t u r e s s u pt h e C L A S S p a r a m e t e r . F o r m o r e i n f o r m a t i o n o n S i m p l e O b j e c t A cP r o t o c o l ( S O A P ) W e b S e r v i c e o n p a g e 1 4 .

T h e t a s k s f r o m w h i c h W S D L i s g e n e r a t e d m u s t bl i n e s t h a t d e n e t h e i r p a r a m e t e r s a n d r e s u l t s ( s i m T h e w e b j e c t p a r s e s a l l o f t h e t a s k s f o u n d a t t h e s ps p e c i a l c o m m e n t l i n e s w i t h i n t h e m t o g e n e r a t e Ww e b j e c t p a r a m e t e r s a r e s p e c i e d , t h e W S D L c a n a d d e d t o t h e V D B a s a g r o u p .

S Y N T A X

 < i e : p a r a m n a m e = " G R O U P _ O U T " d a t a = " o u t p u t _ g r o u p< i e : p a r a m n a m e = " R E P O S I T O R Y " d a t a = " r e p o s i t o r y " / 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l C L A S S G R O U P _ O U T R E P O S I T O R Y

S O A P _ U R I R E P O S I T O R Y _ T Y P E S T Y L E T A S K S V E R S I O N




C L A S S S p e c i e s t h e J a v a c l a s s w i t h w h i c h t h e W S D L m e t hv a l u e s p e c i e d m u s t c o r r e s p o n d t o a n e x i s t i n g t y p e t h e s u p p o r t i n g L D A P d i r e c t o r y . T h e R E P O S I T O R p a r a m e t e r s c a n b e u s e d t o d i r e c t t h e w e b j e c t t o t h e L D A P t o d i s c o v e r t h e t y p e i d e n t i e r . T h i s p a r a m e t

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e o u t p u t g r o u p t o c r e a t e . I fs p e c i e d , t h e n t h e o u t p u t i s a d d e d t o t h e V D B a s a gn a m e . T h e g r o u p c o n t a i n s o n e e l e m e n t f o r e a c h c o b y t h e t y p e i d e n t i e r c o r r e s p o n d i n g t o t h e C L A S S e l e m e n t c o n t a i n s o n e a t t r i b u t e p e r t a s k p a r a m e t e r . b e c o m e s t h e a t t r i b u t e n a m e . T h e p a r a m e t e r t y p e b v a l u e . M e t h o d n a m e a n d t a s k a r e s t o r e d a s m e t a d a

w i t h t h e i d e n t i e r s c o m . i n f o e n g i n e . s o a p . w s d l . m e t h oa n d c o m . i n f o e n g i n e . s o a p . w s d l . t a s k r e s p e c t i v e l y . I f c o m m e n t s a r e s p e c i e d o n e i t h e r t h e e n t i r e t a s k o r p a r a m e t e r s t h e c o m m e n t s a r e s t o r e d a s m e t a d a t a wc o m . i n f o e n g i n e . s o a p . w s d l . c o m m e n t . T a s k c o m m e n t s a r e s t o r ea s m e t a d a t a o n t h e c o r r e s p o n d i n g e l e m e n t . P a r a m em e t a d a t a o n t h e c o r r e s p o n d i n g a t t r i b u t e . I f G R O Ut h e n S O A P _ U R I m u s t b e s p e c i e d .

R E P O S I T O R Y S p e c i e s t h e n a m e o f t h e r e p o s i t o r y w h o s e r e p o s i tt h e r e q u i r e d t y p e i d e n t i e r a n d t a s k d e l e g a t e d e n i

h o s t . m y C o m p a n y . c o m , w h i c h r e p r e s e n t s a n i n s t a l l e d i n s t a nI n f o * E n g i n e w i t h a r e p o s i t o r y t y p e o f c o m . p t c . w i n d c h i l l . I f t h i s p a r a m e t e r i s n o t s p e c i e d t h e r e p o s i t o r y t y p e i s g e nv i r t u a l m a c h i n e n a m e o f t h e r u n n i n g J V M . F o r e x an a m e o f c o m . m y C o m p a n y . h o s t . s e r v e r r e s u l t s i n a r e p o s i t o r y o f h o s t . m y C o m p a n y . c o m . T h i s p a r a m e t e r i s o p t i o n a l .

R E P O S I T O R Y _ T Y P E S p e c i e s t h e n a m e o f t h e r e p o s i t o r y t y p e t h a t c o n t ai d e n t i e r a n d t a s k d e l e g a t e d e n i t i o n s . F o r e x a m p l c o m . p t c . w i n d c h i l l . I f t h i s p a r a m e t e r i s n o t s p e c i e d , t h e n t h e b e h a v i o rR E P O S I T O R Y p a r a m e t e r i s c a r r i e d o u t t o a t t e m p t

a p p r o p r i a t e r e p o s i t o r y t y p e . T h i s p a r a m e t e r i s o p t S O A P _ U R I

I d e n t i e s t h e U R I o f t h e S O A P s e r v i c e u s e d t o r o u f u l l y - q u a l i e d U R I s s h o u l d b e s p e c i e d f o r t h i s p a rh t t p : / / l o c a l h o s t / W i n d c h i l l / s e r v l e t / R P C

w h e r e R P C i s a n i n s t a n c e o f c o m . i n f o e n g i n e . s o a p . S o a p R P . I f t h i s p a r a m e t e r i s s p e c i e d , t h e W S D L i s g e n e r a t ea s a B L O B . I f G R O U P _ O U T i s n o t s p e c i e d , S O A




S T Y L E A c c e p t a b l e v a l u e s a r e r p c o r d o c u m e n t . T h i s p a r a m e t e r g o v e r n g e n e r a t e d W S D L r e p r e s e n t s I n f o * E n g i n e S O As e r v i c e s b e h a v e w h e n i t c o m e s t o p r o c e s s i n g r eI f t h e v a l u e i s r p c , t h e g e n e r a t e d W S D L i s R e m o t e P r o S O A P . I f t h e v a l u e i s d o c u m e n t , t h e g e n e r a t e d W S D L i s d o c S O A P . T h e d e f a u l t v a l u e i s r p c . T h i s p a r a m e t e r i s o n l y p r o c eV E R S I O N p a r a m e t e r i s s e t t o 1 . 1 . T h i s p a r a m e t e r i s o p t i o n a l .

S i n c e t h e d e f a u l t s f o r V E R S I O N a n d S T Y L E a 1 . 0 a n d r p c r e s p e c t i v e l y ,t h i s m e a n s t h a t b y d e f a u l t I n f o * E n g i n e S O A P s e r v i c e s . I f y o u w a n t I n f o * E n g i n e S O A P t o b es p e c i f y r p c a n d 1 . 1 f o r S T Y L E a n d V E R S I O N r e s p e c tI n f o * E n g i n e S O A P t o b e h a v e d o c u m e n t - l i t e r a d o c u m e n t a n d 1 . 1 r e s p e c t i v e l y .

T A S K S S p e c i e s t h e l o c a t i o n , r e l a t i v e t o t h e c o n g u r e de x t e r n a l i z e d t o t h e S O A P c l i e n t u s i n g W S D L .

V E R S I O N A c c e p t a b l e v a l u e s a r e 1 . 0 o r 1 . 1 . T h i s p a r a m e t e r g o v e r n s w hg e n e r a t e d W S D L i s S O A P e n c o d e d o r l i t e r a l . T 1 . 0 , w h i c h r e s u l t s i n e n c o d e d S O A P . T h i s p a r a m e t e r i s s e lT h e S T Y L E p a r a m e t e r i s o n l y p r o c e s s e d i f V E 1 . 1 . T h i s p a r a m e ti s o p t i o n a l .

S i n c e t h e d e f a u l t s f o r V E R S I O N a n d S T Y L E a 1 . 0 a n d r p c r e s p e c t i v e l y ,

t h i s m e a n s t h a t b y d e f a u l t I n f o * E n g i n e S O A P s e r v i c e s . I f y o u w a n t I n f o * E n g i n e S O A P t o b e r p c a n d 1 . 1 f o r S T Y L E a n d V E R S I O N r e s p e c t i v e l y . IS O A P t o b e h a v e d o c u m e n t - l i t e r a l , s p e c i f y d o c u m e n t a n d 1 . 1 r e s p e c t i v e l y .

E X A M P L E

T h e f o l l o w i n g G e n e r a t e - W S D L e x a m p l e g e n e r aT h e R E P O S I T O R Y p a r a m e t e r i s g e n e r a t e d b a s e n a m e ( a s d e s c r i b e d i n t h e R E P O S I T O R Y p a r a m m e t h o d s a r e a s s o c i a t e d w i t h t h e J a v a c l a s s n a m e c o m . i n f o e n g i n e . s o . T h e r e q u e s t i s r o u t e d t h r o u g h t h e S O A P s e r v i c e sg e n e r a t e d W S D L i s r e t u r n e d t o t h e c l i e n t a s a B L

 < i e : p a r a m n a m e = " C L A S S " d a t a = " c o m . i n f o e n g i n e . s o 




G e t - P r o p e r t i e s


C r e a t e s a g r o u p f r o m a J a v a p r o p e r t y r e s o u r c e .

S Y N T A X

 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l A T T R I B U T E G R O U P _ O U T S O U R C E

A T T R I B U T E S p e c i e s t h e n a m e s o f t h e p r o p e r t i e s t o f e t c h a n d p lA T T R I B U T E i s n o t s p e c i e d , a l l o f t h e p r o p e r t i e s fa r e p l a c e d i n t h e o u t p u t g r o u p . T h i s p a r a m e t e r i s o p

G R O U P _ O U T

S p e c i e s t h e n a m e o f t h e g r o u p t o c r e a t e t h a t c o n t a o f t h e o b j e c t s i n t h e m e s s a g e q u e u e .

T h e G R O U P _ O U T c o n t a i n s e x a c t l y o n e e l e m e n t . r e p r e s e n t s o n e p r o p e r t y n a m e / v a l u e p a i r o b t a i n e d T h e n a m e o f t h e a t t r i b u t e i s t h e s a m e a s t h e n a m e o p r o p e r t y , a n d t h e v a l u e o f t h e a t t r i b u t e i s t h e s a m e a


S O U R C E S p e c i e s t h e l o c a t i o n o f t h e p r o p e r t i e s t h a t a r e r e t u w e b j e c t . I t m a y b e s p e c i e d a s a r e l a t i v e o r a b s o l u t

• R e l a t i v e U R I s r e f e r e n c e l e s t h a t r e s i d e u n d e r t h t h a t i s d e n e d f o r t h e l o c a l I n f o * E n g i n e t a s k p r o c• A b s o l u t e U R I s r e f e r e n c e l e s t h a t r e s i d e i n t h e l o

o n a r e m o t e H T T P s e r v e r , o r a r e r e f e r e n c e d t h r o ud i r e c t o r y .

I t m a y a l s o b e s p e c i e d a s a s y s t e m l e p a t h r e f e r e n a s w t . p r o p e r t i e s . T h e d e f a u l t f o r t h i s o p t i o n a l p a r a m e t e p r o p e r t i e s d e n e d b y t h e j a v a . l a n g . S y s t e m c l a s s i n t h e G R O U P _ O U T .




E X A M P L E

T h e f o l l o w i n g G e t - P r o p e r t i e s e x a m p l e J S P p a g e

p r e d e t e r m i n e d s o u r c e a n d r e t u r n s t h o s e p r o p e r t i < % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e "

e r r o r P a g e = " . . / I E E r r o r . j s p " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t

p r e f i x = " i e " % >

< h t m l > < h e a d > < t i t l e > G e t P r o p e r t i e s < / t i t l e > < / h e a d > 

 

 < / h t m l >

T o a c t u a l l y r u n t h i s e x a m p l e , y o u w o u l d n e e d t o a n d g r o u p _ o u t v a r i a b l e s a r e i d e n t i e d .

G e t - R e s o u r c e


C r e a t e s a n I n f o * E n g i n e g r o u p f r o m t h e l o c a l i z e dT h e l a n g u a g e o f t h e s t r i n g s i n t h e c r e a t e d g r o u p is e t t i n g o f a c l i e n t ’ s w e b b r o w s e r .

T h e G e t - R e s o u r c e w e b j e c t i s u s e d i n c o n j u n c t i o nw e b j e c t t o s u p p o r t i n s e r t i o n o f l o c a l i z e d t e x t i n t o

S Y N T A X

 




P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l B U N D L E G R O U P _ O U T

B U N D L E I d e n t i e s t h e J a v a c l a s s b a s e r e s o u r c e b u n d l e f r o m t o b e r e t r i e v e d . T h i s p a r a m e t e r i s r e q u i r e d .

G R O U P _ O U T S p e c i e s t h e n a m e o f a n I n f o * E n g i n e g r o u p i n w h il o c a l i z e d s t r i n g s . T h e d e f a u l t f o r t h i s p a r a m e t e r i s b u n d l e . T h i s p a r a m e t e r i s o p t i o n a l .

E X A M P L E

T h e f o l l o w i n g G e t - R e s o u r c e e x a m p l e J S P p a g e c r e as t r i n g s f r o m t h e s p e c i e d r e s o u r c e b u n d l e :

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " e r r o r P a g e = " . . / I E E r r o r . j s p " % >


< h t m l > < h e a d > < t i t l e > G e t P r o p e r t i e s < / t i t l e > < / h e a d > 


d a t a = " c o m . i n f o e n g i n e . u t i l . I E R e s o u r c e " / 

 

 < / h t m l >

T h e k e y v a r i a b l e c a n b e s p e c i e d i n a f o r m , o r t h e s p e




L i s t - R e p o s i t o r i e s


L i s t s I n f o * E n g i n e r e p o s i t o r y e n t r i e s . T h e o u t p u r e p o s i t o r y w h o s e c o n t e n t s a r e t h e L D A P a t t r i b u te a c h e l e m e n t c o n t a i n s a d n a t t r i b u t e c o n t a i n i n g t h e d i s t i n g u i sr e p o s i t o r y e n t r y , a n d a d o m a i n a t t r i b u t e c o n t a i n i n g t h e d o m a i n w i t h t h e r e p o s i t o r y t h a t c a n b e u s e d f o r t a s k d e l e g

S Y N T A X

< i e : p a r a m n a m e = " F I L T E R " d a t a = " p t c R e p o s i t o r y T y p e

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l F I L T E R F I L T E R _ M O D E G R O U P _ O U T

F I L T E R S p e c i e s t h e l t e r u s e d t o r e t u r n a s u b s e t o f t h e T h e f o r m a t o f t h e l t e r i s < a t t r i b u t e > = < r e g u l a r e x p r w h e r e < a t t r i b u t e > i s a n L D A P a t t r i b u t e ( s u c h a s p t c R e p o s i t o r y T y o r p t c S u p p o r t i n g A d a p t e r ) , a n d < r e g u l a r e x p r e s s i o n > i s a r e g u l a r e x p r e s s i o n t o m a t c h a t t r i b u t e v a l u e s a g a i n s t . TT h e d e f a u l t v a l u e f o r t h i s p a r a m e t e r i s p t c R e p o s i t o r y T y p e = . w h i c h m a t c h e s a l l r e p o s i t o r i e s w i t h a p t c R e p o s i t o r y a t t r i b u t e s e t .

F I L T E R _ M O D E S p e c i e s w h e t h e r t h e l t e r s h o u l d m a t c h o r n o t M A T C H m e a n s t h a t i f t h e r e p o s i t o r y e n t r y m a t b e e n s p e c i e d b y t h e l t e r , t h a t e x p r e s s i o n a r e a

p a r a m e t e r i s o p t i o n a l . T h e d e f a u l t v a l u e f o r t h iG R O U P _ O U T

S p e c i e s t h e n a m e o f t h e o u t p u t g r o u p t o c r e a t eT h e d e f a u l t v a l u e f o r t h i s p a r a m e t e r i s r e p o s i t o r i e s .




L o o k u p - S e r v i c e s


T h i s w e b j e c t p e r f o r m s d i r e c t o r y s e a r c h e s t o n d I n f or e s u l t i n g g r o u p c o n t a i n s o n e e l e m e n t p e r s e r v i c e f o u t h e f o l l o w i n g a t t r i b u t e s :

• d n • d e s c r i p t i o n • p t c R u n t i m e S e r v i c e N a m e • p t c S e r v i c e N a m e • p t c S e r v i c e C l a s s N a m e • p t c M e t a T y p e

• p t c S e r v i c e A d d r e s s • p t c O b j e c t S e r i a l i z a t i o n T y p e • p t c C o r e s i d e n t S e r v i c e

( T h e c o n t e n t s o f t h e p t c A p p l i c a t i o n S e r v i c e o b j e c t C l a s s p l u s d i s t i n g u i s h e d n a m

S i n c e t h e p t c A p p l i c a t i o n S e r v i c e o b j e c t C l a s s o n l y r e q u i r e s p t c S e r v i c e N a m e , d n a n d p t c S e r v i c e N a m e a r e f o u n d i n a l l e l e m e n t s , a n d t h e p r e s e n cd e p e n d e n t o n c o n g u r a t i o n o f e a c h s p e c i c s e r v i c e .

T h e d e f a u l t s v a l u e s a r e : C L A S S - n o n e

F I L T E R - ( o b j e c t c l a s s = p t c A p p l i c a t i o n S e r v i c e ) ( a l l a v a i l a b l e s e r v i c e e n t r i e s ) G R O U P _ O U T - S E R V I C E S

S Y N T A X

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l C L A S S F I L T E R G R O U P _ O U T




C L A S S S p e c i e s t h e t y p e o f t h e o b j e c t s c o n t a i n e d i n t h b y t h e G R O U P _ O U T p a r a m e t e r . F o r e x a m p l eC L A S S = M y C l a s s N a m e a n d G R O U P _ O U T = d a t a _ 1 , t h e X M L r e p r e s e no f t h e o u t p u t g r o u p c o n t a i n s t h e f o l l o w i n g t a g s



F I L T E R T h i s p a r a m e t e r a l l o w s t h e u s e r t o s p e c i f y a n L D( p t c S e r v i c e N a m e = c o m . c o m p a n y . h o s t . s . T h e d e f a u l t v a l u e i s ( o b j e c t c l a s s = p t c A p p l i c a t i o n S e r v i , w h i c h r e t u r n s

a l l s e r v i c e s w i t h i n t h e N a m i n g S e r v i c e ’ s s e a r c p e r f o r m e d w i t h i n t h e V M s N a m i n g S e r v i c e s e

G R O U P _ O U T T h i s p a r a m e t e r a l l o w s t h e u s e r t o s p e c i f y t h e n T h e d e f a u l t v a l u e i s S E R V I C E S . T h e o u t p u t g r( L D A P d i r e c t o r y e n t r i e s w h o s p e c i f y p t c A p p l i c a t i o n S e r v i c a s a n o b j e c t C l a s s ) . T h e o u t p u t g r o u p c o n t a i n s o n e e l e m e ne l e m e n t c o n t a i n s a t a m i n i m u m t h e d n a n d p t c S e r v i c e N a m e a t t r i b u t e s . E a c e l e m e n t m a y a l s o c o n t a i n t h e f o l l o w i n g a t t r i b uc o r r e s p o n d i n g s e r v i c e : p t c R u n t i m e S e r v i c e N a m e , p t c S e r v i c e C l a s s N a , p t c M e t a T y p e , p t c S e r v i c e A d d r e s s , d e s c r i p t i o n , p t c C o r e s i d e n t S e r v i c ,

p t c O b j e c t S e r i a l i z a t i o n T y p e . T h e f o l l o w i n g a t t r i b u t e s m a y bs p e c i e d : p t c S e r v i c e N a m e , p t c S e r v i c e A d d r e s s , p t c C o r e s i d e n t S e r v i .

M a p - C r e d e n t i a l s


R e a d s a l e o r e x e c u t e s a t a s k t o e s t a b l i s h a g r o u pt h e t a s k i n w h i c h t h e w e b j e c t e x e c u t e s ( o r d o e s b a A u t h - M a p c o n t e x t g r o u p t h a t p r o v i d e s a u t h e n t i c a t i oa d a p t e r s i n e s t a b l i s h i n g c o n n e c t i o n s t o b a c k - e n de l e m e n t o f a c r e d e n t i a l s m a p p r o v i d e s a u s e r n a m a r e u s e d i n c o n n e c t i n g t o a s p e c i c b a c k - e n d s y s t

T h e w e b j e c t c a n b e s p e c i e d e x p l i c i t l y a t a n y p o it h e c r e d e n t i a l s m a p t h a t a f f e c t s t h e r e m a i n d e r o f . c r e d e n t i a l s M a p p e r c o n g u r a t i o n p r o p e r t y i s s e t , M a p -c a l l e d i m p l i c i t l y a t t h e b e g i n n i n g o f e v e r y t a s k t om a p f o r t h e t a s k . I f a d e f a u l t c r e d e n t i a l s m a p p i n gM a p - C r e d e n t i a l s w e b j e c t i s n o t c a l l e d i m p l i c i t l y




F o r a d d i t i o n a l i n f o r m a t i o n a b o u t c r e d e n t i a l s m a p p i n C r e d e n t i a l s M a p p i n g o n p a g e 1 1 9 .

S Y N T A X 

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l F I L E S U S E R N A M E T A S K

F I L E S S p e c i e s t h e s y s t e m l e p a t h d i r e c t o r y i n w h i c h e a c c r e d e n t i a l s m a p p i n g i n f o r m a t i o n f o r a s p e c i c u s e p a r a m e t e r i s c o n c a t e n a t e d t o t h e F I L E S p a r a m e t e r o n e s u c h l e . T h e r e s u l t i n g l e n a m e i s f o r m a t t e d a F I L E S _ p a r a m e t e r _ v a l u e / U S E R N A M E _ p a r a

T h e l e i s t h e n r e a d a n d p a r s e d t o p r o d u c e a c r e d e n t h e l e i s a s s u m e d t o b e o f t h e f o r m :

i n s t a n c e : d b u s e r : p a s s w d w h e r e :

• i n s t a n c e s p e c i e s t h e n a m e o f a n I n f o * E n g i n e a d a p t en a m e s u s e d w i t h t h e W E S o r M S G w e b j e c t s .

• d b u s e r s p e c i e s t h e u s e r n a m e . • p a s s w d s p e c i e s t h e c r e d e n t i a l s t h a t a r e p r o v i d e d t o t

c o n n e c t i o n s t o t h e a s s o c i a t e d b a c k - e n d i n f o r m a t

I f b o t h F I L E S a n d T A S K a r e s p e c i e d , l e - b a s e d m t h e n t h e c r e d e n t i a l s m a p p i n g t a s k i s e x e c u t e d . T h i sm a p p i n g i n f o r m a t i o n t o b e s p e c i e d u s i n g l e s , t h e

b y t h e t a s k . I f t h e F I L E S p a r a m e t e r i s o m i t t e d , l e - b a s e d m a p p c a s e , t h e c r e d e n t i a l s m a p i s d e r i v e d o n l y f r o m t h e o b y t h e T A S K p a r a m e t e r . T h e F I L E S p a r a m e t e r m u p a r a m e t e r i s o m i t t e d .




T A S K S p e c i e s t h e U R I o f a n I n f o * E n g i n e t a s k t h a t p A u t h - M a p g r o u p t h a t i s u s e d a s a c r e d e n t i a l s m a p . F o r e x a m p l e ,c o u l d d o o n e o f t h e f o l l o w i n g : • A l l o w a u s e r t o e x p l i c i t l y a u t h e n t i c a t e t o I n f

I n f o * E n g i n e a u t o m a t i c a l l y a u t h e n t i c a t e s t h ei n f o r m a t i o n s y s t e m s .

• E n a b l e r o l e - b a s e d a c c e s s t o n e t w o r k r e s o u r c p l a y e d b y a p a r t i c u l a r u s e r , a n d t h e n c r e a t i n g t h e a u t h e n t i c a t i o n i n f o r m a t i o n s h a r e d b y u s e

I f b o t h F I L E S a n d T A S K a r e s p e c i e d , l e - b a s et h e n t h e c r e d e n t i a l s m a p p i n g t a s k i s e x e c u t e d . m a p p i n g i n f o r m a t i o n t o b e s p e c i e d u s i n g l e s

b y t h e t a s k . T h e l a s t g r o u p p r o d u c e d b y a w e b j e c t i n t h i s t a m a p . I f t h e T A S K p a r a m e t e r i s n o t s p e c i e d , a ce x e c u t e d . I n t h i s c a s e t h e c r e d e n t i a l s m a p i s d e p a r a m e t e r . T h e T A S K p a r a m e t e r m u s t b e s p e c o m i t t e d .

U S E R N A M E I d e n t i e s t h e n a m e o f t h e u s e r f o r w h i c h a c r e d en o u s e r n a m e i s s u p p l i e d , i t i s a s s u m e d t h a t t h e a p p r o p r i a t e a c t i o n t o r e j e c t a n o n y m o u s a c c e s s e x c e p t i o n ) , o r p r o v i d e s a d e f a u l t c r e d e n t i a l s m

T h e d e f a u l t f o r t h i s p a r a m e t e r i s f o r t h e w e b j e c a t t r i b u t e n a m e d a u t h - u s e r o f t h e S E R V E R c o n t e x t g r o u p . To p t i o n a l .

Q u e r y - S c h e m a


R e t r i e v e s s c h e m a i n f o r m a t i o n a b o u t o b j e c t t y p e o r a n o t h e r r e p o s i t o r y .

S Y N T A X 

< i e : p a r a m n a m e = " T Y P E " d a t a = " c o m . m y C o m p a n y . A d 






P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l T Y P E G R O U P _ O U T

S C H E M A _ G E N E R A T O R

T Y P E D e n e s t h e t y p e f o r w h i c h s c h e m a s h o u l d b e g e n e r

G R O U P _ O U T D e n e s t h e n a m e o f t h e o u t p u t g r o u p t o b e g e n e r a t e I f n o t s u p p l i e d n o G R O U P _ O U T i s g e n e r a t e d a n d S c h e m a O b j e c t b e a n i s s t o r e d o n t h e c o l l e c t i o n a s t h e S O A

S H E M A _ G E N E R A T O R

D e n e s t h e f u l l y q u a l i e d n a m e o f a J a v a c l a s s t h a tc o m . i n f o e n g i n e . s c h e m a . S c h e m a G e n e r a t o r i n t e r f a c e . T h e i m p l e m e n t i n g c l a s s i s r e q u i r e d t o k n o w h o w t o n a vt o g e n e r a t e t h e r e q u e s t e d S c h e m a O b j e c t . T h i s p a r a m e t e r d e f a u l t s t o ai m p l e m e n t a t i o n t h a t k n o w s h o w t o g e n e r a t e S c h e m a O b j e c t i n s t a n c e s b a s e d o n i n f o r m a t i o n f o u n d i n t h e L D A P d i r e c t o r y .

A d d i t i o n a l p a r a m e t e r s m a y b e s p e c i e d / r e q u i r e d bS C H E M A _ G E N E R A T O R . F o r e x a m p l e t h e L D A m a y r e q u i r e ( o r a l l o w ) p a r a m e t e r s l i k e R E P O S I T O t o t e l l i t w h e r e i n t h e d i r e c t o r y t o l o o k f o r s c h e m a i n

Q u e r y - T y p e H i e r a r c h y D e s c r i p t i o n

A l l o w s r e t r i e v a l o f i n f o r m a t i o n a b o u t e x i s t i n g t y p e hg r o u p c r e a t e d c o n t a i n s i n f o r m a t i o n f o r e a c h t y p e f o ua n d a l i s t o f i t s a n c e s t o r o r d e s c e n d a n t t y p e s ( d e p e n d t r a v e r s a l ) . T h e o u t p u t g r o u p c a n b e f o r m a t t e d a s e i t hn e s t e d g r o u p t h a t r e e c t s t h e s t r u c t u r e o f t h e t y p e h i e

S Y N T A X

 






P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l T Y P E D I R E C T I O N

G R O U P _ O U T M O D E R E S O L V E R

D I R E C T I O N S p e c i e s t h e d i r e c t i o n o f t r a v e r s a l . A c c e p t a b l eD E S C E N D A N T S , a n d B O T H . T h e d e f a u l t v a lo p t i o n a l .

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e g r o u p i nh i e r a r c h y i n f o r m a t i o n . T h e c o n t e n t s a n d f o r m a t o f t h e g r o u p d e p e n d oD I R E C T I O N , a n d M O D E .

• I f M O D E i s s p e c i e d w i t h a v a l u e o f F L A T , te l e m e n t p e r t y p e ; e a c h e l e m e n t c o n t a i n s t w o t y p e a n d a n c e s t o r s .

• I f M O D E i s s p e c i e d w i t h a v a l u e o f N E S T E a s i n g l e t o p - l e v e l e l e m e n t c o n t a i n i n g t w o a t t t y p e , a n d e i t h e r a n c e s t o r s o r d e s c e n d a n t s .

W h e t h e r a n c e s t o r s o r d e s c e n d a n t s i s u s e d d e p e n d s o n t h e v a l u eD I R E C T I O N . I f D I R E C T I O N i s s p e c i e d w i t ha n c e s t o r s a t t r i b u t e i s i n c l u d e d , o t h e r w i s e d e s c e n d a n t s i s u s e d . T h e v a l u et h e a n c e s t o r s o r d e s c e n d a n t s a t t r i b u t e i s a n I n f o * E n g i n e e l e t h e n e x t t y p e i n t h e h i e r a r c h y , a n d i n t u r n i t s a n c

I f a t y p e h i e r a r c h y s u p p o r t s a d d i t i o n a l i n f o r m aa d d i t i o n a l a t t r i b u t e s m a y b e i n c l u d e d i n e a c h e e x a m p l e , t h e W i n d c h i l l i m p l e m e n t a t i o n t e l l s wh i e r a r c h y i s m o d e l e d o r s o f t b y i n c l u d i n g a n a t t d e n i t i o n w h o s e v a l u e c a n b e o n e o f t h e f o l l o w i n g : i n t e r f a c e , c l a s s , o r s o f t .

T h e d e f a u l t v a l u e f o r t h i s p a r a m e t e r i s h i e r a r c h y . T h i s p a r a m e t e r i s o p t i o n a l .

M O D E S p e c i e s h o w t h e o u t p u t g r o u p i s f o r m a t t e d . A N E S T E D . T h e d e f a u l t v a l u e i s F L A T .




R E S O L V E R S p e c i e s t h e n a m e o f t h e t y p e h i e r a r c h y i m p l e m e n b e f o u n d . C u r r e n t l y t h e r e a r e t w o a c c e p t a b l e v a l u e

• c o m . i n f o e n g i n e . s c h e m a . t y p e . L D A P T y p e — A l l o w s t r a v e r s a l o f t y p e h i e r a r c h i e s s t o r e d i n

• c o m . p t c . c o r e . a d a p t e r . s e r v e r . i m p l . W i n d — A l l o w s t r a v e r s a l o f W i n d c h i l l t y p e h i e r a r c h i e s ( r e q u i r e s W i n d c h i l l b e i n s t a l l e d ) .

T h e d e f a u l t v a l u e i s c o m . i n f o e n g i n e . s c h e m a . t y p e . L D A P T y p e H . T h i s p a r a m e t e r i s o p t i o n a l .

T Y P E S p e c i e s t h e n a m e o f t h e t y p e a t w h i c h t o b e g i n t r a vT h i s i s a r e q u i r e d p a r a m e t e r .

T h r o w - E x c e p t i o n


C a u s e s a n e x c e p t i o n t o b e t h r o w n . I f t h e w e b j e c t i s c aa u n i t w i t h i n a t a s k , c o n t r o l i s t r a n s f e r r e d t o a f a i l u r e b l o c k , i f t h e b l o c k e x i s I f t h e w e b j e c t i s c a l l e d f r o m o u t s i d e o f a u n i t , t h e t a s k

N o t e

I n f o * E n g i n e a r r a n g e s f o r t h e n a m e s a n d m e s s a g e s o f t a s k e x e c u t i o n t o b e r e g i s t e r e d a u t o m a t i c a l l y i n t h e S a t t r i b u t e s n a m e d e x c e p t i o n - c l a s s a n d e x c e p t i o n - m e s s a g e . T h i s m a k e s i t p o s s i b l e f o r f a i l u r e b l o c k s w i t h i n u n i t s t o p r o c e s s e x c e p t i o n s a c a l l i n g t h e T h r o w - E x c e p t i o n w e b j e c t w i t h o u t p a s s i n gS E R V E R c o n t e x t a t t r i b u t e n a m e d e x c e p t i o n - o b j e c t u n w r a p s n e s t e d e x c e p t i o n c r e a t e s t h e r e g i s t e r s t h e r a w , u n w r a p p e d e x c e p t i o n o bw e b j e c t l o o k s f o r t h i s S E R V E R c o n t e x t a t t r i b u t e a n d a s s o c i a t e d e x c e p t i o n o b j e c t d i r e c t l y .

S Y N T A X

 








P A R A M S u p p l i e s o n e o r m o r e v a l u e s t h a t a r e s u b s t i t u t e d i n t e m p l a t e t o p r o d u c e t h e n a l m e s s a g e t e x t . I f P A R Aa s s u m e d t h a t t h e m e s s a g e t e m p l a t e i d e n t i e d b y t h a n d t h e K E Y p a r a m e t e r s d o e s n o t c o n t a i n a n y s u b sn o s u b s t i t u t i o n i s p e r f o r m e d .

T h i s p a r a m e t e r i s u s e d o n l y w h e n y o u a l s o s p e c i f y G R O U P _ I N p a r a m e t e r .

E X A M P L E

T h e f o l l o w i n g T h r o w - E x c e p t i o n e x a m p l e J S P p a g e l o c a l i z e d m e s s a g e i d e n t i e d b y K E Y n u m b e r 1 9 i n t h

< % @ p a g e l a n g u a g e = " j a v a "



h t m l > < h e a d > < t i t l e > T h r o w E x c e p t i o n < / t i t l e > < / h e a d > 

i e : w e b j e c t n a m e = " T h r o w - E x c e p t i o n " t y p e = " M G T " > 



/ b o d y > < / h t m l >

W r i t e - L o g


W r i t e s a m e s s a g e t o t h e l o g a s s o c i a t e d w i t h t h e c o n t e

e x a m p l e , i f t h e w e b j e c t i s c a l l e d f r o m a t a s k e x e c u t e d p r o c e s s o r , t h e m e s s a g e i s w r i t t e n t o t h e t a s k p r o c e s s of r o m a J S P p a g e , i t i s w r i t t e n t o t h e J S P p r o c e s s o r l o g

N o t e W h e n w r i t i n g I n f o * E n g i n e t a s k s , i t i s p r e f e r a b l e t o m l i b r a r y t o i s s u e l o g s t a t e m e n t s t o l o g 4 j .




S Y N T A X







P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ I N L O G M E S S A G E T A G

G R O U P _ I N S p e c i e s t h e n a m e o f t h e i n p u t g r o u p t o l o g . T hX M L a n d w r i t t e n t o t h e l o g l e s p e c i e d b y t h e v a l u e s c a n b e s p e c i e d . A n y i n p u t g r o u p s a r e l oo n t h e M E S S A G E p a r a m e t e r .

L O G S p e c i e s t h e l o g t o w h i c h t h e m e s s a g e s h o u l d b p a r a m e t e r a r e D E B U G , I N F O , E R R O R , A U D T h e d e f a u l t f o r t h i s p a r a m e t e r i s I N F O . T h i s p a

M E S S A G E P r o v i d e s t h e m a i n t e x t o f t h e m e s s a g e t o b e w r i

T h e f o r m a t o f e a c h l o g m e s s a g e w r i t t e n i s :

d a t e - t i m e # : # h o s t # : # s e r v i c e # : # t a g # : # u s e r # : # m e s s

w h e r e : d a t e - t i m e — T h e d a t e a n d t i m e a t w h i c h t h e m e s s a g eh o s t — T h e I n t e r n e t d o m a i n n a m e o f t h e h o s t f r o mw r i t t e n .

s e r v i c e — T h e n a m e o f t h e I n f o * E n g i n e s e r v i c e t h at a g — T h e v a l u e s p e c i e d b y t h e T A G p a r a m e t e ru s e r — T h e a u t h e n t i c a t e d u s e r n a m e o f t h e u s e r f ow o r k i n g w h e n t h e m e s s a g e i s w r i t t e n . m e s s a g e v a l u e — T h e v a l u e s p e c i e d b y t h e M E S S A G

T h e d e f a u l t i s f o r a l o g m e s s a g e t o b e w r i t t e n t h T h i s p a r a m e t e r i s o p t i o n a l .




T A G S p e c i e s a t a g t h a t i s w r i t t e n a s p a r t o f t h e l o g e n t r yf a c i l i t a t i n g t h e s e a r c h i n g a n d s o r t i n g o f l o g s . T h e Tt a s k a u t h o r t o p r o v i d e a s i m p l e i d e n t i e r t h a t c a n b ek i n d o f l o g m e s s a g e f r o m a n o t h e r . F o r e x a m p l e , y ot r o u b l e s h o o t i n g p u r p o s e s , o r t o c l a s s i f y m e s s a g e s

T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e n a m e o f w e b j e c t i s b e i n g c a l l e d . T h i s p a r a m e t e r i s o p t i o n a l

E X A M P L E

T h e f o l l o w i n g W r i t e - L o g e x a m p l e J S P p a g e c r e a t e s t w o d i f f e r e n t l o g s , a n d d i s p l a y s t h e o u t p u t :

< % @ p a g e l a n g u a g e = " j a v a "



< h t m l > < h e a d > < t i t l e > W r i t e - L o g W e b j e c t < / t i t l e > < / h e a d > 

< ! - - c r e a t e a g r o u p - - > 

< ! - - W r i t e a l o g m e s s a g e t o t h e d e f a u l t l o g , " i n f o " - - >

 

< ! - - W r i t e a l o g m e s s a g e t o t h e " d e b u g " l o g - - > 



 



< ! - - g e n e r a t e t h e o u t p u t - - > 






< / h t m l >

M e s s a g e W e b j e c t s T h e f o l l o w i n g w e b j e c t s c a n b e u s e d i n c o n j u n c t i g e n e r i c m e s s a g i n g a n d t a s k q u e u i n g f u n c t i o n s :

• B r o w s e - Q u e u e o n p a g e 4 4 3 • C a l l - R e m o t e P r o c e d u r e o n p a g e 4 4 6 • C a l l - S O A P S e r v i c e o n p a g e 4 5 0 • C r e a t e - O b j e c t o n p a g e 4 5 7 • D e l e t e - O b j e c t o n p a g e 4 6 4 • D e l e t e - R e s u l t s o n p a g e 4 6 7 • Q u e r y - O b j e c t o n p a g e 4 7 0 • Q u e r y - R e s u l t s o n p a g e 4 7 4 • Q u e u e - T a s k o n p a g e 4 7 7 • S e n d - M a i l o n p a g e 4 8 1 • S u b s c r i b e - Q u e u e o n p a g e 4 8 5 • U n s u b s c r i b e - Q u e u e o n p a g e 4 8 9

A l l m e s s a g e w e b j e c t s u s e t h e M S G t y p e a t t r i b u t e v a l u e i n t h e w e b j e c t t a g .

B r o w s e - Q u e u e D E S C R I P T I O N

S e l e c t s a m e s s a g e o r s e t o f m e s s a g e s i n a q u e u e , a l l o w i n g t h e p r o p e m e s s a g e s t o b e v i e w e d w h i l e n o t a c t u a l l y r e t u r n i n g m e s s a g e c o n t e n t .

N o t e T h i s w e b j e c t c a n b e u s e d o n l y a f t e r y o u r e n v i r o n m e n t h a s b e e n s e t u p m e s s a g i n g o r f o r q u e u i n g t a s k s .

S Y N T A X

 




P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l Q U E U E A T T R I B U T E

D B U S E R S E R V I C E G R O U P _ O U T P A S S W D W H E R E

A T T R I B U T E S p e c i e s w h i c h J M S p r o p e r t i e s s h o u l d b e a d d e d t oa t t r i b u t e s . I n a d d i t i o n t o p r o p e r t i e s m a n u a l l y s e t o q u e u i n g t h e f o l l o w i n g J M S - s p e c i c p r o p e r t i e s c a n

• J M S D e s t i n a t i o n • J M S D e l i v e r y M o d e • J M S M e s s a g e I D • J M S T i m e s t a m p • J M S C o r r e l a t i o n I D • J M S R e p l y T o • J M S R e d e l i v e r e d • J M S E x p i r a t i o n • J M S P r i o r i t y • J M S T y p e

T h e d e f a u l t f o r t h i s p a r a m e t e r i s “ * ” , i n w h i c h c a s ea t t r i b u t e s a r e r e t u r n e d . T h i s p a r a m e t e r i s o p t i o n a l




D B U S E R S p e c i e s t h e u s e r n a m e t o u s e w h e n c o n n e c t i n g p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r. m s g . u s e r n a m e a n d . j m s . u s e r n a m e p r o p e r t i e s o f t h e s e r v i c u s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a C r e d e n t i a l s M a p f o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e nm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J Mm a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s . m s g . u s e r n a m e p r o p e r t y i s u s e d . I f t h e . m s g . u s e r n a m e p r o p e r t y i s n o t s e t , t h e n s e t i n t h e . j m s . u s e r n a m e p r o p e r t y i s u s e d . I f n e i t h e r p r o py o u d o n o t s p e c i f y a v a l u e f o r t h i s D B U S E R p a r a m e t e r , I n f o * E n

n o t s p e c i f y a u s e r n a m e w h e n c o n n e c t i n g t o t h e u s c o n n e c t i o n i s a t t e m p t e d .


S E R V I C E S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e p r o p e r t yc o n n e c t i v i t y t o a s p e c i c J M S s e r v i c e . T h i s a l l o n e J M S s e r v i c e p e r I n f o * E n g i n e V i r t u a l M a c o p t i o n a l .

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e g r o u p t o c r e a t e t h a t c o

o f t h e o b j e c t s i n t h e m e s s a g e q u e u e . T h e d e f a ub r o w s e - r e s u l t s . T h i s p a r a m e t e r i s o p t i o n a l .

P A S S W D S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r. m s g . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c u s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a C r e d e n t i a l s M a p f o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e nm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p i

c r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J Mm a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s . m s g . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . m s g . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n s e t i n t h e . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o py o u d o n o t s p e c i f y a v a l u e f o r t h i s P A S S W D p a r a m e t e r , I n f o * E n s p e c i f y a p a s s w o r d w h e n c o n n e c t i n g t o t h e M O





Q U E U E S p e c i e s t h e L D A P r e l a t i v e d i s t i n g u i s h e d n a m e o f b r o w s e d . T h e v a l u e i s a n L D A P d i s t i n g u i s h e d n a m b a s e U R I . I f r e l a t i v e , t h e c n = ( c o m m o n n a m e a t t r i b u t e ) i s i m p l i ce x p l i c i t l y s p e c i e d . T h i s p a r a m e t e r i s r e q u i r e d .

W H E R E S p e c i e s t h e J M S w h e r e c l a u s e u s e d t o s e l e c t t h e m e s s a g e s f r oI f n o w h e r e c l a u s e i s s p e c i e d , a l l m e s s a g e s i n t h e q u e u e p a r a m e t e r i s o p t i o n a l .

E X A M P L E

T h e f o l l o w i n g e x a m p l e b r o w s e s a s p e c i e d q u e u e f o t h e d e f a u l t “ b r o w s e - r e s u l t s ” g r o u p u s i n g t h e R e t u r n


p r e f i x = " i e " % >

 

 



T o a c t u a l l y r u n t h i s e x a m p l e , y o u m u s t p r o v i d e a f o r mi s i d e n t i e d .

C a l l - R e m o t e P r o c e d u r e


M a k e s a r e m o t e p r o c e d u r e c a l l ( R P C ) t o a t h i r d - p a r t P r o t o c o l ( S O A P ) s e r v i c e . R e s u l t s f r o m a n R P C i n v oI n f o * E n g i n e t a s k o r J S P a u t h o r i n t h e f o r m o f a g r o u ps t r u c t u r e o f t h e S O A P r e s p o n s e . I n s i m p l e c a s e s , w h i n a s i n g l e v a l u e o r a r r a y o f s i m p l e v a l u e s , a b a s i c I n fo n e a t t r i b u t e p e r e l e m e n t i s r e t u r n e d . I t i s p o s s i b l e f oa c o m p l e x d a t a s t r u c t u r e i n r e s p o n s e . I n t h i s c a s e a g m u l t i p l e e l e m e n t s w i t h m u l t i p l e a t t r i b u t e s , i s r e t u r n en e s t e d , t h e n t h e r e s u l t i n g I n f o * E n g i n e g r o u p i s a l s o a t t r i b u t e s w h o s e v a l u e s a r e e l e m e n t s . D e a l i n g w i t h su s e o f s c r i p t l e t c o d e w i t h i n t h e h a n d l i n g t a s k o r J S P .




S Y N T A X

 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l O P E R A T I O N A U T H O R I Z A T I O N W S D L D B U S E R

G R O U P _ I N G R O U P _ O U T P A R A M P A S S W D P O R T S E R V I C E

A U T H O R I Z A T I O N B a s e 6 4 – e n c o d e d u s e r n a m e a n d p a s s w o r d p a s sw e b s e r v e r t h r o u g h t h e A u t h o r i z a t i o n H T T P h e a d e r . T h i s p a r au s e d i f t h e S O A P e n d p o i n t i s h t t p o r h t t p s . I f s u p p l i e d , t h e c r e d e u s e d i n e s t a b l i s h i n g a c o n n e c t i o n t o t h e S O A P P A S S W O R D a r e s p e c i e d , t h e y a r e u s e d i n s t e av a l u e . T h i s p a r a m e t e r i s o p t i o n a l .

D B U S E R U s e r n a m e u s e d w h e n m a k i n g a c o n n e c t i o n t o te n d p o i n t ’ s s u p p o r t i n g p r o t o c o l i s h t t p o r h t t p s . I f D B U S E R i s s p e c

t h e n P A S S W O R D m u s t a l s o b e s p e c i e d o r i t i s p a r a m e t e r .




G R O U P _ I N S p e c i e s a n I n f o * E n g i n e g r o u p t h a t r e p r e s e n t s t h e A l l a t t r i b u t e s f o u n d i n t h e i n p u t g r o u p a r e a d d e d a sv a l u e s a r e a d d e d a s v a l u e s o f t h o s e X M L e l e m e n t sn e s t e d b y s e t t i n g a t t r i b u t e v a l u e s t o e l e m e n t s . T h i sg e n e r a t e a r b i t r a r i l y c o m p l e x S O A P r e q u e s t s . A l l ei n p u t g r o u p a r e a d d e d t o t h e s t a n d a r d R P C t o p - l e v t h e o p e r a t i o n n a m e . T h i s i s a n o p t i o n a l p a r a m e t e r .o f i n p u t i s p e r f o r m e d b y t h e w e b j e c t .

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e g r o u p t h a t t hs h o u l d b e s t o r e d i n . D a t a f o u n d i n t h e o u t p u t g r o u p t y p e i n f o r m a t i o n f o u n d i n t h e S O A P r e s p o n s e . T h iT h e d e f a u l t v a l u e i s r p c O u t p u t .

O P E R A T I O N S p e c i e s t h e n a m e o f t h e o p e r a t i o n t o b e e x e c u t e d . p a r a m e t e r . T h e o p e r a t i o n n a m e m u s t b e e x p o s e d b r e f e r e n c e d b y t h e W S D L p a r a m e t e r .

P A R A M S p e c i e s a p a r a m e t e r n a m e a n d v a l u e t h a t s h o u l d b v a l u e m u s t b e i n t h e f o r m o f n a m e = d a t a . C a l l - R e m o t e P r o c e d u r e v e rs u p p l i e d p a r a m e t e r s a g a i n s t t h e s u p p l i e d W S D L t o p a r a m e t e r s a r e p r e s e n t , t h a t t h e s p e c i e d p a r a m e t e t h a t m a x i m u m a n d m i n i m u m o c c u r r e n c e s o f p a r a mt h a t p a r a m e t e r v a l u e s a r e t y p e d a p p r o p r i a t e l y . I t i sr e q u i r e s n o i n p u t p a r a m e t e r s , a n d s o t h i s p a r a m e t e r e q u i r e s s p e c i c p a r a m e t e r s f o r t h e o p e r a t i o n i n q u i s r e q u i r e d . I f n o t s p e c i e d , a n e x c e p t i o n i s i s s u e d .

P A S S W O R D P a s s w o r d t o u s e w h e n m a k i n g a c o n n e c t i o n t o t h e e n d p o i n t ’ s s u p p o r t i n g p r o t o c o l i s h t t p o r h t t p s . I f P A S S W O R D i s s p e c it h e n D B U S E R m u s t a l s o b e s p e c i e d o r i t i s i g n o r e p a r a m e t e r .

P O R T S p e c i e s t h e n a m e o f t h e S O A P p o r t t h a t s h o u l d b e b e t i e d t o m u l t i p l e p o r t s i n a W S D L d o c u m e n t . I f t ht o m o r e t h a n o n e p o r t t h e n t h i s p a r a m e t e r i s r e q u i r ei s o n l y t i e d t o a s i n g l e p o r t t h e n t h a t p o r t i s u s e d .

S E R V I C E S p e c i e s t h e n a m e o f t h e S O A P s e r v i c e t h a t s h o u l dd o c u m e n t m a y e x p o s e m u l t i p l e S O A P s e r v i c e s . I fr e f e r e n c e d b y t h e W S D L p a r a m e t e r e x p o s e s m u l t i p a r a m e t e r i s r e q u i r e d . I f t h e W S D L d o c u m e n t r e f e p a r a m e t e r e x p o s e s o n l y a s i n g l e s e r v i c e , t h e n t h a t s




W S D L R e f e r e n c e s a W e b S e r v i c e s D e n i t i o n L a n g u a gv a l u e m u s t b e a U R L w h o s e c o n t e n t s c a n b e r e aA W S D L d o c u m e n t d e s c r i b e s a w e b s e r v i c e ; w w h a t o p e r a t i o n s e a c h s e r v i c e s u p p o r t s , w h a t p ao r s u p p o r t s , h o w t h e S O A P r e q u e s t s h o u l d b e gn a m e s p a c e s t o u s e ) . T h i s i s a r e q u i r e d p a r a m e d o e s n o t h a v e a W S D L d o c u m e n t t h a t d e s c r i b et h e U R L s p e c i e d i s h t t p o r h t t p s a n d r e q u i r e s a u t h o r i z a t i o ns p e c i e d a s f o l l o w s : h t t p : / / : @ h o s t / p a t h / t o / w s d l / .

E X A M P L E

< % @ p a g e l a n g u a g e = " j a v a " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e /% > < h t m l > < h e a d > < t i t l e > W e a t h e r b y Z i p < / t i t l e > < / h e a d > 

< % S t r i n g z i p = r e q u e s t . g e t P a r a m e t e r ( " z i p C o d e " ) ; i f ( z i p ! = n u l l ) { % > < i e : w e b j e c t n a m e = " C a l l - R e m o t e P r o c e d u r e " t y p e = < i e : p a r a m n a m e = " W S D L " d a t a = " h t t p : / / w w w . v b w s . c o m / s e r v i c e s / w e a t h e r r e t r i e

 < % } % >

< f o r m m e t h o d = " G E T " > Z i p : & n b s p ; " > & n b s p ; < %

i f ( z i p ! = n u l l ) { % > < t a b l e > < t r > < t d c o l s p a n = 2 a l i g n = m i d d l e > " > < / t d > < / t r > < t r > < t d a l i g n = r i g h t > < s t r o n g > L a s t U p d a t e d : < s t r o n g n a m e = " L a s t U p d a t e d " / > < / t d > < t r > < t r > < t d a l i g n = r i g h t > < s t r o n g > C o n d i t i o n s : < / s t r o n g > < / t d > < t d > < t d a l i g n = r i g h t > < s t r o n g > C u r r e n t T e m p : < s t r o n g > < t d > < t d > < /< t r > < t d a l i g n = r i g h t > < s t r o n g > H u m i d i t y :

< / s t r o n g > < t d > < t d > < / t d < t r > < t d a l i g n = r i g h t > < s t r o n g > B a r o m e t e r : < / s t r o n g > < t d > <n a m e = " B a r o m e t e r " / > < / t d > < / t r > < t r > < t d a l i g n = r i g h t > < s t r o n g > B a r o m e t e r D i r e c t i o n : < s t r o n g > < t d > < t d > < / t d > < / t r > < / t a b l e > < % } % > < / h t m l >

C a l l - S O A P S e r v i c e


M a k e s a r e q u e s t t o a t h i r d - p a r t y S i m p l e O b j e c t A c c e T h i s w e b j e c t u s e s a n I n f o * E n g i n e g r o u p a n d a n X S L r e q u e s t . T h e w e b j e c t o u t p u t c a n b e d i r e c t l y g e n e r a t et h a t m i m i c s t h e S O A P r e s p o n s e b o d y , o r a n X S L t e mt r a n s l a t e t h e S O A P r e s p o n s e i n t o a n I n f o * E n g i n e g r

I f a S O A P f a u l t o c c u r s , t h e n a n i n s t a n c e o f c o m . i n f o e n g i n e . e x c e p t i o n . f a t a l . I E R e m o t e i s g e n e r a t e d .

S Y N T A X

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l E N D P O I N T D B U S E R G R O U P _ I N E X C E P T I O N _ O N _ F A U L T X S L _ U R L G R O U P _ O U T




R e q u i r e d S e l e c t O p t i o n a l P A S S W D S O A P _ A C T I O N X S L _ D B U S E R X S L _ P A S S W D X S L _ R E S P O N S E _ U R L

D B U S E R S p e c i e s t h e u s e r n a m e t o u s e t o a u t h e n t i c a t e t oi s u s e d i n c o n j u n c t i o n w i t h P A S S W D i f t h e S O E N D P O I N T p a r a m e t e r r e q u i r e s a u t h e n t i c a t i o

E N D P O I N T S p e c i e s t h e U R L o f t h e S O A P e n d p o i n t t o w h b e s e n t . T h i s p a r a m e t e r i s r e q u i r e d .

E X C E P T I O N _ O N _ F A U L T S p e c i e s w h e t h e r a n e x c e p t i o n i s t h r o w n i f t h e f a u l t . T h e d e f a u l t v a l u e i s t r u e . I f t h e p a r a m e t e r i s s e t t o f a l s e , t h e n n o e x c e p t i o n i s t h r o w n i f a f a u l t o c c u r s . I f X S Lt h e r e s u l t s , t h e n a n X S L t e m p l a t e c a n b e u s e d tI n f o * E n g i n e d a t a ( i n c l u d i n g t h e c o n t e n t s o f t h a c t i o n s t a k e n . I f X S L i s n o t b e i n g u s e d , t h e n t h i n t o a n I n f o * E n g i n e g r o u p . T h i s p a r a m e t e r i s o

G R O U P _ I N S p e c i e s t h e I n f o * E n g i n e g r o u p c o n t a i n i n g d a t e m p l a t e s p e c i e d o n X S L _ U R L . T h i s p a r a m e

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e g r o u p r eI f X S L _ R E S P O N S E _ U R L i s s p e c i e d , t h e n i t r e s p o n s e i n t o a n I n f o * E n g i n e g r o u p n a m e d w i X S L _ R E S P O N S E _ U R L i s n o t s p e c i e d , t h e n e l e m e n t a n d o n e a t t r i b u t e p e r X M L e l e m e n t i n a n a t t r i b u t e c a n b e a n o b j e c t , r e p r e s e n t i n g e l e me l e m e n t , r e p r e s e n t i n g a d d i t i o n a l n e s t e d X M L a t t r i b u t e m a t c h e s t h e c o r r e s p o n d i n g X M L e l e mt h i s p a r a m e t e r i s S O A P R e s p o n s e . T h i s p a r a m e t e r i s o p t i o n a l .

P A S S W D S p e c i e s t h e p a s s w o r d c o r r e s p o n d i n g t o D B U S

S O A P _ A C T I O N S p e c i e s t h e v a l u e ( i f a n y ) o f t h e S O A P A c t i o n h e a d e r t h a t s h o u l d b eT h i s p a r a m e t e r i s o p t i o n a l .




X S L _ D B U S E R S p e c i e s t h e u s e r n a m e t o u s e d t o a u t h e n t i c a t e t o XX S L _ R E S P O N S E _ U R L . T h i s p a r a m e t e r i s u s e d iX S L _ P A S S W D i f t h e X S L t e m p l a t e s t o b e u s e d b yr e m o t e H T T P s e r v e r t h a t r e q u i r e s a u t h e n t i c a t i o n . T

X S L _ P A S S W D S p e c i e s t h e p a s s w o r d c o r r e s p o n d i n g t o X S L _ D B o p t i o n a l .

X S L _ R E S P O N S E _ U R L S p e c i e s t h e l o c a t i o n o f a n X S L t e m p l a t e u s e d t o p T h e X S L t e m p l a t e i s c o m b i n e d w i t h t h e S O A P r e sG R O U P _ O U T . T h i s p a r a m e t e r i s o p t i o n a l .

F u l l y q u a l i e d U R L s a r e d e r e f e r e n c e d u s i n g A u t h - M a p c o n t e x t g r o u p d a t a .

T h e A u t h - M a p i s s e a r c h e d f o r a u s e r n a m e a n d p a s s w o r d bn a m e f o u n d i n t h e f u l l y q u a l i e d U R L . F o r e x a m p lU R L i s :

h t t p : / / m a c h i n e . c o m / i n f o e n g i n e / s e r v l e t / I E / t a s k s / c r e a

t h e A u t h - M a p c o n t e x t g r o u p i s s e a r c h e d f o r a u s e r n a m e ah a s a n I N S T A N C E n a m e o f h t t p : / / m a c h i n e . c o m . I f a u s e r n a m e a n d p a s s w o r d a r e f o u n d , B A S I C a u t h e n t i c a t i o n i n a c c e s s i n g t h e U R L . I f n o u s e r n a m e a n d p a s s w o r d ai n f o r m a t i o n i s s e n t t o t h e r e m o t e w e b s e r v e r .

I f t h e d a t a v a l u e c o n t a i n s t h e : / / s t r i n g , i t i s a s s u m e d t o b e a f u l l y

i n t e r n e t U R L . I f t h e d a t a v a l u e d o e s n o t c o n t a i n t h el o c a l l e r e l a t i v e t o t h e c u r r e n t t a s k r o o t d i r e c t o r y .




X S L _ U R L S p e c i e s t h e l o c a t i o n o f t h e X S L t e m p l a t e u s e dT h e X S L t e m p l a t e i s c o m b i n e d w i t h t h e G R O Ur e q u e s t . W h e n a u t h o r i n g t h e X S L d o c u m e n t s u s e d t o t r r e s p o n s e , i f t h e e x a m p l e r e q u e s t a n d r e s p o n s e a r e a v a i l a b l e t h e y c a n b e u s e d a s t e m p l a t e s f o r e x a m p l e r e q u e s t a n d r e s p o n s e d o c u m e n t s a v a it o p a y c l o s e a t t e n t i o n t o t h e s c h e m a p r o v i d e d bd o c u m e n t . C o m p l y i n g w i t h t h e W S D L d o c u m v a l i d a n d a c c e p t a b l e X M L t o t h e w e b s e r v i c e . o n a s e r v i c e ’ s i m p l e m e n t a t i o n , i t m a y o r m a y n o t b e e x i b l e iH o w e v e r , t h e s c h e m a p r o v i d e d i n t h e W S D L s b e u s e d t o c r a f t X M L t h a t v a l i d a t e s a g a i n s t t h a

t h e o r d e r , c a s e , o p t i o n a l i t y , c a r d i n a l i t y , a n d d a a n d a t t r i b u t e s .

F u l l y q u a l i e d U R L s a r e d e - r e f e r e n c e d u s i n g A u t h - M a p c o n t e x t g r o u p d aT h e A u t h - M a p i s s e a r c h e d f o r a u s e r n a m e a n d p a s s w on a m e f o u n d i n t h e f u l l y q u a l i e d U R L . F o r e x a U R L i s :

h t t p : / / m a c h i n e . c o m / i n f o e n g i n e / s e r v l e t / I E / t a s k s /

t h e A u t h - M a p c o n t e x t g r o u p i s s e a r c h e d f o r a u s e r n a mh a s a n I N S T A N C E n a m e o f h t t p : / / m a c h i n e . c o m . I f a u s e r n a m e a n d p a s s w o r d a r e f o u n d , B A S I C a u t h e n t i c a t i o

a c c e s s i n g t h e U R L . I f n o u s e r n a m e a n d p a s s w oi n f o r m a t i o n i s s e n t t o t h e r e m o t e w e b s e r v e r .

I f t h e d a t a v a l u e c o n t a i n s t h e : / / s t r i n g , i t i s a s s u m e d t o b e a f ui n t e r n e t U R L . I f t h e d a t a v a l u e d o e s n o t c o n t a i nl o c a l l e r e l a t i v e t o t h e c u r r e n t t a s k r o o t d i r e c t o


E X A M P L E : T R A N S L A T E - G R O U P A N D X S

N o t e I n f o * E n g i n e S O A P c o m m e n t s a r e u s e d i n t h e e x a

i n f o r m a t i o n o n S O A P a n d S O A P c o m m e n t s , s e e S O A P S e r v i c e s o n p a g e . T h i s e x a m p l e u s e s t h e T r a n s l a t e - G r o u p w e b j e c t r e s p o n s e t h a t w a s r e t u r n e d f r o m t h e C a l l - S O A P SI n f o * E n g i n e g r o u p .




h o s t l o o k u p . x m l

< % @ p a g e l a n g u a g e = " j a v a " i m p o r t = " j a v a . u t i l . S t r i n g T o

o b j e c t . I e M u l t i p a r t I n p u t S t r e a m , j a v a . i o . B y t e A r r a y I n p < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i

p r e f i x = " i e " % >

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f R e s o l v e s i n f o r m a t i o n a b o u t a h o s t n a m e .

@ p a r a m s t r i n g h o s t T h e h o s t n a m e @ r e t u r n I N F O E N G I N E _ G R O U P $ ( o u t p u t ) - - >





 



 < i e : p a r a m n a m e = " E N D P O I N T "

d a t a = " h t t p : / / w w w . e s y n a p s . c o m / w e b s e r v i c e s / Y o u r H < i e : p a r a m n a m e = " S O A P _ A C T I O N "

d a t a = " h t t p : / / t e m p u r i . o r g / G e t H o s t I n f o B y N a m e "< i e : p a r a m n a m e = " X S L _ U R L "

d a t a = " / c o m / c o m p a n y / h o s t l o o k u p / h o s t l o o k u p R e q 



 



 




h o s t l o o k u p R e q u e s t . x s l

< ? x m l v e r s i o n = ' 1 . 0 ' ? >

< x s l : s t y l e s h e e t x m l n s : x s l = " h t t p : / / w w w . w 3 . o r g / 1 9 9 9 / X S L / T r a n s f x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / 1 . 0 " >

< x s l : t e m p l a t e m a t c h = " / w c : C O L L E C T I O N / p a r a m e t e r< s o a p : E n v e l o p e x m l n s : s 0 = " h t t p : / / t e m p u r i . o r g / "

x m l n s : s o a p = " h t t p : / / s c h e m a s . x m l s o a p . o r g / s o a p / e x m l n s : x s = " h t t p : / / w w w . w 3 . o r g / 2 0 0 1 / X M L S c h e m a "

< s o a p : B o d y > < s 0 : G e t H o s t I n f o B y N a m e >

< s 0 : N a m e > < x s l : v a l u e - o f s e l e c t = " h o s t " / > < / s 0< / s 0 : G e t H o s t I n f o B y N a m e >

< / s o a p : B o d y > < / s o a p : E n v e l o p e > < / x s l : t e m p l a t e > < / x s l : s t y l e s h e e t >

h o s t l o o k u p R e s p o n s e . x s l

< ? x m l v e r s i o n = ' 1 . 0 ' ? > < x s l : s t y l e s h e e t

x m l n s : x s l = " h t t p : / / w w w . w 3 . o r g / 1 9 9 9 / X S L / T r a n s f

x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / 1 . 0 " >< x s l : t e m p l a t e m a t c h = " / w c : C O L L E C T I O N / r e s p o n s e /< w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m /< l o o k u p R e s p o n s e T Y P E = " O b j e c t " S T A T U S = " 0 " >

< w c : I N S T A N C E > < x s l : f o r - e a c h s e l e c t = " A l i a s e s / w c : I N S T A N C E / A < A l i a s > < x s l : v a l u e - o f s e l e c t = " c u r r e n t ( ) " / > < / A l< / x s l : f o r - e a c h > < N a m e > < x s l : v a l u e - o f s e l e c t = " N a m e " / > < / N a m e > < x s l : f o r - e a c h s e l e c t = " I P L i s t / w c : I N S T A N C E / I P A < x s l : v a l u e - o f s e l e c t = " c u r r e n t ( ) " / >< / x s l : f o r - e a c h >

< / w c : I N S T A N C E > < / l o o k u p R e s p o n s e > < / w c : C O L L E C T I O N > < / x s l : t e m p l a t e > < / x s l : s t y l e s h e e t >




E X A M P L E : X S L _ R E S P O N S E _ U R L

T h i s e x a m p l e u s e s t h e X S L _ R E S P O N S E _ U R L p a r a

r e s p o n s e i n t o a g r o u p i d e n t i c a l t o t h a t p r o d u c e d b y t hh o s t l o o k u p 2 . x m l

< % @ p a g e l a n g u a g e = " j a v a " i m p o r t = " j a v a . u t i l . S t i n f o e n g i n e . o b j e c t .

I e M u l t i p a r t I n p u t S t r e a m , j a v a . i o . B y t e A r r a y I n p < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i

p r e f i x = " i e " % >

< ! - - c o m . i n f o e n g i n e . s o a p . r p c . d e f R e s o l v e s i n f o r m a t i o n a b o u t a h o s t n a m e , g o e s s t r a i g h tr e s p o n s e t o g r o u p .

@ p a r a m s t r i n g h o s t T h e h o s t n a m e @ r e t u r n I N F O E N G I N E _ G R O U P $ ( o u t p u t ) - - >

 



 < i e : p a r a m n a m e = " E N D P O I N T "

d a t a = " h t t p : / / w w w . e s y n a p s . c o m / w e b s e r v i c e s / Y o u r H < i e : p a r a m n a m e = " S O A P _ A C T I O N "

d a t a = " h t t p : / / t e m p u r i . o r g / G e t H o s t I n f o B y N a m e "< i e : p a r a m n a m e = " X S L _ U R L "

d a t a = " / s o a p / d o c u m e n t / h o s t l o o k u p / h o s t l o o k u p R e< i e : p a r a m n a m e = " X S L _ R E S P O N S E _ U R L "

d a t a = " / s o a p / d o c u m e n t / h o s t l o o k u p / h o s t l o o k u p R e s p o 

 




h o s t l o o k u p R e s p o n s e S O A P . x s l

< ? x m l v e r s i o n = ' 1 . 0 ' ? >

< x s l : s t y l e s h e e t x m l n s : x s l = " h t t p : / / w w w . w 3 . o r g / 1 9 9 9 / X S L / T r a n s f x m l n s : w c = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / 1 . 0 " x m l n s : s o a p = " h t t p : / / s c h e m a s . x m l s o a p . o r g / s o a p / e x m l n s : d f l t = " h t t p : / / t e m p u r i . o r g / " >

< ! - - D u e t o X S L / X P a t h l i m i t a t i o n a n d n o t b e i n g a b t h e " d e f a u l t " n a m e s p a c e w e n e e d t o a s s i g n a b o g u s t o t h e d e f a u l t n a m e s p a c e a n d u s e i t i n o u r X S L s o w e c a n s e l e c t u n q u a l i f i e d e l e m e n t s w i t h i n t h e S O A- - >

< x s l : t e m p l a t e m a t c h = " / s o a p : E n v e l o p e / s o a p : B o d y / d f l t : G e t H o s t I n f o B y N a m e R e s p o n s e / d f l t : G e t H o s

< w c : C O L L E C T I O N x m l n s : w c = " h t t p : / / w w w . p t c . c o m /< o u t p u t T Y P E = " O b j e c t " S T A T U S = " 0 " >

< w c : I N S T A N C E > < N a m e > < x s l : v a l u e - o f s e l e c t = " d f l t : N a m e " / > < / N< x s l : f o r - e a c h s e l e c t = " d f l t : A l i a s e s / d f l t : A l i a s< A l i a s > < x s l : v a l u e - o f s e l e c t = " c u r r e n t ( ) " / > < / A< / x s l : f o r - e a c h > < x s l : f o r - e a c h s e l e c t = " d f l t : I P L i s t / d f l t : I P A d d < x s l : v a l u e - o f s e l e c t = " c u r r e n t ( ) " < / x s l : f o r - e a c h >

< / w c : I N S T A N C E > < / o u t p u t >

< / w c : C O L L E C T I O N > < / x s l : t e m p l a t e > < / x s l : s t y l e s h e e t >

C r e a t e - O b j e c t


C r e a t e s a J M S m e s s a g e a n d p l a c e s t h a t m e s s a g e

t y p e a n d c o n t e n t s o f t h e m e s s a g e a r e g o v e r n e d b yN o t e T h i s w e b j e c t c a n b e u s e d o n l y a f t e r y o u r e n v i r o n mm e s s a g i n g .




S Y N T A X



 < i e : p a r a m n a m e = " P R O P E R T Y " d a t a = " n a m e _ v a l u e _ p a i r " / 

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l Q U E U E P U T _ B O O L E A N D B U S E R P U T _ B Y T E G R O U P _ I N P U T _ B Y T E S G R O U P _ O U T P U T _ I N T P A S S W D P U T _ C H A R P R I O R I T Y P U T _ D O U B L E P R O P E R T Y P U T _ F L O A T T I M E _ T O _ L I V E P U T _ L O N G S E R V I C E P U T _ S H O R T P U T _ S T R I N G

T Y P E





I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e nm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J Mm a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s . m s g . u s e r n a m e p r o p e r t y i s u s e d . I f t h e . m s g . u s e r n a m e p r o p e r t y i s n o t s e t , t h e n s e t i n t h e . j m s . u s e r n a m e p r o p e r t y i s u s e d . I f n e i t h e r p r o py o u d o n o t s p e c i f y a v a l u e f o r t h i s D B U S E R p a

n o t s p e c i f y a u s e r n a m e w h e n c o n n e c t i n g t o t h e M O M , a n d a n a n o c o n n e c t i o n i s a t t e m p t e d .


G R O U P _ I N T h e n a m e o f a n I n f o * E n g i n e g r o u p t o s e r i a l i z e“ * ” m e a n s s e r i a l i z e a l l g r o u p s . T h i s p a r a m e t e r p a r a m e t e r i s I n f o * E n g i n e . T h i s p a r a m e t e r i s o

G R O U P _ O U T T h e n a m e o f t h e s t a t u s g r o u p t o c r e a t e u p o n s u p a r a m e t e r i s t o c r e a t e d a g r o u p n a m e d “ c r e a t e -

o p t i o n a l . P A S S W D

S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r. m s g . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c u s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a C r e d e n t i a l s M a p f o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e nm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J M

m a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s . m s g . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . m s g . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n s e t i n t h e . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o py o u d o n o t s p e c i f y a v a l u e f o r t h i s P A S S W D p as p e c i f y a p a s s w o r d w h e n c o n n e c t i n g t o t h e M O M . T h i s p a r a m e t e r




P R I O R I T Y S p e c i e s a n i n t e g e r p r i o r i t y t o b e s e t o n t h e o u t g o i nr a n g e f o r J M S Q u e u e p r i o r i t i e s i s f r o m 0 – 9 , w i t h 4P r i o r i t i e s a r e i g n o r e d b y I n f o * E n g i n e , b u t c a n b e u r e c e i v i n g m e s s a g e s q u e u e d b y I n f o * E n g i n e . T h i s

P R O P E R T Y S p e c i e s a n a m e a n d v a l u e p a i r t o s e t o n t h e o u t g o i p r o p e r t i e s a r e i g n o r e d b y I n f o * E n g i n e , b u t c a n b e uT h e f o r m a t f o r t h e P R O P E R T Y v a l u e i s : n a m e = v a l u e

w h e r e :

• n a m e — T h e p r o p e r t y n a m e . • v a l u e — T h e c o r r e s p o n d i n g v a l u e o f t h e p r o p e r t y .

T h i s d e f a u l t b e h a v i o r f o r t h i s p a r a m e t e r i s n o t t o s eo n t h e o u t g o i n g m e s s a g e . T h i s p a r a m e t e r i s o p t i o n

P U T _ B O O L E A N P l a c e s a J a v a B o o l e a n v a l u e i n t o t h e J M S m e s s a g e .a s T R U E o r F A L S E . T h i s p a r a m e t e r c a n o n l y b e u sa s B y t e s M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g e .

P U T _ B Y T E P l a c e s a s i n g l e b y t e i n t o t h e J M S m e s s a g e . T h i s p a t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g e .

P U T _ B Y T E S P l a c e s m u l t i p l e b y t e s i n t o t h e J M S m e s s a g e . T h i s pi f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g e .

P U T _ C H A R P l a c e s a s i n g l e J a v a c h a r a c t e r i n t o t h e J M S m e s s a go n l y b e u s e d i f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g e .

P U T _ D O U B L E P l a c e s a J a v a d o u b l e v a l u e i n t o t h e J M S m e s s a g e . o n l y b e u s e d i f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g e .

P U T _ F L O A T P l a c e s a o a t i n g p o i n t n u m b e r i n t o t h e J M S m e s s a go n l y b e u s e d i f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g e .

P U T _ I N T P l a c e s a n i n t e g e r i n t o t h e J M S m e s s a g e . T h i s p a r a mT Y P E i s s p e c i e d a s B y t e s M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g e .




P U T _ L O N G P l a c e s a l o n g i n t e g e r i n t o t h e J M S m e s s a g e . T ht h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g e .

P U T _ S H O R T P l a c e s a s h o r t i n t e g e r i n t o t h e J M S m e s s a g e . T hi f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g .

P U T _ S T R I N G P l a c e s a n i n s t a n c e o f j a v a . l a n g . S t r i n g i n t o t h e J M S m e s s a g e . p a r a m e t e r c a n o n l y b e u s e d i f t h e T Y P E i s s p e c B y t e s M e s s a g e , T e x t M e s s a g e , M a p M e s s a g e , o r S t r e a m M e s s a g e .

Q U E U E T h e L D A P r e l a t i v e d i s t i n g u i s h e d n a m e o f t h e Jt h e n e w m e s s a g e . T h e v a l u e i s a n L D A P d i s t i n

c o n g u r e d b a s e U R I . I f r e l a t i v e , t h e c n = ( c o m m o n n a m e a t t r i b u t e )n o t e x p l i c i t l y s p e c i e d . T h i s p a r a m e t e r i s r e q u

T I M E _ T O _ L I V E S p e c i e s h o w l o n g , i n m i n u t e s , t h e q u e u e d m e d e f a u l t f o r t h i s p a r a m e t e r i s 0 , i n w h i c h c a s e t h i n d e n i t e l y . T h i s p a r a m e t e r i s o p t i o n a l .





T Y P E I n d i c a t e s t h e t y p e o f J M S m e s s a g e t o c r e a t e . M e s s aP o s s i b l e m e s s a g e t y p e s a r e :

• I n f o E n g i n e — U s e d f o r I n f o * E n g i n e t o I n f o * E n g i n e c g r o u p s s e r i a l i z e d a r e g o v e r n e d b y t h e G R O U P _ I

• B y t e s M e s s a g e — F o r o u t g o i n g m e s s a g e s , t h i s t y p e s u p pP U T _ t y p e p a r a m e t e r s f o r b u i l d i n g a m e s s a g e t h at h i r d - p a r t y r e c i p i e n t . I n c o m i n g m e s s a g e s a r e p r oa s U n k n o w n . T h e c o n t e n t s o f a B y t e s M e s s a g e i s s u p p l i e d a s B L O B d a o n a n i n p u t s t r e a m t o t h e c a l l i n g t a s k .

• T e x t M e s s a g e — S u p p o r t s o n l y a P U T _ S T R I N G p a r a m P U T _ S T R I N G p a r a m e t e r v a l u e s a r e c o n c a t e n a t o u t g o i n g T e x t M e s s a g e .

• M a p M e s s a g e — F o r o u t g o i n g m e s s a g e s , t h i s t y p e s u p p P U T _ t y p e p a r a m e t e r s w i t h v a l u e s i n t h e f o r m o f n a m e = d a t a . T h e n a m e p o r t i o n o f t h e v a l u e i s t h e k e y u s e d t o p l a c e d a t a i n t h e M a p M e s s a g e .

• S t r e a m M e s s a g e — F o r o u t g o i n g m e s s a g e s , t h i s t y p e s u p P U T _ t y p e p a r a m e t e r s f o r b u i l d i n g a m e s s a g e t h at h i r d - p a r t y r e c i p i e n t .

• U n k n o w n — T u r n s B L O B d a t a i n t o a B y t e s M e s s a g e . F o r i n c o m i n g m e s s a g e s , a n e w e m p t y I e R e q u e s t i s c r e a t e d a n d t h e c o n t e n t s o fm e s s a g e a r e t a c k e d o n a s B L O B d a t a .




T h e f o l l o w i n g t a b l e i n d i c a t e s w h i c h P U T _ t y p ew i t h w h i c h m e s s a g e t y p e s :

B y t e s M e s s a g e T e x t M e s s a g e M a S t r e a m P U T _ B O O L E A N X X X P U T _ B Y T E X X P U T _ B Y T E S X X X P U T _ C H A R X X X P U T _ D O U B L E X X X P U T _ F L O A T X X X P U T _ I N T X X XP U T _ L O N G X X X P U T _ S H O R T X X X P U T _ S T R I N G X X X X

N o t e S u p p o r t f o r t h e t y p e S T R I N G i n B y t e s M e s s a g e a c t u a l l y c a u s e s t h e v a l s t r i n g t o b e w r i t t e n a s a b y t e a r r a y ; i t i s n o t a c t u

T h e d e f a u l t v a l u e f o r t h i s p a r a m e t e r i s I n f o E n g i n e , m e a n i n g t h a t a n I n f o * E n g i n e r e q u e s t i s s e r i a l i z e d a n d p l a c e d i nt h i s c a s e c a n m e a n a c t u a l J a v a s e r i a l i z a t i o n o r sr e q u e s t t o X M L ( t h i s i s t h e c a s e w h e n B L O B d a

E X A M P L E S

T h e f o l l o w i n g e x a m p l e c r e a t e s a J M S m e s s a g e aq u e u e :


p r e f i x = " i e " % >

 < i e : p a r a m n a m e = " D B U S E R " d a t a = " $ ( @ F O R M [ ] d b u s< i e : p a r a m n a m e = " P A S S W D " d a t a = " $ ( @ F O R M [ ] p a s s< i e : p a r a m n a m e = " Q U E U E " d a t a = " $ ( @ F O R M [ ] q u e u e< i e : p a r a m n a m e = " T I M E _ T O _ L I V E " d a t a = " $ ( @ F O R M

 



T o a c t u a l l y r u n t h i s e x a m p l e y o u m u s t p r o v i d e a d b u s e r , p a s s w d , q u e u e , t i m e , p r i o r i t y , a n d s t r i n g v a r i a b l e s a r e i d e n t i e d .




T h e f o l l o w i n g e x a m p l e s h o w s h o w t h e C r e a t e - O b j e cq u e u e a T e x t M e s s a g e c o n t a i n i n g X M L d a t a t o b e p r o c e s s e d b ya p p l i c a t i o n :


< ! - - g e t a n " e m p l o y e e o b j e c t f r o m J D B C / J N D I o r w h e r e e f o r t h e p u r p o s e s o f e x a m p l e j u s t u s i n g C r e a t e - G r o u p


d a t a = " n a m e = j o e : e m a i l = j o e @ s o m e w h e r e . n i c e " / > 



< ! - - x m l - i z e t h e p a r t s - - > 

 < n a m e > { 0 } < / n a m e > < e m a i l > { 1 } < / e m a i



< ! - - t u r n t h e m i n t o a n X M L d o c u m e n t a n d p u t i n i n a T e x tm y q u e u e - - > 

 & # 1 

 & # 1 



D e l e t e - O b j e c t


R e m o v e s a m e s s a g e f r o m a J M S q u e u e .




N o t e T h i s w e b j e c t c a n b e u s e d o n l y a f t e r y o u r e n v i r o n mm e s s a g i n g .

S Y N T A X

 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l Q U E U E D B U S E R

S E R V I C E G R O U P _ O U T P A S S W D W H E R E



n o t s p e c i f y a u s e r n a m e w h e n c o n n e c t i n g t o t h ec o n n e c t i o n i s a t t e m p t e d .






G R O U P _ O U T S p e c i e s t h e n a m e o f t h e s t a t u s g r o u p t o c r e a t e a n d d e f a u l t f o r t h i s p a r a m e t e r i s d e l e t e - r e s u l t s . T h i s p a r a m e t e r i s o p t i o n

P A S S W D S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g t o t p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k e s p c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r , o r . m s g . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c e t h au s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a t i o n C r e d e n t i a l s M a p p i n gf o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n t i a lm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p i n g ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) m a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n . m s g . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . m s g . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n t h e vs e t i n t h e . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y o u d o n o t s p e c i f y a v a l u e f o r t h i s P A S S W D p a r a m s p e c i f y a p a s s w o r d w h e n c o n n e c t i n g t o t h e M O M .


Q U E U E I d e n t i e s t h e L D A P r e l a t i v e d i s t i n g u i s h e d n a m e o ft h e m e s s a g e f r o m . T h e v a l u e i s a n L D A P d i s t i n g u ic o n g u r e d b a s e U R I . I f r e l a t i v e , t h e c n = ( c o m m o n n a m e a t t r i b u t e ) i s i n o t e x p l i c i t l y s p e c i e d . T h i s p a r a m e t e r i s r e q u i r e d

W H E R E S p e c i e s a p r o p e r l y f o r m a t t e d J M S m e s s a g e s e l e c tJ a v a M e s s a g e S e r v i c e s p e c i c a t i o n , u s e d t o s e l e c t t h e m e s s a g e q u e u e f o r d e l e t i o n . T h e r s t m e s s a g e ii s d e l e t e d . T h e d e f a u l t b e h a v i o r f o r t h i s p a r a m e t e r t h e q u e u e t o b e d e l e t e d . T h i s p a r a m e t e r i s o p t i o n a l

E X A M P L E

T h e f o l l o w i n g e x a m p l e d e l e t e s a J M S m e s s a g e f r o m


p r e f i x = " i e " % >

 < i e : p a r a m n a m e = " D B U S E R " d a t a = " $ ( @ F O R M [ ] d b u s e r [ ]< i e : p a r a m n a m e = " P A S S W D " d a t a = " $ ( @ F O R M [ ] p a s s w d [ < i e : p a r a m n a m e = " Q U E U E " d a t a = " $ ( @ F O R M [ ] q u e u e [ ] ) "






T o a c t u a l l y r u n t h i s e x a m p l e y o u w o u l d n e e d t o p d b u s e r ,

p a s s w d , q u e u e , a n d w h e r e v a r i a b l e s a r e i d e n t i e d .

D e l e t e - R e s u l t s


R e t r i e v e s a n d d e l e t e s a m e s s a g e f r o m a n I n f o * E nt h a t t h e m e s s a g e c o n t a i n s a k n o w n I n f o * E n g i n e t o a u s e r .

N o t e T h i s w e b j e c t c a n b e u s e d o n l y a f t e r y o u r e n v i r o n mt a s k s .

S Y N T A X

 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l D B U S E R S E R V I C E P A S S W D Q U E U E W H E R E




D B U S E R S p e c i e s t h e u s e r n a m e t o u s e w h e n c o n n e c t i n g t o t p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k e s p rc r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r , o r . m s g . u s e r n a m e a n d . j m s . u s e r n a m e p r o p e r t i e s o f t h e s e r v i c e t h au s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a t i o n C r e d e n t i a l s M a p p i n gf o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n t i a lm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p i n g ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) m a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n . m s g . u s e r n a m e p r o p e r t y i s u s e d . I f t h e . m s g . u s e r n a m e p r o p e r t y i s n o t s e t , t h e n t h e vs e t i n t h e . j m s . u s e r n a m e p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y o u d o n o t s p e c i f y a v a l u e f o r t h i s D B U S E R p a r a m

n o t s p e c i f y a u s e r n a m e w h e n c o n n e c t i n g t o t h e M Oc o n n e c t i o n i s a t t e m p t e d .


S E R V I C E S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e p r o p e r t y s e t r c o n n e c t i v i t y t o a s p e c i c J M S s e r v i c e . T h i s a l l o w s o n e J M S s e r v i c e p e r I n f o * E n g i n e V i r t u a l M a c h i n eo p t i o n a l .

P A S S W D S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g t o t

p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k e s p c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r , o r . m s g . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c e t h au s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a t i o n C r e d e n t i a l s M a p p i n gf o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n t i a lm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p i n g ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) m a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n . m s g . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . m s g . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n t h e vs e t i n t h e . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y o u d o n o t s p e c i f y a v a l u e f o r t h i s P A S S W D p a r a m s p e c i f y a p a s s w o r d w h e n c o n n e c t i n g t o t h e M O M .





Q U E U E S p e c i e s t h e L D A P d i s t i n g u i s h e d n a m e o f a m i s a n L D A P d i s t i n g u i s h e d n a m e r e l a t i v e t o a c or e l a t i v e , t h e c n = ( c o m m o n n a m e a t t r i b u t e ) i s i m p l i c i t is p e c i e d . T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u c o m . i n f o e n g i n e . m s g . d e f a u l t R e s p o n s e Q p r o p e r t y .


W H E R E S p e c i e s a p r o p e r l y f o r m a t t e d J M S m e s s a g e s eJ a v a M e s s a g e S e r v i c e s p e c i c a t i o n , u s e d t o s e lt h e m e s s a g e q u e u e f o r d e l e t i o n . T h e r s t m e s s ad e l e t e d .

T h e v a l u e o f t h e C O R R E L A T I O N _ I D p a r a m e

c a n b e u s e d a s t h e W H E R E v a l u e t o s e l e c t t h e cT h e d e f a u l t v a l u e o f t h i s p a r a m e t e r i s d e r i v e d fi n t h e S E R V E R c o n t e x t g r o u p a n d r e s u l t s i n a sm e s s a g e s . T h i s p a r a m e t e r i s o p t i o n a l .

E X A M P L E

T h e f o l l o w i n g e x a m p l e r e t r i e v e s a m e s s a g e f r o mt h e m e s s a g e :


p r e f i x = " i e " % > < i e : p a r a m n a m e = " Q U E U E " d a t a = " $ ( F O R M [ ] Q U E U E < i e : p a r a m n a m e = " C O R R E L A T I O N _ I D "

d a t a = " $ ( F O R M [ ] C O R R I D [ 0 ] ) " /

T o a c t u a l l y r u n t h i s e x a m p l e y o u w o u l d n e e d t o p C O R R I D , a n d w h e r e v a r i a b l e s a r e i d e n t i e d .




Q u e r y - O b j e c t


R e t r i e v e s a m e s s a g e f r o m a J M S m e s s a g e q u e u e . I f t h e r e i s n o m e s s a g e t o r e t u r n , a n i n s t a n c e o f c o m . i n f o e n g i n e . e x c e p t i o n . n o n f a t a l . I E R e q i s t h r o w n .

N o t e T h i s w e b j e c t c a n b e u s e d o n l y a f t e r y o u r e n v i r o n m e n m e s s a g i n g .

S Y N T A X

 

 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l Q U E U E B L O B _ C O U N T

D B U S E R S E R V I C E D E L E T E G E T _ B O O L E A N G E T _ B Y T E G E T _ B Y T E S G E T _ C H A R G E T _ D O U B L E




R e q u i r e d S e l e c t O p t i o n a l G E T _ F L O A T G E T _ I N T G E T _ L O N G G E T _ S H O R T G E T _ S T R I N G P A S S W D W H E R E

B L O B _ C O U N T S p e c i e s t h e n u m b e r o f B L O B s t o r e t u r n o n t h eB L O B s n o t r e t u r n e d c a n b e u s e d a s i n p u t t o o t hd e f a u l t f o r t h i s p a r a m e t e r i s 0 . T h i s p a r a m e t e r


I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e nm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J Mm a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s . m s g . u s e r n a m e p r o p e r t y i s u s e d . I f t h e . m s g . u s e r n a m e p r o p e r t y i s n o t s e t , t h e n s e t i n t h e . j m s . u s e r n a m e p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t yy o u d o n o t s p e c i f y a v a l u e f o r t h i s D B U S E R p a o e s n o t s p e c i f y a u s e r n a m e w h e n c o n n e c t i n g t o t h ec o n n e c t i o n i s a t t e m p t e d . T h i s p a r a m e t e r i s o p t


D E L E T E S p e c i e s w h e t h e r o r n o t t o r e m o v e t h e m e s s a g er e t r i e v e d f r o m t h e q u e u e . T h e d e f a u l t f o r t h i s pd e l e t e s t h e o b j e c t o n c e i t i s r e t r i e v e d f r o m t h e qT h i s p a r a m e t e r i s o p t i o n a l .

G E T _ B O O L E A N R e t r i e v e s a J a v a B o o l e a n v a l u e f r o m t h e J M S ms p e c i e d a s T R U E o r F A L S E . T h i s p a r a m e t e r cm e s s a g e t y p e i s S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n a l .




G E T _ B Y T E R e t r i e v e s a s i n g l e b y t e f r o m t h e J M S m e s s a g e . T h i i f t h e i n c o m i n g m e s s a g e t y p e i s S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n

G E T _ B Y T E S R e t r i e v e s m u l t i p l e b y t e s f r o m t h e J M S m e s s a g e . T b e u s e d i f t h e i n c o m i n g m e s s a g e t y p e i s S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n a l .

G E T _ C H A R R e t r i e v e s a s i n g l e J a v a c h a r a c t e r f r o m t h e J M S m e o n l y b e u s e d i f t h e i n c o m i n g m e s s a g e t y p e i s S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n a l .

G E T _ D O U B L E R e t r i e v e s a J a v a d o u b l e v a l u e f r o m t h e J M S m e s s a

b e u s e d i f t h e i n c o m i n g m e s s a g e t y p e i s S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n a l .

G E T _ F L O A T R e t r i e v e s a o a t i n g p o i n t n u m b e r f r o m t h e J M S m ec a n o n l y b e u s e d i f t h e i n c o m i n g m e s s a g e t y p e i s S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n a l .

G E T _ I N T R e t r i e v e s a n i n t e g e r f r o m t h e J M S m e s s a g e . T h i s p t h e i n c o m i n g m e s s a g e t y p e i s S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n a

G E T _ L O N G

R e t r i e v e s a l o n g i n t e g e r f r o m t h e J M S m e s s a g e . T hu s e d i f t h e i n c o m i n g m e s s a g e t y p e i s S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n a l .

G E T _ S H O R T R e t r i e v e s a s h o r t i n t e g e r f r o m t h e J M S m e s s a g e . T b e u s e d i f t h e i n c o m i n g m e s s a g e t y p e i s S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n a l .

G E T _ S T R I N G R e t r i e v e s a n i n s t a n c e o f j a v a . l a n g . S t r i n g f r o m t h e J M S m e s s a g e . T p a r a m e t e r c a n o n l y b e u s e d i f t h e i n c o m i n g m e s s a g S t r e a m M e s s a g e . T h i s p a r a m e t e r i s o p t i o n a l .




P A S S W D S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r. m s g . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c u s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a C r e d e n t i a l s M a p f o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e nm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J Mm a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s . m s g . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . m s g . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n s e t i n t h e . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o py o u d o n o t s p e c i f y a v a l u e f o r t h i s P A S S W D p a

s p e c i f y a p a s s w o r d w h e n c o n n e c t i n g t o t h e M OT h i s p a r a m e t e r i s o p t i o n a l .

Q U E U E S p e c i e s t h e L D A P d i s t i n g u i s h e d n a m e o f t h e r e t r i e v e t h e m e s s a g e . T h e v a l u e i s a n L D A P d i c o n g u r e d b a s e U R I . I f r e l a t i v e , t h e c n = ( c o m m o n n a m e a t t r i b u t e )n o t e x p l i c i t l y s p e c i e d . T h i s p a r a m e t e r i s r e q u

W H E R E S p e c i e s a p r o p e r l y f o r m a t t e d J M S m e s s a g e s eJ a v a M e s s a g e S e r v i c e s p e c i c a t i o n , u s e d t o s e l

t h e m e s s a g e q u e u e f o r r e t r i e v a l . T h e r s t m e s s ar e t u r n e d . T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o s eT h i s p a r a m e t e r i s o p t i o n a l .

E X A M P L E

T h e f o l l o w i n g e x a m p l e r e t r i e v e s a m e s s a g e f r o m


p r e f i x = " i e " % >



< i e : p a r a m n a m e = " D B U S E R " d a t a = " $ ( @ F O R M [ ] d b u s< i e : p a r a m n a m e = " P A S S W D " d a t a = " $ ( @ F O R M [ ] p a s s< i e : p a r a m n a m e = " D E L E T E " d a t a = " $ ( @ F O R M [ ] d e l e 



T o a c t u a l l y r u n t h i s e x a m p l e y o u w o u l d n e e d t o p d b u s e r , p a s s w d , d e l e t e , a n d w h e r e v a r i a b l e s a r e i d e n t i e d .




Q u e r y - R e s u l t s


R e t r i e v e s a m e s s a g e f r o m a n I n f o * E n g i n e t a s k q u e u b y d e f a u l t , d e l e t e s t h e m e s s a g e f r o m t h e q u e u e . I t i s c o n t a i n s a k n o w n I n f o * E n g i n e o b j e c t , n o r m a l l y a g r

N o t e T h i s w e b j e c t c a n b e u s e d o n l y a f t e r y o u r e n v i r o n m e n tt a s k s .

S Y N T A X



 



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l C O R R E L A T I O N _ I D D B U S E R S E R V I C E D E L E T E P A S S W D Q U E U E W A I T _ T I M E W H E R E

C O R R E L A T I O N _ I D S p e c i e s t h e J M S h e a d e r c o r r e l a t i o n i d e n t i e r . T h ir e s u l t s f r o m a r e s p o n s e q u e u e a n d c o r r e s p o n d s t o t p a r a m e t e r u s e d w h e n q u e u e i n g a t a s k f o r e x e c u t i o w e b j e c t . T h i s p a r a m e t e r i s o p t i o n a l .






n o t s p e c i f y a u s e r n a m e w h e n c o n n e c t i n g t o t h ec o n n e c t i o n i s a t t e m p t e d .



D E L E T E I n d i c a t e s w h e t h e r o r n o t t h e m e s s a g e i s t o b e d e

s u c c e s s f u l l y r e t u r n e d t o t h e u s e r . I f t h e v a l u e s m e s s a g e i s d e l e t e d . I f t h e v a l u e s p e c i e d i s F A Ld e l e t e d . T h e d e f a u l t f o r t h i s p a r a m e t e r i s T R U E

P A S S W D S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r. m s g . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c u s e d t o c o n n e c t t o t h e M O M .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e nm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p i

c r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J Mm a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s . m s g . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . m s g . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n s e t i n t h e . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o py o u d o n o t s p e c i f y a v a l u e f o r t h i s P A S S W D p a r a m e t e r , I n f o * E n s p e c i f y a p a s s w o r d w h e n c o n n e c t i n g t o t h e M O





Q U E U E A n L D A P d i s t i n g u i s h e d n a m e o f a m a n a g e d q u e u L D A P d i s t i n g u i s h e d n a m e r e l a t i v e t o a c o n g u r e d t h e c n = ( c o m m o n n a m e a t t r i b u t e ) i s i m p l i c i t i f n o t e x pT h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e v a l u e s pc o m . i n f o e n g i n e . m s g . d e f a u l t R e s u l t s Q u e u p r o p e r t y .


W A I T _ T I M E S p e c i e s t h e t i m e i n s e c o n d s t o w a i t f o r t h e r e s u l t t oq u e u e . T h e d e f a u l t f o r t h i s p a r a m e t e r i s 0 . T h i s p a r

W H E R E S p e c i e s a p r o p e r l y f o r m a t t e d J M S m e s s a g e s e l e c tJ a v a M e s s a g e S e r v i c e s p e c i c a t i o n , u s e d t o s e l e c t

t h e m e s s a g e q u e u e f o r r e t r i e v a l . T h e r s t m e s s a g e ir e t u r n e d .

T h e v a l u e o f t h e C O R R E L A T I O N _ I D p a r a m e t e r f c a n b e u s e d a s t h e W H E R E v a l u e t o s e l e c t t h e c o r r e

T h e d e f a u l t v a l u e o f t h i s p a r a m e t e r i s d e r i v e d f r o m i n t h e S E R V E R c o n t e x t g r o u p a n d r e s u l t s i n a s u b s m e s s a g e s . T h i s p a r a m e t e r i s o p t i o n a l .

E X A M P L E

T h e f o l l o w i n g e x a m p l e r e t r i e v e s a m e s s a g e f r o m t h e

t h e r e s u l t s : < % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % >


 < i e : p a r a m n a m e = " W H E R E " d a t a = " $ ( @ F O R M [ ] w h e r e [ 0 ] )






T o a c t u a l l y r u n t h i s e x a m p l e y o u w o u l d n e e d t o p r o v q u e u e , c o r r i d , w h e r e , a n d d e l e t e v a r i a b l e s a r e i d e n t i e d .




Q u e u e - T a s k


A l l o w s a s u b s c r i b e r o f a n I n f o * E n g i n e t a s k q u e ue x e c u t i o n . T h e t a s k i s b u i l t f r o m a t a s k e x e c u t i o nm o r e e x i s t i n g I n f o * E n g i n e g r o u p s .


S Y N T A X



 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l T A S K C O R R E L A T I O N _ I D

D B U S E R S E R V I C E D E S T I N A T I O N G R O U P _ I N P A S S W D P R I O R I T Y Q U E U E R E S U L T _ T I M E _ T O _ L I V E T A S K _ T I M E _ T O _ L I V E




C O R R E L A T I O N _ I D S p e c i e s a J M S m e s s a g e s e l e c t o r t o s e t a s t h e J M S ho f t h e r e s u l t . T h e v a l u e o f t h i s p a r a m e t e r c a n t h e n bW H E R E p a r a m e t e r o f t h e Q u e r y - R e s u l t s o r D e l e t et h e c o r r e s p o n d i n g r e s u l t .

T h e d e f a u l t v a l u e o f t h i s p a r a m e t e r i s d e r i v e d f r o m a u t h - u s e r H T T P h e a d e r v a l u e f o u n d i n t h e S E R V E R c o n t e x t g r o u p a u t h - u s e r i s n o t d e n e d a n d n o e x p l i c i t c o r r e l a t i o n i d e n t i e r i s s p e ci d e n t i e r i s a s s o c i a t e d w i t h t h e t a s k . I n t h i s c a s e , t hr e t u r n e d f r o m Q u e r y - T a s k r e t u r n s t h e v a l u e o f t h e w a s a s s o c i a t e d w i t h t h e t a s k . T h i s p a r a m e t e r i s o p t

D E S T I N A T I O N S p e c i e s t h e L D A P d i s t i n g u i s h e d n a m e o f t h e q u et h e r e s p o n s e s h o u l d b e q u e u e d a f t e r t h e t a s k i s e x ed e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e v a l u e s p e c i c o m . i n f o e n g i n e . m s g . d e f a u l t R e s p o n s e Q u e p r o p e r t y . T h i s p a r a m e t e r i s o p t i o n a l .

D B U S E R S p e c i e s t h e u s e r n a m e t o u s e w h e n c o n n e c t i n g t o t p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k e s p rc r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r , o r . m s g . u s e r n a m e a n d . j m s . u s e r n a m e p r o p e r t i e s o f t h e s e r v i c e t h au s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a t i o n , s e e C r e d e n t i a l s M a p p i n gf o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n t i a lm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p i n g ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) m a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n . m s g . u s e r n a m e p r o p e r t y i s u s e d . I f t h e . m s g . u s e r n a m e p r o p e r t y i s n o t s e t , t h e n t h e vs e t i n t h e . j m s . u s e r n a m e p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y o u d o n o t s p e c i f y a v a l u e f o r t h i s D B U S E R p a r a mn o t s p e c i f y a u s e r n a m e w h e n c o n n e c t i n g t o t h e M Oc o n n e c t i o n i s a t t e m p t e d . T h i s p a r a m e t e r i s o p t i o n a

S E R V I C E S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e p r o p e r t y s e tc o n n e c t i v i t y t o a s p e c i c J M S s e r v i c e . T h i s a l l o w s o n e J M S s e r v i c e p e r I n f o * E n g i n e V i r t u a l M a c h i n eo p t i o n a l .

G R O U P _ I N S p e c i e s t h e n a m e o f a l o c a l V D B I n f o * E n g i n e g r ot a s k t o b e q u e u e d . T h e d e f a u l t b e h a v i o r i s t h a t n o g g r o u p s c a n b e s p e c i e d o n t h i s p a r a m e t e r . T h i s p a r




P A S S W D S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r. m s g . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c u s e d t o c o n n e c t t o t h e M O M .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e nm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J Mm a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s . m s g . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . m s g . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n s e t i n t h e . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o py o u d o n o t s p e c i f y a v a l u e f o r t h i s P A S S W D p as p e c i f y a p a s s w o r d w h e n c o n n e c t i n g t o t h e M O

P R I O R I T Y S p e c i e s a n i n t e g e r p r i o r i t y t o b e s e t o n t h e o u t r a n g e f o r J M S Q u e u e p r i o r i t i e s i s f r o m 0 – 9 , w P r i o r i t i e s a r e i g n o r e d b y I n f o * E n g i n e , b u t c a n r e c e i v i n g e v e n t s s e n t b y I n f o * E n g i n e . T h e d e ft o s e t a p r i o r i t y w h i c h r e s u l t s i n t h e m e s s a g e b ed e f a u l t p r i o r i t y . T h i s p a r a m e t e r i s o p t i o n a l .

Q U E U E S p e c i e s t h e L D A P d i s t i n g u i s h e d n a m e o f t h e p l a c e d . T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e c o m . i n f o e n g i n e . m s g . d e f a u l t E x e c u t i o n p r o p e r t y . T h i s p a r a m e t e r i s o p t i o n a l .

R E S U L T _ T I M E _ T O _ L I V E I n d i c a t e s a n u m e r i c v a l u e s p e c i f y i n g h o w l o n gs h o u l d r e m a i n i n t h e r e s p o n s e q u e u e b e f o r e b e p a r a m e t e r i s s p e c i e d a s a n u m e r i c s t r i n g i n m i p a r a m e t e r i s 0 , i n w h i c h c a s e t h e M O M d o e s n o p a r a m e t e r i s o p t i o n a l .




T A S K S p e c i e s a U R I t h a t i s t h e l o c a t i o n o f t h e X M L t a s k E X E C U T I O N _ Q U E U E t o e x e c u t e . T h e U R I c a n b

• R e l a t i v e U R I s r e f e r e n c e l e s t h a t r e s i d e u n d e r t h t h a t i s d e n e d f o r t h e l o c a l I n f o * E n g i n e t a s k p r o c

• A b s o l u t e U R I s r e f e r e n c e l e s t h a t r e s i d e i n t h e l oo n a r e m o t e H T T P s e r v e r , o r a r e r e f e r e n c e d t h r o ud i r e c t o r y .

F o r e x a m p l e U R I s , s e e S p e c i f y i n g U R I s a n d U R L s o n p a g e 6 4 .


N o t e T h e U R I s s h o w n i n t h i s g u i d e u s e t h e f o r w a r d s l a s h

p a t h s e v e n t h o u g h t h e b a c k s l a s h ( \ ) i s t h e d i r e c t o r y s y s t e m s . I n f o * E n g i n e c o r r e c t l y i d e n t i e s a l l s y s t e m f o r w a r d s l a s h . I f y o u p r e f e r t o u s e t h e b a c k s l a s h f o r Nt h e b a c k s l a s h i n t h e U R I . T h i s m e a n s t h a t y o u e n t e r

T A S K _ T I M E _ T O _ L I V E I n d i c a t e s a n u m e r i c v a l u e s p e c i f y i n g h o w l o n g t h e t h e e x e c u t i o n q u e u e b e f o r e i t c a n b e d i s c a r d e d b y t s p e c i e d a s a n u m e r i c s t r i n g i n m i n u t e s . T h e d e f a u w h i c h c a s e t h e M O M d o e s n o t d i s c a r d t h e m e s s a g e

E X A M P L E

T h e f o l l o w i n g e x a m p l e a d d s t h e s p e c i e d t a s k t o t h e < % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % >


 




T o a c t u a l l y r u n t h i s e x a m p l e y o u w o u l d n e e d t o pQ U E U E , T T T L , R T T L , D E S T , C O R R I D , a n d P R

S e n d - M a i l


C r e a t e s a n d s e n d s a n e m a i l m e s s a g e . S e n d - M a i l c o p y , a n d b l i n d c o p y r e c i p i e n t s , a s w e l l a s m e s s a c a n c r e a t e a n d s e n d m u l t i - p a r t M I M E m e s s a g e s c b o d y p a r t t y p e s . I t a l l o w s m e s s a g e b o d y p a r t s t o w e b j e c t p a r a m e t e r s o r a s B L O B s u s i n g t h e t a s k i

S Y N T A X

 

< i e : p a r a m n a m e = " C O N N E C T I O N _ T I M E O U T " d a t a = " m i < i e : p a r a m n a m e = " C O N T E N T " d a t a = " m e s s a g e _ b o d y " / < i e : p a r a m n a m e = " C O N T E N T _ T Y P E " d a t a = " M I M E _ t y p 

< i e : p a r a m n a m e = " H E A D E R S _ C H A R S E T " d a t a = " < i e : p a r a m n a m e = " M A I L _ S E R V E R " d a t a = " h o s t _ n a m e "< i e : p a r a m n a m e = " M A X _ D E L I V E R Y _ T I M E " d a t a = " < i e : p a r a m n a m e = " R E P L Y _ T O " d a t a = " e - m a i l _ a d d r e s s 

< / w e b j e c t >

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l T O B L O B _ C O U N T C C

C O N N E C T I O N _ T I M E OC O N T E N T B C C C O N T E N T _ L I N E _ B R E A K D B U S E R




R e q u i r e d S e l e c t O p t i o n a l C O N T E N T _ T Y P E F R O M C O N T E N T _ U R L G R O U P _ O U T

H E A D E R S _ C H A R S E T H E A D E R M A I L _ S E R V E R M A X _ D E L I V E R Y _ T I M E M U L T I P A R T _ T Y P E P A S S W D P A S S W O R D R E P L Y _ T O S U B J E C T

T I M E O U T U S E R N A M E

B C C S p e c i e s t h e e m a i l a d d r e s s o r a d d r e s s e s o f t h e b l i n m e s s a g e . E a c h o f t h e s e r e c i p i e n t s r e c e i v e s a c o p y ot h e s e a d d r e s s e s a r e d i s c l o s e d t o a n y o t h e r r e c i p i e n c o p y r e c i p i e n t s . T h i s p a r a m e t e r c a n b e s p e c i e d m m u l t i p l e b l i n d c o p y r e c i p i e n t s . E a c h i n s t a n c e o f t h o n e a d d r e s s . T h i s p a r a m e t e r i s o p t i o n a l .

B L O B _ C O U N T S p e c i e s t h e n u m b e r o f B L O B s t o r e a d f r o m t h e i nC O N T E N T p a r a m e t e r i s a l s o s p e c i e d , t h e B L O B m e s s a g e a s a t t a c h m e n t s . I f t h e C O N T E N T p a r a m eB L O B s b e c o m e t h e m e s s a g e .

C C S p e c i e s t h e e m a i l a d d r e s s o r a d d r e s s e s o f n o n - p r ic o p i e s o f t h e m e s s a g e a r e s e n t . T h i s p a r a m e t e r c a n t o s p e c i f y m u l t i p l e c o p y r e c i p i e n t s . E a c h i n s t a n c e e x a c t l y o n e a d d r e s s . T h i s p a r a m e t e r i s o p t i o n a l .

C O N N E C T I O N _ T I M E O U T S p e c i e s a c o n n e c t i o n t i m e o u t i n m i l l i s e c o n d s , s u

c o m . i n f o e n g i n e . m a i l . s m t p . c o n n e c t i o n t i m s y s t e m p r o p e r t y . T h i s p a r a m e t e r i s o p t i o n a l .

C O N T E N T S p e c i e s a t e x t u a l m e s s a g e b o d y . E a c h i n s t a n c e o f c a n c o r r e s p o n d t o a n i n s t a n c e o f t h e C O N T E N T _ Ts p e c i e s t h e M I M E c o n t e n t t y p e o f t h e C O N T E N TC O N T E N T _ T Y P E i s s p e c i e d , t h e C O N T E N T p a u n l e s s t h e B L O B _ C O U N T p a r a m e t e r i s s p e c i e d .s p e c i e d f o r t h i s p a r a m e t e r .




C O N T E N T _ L I N E _ B R E A K T h i s p a r a m e t e r i s a m u l t i - v a l u e d p a r a m e t e r t h at o b e u s e d a s a l i n e b r e a k . W h e r e v e r t h e v a l u e oc o n t e n t o f t h e e m a i l i t i s r e p l a c e d w i t h a l i n e b r

C O N T E N T _ T Y P E S p e c i e s t h e M I M E c o n t e n t t y p e o f a c o r r e s p o E a c h i n s t a n c e o f t h e C O N T E N T _ T Y P E p a r a mo f t h e C O N T E N T p a r a m e t e r a n d s p e c i e s t h e M p a r a m e t e r . I f n o C O N T E N T _ T Y P E p a r a m e t e c o n t e n t t y p e s o f t h e C O N T E N T p a r a m e t e r s d e t h e r e a r e f e w e r C O N T E N T _ T Y P E p a r a m e t e r s p l a i n t e x t v a l u e s a r e i m p l i c i t l y a d d e d t o t h e l i s p a r a m e t e r s .

C O N T E N T _ U R L T h e C O N T E N T _ U R L p a r a m e t e r c a n b e m u l t i U R L t h a t i s o p e n e d a n d r e a d . T h e c o n t e n t r e a d p a r t ( m a i n b o d y o r a t t a c h m e n t ) f o r t h e m e s s a g

D B U S E R S p e c i e s t h e u s e r n a m e t o u s e w h e n c o n n e c t i n g p a r a m e t e r i s o p t i o n a l .

F R O M S p e c i e s t h e e m a i l a d d r e s s o f t h e o r i g i n a t o r o fd e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e v a l u e s pc o m . i n f o e n g i n e . m a i l . o r i g i n a t o r p r o p e r t y . I f t h e p r o p e r t

n o t e x i s t , a n d t h e F R O M p a r a m e t e r i s n o t s p e c iT h i s p a r a m e t e r i s o p t i o n a l .

G R O U P _ O U T S p e c i e s t h e o p t i o n a l n a m e o f a n o u t p u t g r o u p t h e n a n o u t p u t g r o u p i s r e t u r n e d c o n t a i n i n g a s a t t r i b u t e s n a m e d s e n t , u n s e n t , a n d i n v a l i d . T h e s e n t a t t r i b u t e s p e c i e s ta d d r e s s e s t o w h i c h t h e m e s s a g e w a s s e n t , t h e u n s e n t a t t r i b u t e s p e c i e s ta d d r e s s e s t h a t a r e a s s u m e d t o b e v a l i d b u t t o w b e s e n t ( f o r e x a m p l e , b e c a u s e t h e m a i l s e r v e r w i n v a l i d a t t r i b u t e s p e c i e s t h e a d d r e s s e s t h a t w e r e i n v a l

H E A D E R

A m u l t i - v a l u e d p a r a m e t e r , w i t h e a c h v a l u e s p eo u t g o i n g m a i l m e s s a g e . T h e f o r m a t o f t h e p a r a n a m e = v a l u e ( n o q u o t a t i o n m a r k s s h o u l d b e p l a c e d a r o u n d v a l u e ) . F o r e x a m p l e :

c c = u s e r @ h o s t . c o m

a d d s a C C h e a d e r t o t h e m e s s a g e e v e n t h o u g h t h e u s i n t h e C C l i s t , a n d d o e s n o t r e c e i v e t h e e m a i l .




H E A D E R S _ C H A R S E T S p e c i e s t h e n a m e o f t h e c h a r a c t e r s e t t h a t i s u s e d it h e s u b j e c t h e a d e r .

M A I L _ S E R V E R S p e c i e s t h e i n t e r n e t d o m a i n n a m e o f t h e S M T P mw h i c h t h e m e s s a g e i s s e n t f o r r o u t i n g t o t h e r e c i p i ef o r t h i s p a r a m e t e r i s t o o b t a i n t h e m a i l s e r v e r n a m c o m . i n f o e n g i n e . m a i l . s m t p . s e r v e r p r o p e r t y . I f t h e p r o p e r t y d n o t e x i s t , a n d M A I L _ S E R V E R i s n o t s p e c i e d , t h el o c a l h o s t . T h i s p a r a m e t e r i s o p t i o n a l .

M A X _ D E L I V E R Y _ T I M E S p e c i e s t h e m a x i m u m l e n g t h o f t i m e i n s e c o n d s t od e l i v e r m e s s a g e s t o v a l i d a d d r e s s e s i n c a s e s w h e r et h a t t h e a d d r e s s e s a r e v a l i d , b u t t h e m a i l s e r v e r d o ee x a m p l e , b e c a u s e t h e m a i l s e r v e r i s t e m p o r a r i l y u nd e f a u l t v a l u e i s 6 0 s e c o n d s .

M U L T I P A R T _ T Y P E S p e c i e s t h e M I M E s u b t y p e o f t h e m u l t i p a r t m e s s C O N T E N T a n d / o r C O N T E N T _ U R L p a r a m e t e r v d e f a u l t v a l u e f o r t h i s p a r a m e t e r i s m i x e d .

P A S S W D S p e c i e s t h e p a s s w o r d a s s o c i a t e d w i t h t h e D B U S E p a r a m e t e r i s o p t i o n a l .

P A S S W O R D S p e c i e s t h e p a s s w o r d t o s p e c i f y w h e n a u t h e n t i c a tW h i l e P A S S W O R D c a n b e u s e d i n c o n j u n c t i o n w in e c e s s a r y f o r b o t h p a r a m e t e r s t o b e s p e c i e d . T h e t o o b t a i n t h e p a s s w o r d f r o m t h e . m a i l . s m t p . p a s s w o r d p r o p e r t y . T h i s p a r a m e t e r i s o p t i o n a l .

R E P L Y _ T O S p e c i e s t h e e m a i l a d d r e s s o r a d d r e s s e s t o w h i c h r M u l t i p l e v a l u e s c a n b e s p e c i e d f o r t h i s p a r a m e t e r p a r a m e t e r , s p e c i f y e x a c t l y o n e e m a i l a d d r e s s . T h e i s f o r r e p l i e s t o b e s e n t t o t h e a d d r e s s s p e c i e d b y F o p t i o n a l .

S U B J E C T S p e c i e s t h e s u b j e c t h e a d e r o f t h e m e s s a g e . I f i t i s nd o e s n o t c o n t a i n a s u b j e c t h e a d e r . T h i s p a r a m e t e r i

T I M E O U T S p e c i e s a n i n p u t a n d o u t p u t ( I / O ) t i m e o u t i n m i l l it h e c o m . i n f o e n g i n e . m a i l . s m t p . t i m e o u t s y s t e m p r o p e r t y . T h i s p a r a m e t e r i s o p t i o n a l .




T O S p e c i e s t h e e m a i l a d d r e s s o r a d d r e s s e s o f t h e m e s s a g e . I t m a y b e s p e c i e d m u l t i p l e t i m e s t o r e c i p i e n t s . E a c h i n s t a n c e o f t h e p a r a m e t e r s p e ci s a r e q u i r e d p a r a m e t e r

U S E R N A M E S p e c i e s t h e u s e r n a m e t o s p e c i f y w h e n a u t h e n tW h i l e U S E R N A M E c a n b e u s e d i n c o n j u n c t i o n e c e s s a r y f o r b o t h p a r a m e t e r s t o b e s p e c i e d . Tf o r t h e u s e r n a m e t o b e o b t a i n e d f r o m t h e . m a i l . s m t p . u s e r n a m e p r o p e r t y . I f t h e p r o p e r t y d o e s n o t e x i s t , a n d U S E R N A M E b i n d i n g t o t h e m a i l s e r v e r i s a t t e m p t e d . T h i s p a

E X A M P L E

T h e f o l l o w i n g e x a m p l e s e n d s a n e m a i l b a s e d o n


p r e f i x = " i e " % >

 < i e : p a r a m n a m e = " U S E R N A M E " d a t a = " $ ( @ F O R M [ ] u < i e : p a r a m n a m e = " F R O M " d a t a = " $ ( @ F O R M [ ] f r o m [ ] < i e : p a r a m n a m e = " S U B J E C T " d a t a = " $ ( @ F O R M [ ] s u b< i e : p a r a m n a m e = " C O N T E N T _ T Y P E "

d a t a = " $ ( @ F O R M [ ] c o n t e n t T y p e [ ] ) 

T o a c t u a l l y r u n t h i s e x a m p l e y o u w o u l d n e e d t o p u s e r , p a s s w o r d , t o , f r o m , s u b j e c t , c o n t e n t T y p e , a n d c o n t e n t v a r i a b l e s a r e i d e n t

S u b s c r i b e - Q u e u e


R e g i s t e r s a n e v e n t h a n d l e r t h a t i s c a l l e d b y t h e M m e s s a g e a r r i v e s i n t h e s p e c i e d q u e u e .





S Y N T A X



 < i e : p a r a m n a m e = " Q U E U E " d a t a = " m a n a g e d _ q u e u e _ n a m e " /< i e : p a r a m n a m e = " W H E R E " d a t a = " j m s _ m e s s a g e _ s e l e c t o r



P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l D B U S E R S E R V I C E E X E C U T E _ T A S K P A S S W D Q U E U E W H E R E M A X _ C O N C U R R E N C Y

D B U S E R S p e c i e s t h e u s e r n a m e t o u s e w h e n c o n n e c t i n g t o t p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k e s p rc r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r , o r

. m s g . u s e r n a m e a n d . j m s . u s e r n a m e p r o p e r t i e s o f t h e s e r v i c e t h au s e d t o c o n n e c t t o t h e M O M .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n t i a lm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p i n g ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) m a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n . m s g . u s e r n a m e p r o p e r t y i s u s e d . I f t h e . m s g . u s e r n a m e p r o p e r t y i s n o t s e t , t h e n t h e vs e t i n t h e . j m s . u s e r n a m e p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y o u d o n o t s p e c i f y a v a l u e f o r t h i s D B U S E R p a r a mn o t s p e c i f y a u s e r n a m e w h e n c o n n e c t i n g t o t h e M Oc o n n e c t i o n i s a t t e m p t e d .





E X E C U T E _ T A S K S p e c i e s t h e t a s k t o b e e x e c u t e d w h e n a m e s s a gq u e u e . I f t h e i n c o m i n g m e s s a g e d o e s n o t c o n t at a s k s p e c i e d o n t h i s p a r a m e t e r i s r u n . I f E X E C U T E _ T A S K i s n o t s p e c i e d , t h e n t h e I n f o * E n g i n e r e q u e s t s o n i t s q u e u e . O t h e r i n c o T h i s p a r a m e t e r i s o p t i o n a l .

M A X _ C O N C U R R E N C Y S p e c i e s t h e n u m b e r o f r e c e i v e r s t h a t s h o u l d b s u b s c r i p t i o n . T h i s s p e c i e s t h e m a x i m u m n u mI n f o * E n g i n e s y s t e m p r o c e s s e s s i m u l t a n e o u s l ym e s s a g e s t o b e p r o c e s s e d s e r i a l l y .

S p e c i f y i n g a M A X _ C O N C U R R E N C Y v a l u e

m e s s a g e s t h a t a r e p l a c e d i n a q u e u e a r e n o t n e c i n w h i c h t h e y w e r e q u e u e d . T h i s p a r a m e t e r s h om e s s a g e s i s i m p o r t a n t . T h i s p a r a m e t e r i s o p t i o

N o t e S p e c i f y i n g t h i s p a r a m e t e r d o e s n o t n e c e s s a r i l y b u s y w h e n g i v e n a q u e u e l o a d . T h i s f u n c t i o n a l it h e c o n g u r a t i o n o f t h e M O M y o u a r e c o n n e c t i n

T o i l l u s t r a t e t h i s , T i b c o E M S s u p p o r t s a q u e u e pd e f a u l t v a l u e f o r t h i s p r o p e r t y i s 5 , m e a n i n g t h a t a n y g i v e n r e c e

v e m e s s a g e s a t a t i m e . B a s e d o n t h e a m o u n t o f m e a n t h a t i f y o u r M A X _ C O N C U R R E N C Y i s t o m a y r e m a i n i d l e . F o r e x a m p l e , g i v e n t h e d e f a u l E M S ( v e m e s s a g e s p e r r e c e i v e r ) , i f t h e r e w e r e u p o n s u b s c r i p t i o n y o u s p e c i e d a M A X _ C O N C U 4 , t h e n o n l y t h r eo u t o f t h e f o u r a v a i l a b l e r e c e i v e r s w o u l d a c t u a l c o n c u r r e n c y o f t h r e e ) . B e c a u s e t h e f t e e n m e s s ad e f a u l t p r e f e t c h v a l u e o f v e a n d d i s t r i b u t e d e v e t h e f o u r t h w o u l d t h e n b e l e f t i d l e . S e t t i n g a v a l u e 1 f o r t h e q u e u ei n q u e s t i o n w o u l d r e s u l t i n a l l r e c e i v e r s s t a y i n gt y p i c a l l y l a r g e t h e n t h i s m a y m e a n t h a t t h e r e i s a




P A S S W D S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g t o t p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k e s p c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r , o r . m s g . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c e t h au s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a t i o n C r e d e n t i a l s M a p p i n gf o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n t i a lm e s s a g i n g s o f t w a r e a r e u s e d . I f n o s u c h m a p p i n g ic r e d e n t i a l s f o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) m a p p e d c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n . m s g . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . m s g . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n t h e vs e t i n t h e . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y o u d o n o t s p e c i f y a v a l u e f o r t h i s P A S S W D p a r a m

s p e c i f y a p a s s w o r d w h e n c o n n e c t i n g t o t h e M O M .T h i s p a r a m e t e r i s o p t i o n a l .

Q U E U E S p e c i e s t h e L D A P d i s t i n g u i s h e d n a m e o f a n a d m v a l u e c a n b e a n L D A P d i s t i n g u i s h e d n a m e r e l a t i v b a s e U R I o r a f u l l y q u a l i e d L D A P d i s t i n g u i s h e d nt h e c n = ( c o m m o n n a m e a t t r i b u t e ) i s i m p l i c i t i f n o t e x pT h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u s e t h e v a l u e s pc o m . i n f o e n g i n e . m s g . d e f a u l t E x e c u t i o n Q u p r o p e r t y . I f t h e r e i s n o s u c h v a l u e , t h e n t h e Q U E U E p a r a m e t e r m u s t bi s o p t i o n a l .


W H E R E S p e c i e s a p r o p e r l y f o r m a t t e d J M S m e s s a g e s e l e c tJ a v a M e s s a g e S e r v i c e s p e c i c a t i o n , u s e d t o s e l e c t e x e c u t e f r o m t h e s p e c i e d q u e u e . T h e d e f a u l t f o r t ht o a l l m e s s a g e s t h a t a r r i v e i n t h e q u e u e . T h i s p a r a m

E X A M P L E

T h e f o l l o w i n g e x a m p l e r e g i s t e r s a s u b s c r i p t i o n t o l i s

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b / c o r e "

p r e f i x = " i e " % >








T o a c t u a l l y r u n t h i s e x a m p l e y o u w o u l d n e e d t o p q u e u e a n d w h e r e v a r i a b l e s a r e i d e n t i e d .

U n s u b s c r i b e - Q u e u e


U n r e g i s t e r s a n e v e n t h a n d l e r t h a t i s c a l l e d b y t h e m e s s a g e a r r i v e s i n a s p e c i e d q u e u e .


S Y N T A X

 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l G R O U P _ O U T Q U E U E W H E R E S E R V I C E

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e s t a t u s g r o u p t o c r e a t e b e h a v i o r f o r t h i s p a r a m e t e r i s t o c r e a t e a g r o u p T h i s p a r a m e t e r i s o p t i o n a l .

Q U E U E S p e c i e s t h e L D A P d i s t i n g u i s h e d n a m e o f a n av a l u e i s a n L D A P d i s t i n g u i s h e d n a m e r e l a t i v e I f r e l a t i v e , t h e c n = ( c o m m o n n a m e a t t r i b u t e ) i s i m p l i c i ts p e c i e d . T h e d e f a u l t f o r t h i s p a r a m e t e r i s t o u t h e c o m . i n f o e n g i n e . m s g . d e f a u l t E x e c u t i p r o p e r t y . I f t h e r e i s n o s u c h v a l u e , t h e n t h e Q U E U E p a r a m p a r a m e t e r i s o p t i o n a l .




W H E R E S p e c i e s a p r o p e r l y f o r m a t t e d J M S m e s s a g e s e l e c tM e s s a g e S e r v i c e s p e c i c a t i o n , u s e d t o s e l e c t t h e q uf r o m t h e s p e c i e d q u e u e . T h e d e f a u l t f o r t h i s p a r a mq u e u e l i s t e n e r a s s o c i a t e d w i t h n o m e s s a g e s e l e c t o r


E X A M P L E

T h e f o l l o w i n g e x a m p l e c a n c e l s a s u b s c r i p t i o n l i s t e n

< % @ p a g e l a n g u a g e = " j a v a " s e s s i o n = " f a l s e " % > < % @ t a g l i b u r i = " h t t p : / / w w w . p t c . c o m / i n f o e n g i n e / t a g l i b / c o r e "

p r e f i x = " i e " % >

 

T o a c t u a l l y r u n t h i s e x a m p l e y o u w o u l d n e e d t o p r o v q u e u e v a r i a b l e i s i d e n t i e d .

W e b E v e n t S e r v i c e W e b j e c t sT h e f o l l o w i n g W e b E v e n t S e r v i c e ( W E S ) w e b j e c t s c a t h i r d - p a r t y M O M f o r h a n d l i n g I n f o * E n g i n e e v e n t s

• E m i t - E v e n t o n p a g e 4 9 1 • S u b s c r i b e - E v e n t o n p a g e 4 9 7 • U n s u b s c r i b e - E v e n t o n p a g e 5 0 0

A l l W e b E v e n t S e r v i c e w e b j e c t s u s e t h e W E S t y p e a t t r i b u t e v a l u e i n t h e w e b j e c t t a g .

N o t e T h e s e w e b j e c t s c a n b e u s e d o n l y a f t e r y o u r e n v i r o n m et h e W e b E v e n t S e r v i c e .




E m i t - E v e n t


C a u s e s I n f o * E n g i n e t o s e n d a n a m e d e v e n t t h r o u( J M S ) t o b e h a n d l e d b y a n y s u b s c r i b e r s . W h e n t hc o m p l e t e s s u c c e s s f u l l y , a n e m p t y s t a t u s g r o u p w a m e s s a g e s t a t i n g t h a t t h e e v e n t w a s s u c c e s s f u l l yw e b j e c t i s u n s u c c e s s f u l , a n a p p r o p r i a t e e x c e p t i o

S Y N T A X

 

 < i e : p a r a m n a m e = " T I M E _ T O _ L I V E " d a t a = " m i n u t e s " / 

P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l

E V E N T P U T _ B O O L E A N D B U S E R P U T _ B Y T E G R O U P _ I N P U T _ B Y T E S G R O U P _ O U T P U T _ C H A R P A S S W D P U T _ D O U B L E P R I O R I T Y P U T _ F L O A T P R O P E R T Y P U T _ I N T T I M E _ T O _ L I V E P U T _ L O N G S E R V I C E




R e q u i r e d S e l e c t O p t i o n a l

P U T _ S H O R T P U T _ S T R I N G T Y P E

D B U S E R S p e c i e s t h e u s e r n a m e t o u s e w h e n c o n n e c t i n g t o t p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k e s p rc r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r , o r . w e s . u s e r n a m e a n d . j m s . u s e r n a m e p r o p e r t i e s o f t h e s e r v i c e t h au s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a t i o n C r e d e n t i a l s M a p p i n gf o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n t i a l( W E S ) a r e u s e d . I f n o s u c h m a p p i n g i s f o u n d , t h e n f o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) a r e u s e d . I f c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n t h e . w e s . u s e r n a m e p r o p e r t y i s u s e d . I f t h e . w e s . u s e r n a m e p r o p e r t y i s n o t s e t , t h e n t h e v a l u e . j m s . u s e r n a m e p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y i s s es p e c i f y a v a l u e f o r t h i s D B U S E R p a r a m e t e r , I n f o * a u s e r n a m e w h e n c o n n e c t i n g t o t h e M O M , a n d a n ai s a t t e m p t e d .


E V E N T

S p e c i e s t h e L D A P d i s t i n g u i s h e d n a m e o f t h e e v e na n L D A P d i s t i n g u i s h e d n a m e r e l a t i v e t o a c o n g u r< e v e n t _ n a m e > @ < d o m a i n > i s r e c o m m e n d e d t o g i v e a d d i t i o n aa n d a v o i d n a m e c o n i c t s . I f r e l a t i v e , t h e c n = ( c o m m o n n a m e a t t r i b u t e ) i m p l i c i t i f n o t e x p l i c i t l y s p e c i e d .


G R O U P _ I N S p e c i e s t h e n a m e o f a g r o u p t o b e s e n t a l o n g w i t h ts h o u l d o n l y b e s p e c i e d i f t h e T Y P E i s I n f o E n g i n e . I f G R O U P _ I N i s s p e c i e d a n d t h e T Y P E i s s e t t o a d i f f e r e n t v a l u e , t h n o r e d .

M u l t i p l e G R O U P _ I N v a l u e s m a y b e s p e c i e d . A ve n t i r e V D B t o b e s e n t . T h e d e f a u l t f o r t h i s p a r a m e V D B c o l l e c t i o n .


G R O U P _ O U T S p e c i e s t h e n a m e o f t h e s t a t u s g r o u p t o c r e a t e u p o t h i s p a r a m e t e r i s t o c r e a t e a g r o u p n a m e d e m i t - r e s u l t s .





P A S S W D S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r. w e s . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c u s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m as e e C r e d e n t i a l s M a p p i n g o n p a g e 1 1 9 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n( W E S ) a r e u s e d . I f n o s u c h m a p p i n g i s f o u n d , tf o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) a r e u s e dc r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n t h e . w e s . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . w e s . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n t h e v a . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y s p e c i f y a v a l u e f o r t h i s P A S S W D p a r a m e t e r , I n

p a s s w o r d w h e n c o n n e c t i n g t o t h e M O M . T h i s p a r a m e t e r i s o p t i o n a l .

T I M E _ T O _ L I V E S p e c i e s i n m i n u t e s h o w l o n g t h e e v e n t s h o u l d f o r t h i s p a r a m e t e r i s 0 , w h i c h i s a s p e c i a l c a s e i d o e s n o t e x p i r e .


S E R V I C E S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e p r o p e r t yc o n n e c t i v i t y t o a s p e c i c J M S s e r v i c e . T h i s a l l o n e J M S s e r v i c e p e r I n f o * E n g i n e V i r t u a l M a c T h i s p a r a m e t e r i s o p t i o n a l .

P R I O R I T Y S p e c i e s a n i n t e g e r p r i o r i t y t o b e s e t o n t h e o u t r a n g e f o r J M S Q u e u e p r i o r i t i e s i s f r o m 0 – 9 , w P r i o r i t i e s a r e i g n o r e d b y I n f o * E n g i n e , b u t c a n r e c e i v i n g e v e n t s s e n t b y I n f o * E n g i n e . T h i s p a r




P R O P E R T Y S p e c i e s a n a m e a n d v a l u e p a i r t o s e t o n t h e o u t g o i p r o p e r t i e s a r e i g n o r e d b y I n f o * E n g i n e , b u t c a n b e uT h e f o r m a t f o r t h e P R O P E R T Y v a l u e i s n a m e = v a l u e

w h e r e : n a m e — T h e p r o p e r t y n a m e . v a l u e — T h e c o r r e s p o n d i n g v a l u e o f t h e p r o p e r t y .

T h e d e f a u l t b e h a v i o r f o r t h i s p a r a m e t e r i s t o n o t s e o n t h e o u t g o i n g m e s s a g e .


P U T _ B O O L E A N P l a c e s a J a v a B o o l e a n v a l u e i n t o t h e J M S m e s s a g e .a s T r u e o r F a l s e . T h i s p a r a m e t e r c a n o n l y b e u s e d i f t h e Ta s B y t e s M e s s a g e o r M a p M e s s a g e .

P U T _ B Y T E P l a c e s a s i n g l e b y t e i n t o t h e J M S m e s s a g e . T h i s p a t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e o r M a p M e s s a g e .

P U T _ B Y T E S P l a c e s m u l t i p l e b y t e s i n t o t h e J M S m e s s a g e . T h i s pi f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e o r M a p M e s s a g e .

P U T _ C H A R

P l a c e s a s i n g l e J a v a c h a r a c t e r i n t o t h e J M S m e s s a g b e u s e d i f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e o r M a p M e s s a g e .

P U T _ D O U B L E P l a c e s a J a v a d o u b l e v a l u e i n t o t h e J M S m e s s a g e . Tu s e d i f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e o r M a p M e s s a g e .

P U T _ F L O A T P l a c e s a o a t i n g p o i n t n u m b e r i n t o t h e J M S m e s s a g b e u s e d i f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e o r M a p M e s s a g e .

P U T _ I N T P l a c e s a n i n t e g e r i n t o t h e J M S m e s s a g e . T h i s p a r a m

T Y P E i s s p e c i e d a s B y t e s M e s s a g e o r M a p M e s s a g e . P U T _ L O N G

P l a c e s a l o n g i n t e g e r i n t o t h e J M S m e s s a g e . T h i s p t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e o r M a p M e s s a g e .

P U T _ S H O R T P l a c e s a s h o r t i n t e g e r i n t o t h e J M S m e s s a g e . T h i s pi f t h e T Y P E i s s p e c i e d a s B y t e s M e s s a g e o r M a p M e s s a g e .




P U T _ S T R I N G P l a c e s a n i n s t a n c e o f j a v a . l a n g . S t r i n g i n t o t h e J M S m e s s a g e . p a r a m e t e r c a n o n l y b e u s e d i f t h e T Y P E i s s p e c B y t e s M e s s a g e , T e x t M e s s a g e , o r M a p M e s s a g e .




T Y P E S p e c i e s t h e t y p e o f m e s s a g e t o b e s e n t b y s e l e c t i n g e n e r a t e t h e o u t g o i n g m e s s a g e . M e s s a g e t y p e s a r e

T h e d e f a u l t v a l u e f o r t h i s p a r a m e t e r i s I n f o E n g i n e , w h i c h m e a n s t h a t a n I n f o * E n g i n e r e q u e s t i s s e r i a l i z e d a n d p l a c e d i n t h ec a s e c a n m e a n a c t u a l J a v a s e r i a l i z a t i o n o r s e r i a l i z ar e q u e s t t o X M L ( t h i s i s t h e c a s e w h e n B L O B d a t a n

P o s s i b l e m e s s a g e t y p e s a r e :

• I n f o E n g i n e — U s e d f o r I n f o * E n g i n e t o I n f o * E n g i n e c g r o u p s s e r i a l i z e d a r e g o v e r n e d b y t h e G R O U P _ I

• B y t e s M e s s a g e — F o r o u t g o i n g m e s s a g e s , t h i s t y p e s u p pP U T _ t y p e p a r a m e t e r s f o r b u i l d i n g a m e s s a g e t h at h i r d - p a r t y r e c i p i e n t . I n c o m i n g m e s s a g e s a r e p r oa s U n k n o w n . T h e c o n t e n t s o f a B y t e s M e s s a g e i s s u p p l i e d a s B L O B d a o n a n i n p u t s t r e a m t o t h e c a l l i n g t a s k .

• T e x t M e s s a g e — S u p p o r t s o n l y a P U T _ S T R I N G p a r a m P U T _ S T R I N G p a r a m e t e r v a l u e s a r e c o n c a t e n a t o u t g o i n g T e x t M e s s a g e .

• M a p M e s s a g e — F o r o u t g o i n g m e s s a g e s , t h i s t y p e s u p p P U T _ t y p e p a r a m e t e r s w i t h v a l u e s i n t h e f o r m o f n a m e = d a t a , w h e r e n a m e i s t h e k e y u s e d t o p l a c e d a t a i n t h e M a p M e s s a g e .

• U n k n o w n — T u r n s B L O B d a t a i n t o a B y t e s M e s s a g e . F o r i n c o m i n g m e s s a g e s , a n e w , e m p t y I n f o * E n g i n e r e q u e s t i s ct h e m e s s a g e a r e a t t a c h e d a s B L O B d a t a .

T h e f o l l o w i n g t a b l e i n d i c a t e s w h i c h P U T _ t y p e p a w i t h w h i c h m e s s a g e t y p e s :

B y t e s M e s s a g e T e x t M e s s a g e P U T _ B O O L E A N X X P U T _ B Y T E X X P U T _ B Y T E S X X P U T _ C H A R X X P U T _ D O U B L E X X P U T _ F L O A T X X P U T _ I N T X X P U T _ L O N G X X P U T _ S H O R T X X P U T _ S T R I N G X X X

N o t e S u p p o r t f o r t h e t y p e S T R I N G i n B y t e s M e s s a g e a c t u a l l y c a u s e s t h e v a l u e o s t r i n g t o b e w r i t t e n a s a b y t e a r r a y ; i t i s n o t a c t u a l l y




E X A M P L E

T h e f o l l o w i n g e x a m p l e e m i t s a s p e c i e d e v e n t t o


p r e f i x = " i e " % >

 < i e : p a r a m n a m e = " D B U S E R " d a t a = " $ ( @ F O R M [ ] d b u s< i e : p a r a m n a m e = " P A S S W D " d a t a = " $ ( @ F O R M [ ] p a s s< i e : p a r a m n a m e = " G R O U P _ I N " d a t a = " $ ( @ F O R M [ ] g r< i e : p a r a m n a m e = " G R O U P _ O U T " d a t a = " $ ( @ F O R M [ ] 

T o a c t u a l l y r u n t h i s e x a m p l e , y o u n e e d t o p r o v i d P A S S W D , G R O U P _ I N , G R O U P _ O U T , E V E N i d e n t i e d .

S u b s c r i b e - E v e n t


C a u s e s t h e I n f o * E n g i n e p r o c e s s w h e r e t h i s w e b jt o l i s t e n f o r a p a r t i c u l a r e v e n t . W h e n a n e v e n t i s a n e x e c u t i o n e n v i r o n m e n t f r o m t h e r e q u e s t o r a vc o n g u r e d t a s k . W h e n t h e e x e c u t i o n o f t h e w e b j e m p t y s t a t u s g r o u p w i t h t h e s t a t u s o f 0 i s r e t u r n e s u c c e s s f u l s u b s c r i p t i o n t o t h e e v e n t . I f t h e e x e c uu n s u c c e s s f u l l y , a n a p p r o p r i a t e e x c e p t i o n i s t h r o

S Y N T A X

 < i e : p a r a m n a m e = " E X E C U T E _ T A S K " d a t a = " t a s k _ n a m e< i e : p a r a m n a m e = " F A I L U R E _ T A S K " d a t a = " t a s k _ n a m e 






P A R A M E T E R S

R e q u i r e d S e l e c t O p t i o n a l E V E N T D B U S E R E X E C U T E _ T A S K G R O U P _ O U T F A I L U R E _ T A S K P A S S W D G R O U P _ I N S E R V I C E

D B U S E R S p e c i e s t h e u s e r n a m e t o u s e w h e n c o n n e c t i n g t o t p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k e s p rc r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r , o r . w e s . u s e r n a m e a n d . j m s . u s e r n a m e p r o p e r t i e s o f t h e s e r v i c e t h au s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a t i o n C r e d e n t i a l s M a p p i n g

f o r M O M s o n p a g e 1 2 5 . I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n t i a l( W E S ) a r e u s e d . I f n o s u c h m a p p i n g i s f o u n d , t h e n f o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) a r e u s e d . I f c r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n t h e . w e s . u s e r n a m e p r o p e r t y i s u s e d . I f t h e . w e s . u s e r n a m e p r o p e r t y i s n o t s e t , t h e n t h e v a l u e . j m s . u s e r n a m e p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y i s s es p e c i f y a v a l u e f o r t h i s D B U S E R p a r a m e t e r , I n f o * a u s e r n a m e w h e n c o n n e c t i n g t o t h e M O M , a n d a n ai s a t t e m p t e d .


E V E N T I n d i c a t e s t h e L D A P d i s t i n g u i s h e d n a m e o f t h e e v e v a l u e i s a n L D A P d i s t i n g u i s h e d n a m e r e l a t i v e t o a s y n t a x o f < e v e n t _ n a m e > @ < d o m a i n > i s r e c o m m e n d e d t o g i v e a d d im e a n i n g a n d a v o i d n a m e c o n i c t s . I f r e l a t i v e , t h e c n = ( c o m m o n n a m e a t t r i b u t e ) i s i m p l i c i t i f n o t e x p l i c i t l y s p e c i e d .

T h i s p a r a m e t e r i s r e q u i r e d i f G R O U P _ I N i s n o t s u p

E X E C U T E _ T A S K I n d i c a t e s t h e t a s k t o b e e x e c u t e d u p o n e v e n t n o t i cr e q u i r e d i f G R O U P _ I N i s n o t s u p p l i e d .

F A I L U R E _ T A S K I n d i c a t e s t h e t a s k t o b e e x e c u t e d i f E X E C U T E _ T A p a r a m e t e r c a n o n l y b e s p e c i e d i f G R O U P _ I N i s n f o r t h i s p a r a m e t e r i s t o l o g t h e e r r o r .




G R O U P _ I N S p e c i e s t h e n a m e o f a g r o u p f r o m w h i c h t o e x t ra n d F A I L U R E _ T A S K . T h e g r o u p m u s t h a v e Ec o l u m n s . I t c a n a l s o h a v e a F A I L U R E _ T A S K f o r e a c h r o w i n t h e i n p u t g r o u p . T h i s p a r a m e t e E X E C U T E _ T A S K a r e n o t s p e c i e d .

G R O U P _ O U T S p e c i e s t h e n a m e o f t h e s t a t u s g r o u p t o b e c r e af o r t h i s p a r a m e t e r i s t o c r e a t e a g r o u p n a m e d s u b s c r i p t i o n - r e s u l . T h i s p a r a m e t e r i s o p t i o n a l .

P A S S W D S p e c i e s t h e p a s s w o r d t o u s e w h e n c o n n e c t i n g p a r a m e t e r i s s p e c i e d , t h e p a r a m e t e r v a l u e t a k c r e d e n t i a l s m a p p i n g f o r t h e a u t h e n t i c a t e d u s e r. w e s . p a s s w o r d a n d . j m s . p a s s w o r d p r o p e r t i e s o f t h e s e r v i c u s e d t o c o n n e c t t o t h e M O M . F o r m o r e i n f o r m a C r e d e n t i a l s M a p pf o r M O M s o n p a g e 1 2 5 .

I f t h i s p a r a m e t e r i s o m i t t e d , t h e m a p p e d c r e d e n( W E S ) a r e u s e d . I f n o s u c h m a p p i n g i s f o u n d , tf o r t h e J a v a M e s s a g i n g S e r v i c e ( J M S ) a r e u s e dc r e d e n t i a l s a r e f o u n d , t h e n t h e v a l u e s e t i n t h e . w e s . p a s s w o r d p r o p e r t y i s u s e d . I f t h e . w e s . p a s s w o r d p r o p e r t y i s n o t s e t , t h e n t h e v a . j m s . p a s s w o r d p r o p e r t y i s u s e d . I f n e i t h e r p r o p e r t y s p e c i f y a v a l u e f o r t h i s P A S S W D p a r a m e t e r , I n p a s s w o r d w h e n c o n n e c t i n g t o t h e M O M .


S E R V I C E S p e c i e s t h e n a m e o f t h e I n f o * E n g i n e p r o p e r t yc o n n e c t i v i t y t o a s p e c i c J M S s e r v i c e . T h i s a l l o n e J M S s e r v i c e p e r I n f o * E n g i n e V i r t u a l M a c h i n e ( V M ) .


E X A M P L E

T h e f o l l o w i n g e x a m p l e s u b s c r i b e s t h e c u r r e n t I n e v e n t :


p r e f i x = " i e " % >

< i e : p a r a m n a m e = " D B U S E R " d a t a = " $ ( @ F O R M [ ] d b u s< i e : p a r a m n a m e = " P A S S W D " d a t a = " $ ( @ F O R M [ ] p a s s< i e : p a r a m n a m e = " E V E N T " d a t a = " $ ( @ F O R M [ ] e v e n t






T o a c t u a l l y r u n t h i s e x a m p l e , y o u n e e d t o p r o v i d e a f P A S S W D , E V E N T , G R O U P _ I N , a n d G R O U P _ O U

U n s u b s c r i b e - E v e n t


C a u s e s I n f o * E n g i n e t o c e a s e l i s t e n i n g f o r a p a r t i c u l am o n i t o r e d . W h e n t h e e x e c u t i o n o f t h e w e b j e c t c o m ps t a t u s g r o u p w i t h t h e s t a t u s o f 0 i s r e t u r n e d w i t h a m eu n s u b s c r i p t i o n f r o m t h e e v e n t . I f t h e e x e c u t i o n o f t hu n s u c c e s s f u l l y , a n a p p r o p r i a t e e x c e p t i o n i s t h r o w n .

S Y N T A X

Documents

Info Engine Users Guide