WebSphere Portal et HATS

IBM® WebSphere Portal constitue un point d'accès unique à du contenu et des applications Web, personnalisés en fonction des besoins de chaque utilisateur.

Grâce à l'intégration de HATS et de WebSphere Portal, les données circulent librement entre HATS, WebSphere Portal et les autres applications de type Portal. Par ailleurs, toutes les fonctions appropriées de WebSphere Portal peuvent être utilisées dans HATS par le biais d'outils intégrés et d'un développement Java™ facile à mettre en oeuvre. Lorsque HATS est exécuté dans l'environnement WebSphere Portal, la plupart de ses fonctions sont préservées. Pour plus d'informations, voir Considérations et restrictions relatives aux portlets HATS.

Désormais, les applications HATS peuvent être exécutées directement dans WebSphere Portal en tant que portlets, ce qui permet une interaction directe entre WebSphere Portal et HATS. Vous pouvez développer des portlets HATS conformes à l'API de portlet IBM ou à la spécification d'API de portlet standard Java (JSR 168).

Remarque :
Dans ce document, les portlets HATS conformes à l'API de portlet standard (JSR 168) sont appelées portlets standard.

Les classes Business Logic de HATS peuvent utiliser les interfaces API WebSphere Portal, tandis que les JSP HATS peuvent inclure les bibliothèques de balises JSP de WebSphere Portal. Pour plus d'informations sur la programmation des portlets et sur les fonctions de portail évoluées, voir HATS Web Application Programmer's Guide.

Un projet de portlet HATS est destiné aux applications orientées transformation. Pour savoir comment adapter les applications basées sur des objets d'intégration de modèle 1 afin qu'elles puissent s'exécuter dans WebSphere Portal, voir HATS Web Application Programmer's Guide. Pour savoir comment convertir des applications fondées sur des objets d'intégration Struts afin qu'elles s'exécutent dans WebSphere Portal, consultez le centre de documentation WebSphere Portal, à l'adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp, puis recherchez Struts.

Pour un complément d'informations sur les outils Portal, sélectionnez le menu Aide dans la barre d'outils Rational SDP et sélectionnez Sommaire de l'aide. Dans la partie gauche, cliquez sur la rubrique relative au développement des applications de portail ou de portlet pour accéder à la documentation destinée aux développeurs de portlets.

Création de portlets HATS

Un portlet HATS peut être créé de deux façons :

Création d'un nouveau projet de portlet HATS

Pour créer un nouveau projet de portlet HATS, lancez l'assistant de création de projet en utilisant l'une des actions suivantes :

Dans le panneau Projet HATS de l'assistant de création de projet :

  1. Entrez un nom projet de type portlet.
  2. Vous pouvez éventuellement entrer une description.
  3. Acceptez l'emplacement par défaut.
  4. Sélectionnez Web pour indiquer qu'il s'agit d'un projet Web.
    Remarque :
    Si l'option de déploiement Web est désactivée, cela signifie qu'aucun environnement d'exécution serveur n'est défini. Pour définir des environnements d'exécution de serveur, accédez à Fenêtre > Préférences > Serveur > Environnements d'exécution et ajoutez au moins une définition d'environnement d'exécution.
  5. Pour la zone Serveur cible, sélectionnez l'un des serveurs WebSphere Portal pris en charge, WebSphere Portal v6.0 ou WebSphere Portal v6.1.
    Remarques :
    1. En général, les portlets ciblés pour WebSphere Portal v6.0 peuvent être déployés et s'exécutent surWebSphere Portal v6.1. Pour plus d'informations, voir le centre de documentation WebSphere Portal à l'adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp, puis recherchez Planification de migration.
    2. Les portlets standard ciblés pour WebSphere Portal V6.0 ou V6.1 peuvent également s'exécuter sur WebSphere Application Server V6.1 ou V7.0.
  6. Pour la zone Projet d'application d'entreprise, entrez le nom du projet EAR à utiliser pour effectuer des tests dans l'environnement de test local.
    Remarque :
    Les projets de type portlet standard et de type portlet IBM peuvent être ajoutés à ce projet EAR.
  7. Pour la zone Portlet API, sélectionnez Portlet JSR 168 ou Portlet IBM pour indiquer l'API à laquelle ce portlet est conforme.
    Remarque :
    Si Portlet IBM est sélectionné, un message d'avertissement s'affiche, indiquant que cette API est obsolète.
  8. Indiquez si les fichiers de support de console d'administration doivent être inclus.
    Remarque :
    Cette option n'est pas prise en charge pour les portlets HATS standard.
  9. Cliquez sur Suivant et continuez de créer votre projet.

Vous générez ainsi un projet de type portlet HATS comprenant un projet EAR pouvant être utilisé à des fins de test dans un environnement de test local.

Génération de portlets à partir de projets Web HATS

Pour qu'un projet Web HATS existant puisse s'exécuter en tant que portlet, il est nécessaire de modifier sa structure et son contenu afin qu'il soit conforme à la spécification du portlet. HATS Toolkit automatise le processus de conversion d'un projet Web HATS standard en portlet. La fonction Outils de WebSphere Portal de Rational SDP est nécessaire pour ce processus de conversion.

Pour générer un projet de type portlet HATS à partir d'un projet Web HATS existant, cliquez sur le projet Web avec le bouton droit de la souris dans la vue Projets HATS et sélectionnez Générer un projet de type portlet.

Dans le panneau Options de génération de projet de type portlet de l'assistant Générer un projet de type portlet :

  1. Entrez un nom projet de type portlet.
  2. Pour la zone Serveur cible, sélectionnez le serveur WebSphere Portal cible, WebSphere Portal v6.0 ou WebSphere Portal v6.1.
    Remarques :
    1. Pour générer un projet de portlet HATS à partir d'un projet Web HATS, le serveur cible du projet Web détermine les options du serveur cible du projet de portlet. Si le serveur cible du projet Web est WebSphere Application Server v6.0, les options de serveur cible pour le projet de portlet généré sont WebSphere Portal v6.0 ou v6.1. Si le serveur cible du projet Web est WebSphere Application Server v6.1, l'option de serveur cible pour le portlet généré est WebSphere Portal v6.1. Si le serveur cible du projet Web est WebSphere Application Server v7.0, il n'y a pas d'option pour générer un portlet.
    2. En général, les portlets ciblés pour WebSphere Portal v6.0 peuvent être déployés et s'exécutent surWebSphere Portal v6.1. Pour plus d'informations, voir le centre de documentation WebSphere Portal à l'adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp, puis recherchez Planification de migration.
    3. Les portlets standard ciblés pourWebSphere Portal V6.0 ou V6.1 peuvent également s'exécuter sur WebSphere Application Server V6.1 ou V7.0.
  3. Pour la zone Projet d'application d'entreprise, entrez le nom du projet EAR à utiliser pour effectuer des tests dans l'environnement de test local.
    Remarque :
    Les projets de type portlet standard et de type portlet IBM peuvent être ajoutés à ce projet EAR.
  4. Pour la zone Portlet API, sélectionnez Portlet JSR 168 ou Portlet IBM pour indiquer l'API à laquelle ce portlet est conforme.
    Remarque :
    Si Portlet IBM est sélectionné, un message d'avertissement s'affiche, indiquant que cette API est obsolète.
  5. Sélectionnez le type de fichier à convertir automatiquement dans la liste :
  6. Cliquez sur Fin.

Un projet de type portlet HATS est alors créé à partir du projet Web sélectionné. Ce portlet peut être personnalisé. Pour plus d'informations sur la modification de projets HATS, voir Modification d'un projet HATS.

Remarques :
  1. Si vous convertissez un projet Web HATS en un projet HATS de type portlet, vous devrez peut-être modifier manuellement le fichier de configuration de Web Express Logon (WEL) (hatswelcfg.xml) si les modules d'extension configurés pour le projet Web ne sont pas pris en charge par le projet de type portlet. Il est recommandé d'ajouter les modules d'extension pris en charge à l'aide de l'interface utilisateur de configuration de WEL, afin que le fichier de configuration de WEL (hatswelcfg.xml) soit mis à jour correctement.
  2. Une fois le projet de portlet HATS généré à partir d'un projet Web HATS, les modifications apportées à un projet ne sont pas répercutées dans l'autre projet. Si vous souhaitez adopter les modifications apportées au projet Web HATS de base, vous pouvez générer un nouveau projet de portlet HATS à partir du projet modifié.
  3. Un projet de type portlet HATS ne peut pas être reconverti en projet Web HATS standard.
  4. Si vous disposez d'une application HATS V4, V5, V6, V7.0 ou V7.1, vous devez la faire migrer vers HATS V7.5.1 avant de générer un projet de type portlet. Pour plus d'informations sur la migration vers HATS V7.5.1, voir Migration vers HATS V7.5.1.

Migration de portlets IBM vers des portlets standard

La migration d'un portlet IBM HATS vers un portlet HATS standard doit être effectuée manuellement. Pour cela, procédez comme suit :

  1. Migration des valeurs de projet.
  2. Migration des fichiers descripteur de déploiement Web et de portlet.
  3. Migration de transformations, de modèles et de gestionnaires de macro.
  4. Migration de fichiers spécifiques à HATS.
  5. Migration de fonctions supplémentaires associées au portail (en option).

Migration des valeurs de projet

  1. Si incluse, supprimez la facette Struts étant donné que les portlets HATS standard ne prennent pas en charge cette valeur.
    1. Dans la vue Projets HATS, cliquez avec le bouton droit de la souris sur le projet de type portlet et sélectionnez Propriétés.
    2. Sur la page Propriétés, sélectionnez Valeurs de projets.
    3. Si elle est sélectionnée, désélectionnez la case à cocher de Struts for IBM portlets.
    4. Cliquez sur OK.
  2. Remplacez la valeur de la zone Portlets IBM par celle de la zone Portlets JSR.
    1. Dans la vue Projets HATS, cliquez avec le bouton droit de la souris sur le projet de type portlet et sélectionnez Propriétés.
    2. Sur la page Propriétés, sélectionnez Valeurs de projets.
    3. Décochez la case Portlets IBM et sélectionnez Portlets JSR. Dans la colonne Version, vérifiez que la valeur 1.0 est affichée. Dans le cas contraire, cliquez sur le bouton de liste déroulante situé à côté du numéro de version et sélectionnez 1.0.
    4. Cliquez sur OK.

Migration des fichiers descripteur de déploiement Web et de portlet

  1. Dans la vue Navigateur, modifiez le descripteur de déploiement Web (Web Content/WEB-INF/web.xml), puis procédez comme suit :
    1. Dans l'onglet Servlets, supprimez les servlets et mappages votre_portlet et HATSAdminServlet (le cas échéant).
    2. Dans l'onglet Variables de la section Références de la bibliothèque de balises, supprimez la référence de bibliothèque de balises admin.tld (le cas échéant).
    3. Dans ce même onglet de la section Références de la bibliothèque de balises, ajoutez une référence de bibliothèque de balises std-portlet.tld à l'aide des paramètres suivants :
      URL: http://java.sun.com/portlet
      Location: /WEB-INF/tld/std-portlet.tld	
  2. Dans la vue Navigateur, modifiez le descripteur de déploiement de portlet (Web Content/WEB-INF/portlet.xml), puis procédez comme suit :
    1. Migrez vers un descripteur de déploiement de portlet compatible avec les portlets standard. Pour savoir comment effectuer la migration, voir la section Migration depuis l'API de portlet IBM, dans le centre de documentation WebSphere Portal à l'adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.
    2. Supprimez EntryPortlet (le portlet) et toutes les références s'y rapportant dans le descripteur de déploiement de portlet.
    3. Ajoutez Jsr168EntryPortlet au descripteur de déploiement de portlet. Voir le descripteur de déploiement de portlet dans un modèle de portlet HATS JSR 168.

Migration de transformations, de modèles et de gestionnaires de macro

Dans la vue Projets HATS, modifiez tous les fichiers JSP associés aux transformations, aux modèles et aux gestionnaires de macro. Dans l'onglet Source :

  1. Ajoutez le code suivant :
  2. Convertissez response.encodeUrl("...") en renderResponse.encodeUrl(renderRequest.getContextPath()+"...").
  3. Convertissez toutes les instances de request en renderRequest.

Migration des fichiers spécifiques à HATS

  1. Importez tous les fichiers du dossier<répertoire_installation_partagé>\plugins\com.ibm.hats_nnn\predefined\ projects\portlet\jsr dans leurs dossiers respectifs dans le projet de type portlet (où répertoire_installation_partagé correspond au répertoire de ressources partagées dans lequel l'offre HATS a été installée à l'aide d'IBM Installation Manager et nnn représente la version et le niveau de compilation de HATS).
  2. Dans la vue Navigateur, supprimez les fichiers et dossiers ci-après, le cas échéant :
    1. Les fichiers HATSApplet.cab et HATSApplet.jar dans le dossier Contenu Web.
    2. Le dossier hatsadmin figurant dans le dossier Contenu Web.
    3. Le fichier hatsadmin.tld dans le dossier Contenu Web/WEB-INF/tld.

Migration de fonctions supplémentaires

  1. Si vous utilisez Web Express Logon (WEL), vous devrez peut-être modifier les classes de module d'extension WEL, car certaines classes de module d'extension sont différentes pour les portlets IBM et pour les portlets standard.

    Par exemple, les classes de module d'extension WEL suivantes sont utilisées dans les portlets IBM :

    Les classes de module d'extension WEL suivantes sont utilisées dans les portlets standard :

  2. Si vous implémentez un coffre d'accréditation dans votre collection de portlets, vous devez migrer le code permettant d'accéder au service de coffre d'accréditation. Pour plus d'informations, voir la section Authentification de portlets, dans le centre de documentation WebSphere Portal à l'adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.
  3. Si vous implémentez la communication entre portlets, vous devez convertir le mécanisme de communication utilisé. Pour plus d'informations, voir Communication entre portlets.

Utilisation des portlets HATS

Un projet de type portlet HATS demeure un projet HATS. Vous pouvez donc le gérer avec l'ensemble des éditeurs et des assistants HATS. Mais il s'agit aussi d'un portlet. Il est donc pris en charge par tous les éditeurs du kit d'outils WebSphere Portal et par la configuration d'exécution. Dans l'arborescence, un projet de type portlet HATS est identifié par une icône différente icône de dossier de portlet.

Remplacement de paramètres de connexion et de variables globales

Vous pouvez autoriser le remplacement des paramètres de connexion et des variables globales de vos portlets en personnalisant les paramètres du projet. Pour plus d'informations, voir Remplacement de paramètres de connexion et Remplacement de variables globales.

Portlets IBM

Pour les portlets IBM HATS, si vous autorisez les remplacements dans les paramètres du projet, le remplacement peut être effectué en étendant la classe EntryPortlet et en substituant la méthode doView(). Pour plus d'informations sur l'extension de la classe EntryPortlet, voir HATS Web Application Programmer's Guide.

Portlets standard

Pour les portlets HATS standard, si vous autorisez les remplacements dans les paramètres du projet, l'utilisateur peut alors remplacer les paramètres de connexion et les variables globales en basculant dans le mode édition dans la barre d'outils du portlet. Pour WebSphere Portal V6.0 et V6.1, sélectionnez Personnaliser dans le menu du portlet de la barre d'outils.

Remarque :
HATS ne prend pas en charge le mode édition du portlet sur WebSphere Application Server V6.1 ou V7.0. Si vous déployez votre portlet HATS standard afin qu'il s'exécute directement dans WebSphere Application Server V6.1 ou V7.0, l'utilisateur peut remplacer les paramètres de connexion et les variables globales dans l'URL permettant d'accéder au portlet plutôt que d'utiliser le mode édition du portlet.

Si ce mode est utilisé, une page de paramètres s'affiche pour l'utilisateur. Cette page permet à l'utilisateur de remplacer les paramètres de connexion et les paramètres de valeur globale. Ces fonctions sont équivalentes aux fonctions HATS pour les applications Web permettant à l'utilisateur de remplacer les paramètres au moyen de l'URL lorsque l'utilisateur accède pour la première fois à l'application.

Sur la page Paramètres, dans la section Paramètre de connexion, le menu déroulant correspondant répertorie les paramètres de session Host On-Demand qui vous permettent d'effectuer des substitutions dans les paramètres du projet. L'utilisateur définit une valeur de substitution en sélectionnant un paramètre dans la liste déroulante, en entrant une valeur dans la zone Valeur, puis en cliquant sur Ajouter. Par défaut, le paramètre peut être modifié lorsqu'il est ajouté à l'origine. Il peut être désactivé en sélectionnant false dans la liste déroulante Activé. Une substitution peut être désactivée en sélectionnant la case en regard du nom du paramètre et en cliquant sur Supprimer.

Dans la section Variable globale, l'utilisateur définit une valeur de substitution en entrant un nom et une valeur de variable globale, puis en cliquant sur Ajouter. Une fois la valeur de substitution ajoutée, la variable globale peut être identifiée comme étant une variable globale partagée en sélectionnant true dans le menu déroulant Partagé. Par défaut, le paramètre peut être modifié lorsqu'il est ajouté à l'origine. Il peut être désactivé en sélectionnant false dans la liste déroulante Activé. Une valeur de substitution peut être supprimée en sélectionnant la case en regard du nom de variable globale et en cliquant sur Supprimer.

Lorsque l'utilisateur clique sur Sauvegarder et quitter, les paramètres sont enregistrés dans les préférences du portlet.

Remarques :
  1. Les valeurs entrées par l'utilisateur ne sont pas validées.
  2. L'utilisateur doit se déconnecter et redémarrer la collection de portlets afin que les nouvelles valeurs soient applicables.

En plus d'autoriser les utilisateurs à définir des valeurs de substitution, vous pouvez fournir des substitutions de paramètre de connexion et de variable globale à l'aide d'un programme en étendant le portlet JSR 168. Pour plus d'informations, voir la section Extending the Entry portlet du manuel HATS Web Application Programmer's Guide

Remarque :
Si vous fournissez des substitutions de paramètre de connexion ou de variable globale via la classe de portlet étendue et que l'utilisateur fournit la même valeur de substitution via le mode édition de portlet, les valeurs fournies par l'utilisateur dans le mode édition remplacent les valeurs fournies dans la classe de portlet étendue.

.

Communication entre portlets

WebSphere Portal prend en charge différents modes d'échange et de partage d'informations entre les portlets. Pour plus d'informations, voir la section Communication de portlet, dans le centre de documentation WebSphere Portal à l'adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.

Cette section présente la prise en charge de la communication entre les portlets WebSphere Portal dans HATS.

Portlets IBM

Les portlets IBM IBM prennent en charge l'implémentation Click-to-Action pour fournir une solution de communication entre portlets. Pour plus d'informations, voir la section Portlets coopératifs du HATS Web Application Programmer's Guide

Portlets standard

La prise en charge des portlets HATS standard (JSR 168) utilise le mécanisme de portlets coopératifs de WebSphere afin de fournir une solution de communication entre portlets.

Les portlets JSR 168 communiquent entre eux par le biais de propriétés. Un portlet HATS JSR 168 est capable d'envoyer et de recevoir des propriétés d'autres portlets JSR 168 (HATS ou non HATS). Les portlets doivent être connectés entre eux afin que la communication soit possible.

Envoi d'une propriété à partir d'un portlet HATS JSR 168
  1. Créez une variable globale contenant la valeur de la propriété à envoyer. Pour ce faire, vous pouvez exécuter une action Extraction d'une variable globale ou une action Définition d'une variable globale. Seules les variables globales pouvant contenir zéro ou plusieurs chaînes sont utilisées pour la communication entre les portlets JSR 168. Les variables globales peuvent être considérées comme des encapsuleurs pour les valeurs des propriétés JSR 168.
  2. Ajoutez une action Envoyer une variable globale à un événement d'écran HATS ou à un événement d'écran sans correspondance pour envoyer la valeur de la variable globale en tant que propriété. Pour savoir comment procéder, voir Action Envoyer une variable globale.

    Cette action peut être utilisée en association avec une action Extraction d'une variable globale pour envoyer des données entrées par l'utilisateur d'un portlet à l'autre. Par exemple, vous pouvez ajouter une action Extraction d'une variable globale entre les actions Appliquer la transformation et Envoyer une variable globale afin de capturer les données entrées par l'utilisateur et les envoyer vers d'autres portlets.

  3. Si l'utilisateur exécute l'action Envoi de la variable globale lorsque le projet de type portlet HATS JSR 168 est en cours d'exécution, le nom de la propriété et la chaîne contenue dans la variable globale spécifiée sont transmis à WebSphere Portal, qui demande alors aux autres portlets connectés à ce portlet HATS JSR 168 de recevoir la propriété.
Réception d'une propriété par un portlet HATS JSR 168
  1. Utilisez les paramètres de portlet pour définir les noms des propriétés ainsi que les variables globales associées qui contiendront les valeurs des propriétés, pouvant être reçus par ce portlet. Pour accéder aux paramètres de portlet, dans l'éditeur des paramètres de projet, cliquez sur l'onglet Autre, puis sur Portlet. Pour plus d'instructions, voir Paramètres de portlet.
  2. Lorsque WebSphere Portal reçoit une propriété de la part d'un portlet source, le portlet cible en est informé. Le service d'exécution du portlet HATS JSR 168 récupère la valeur de la propriété à partir de WebSphere Portal et la stocke dans la variable globale spécifiée. Seules les variables contenant une ou plusieurs chaînes peuvent être utilisées pour la communication entre les portlets JSR 168.
Communication avec les portlets non HATS JSR 168

Rational SDP fournit un support d'interface graphique pour l'implémentation de portlets coopératifs. Procédez comme suit pour configurer la communication entre les portlets non HATS JSR 168 et les portlets HATS JSR 168 :

  1. Ouvrez la vue Explorateur de projets dans la barre de menus Rational SDP en sélectionnant Fenêtre > Afficher la vue > Autre > Général > Explorateur de projets.
  2. Dans la vue Explorateur de projets, cliquez avec le bouton droit de la souris sur le noeud Portlet Deployment Descriptor sous le projet de type portlet.
  3. Sélectionnez Cooperative > Enable this Portlet to Send Data (Source) ou Cooperative > Enable this Portlet to Receive Data (Target) pour lancer l'assistant et activer le support de portlet coopératif pour le portlet sélectionné.
  4. Vérifiez que les paramètres suivants sont corrects dans cet assistant :
Edition de l'URI de type de données

Lorsque vous configurez une action Envoyer une variable globale ou un paramètre de portlet pour la réception d'une propriété, HATS définit par défaut l'URI de type de données de la propriété sur http://com.ibm.hats.portlet.pb#<nom_propriété>Type. Cet URI est uniquement utilisé lorsque vous connectez les portlets source et cible. WebSphere Portal exige que les portlets cible et source utilisent le même URI afin d'envoyer et de recevoir la propriété. Si vous devez pour une raison quelconque configurer l'URI de manière différente de la configuration par défaut, vous pouvez modifier l'URI d'une propriété à l'aide de Portal Toolkit en procédant comme suit :

  1. Ouvrez la vue Explorateur de projets dans la barre de menus Rational SDP en sélectionnant Fenêtre > Afficher la vue > Autre > Général > Explorateur de projets.
  2. Dans la vue Explorateur de projets, développez le projet jusqu'à que s'affiche la propriété que vous souhaitez modifier. Les propriétés figurent dans le noeud Portlet Deployment Descriptor.
  3. Cliquez sur la propriété à l'aide du bouton droit de la souris et sélectionnez Edit Data Type.
  4. Modifiez Data Type URI dans l'assistant Edit Cooperative Source ou Edit Cooperative Target.

Connexion de portlets en vue de la communication

Des connexions entre les portlets sont utilisées pour acheminer le flux d'informations entre les portlets communiquant à l'aide d' d'API de portlet coopératif WebSphere Portal. La connexion de portlets consiste à relier deux portlets à l'aide de l'outil de connexion du serveur de portail en vue d'envoyer et de recevoir une propriété de portlet coopératif. Chaque connexion s'applique à une seule propriété et les deux portlets doivent attribuer le même nom à cette propriété  ; cependant, les noms attribués à la variable globale associée peuvent être différents. En d'autres termes, si deux portlets doivent envoyer et recevoir deux propriétés, ils doivent être reliés par deux connexions différentes, chacune étant associée à une des deux propriétés. Si l'étape de connexion n'est pas réalisée, la transmission des données n'a pas lieu.

PDT et tables personnalisés

Avant de déployer un projet de type portlet avec une table de définition d'imprimante personnalisée (PDT) ou des tables personnalisées sur un serveur de portail, vous devez copier des fichiers ou des dossiers dans le répertoire \Web Content du projet de type portlet HATS. Les fichiers ou dossiers de chaque type d'ajout sont indiqués ci-après :

Web Services for Remote Portlets

WSRP (Web Services for Remote Portlets) est une norme utilisée par les portails pour fournir les portlets, les applications et le contenu en tant que services WSRP. De plus, d'autres portails peuvent intégrer les services WSRP en tant que portlets distants pour leurs utilisateurs. Les portlets HATS standard et IBM peuvent être fournis en tant que portlets distants pouvant être utilisés par d'autres portails. Pour plus d'informations, voir le centre de documentation WebSphere Portal à l'adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp puis recherchez Utilisation des services WSRP.

Test des portlets HATS

Si un environnement de test WebSphere Portal est configuré dans Rational SDP, vous pouvez l'utiliser pour tester vos portlets HATS standard ou IBM avant de les déployer sur un serveur de production Portal.

Vous pouvez également tester vos portlets HATS standard avec l'environnement de test local WebSphere Application Server V6.1 ou V7.0, selon le cas,, avant de les déployer.

Pour tester un projet de portlet HATS, utilisez la même procédure que pour tester le projets Web HATS. Pour plus d'informations, voir Présentation.

Exportation des portlets HATS

Pour exporter un portlet HATS en vue de son déploiement, à partir de la vue Projets HATS, cliquez avec le bouton droit sur le projet de portlet et sélectionnez Exporter le projet. Entrez le nom du fichier cible pour le fichier .war exporté dans la liste déroulante Destination, puis cliquez sur Terminer. Seul le fichier .war est exporté. Le fichier .ear n'est utilisé qu'à des fins de test dans l'environnement de test local.

Après avoir exporté le fichier .war du portlet HATS, vous devez l'installer dans WebSphere Portal à l'aide des outils d'administration WebSphere Portal.

Si vous installez un portlet standard dans WebSphere Application Server V6.1 ou V7.0, utilisez la console d'administration WebSphere Application Server et suivez la procédure suivante :

Gestion des portlets HATS

Vous pouvez administrer des portlets HATS à l'aide de la console d'administration HATS. Les portlets HATS standard installés sur Portal Server ou sur WebSphere Application Server peuvent être gérés à l'aide d'une application d'administration HATS autonome. Les portlets IBM HATS peuvent être gérés à l'aide d'une application d'administration HATS autonome ou via le support de console d'administration inclus dans le portlet.

Utilisation d'une application d'administration HATS autonome

Pour gérer les portlets HATS standard et IBM HATS à l'aide d'une application d'administration HATS autonome, procédez comme suit :

  1. Créez un projet HATS Administration autonome dans HATS Toolkit en sélectionnant Fichier > Nouveau > Projet > HATS > Projet HATS Administration. Le projet d'administration HATS apparaît uniquement dans HATS Toolkit sur l'onglet Navigateur.
  2. Exportez le projet .ear d'administration HATS vers un fichier .ear en cliquant sur le projet .ear à l'aide du bouton droit de la souris et en sélectionnant Exportation > Java EE > EAR.
  3. Déployez le fichier .ear de l'application d'administration HATS autonome sur WebSphere Application Server à l'aide de la console d'administration WebSphere Application Server.
    Remarques :
    1. Installez le fichier .ear sur le même système WebSphere Application Server que celui du serveur WebSphere Portal. Lorsqu'un portlet HATS standard est installé directement sur WebSphere Application Server, installez le fichier .ear sur le même serveur.
    2. Vérifiez que le module est mappé sur WebSphere Application Server, par exemple, server1, et non sur WebSphere Portal Server.
    3. Pour WebSphere Application Server V6.x, vérifiez que l'option Tous authentifiés sur le panneau Mapper les rôles de sécurité aux utilisateurs/groupes est cochée pour le rôle d'administrateur HATS. Pour WebSphere Application Server V7.x, vérifiez que l'option Tous authentifiés dans le domaine de l'application est sélectionnée, à l'aide de la liste déroulante Mapper les sujets spéciaux du panneau Mapper les rôles de sécurité aux utilisateurs/groupes.
  4. L'ID utilisateur utilisé pour administrer les portlets doit être défini en tant qu'utilisateur de la console d'administration WebSphere Application Server avec droits d'accès Administrateur. Pour ce faire, procédez comme suit :
    1. Dans la console d'administration WebSphere Application Server, sélectionnez Utilisateurs et groupes > Rôles de l'utilisateur administratif > Ajouter (pour les versions antérieures à WebSphere Application Server V6.1, sélectionnez Administration du système > Paramètres de la console > Utilisateurs de la console > Ajouter).
    2. Entrez l'ID utilisateur utilisé pour administrer les porlets et mappez l'ID utilisateur au rôle Administrateur.
    Remarque :
  5. Démarrez l'application d'administration HATS à l'aide de la console d'administration WebSphere Application Server.
  6. Accédez à la console d'administration HATS autonome. Par exemple, utilisez l'URL http://<washostname>/<hatsadminprojectname>/hatsadmin/admin.
    Remarque :
    Lorsque vous accédez à la console d'administration HATS, vous devez utiliser un navigateur différent de celui utilisé pour accéder aux portlets.
    1. Sélectionnez Guide d'initiation > Portée de la gestion.
    2. Cliquez sur Nouveau.
    3. Dans la zone Hôte, entrez un nom d'hôte identique à celui de l'hôte WebSphere Application Server cible.
    4. Dans la zone Port, entrez le port BOOTSTRAP_ADDRESS de votre serveur cible. Pour rechercher le port BOOTSTRAP_ADDRESS du serveur cible, accédez à la console d'administration WebSphere Application Server, puis procédez comme suit :
      1. Sélectionnez Serveurs > Serveurs d'applications.
      2. Cliquez sur votre serveur cible (WebSphere Portal Server ou WebSphere Application Server), par exemple sur server1, si un portlet HATS standard est installé directement sur WebSphere Application Server.
      3. Dans l'onglet Configuration, sous Communications, développez Ports.
      4. Notez le port BOOTSTRAP_ADDRESS de votre serveur cible.
    5. Cliquez sur OK.
    6. Sélectionnez l'hôte que vous venez d'ajouter.
    7. Ne sélectionnez pas Gérez toutes les applications dans la portée sélectionnée ci-dessus.
    8. La liste des portlets HATS s'affiche. Utilisez la console d'administration HATS pour gérer une collection de portlets à la fois, après l'avoir sélectionnée dans la liste.

Utilisation du support d'administration inclus dans le portlet

Pour gérer les portlets IBM HATS à l'aide d'un portlet incluant le support de console d'administration HATS, procédez comme suit.

Remarque :
Cette option n'est pas prise en charge dans les portlets HATS standard.

  1. Créez un projet de type portlet IBM HATS dans HATS Toolkit en sélectionnant Fichier > Nouveau > Projet HATS. Dans l'assistant de création de projet de votre portlet IBM, sélectionnez l'option Ajouter un support de console d'administration.
  2. Dans la vue Projets HATS, cliquez sur le projet de type portlet à l'aide du bouton droit de la souris pour l'exporter vers un fichier .war et sélectionnez Exporter un projet.
  3. Déployez le fichier .war du portlet IBM HATS sur votre serveur WebSphere Portal.
  4. Accédez à la console d'administration WebSphere Application Server sur laquelle le serveur WebSphere Portal est installé.
    1. Sélectionnez Applications > Applications d'entreprise.
    2. Cliquez sur le nom de votre portlet d'administration HATS, puis cliquez surView Deployment Descriptor.
    3. Notez la valeur PA_value dans le descripteur de déploiement, par exemple, PA_#uaj0rfu (WebSphere Portal V6.0) ou PA_projectname (WebSphere Portal V6.1).
    4. Sélectionnez Serveurs > Serveurs d'applications.
    5. Cliquez sur votre serveur WebSphere Portal, dans l'onglet Configuration sous Communications, développez Ports.
    6. Notez le port BOOTSTRAP_ADDRESS de votre serveur Portal.
  5. Accédez à la console d'administration HATS incluse dans votre portlet à l'aide de la valeur PA_value que vous avez notée ci-dessous dans votre descripteur de déploiement. Par exemple, utilisez l'URL, http://<portalhostname>/wps/PA_value/hatsadmin/admin.
    Remarque :
    Lorsque vous accédez à la console d'administration HATS, vous devez utiliser un navigateur différent de celui utilisé pour accéder aux portlets.
    1. Sélectionnez Guide d'initiation > Portée de la gestion.
    2. Cliquez sur Nouveau, dans la zone Hôte, entrez un nom d'hôte identique à celui de l'hôte du serveur WebSphere Portal, et dans la zonePort entrez le port BOOTSTRAP_ADDRESS du serveurWebSphere Portal mentionné ci-dessus. Cliquez sur OK.
    3. Sélectionnez l'hôte que vous venez d'ajouter.
    4. Ne sélectionnez pas Gérez toutes les applications dans la portée sélectionnée ci-dessus.
    5. La liste des portlets HATS s'affiche. Utilisez la console d'administration HATS pour gérer uniquement la collection de portlets à laquelle est associée la console.

Considérations et restrictions relatives aux portlets HATS

Considérations et restrictions communes

Lorsque vous utilisez des portlets HATS IBM ou standard, tenez compte des considérations et des restrictions suivantes :

Considérations et restrictions relatives aux portlets IBM

Lorsque vous utilisez des portlets IBM HATS, tenez compte des considérations et des restrictions suivantes :

Considérations et restrictions relatives aux portlets standard

Lorsque vous utilisez des portlets HATS standard, tenez compte des considérations et des restrictions suivantes :