Adaptation des canaux et portlets

Connecteur Apogee (esup-connecteur-apogee)

Connecteur Harpège (esup-connecteur-harpege)

Suivre les instructions #Librairies JAR de uportal. Pour tomcat6, suivre aussi les instructions #Librairies JAR et tomcat 6

Canal Sympa (CSympa)

Pour tomcat6, suivre aussi les instructions Librairies JAR et tomcat 6

Canal Stockage (CStockage)

Portlet newsPortlet

La portlet news utilise une tagLib DisplayTags.

Celle ci pose un problème avec uPortal 3 dans sa version actuel, le portail prefixe tout les paramètres envoyés et reçus par "pltp_" afin de ne pas les mélanger.

La librairie displaytag positionne mal les paramètres lorsque l'on utilise un href dans un tag column (cf : http://jira.codehaus.org/browse/DISPL-637)

Exemple qui pose problème

<d:column property="XXXX" titleKey="XXX.XXX.XXX"  href="${baseRenderUrl}" paramId="XX" paramProperty="XX"  />

Seule solution trouvé pour l'instant préfixé manuellement le paramId :

<d:column property="XXXX" titleKey="XXX.XXX.XXX"  href="${baseRenderUrl}" paramId="pltp_XX" paramProperty="XX"  />

Cf : http://sourcesup.cru.fr/frs/download.php/2661/Note_To_uPortal_V3_User.doc

Une nouvelle version du projet nommé esup-news est disponible et compatible portail 3.2 (cf l'incubateur de projet) http://www.esup-portail.org/display/ESUPNEWS/Home

Canal CMonDossierWeb/Harpège

• Dans ***/custom/uPortal/uportal-impl/src/main/resources/properties/contexts/datasourceContext.xml
  Il faut déclarer des beans pour les pools qu'on rajoute

  <bean id="Apogee" class="org.springframework.jndi.JndiObjectFactoryBean">
  <property name="jndiName" value="java:comp/env/jdbc/Apogee"/>
  </bean>
  <bean id="Harpege" class="org.springframework.jndi.JndiObjectFactoryBean">
  <property name="jndiName" value="java:comp/env/jdbc/Harpege"/>
  </bean>
  

• Suivre les instructions #Librairies JAR de uportal. Pour tomcat6, suivre aussi les instructions #Librairies JAR et tomcat 6
• NB : le canal ConsultHarpege (ancienne doc) est obsolete. Utilisez plutôt esup-agent (qui utilise les webservices Harpege)

Portlet pstage

L'API servlet a changé de répertoire dans tomcat 6 :

uPortal3 utilise une bibliothèque castor 1.1.1 qu'il déploie dans (tomcat.home)/shared/lib. celle-ci est incompatible avec la bibliothèque livrée avec Pstage (castor-1.2-xml.jar) :

Supprimer la biblothèque castor-1.2-xml.jar du répertoire (pstage)/WEB-INF/lib

Suivre aussi les instructions pour les portlets ci-dessous

Adaptations courantes

Librairies JAR de uportal

Plusieurs portlets demandent les librairies lib/*/.jar dans uportal.home, sans vraiment s'en servir. En uportal 3.2, ces librairies ont changé de place.
Une solution simple : supprimer la ligne suivante de build.xml

<fileset dir="${uportal.home}/lib" includes="**/*.jar" />

Librairies JAR et tomcat 6

Esup dans la version 3 préconise l'utilisation de tomcat 6.

• Le fichier el-api.jar est maintenant inclus dans tomcat et ne doit pas être dans les portlet (portlet esup-hc)
• Les librairies JAR de tomcat 6 sont dans lib et non plus dans common/lib. Il faut donc remplacer dans le build.xml de la portlet

  <fileset dir="${tomcat.home}/common/lib" includes="**/*.jar" />
  

  Par :

  <fileset dir="${tomcat.home}/lib" includes="**/*.jar" />
  

  Ou alors

  <property name="lib.tomcat" value="common/lib"/>
  

  Par :

  <property name="lib.tomcat" value="lib"/>
  

Les portlets

La version la librairie Pluto a changé en uPortal 3 ce qui entraine des modifications du coté des Portlets

web.xml

Il faut maintenant spécifier un portlet-name et un load-on-startup dans le web.xml

<servlet>
  <servlet-name>esup-helpdesk</servlet-name>
[...]
  <init-param>
    <param-name>portlet-name</param-name>
    <param-value>esup-helpdesk</param-value>
  </init-param>
  <load-on-startup>1</load-on-startup>
</servlet

La servlet Pluto doit maintenant être mappée sur /PlutoInvoker/[portlet]

<servlet-mapping>
  <servlet-name>esup-helpdesk</servlet-name>
  <url-pattern>/PlutoInvoker/esup-helpdesk</url-pattern>
</servlet-mapping>

portlet.xml

Si la portlet est publiée dans uPortal avec le paramètre "disableDynamicTitle" désactivé :

  <parameter>
      <name>disableDynamicTitle</name>
      <value>true</value>
      <description/>
      <ovrd>N</ovrd>
  </parameter>

...Pluto utilise alors le nom défini dans le fichier portlet.xml pour afficher son titre dans le portail.

<portlet-info>
  <title>Assistance en ligne</title>
  <short-title>Assistance en ligne</short-title>
  <keywords>esup helpdesk</keywords>
</portlet-info>