Installation

...

en mode portlet ou mixed

Le module ori-oai-search est aussi disponible en version portlet. Il peut donc être intégré dans tout moteur de portlet comme un ENT ou un CMS.
En plus de la version, on peut déployer le module en mode mixed. Dans ce cas, le contexte déployé sera à la fois une portlet mais aussi sera disponible en tant que servlet via le Tomcat.

Intégration dans ESUP Portail

Il est nécessaire d'éditer le fichier commons-parameters.properties du module ORI-OAI*quick-install pour spécifier le mode d'installation :

SEARCH_DEPLOY_TYPE=portlet

ou

SEARCH_DEPLOY_TYPE=mixed

Ensuite, il faut configurer le fichier [ORI_HOME]/src/ori-oai-search-svn/build.properties :

# Chemin vers la racine du projet uPortal ou ESUP Portail (où se trouve le build.xml principal)
# A renseigner pour faire un appel automatique à "ant deployPortletApp"
uportal.root.dir=......

uportal.root.dir

Chemin vers la racine du projet uPortal ou ESUP Portail (où se trouve le build.xml principal contenant la target ANT deployPortletApp)

Lors de l'installation du module ORI-OAI-search (target ant all-search), le fichier WAR sera généré et un appel à la tâche ant deployPortletApp de ESUP Portail sera fait automatiquement pour déployer la portlet.

<Context path="/ori-oai-search" docBase="......./webapps/ori-oai-search" crossContext="true" reloadable="false" />

Les CSS en mode portlet

Lors d'un déploiement en mode portlet dans un ENT par exemple, aucun en-tête HTML n'est généré par l'application. En effet, le HTML généré par la portlet ori-oai-search est intégré dans un environnement autre. Dans ce cas, aucune CSS n'est associée par défaut à votre interface. Il est donc impératif d'ajouter le lien vers votre CSS ori-oai-search.css depuis l'en-tête HEAD de votre moteur de portlet.

Dans le cas de l'ENT ESUP Portail, vous pouvez par exemple importer la CSS de ori-oai-search depuis la CSS ???_portlet..css du dossier VOTRE_CHEMIN/uPortal/media/org/jasig/portal/layout/AL_TabColumn/integratedModes/VOTRE_DOSSIER_DE_SKINS/skin comme ceci:

@import url("../../../../../../../../../../[CONTEXT_SEARCH]/css/ori-oai-search.css");
@import url("../../../../../../../../../../[CONTEXT_SEARCH]/css/oos-portlet.css");

Où le nombre de sauts dans l'arborescence est à personnaliser selon votre cas.

Des vues différentes pour publier une portlet plusieurs fois

Imaginons que l'on veuille montrer plusieurs canaux dans l'ENT où l'un correspond à la recherche de ressources pédagogiques, et l'autre uniquement les thèses.
Dans ce cas, on peut déployer 2 portlets avec des configurations différentes, ou alors utiliser la solution suivante.

Dans cette solution, il faut définir une configuration avec 2 menus de recherches dans config.xml :

• sur les ressources pédagogiques

  Code Block
  xml xml
  <search_menu key="lom" .....> </search_menu>

• sur les thèses

  Code Block
  xml xml
  <search_menu key="tef" .....> </search_menu>

Ensuite, il faut publier 2 fois cette portlet dans l'ENT en spécifiant un paramètre avec une valeur différente pour chaque publication. Ce paramètre est menu.key. Il peut être multivalué et doit avoir comme valeur une ou plusieurs clefs de blocs <search_menu>.
Dans ce cas, l'utilisateur ne verra que le(s) menu(s) de recherche correspondant aux clefs fournies en paramètre.

Dans notre exemple, il faut donc publier 2 fois la portlet avec les paramètres suivants :

• Code Block
  menu.key=lom

• Code Block
  menu.key=tef

 L'installation avancée est tout de même possible en suivant cette documentation.