Les gadgets ou pages directement accessibles par le biais d'URL spéciales sont appelés services. Les services vous permettent d'accéder aux données d'un gadget ou d'une page spécifique pour exécuter une fonction. Le service renvoie uniquement les données de ce gadget ou de cette page au lieu de celles de l'application NPS complète. Ce service fonctionne comme si vous accédiez directement à NPS, mais il ne récupère que les données renvoyées par le gadget ou la page spécifique. Si les données renvoyées sont affichées dans un navigateur, seul le gadget ou la page indiqué apparaît.
Tous les gadgets et pages sont accessibles en tant que services.
Si vous tentez d'accéder à un service (gadget ou page) accessible uniquement à des utilisateurs logués, NPS affiche automatiquement une invite de login. Une fois vos références saisies, le service est affiché s'il est à la disposition de l'utilisateur. Dans le cas contraire, un message d'erreur apparaît.
Les services publics sont des gadgets ou des pages accessibles à tous les utilisateurs, qu'ils soient logués ou non. Les services publics incluent tous les gadgets et pages assignés à l'utilisateur public, ainsi que les autres gadgets configurés en tant que services publics dans l'objet Portail.
Les services privés sont des gadgets ou des pages uniquement accessibles aux utilisateurs logués. Ces gadgets et ces pages sont basés sur les pages et les gadgets hérités assignés aux conteneurs, aux groupes et aux utilisateurs.
Les versions précédentes de Novell Portal Services (NPS) traitaient toutes les requêtes via la servlet de portail. Dans NPS 1.5, vous devez utiliser différentes servlets pour accéder à l'application et aux services.
Il s'agit de la servlet de portail générale. Elle constitue le point d'entrée habituel de l'application NPS. Les données complètes du portail sont renvoyées pour tous les gadgets et pages hérités. Une transformation ou un rendu interne (en général, en langage HTML) se produit si l'état de la session indique que le navigateur ne prend pas en charge le langage XSL. La servlet de portail crée alors toutes les requêtes suivantes par le biais de portalservice. Le portail effectue un rendu interne pour renvoyer des données HTML, ou xmlportalservice s'il renvoie des données XML et XSL. Par exemple :
http://portalHost/npsservlet/portal
L'utilisation du point d'entrée du portail pour les services est certes prise en charge, mais elle n'en demeure pas moins complexe. Par exemple :
http://portalHost/nps/servlet/portal?NPService=MonService&NPServiceDataType=ServiceAsData&FULLPAGE=branding
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.
Cette servlet est similaire à la servlet de portail à la seule différence qu'en arrière-plan, elle convertit ou transforme toujours les données renvoyées (généralement en HTML) pour l'ensemble du portail, que le client prenne ou non en charge les transformations XSL. Par exemple,
http://portalHost/nps/servlet/portalservice
L'utilisation du point d'entrée de la servlet portalservice pour les services est certes prise en charge, mais elle n'en demeure pas moins complexe. Par exemple :
http://portalHost/nps/servlet/portalservice?NPService=Monservice&NPServiceDataType=ServiceAsData&FULLPAGE=branding
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.
Cette servlet est similaire à la servlet de portail, sauf qu'elle renvoie systématiquement des données XML et XSL pour l'intégralité du portail, que le client prenne en charge ou non les transformations XSL. Par exemple :
http://portalHost/nps/servlet/xmlportalservice
L'utilisation du point d'entrée de la servlet xmlportalservice pour les services est certes prise en charge, mais elle n'en demeure pas moins complexe. Par exemple :
http://portalHost/nps/servlet/xmlportalservice?NPService=MonService&NPServiceDataType=ServiceAsData&FULLPAGE=branding
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.
Ces servlets sont les méthodes préférées pour accéder aux gadgets en tant que services. Elles renvoient les données transformées (en général, au format HTML) pour les services uniquement, et non pour l'intégralité du portail. Par exemple :
http://portalHost/nps/servlet/xmlservice?NPSservice=MonService
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.
Cette servlet permet à un gadget d'être provisoirement affiché sur toute la page dans le portail. Le comportement de cette servlet est identique à celui de la servlet service, sauf que toutes les requêtes suivantes sont envoyées à normalfullpageservice pour déterminer le moment où la page entière doit être fermée et où le portail complet doit être à nouveau affiché. Les services utilisent rarement cette servlet. Par exemple :
http://portalHost/nps/servlet/fullpageservice?NPService=MonService
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.
Cette servlet permet l'affichage par défaut d'un gadget sur toute la page et ne réaffiche la vue entière du portail qu'en fonction de l'état du service/gadget (via l'appel getFullPageMode dans GadgetInstance). Sinon, cette servlet est identique à la servlet fullpagservice. Elle est rarement utilisée. Par exemple :
http://portalHost/nps/servlet/normalfullpageservice?NPservice=MonService
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.
Cette servlet permet l'affichage par défaut d'un gadget sur toute la page et ne réaffiche la vue entière du portail qu'en fonction de l'état du service/gadget (via l'appel getFullPageMode dans GadgetInstance). Sinon, cette servlet est identique à la servlet fullpagservice. Elle est rarement utilisée. Par exemple :
http://portalHost/nps/servlet/normalfullpageservice?NPservice=MonService
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.
Il est recommandé d'utiliser les servlets pageservice et xmlpageservice pour accéder aux pages en tant que services et autoriser l'interaction avec les gadgets dans la page concernée. Elles renvoient les données transformées (en général, au format HTML) pour la page et tous les gadgets qu'elle contient uniquement, et non pour l'intégralité du portail. Elles sont dotées d'un paramètre supplémentaire, NPPage={ID du service de page}. Par exemple :
http://portalHost/nps/servlet/service?=MaPage
Remplacez MaPage par la page à laquelle vous souhaitez accéder.
http://portalHost/nps/servlet/service?NPPage=MaPage&NPService=MonService
Remplacez MaPage par la page à laquelle vous souhaitez accéder et MonService, par le gadget que vous souhaitez utiliser sur cette page.
Cette servlet renvoie les données XML brutes pour le service sélectionné uniquement, sans y ajouter de données de portail ou de balises de gadget. Cette méthode ne permet d'obtenir que les données XML d'un service. Par exemple :
http://portalHost/nps/servletxmldataservice?NPService=MonService
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.
Cette servlet renvoie le contenu déterminé par le service. Elle est similaire au paramètre CustomContentType utilisé dans les versions antérieures de NPS. Par exemple :
http://portalHost/nps/servlet/xmldataservice?NPService=MonService
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.
Pour simplifier le développement des feuilles de style, NPS 1.5 fournit les points d'entrée les plus classiques sous forme de variables dans les feuilles de style. La servlet utilisée par les feuilles de style varie en fonction du comportement de la servlet qui traite la requête.
Pour plus d'informations sur les feuilles de style et les variables, reportez-vous à la section Feuilles de style de portail.
Le gadget conserve son état actuel (service, page entière, partie du portail, etc.). Vous devez utiliser cette variable pour tous les gadgets dans les feuilles de style, sauf si vous souhaitez imposer un autre état que celui qu'elle utilise actuellement.
Utilisez cette variable pour les gadgets qui requièrent l'état page entière. Cette variable n'est pas nécessaire pour les services déjà dotés de cet état.
Le gadget renvoie un contenu personnalisé et doit annuler le comportement du portail.
Avec Novell Portal Services (NPS), il vous est possible de vous authentifier directement dans l'URL lorsque vous accédez à une URL de servlet. Procédez de l'une des manières suivantes :
http://portalHost/nps/servlet/portalservice?NPService=MonService&NPUser=juser&NPPassword=secret
Remplacez MonService par la page ou le gadget auquel vous souhaitez accéder.