Fonction de recherche dans le portail

Pour plus de facilité et pour l'harmonisation avec les autres services REST du portail, le service REST distant du portail pour PUMA comporte une fonction de recherche. Cette fonction de recherche est créée en greffant un fournisseur dans une fonction de recherche réutilisable du portail. Cette fonction vous permet d'extraire des URL spécifiques du service en spécifiant au servlet dit de recherche un URI absolu en tant que paramètre, référencé par /wps/poc.

Les URI absolus du service REST distant pour PUMA peuvent être construits à partir des chemins d'URL du service. Ils peuvent également être obtenus depuis les éléments atom:id des flux ou des entrées ATOM. Les URI sont entièrement codés en UTF-8. Lorsque vous construisez manuellement un URI, vous devez prendre le chemin d'URI venant à la suite de l'élément /um/ sans la barre oblique, lui ajouter um: en tant que préfixe de l'URI et coder toute l'expression en UTF-8. Exemple d'URL :

/um/secure/users/profiles?searchAttributes=uid%3Dwps*

Cette URL comporte l'URI suivant :

um:secure/users/profiles%3FsearchAttributes%3Duid%3Dwps*

Vous pouvez ensuite appeler l'URL suivante :

/wps/poc?uri=um:secure/users/profiles%3FsearchAttributes%3Duid%3Dwps*

Vous êtes ensuite redirigé vers l'URL de service REST correspondante. Pour les opérations GET, il est obligatoire d'ajouter &mode=download à l'URI pour qu'une redirection soit effectuée en vue d'obtenir les données. Ou, si vous utilisez le paramètre verb=lookup, lequel est obligatoire pour les opérations autres que GET, vous pouvez extraire un flux ATOM avec une description du service telle que la suivante :

<?xml version="1.0" encoding="UTF-8"?>
<atom:entry xmlns:atom="http://www.w3.org/2005/Atom" xmlns:xhtml="http://www.w3.org/1999/xhtml">
    <atom:author>
        <atom:name>HCL Digital Experience Portal</atom:name>
    </atom:author>
    <atom:id>um:secure/users/profiles?searchAttributes=uid=wps*</atom:id>
    <atom:link href="/wps/um/secure/users/profiles?searchAttributes=uid=wps*"/>
    <atom:title>Remote PUMA REST service URI information</atom:title>
    <atom:updated>2006-12-19T19:21:37.562Z</atom:updated>
</atom:entry>

Si vous avez besoin de la description du service de plusieurs URL de service REST, vous pouvez définir le paramètre uri à plusieurs reprises en utilisant des URI différents. Ces descriptions sont ensuite agrégées dans un seul flux ATOM par le servlet de recherche.