Utilisation des pages de portail et des autres ressources

L'exercice suivant vous montre certaines étapes d'utilisation des ressources de portail, telles que les pages et les portlets, de recherche de ressources et d'informations sur ces ressources et d'ajout d'un portlet à une page.

Pourquoi et quand exécuter cette tâche

Recherche d'une page de portail :

Recherchez la page Mise en route. Entrez la commande suivante et indiquez le nom unique de la page :

wsadmin>Content.find("page", "un", "ibm.portal.Home.Getting Started")

S'il existe une page possédant le nom unique spécifié, l'interface de script du portail renvoie l'ID objet de la page, comme suit :

wsadmin>Content.find("page", "un", "ibm.portal.Home.Getting Started")
   'Z6_CGAH47L00OJCC0I6U1NESJ2GK0'

Si vous ne savez pas si la ressource est une page ou un libellé, vous pouvez spécifier le type n'importe lequel au lieu de page. Dans ce cas, vous obtenez la réponse suivante :

wsadmin>Content.find("any", "un", "ibm.portal.Home.Getting Started")
   'Z6_CGAH47L00OJCC0I6U1NESJ2GK0'

Pour en savoir plus sur les différentes manières de rechercher des ressources de portail, utilisez la commande help() fournie par l'interface de script du portail pour chaque commande. Pour obtenir un exemple, reportez-vous à la section sur l'obtention d'aide pour une commande.

Recherche d'informations sur une page de portail :

Pour afficher des informations standard sur une ressource de portail, utilisez la commande details(). Vous devez spécifier la ressource sur laquelle vous souhaitez obtenir des informations plus détaillées. L'exemple suivant peut être la page Mise en route :

wsadmin>Content.find("page", "un", "ibm.portal.Home.Getting Started", "select")
'Z6_CGAH47L00OJCC0I6U1NESJ2GK0'
wsadmin>Content.details()

La réponse suivante est renvoyée :

wsadmin>Content.find("page", "un", "ibm.portal.Home.Getting Started", "select")
'Z6_CGAH47L00OJCC0I6U1NESJ2GK0'
wsadmin>Content.details()
name: ibm.portal.Home.Getting_Started
id  :Z6_CGAH47L00OJCC0I6U1NESJ2GK0
type: staticpage      
      no children

Pour rechercher des informations sur une ressource de portail, vous devez spécifier cette ressource. Si vous ne spécifiez pas la ressource, par exemple en entrant uniquement wsadmin>Content.details(), vous obtenez une réponse telle que la suivante :

WASX7015E: Exception running command: "Content.details()"; exception information: 
   com.ibm.bsf.BSFException: exception from Jython:
Traceback (innermost last):  
   File "<input>", line 1, in ?
EJPXD0020W: No object has been selected.

Voici quelques exemples de demande d'informations sur une page de portail :

wsadmin>Content.get("type")
   'staticpage'
wsadmin>Content.get("uniquename")
   'ibm.portal.Home.Getting Started'
wsadmin>Content.get("allportlets")
   'true'
wsadmin>Content.nlsget("title", "en")
   'Getting Started'
wsadmin>Content.parmget("com.ibm.portal.bookmarkable")
   'Yes'

L'exemple suivant montre la hiérarchie d'une page :

wsadmin>Content.path()'Z6_000000000000000000000000A0 Z6_CGAH47L00GS790I6U1M1F020A3 Z6_CGAH47L00OJCC0I6U1NESJ2GK0'

Cette commande renvoie une "liste" des ID objet des noeuds entre le noeud racine et votre noeud sélectionné. Comme vous pouvez le constater, il ne s'agit pas d'une véritable liste au sens Jython, mais d'une chaîne d'entrées séparées par des espaces. Pour obtenir une liste plus lisible, utilisez la commande split(), comme illustré dans l'exemple suivant :

wsadmin>for id in Content.path().split():
wsadmin>  Content.get(id, "un")
wsadmin>
'wps.content.root'
'ibm.portal.Home'
'ibm.portal.Home.Getting Started'

A l'aide de cette simple boucle, vous pouvez imprimer l'intégralité de la hiérarchie des noeuds jusqu'à la page 'Getting Started' actuellement sélectionnée.

Création d'une page :

Pour créer une page en tant que page enfant de la page actuellement sélectionnée, utilisez la commande suivante :

wsadmin>Content.create("page", "Title of my first page", "html", "select")'
Z6_CGAH47L0082M00I6T9E0NL3001'

Cette commande crée une page pour le marquage HTML et renvoie son ID objet de portail. Vous pouvez maintenant commencer à ajouter des attributs ou des métadonnées à la page.

Ajout d'un portlet à une page :

Pour ajouter un portlet à la page créée précédemment, utilisez la commande suivante :

wsadmin> myportlet = Portlet.find("portlet", "un", "wps.p.Information")
wsadmin> Layout.create("container", "horizontal", "select")'
Z7_CGAH47L008C970I6NA7U4300G2'
wsadmin> Layout.create("portlet", myportlet)'
Z7_CGAH47L008C970I6NA7U4300G1'

Ce code ajoute le portlet Information à la page et le place dans un conteneur horizontal.