Il peut être intéressant de travailler sur uPortal dans un environnement de développement comme Eclipse, notamment si vous avez à développer ou configurer de manière assez poussée certaines parties du portail.

Une documentation Apereo concerne d'ailleurs cette configuration d'Eclipse avec uPortal  : https://wiki.jasig.org/display/UPM42/Eclipse

Pas tout à fait à jour, on vous redonne ici  les grandes lignes pour obtenir un environnement "convenable"  qui vous permettra de naviguer dans les sources du portail, de développer et de faire du debug distant confortablement.

Récupération des sources

Si ce n'est pas déjà fait, on récupère le projet esup-uportal, par git plutôt ...

git clone https://github.com/EsupPortail/esup-uportal.git
 
cd esup-uportal
git checkout -b mon-uportal uportal-4.2.1-esup-0

Java / Maven

On s'assure que l'on a les versions maven / java adéquates.

which java
/usr/local/jdk1.7.0_75/bin/java
 which mvn
/usr/local/apache-maven-3.3.9/bin/mvn

Compilation pour code généré

On compile en ligne de commandes (pour générer certaines sources que Eclipse ne sait pas générer - cf pb du gmavenplus-plugin) :

mvn clean compile

Configuration Eclipse

On lance Eclipse et on le configure pour utiliser les versions de maven et java (java si besoin) données ci-dessus

On le configure également pour ne pas valider certaines choses qui :

  1. prennent beaucoup de temps cpu
  2. ou/et ne valident de toute façon pas (technologies utilisées autour de JPA particulières ?)

-> Window > preferences > validation : vous pouvez désactiver la validation pour JPA, XML et XSL.

On admet ici que cela est un peu radical, aussi vous pouvez éventuellement (si vous en ressentez le besoin ?) faire les choses plus finement et modifier par exemple les règles de validation précisément dans window > preferences > java persistence > jpa > errors / warnings

Importation Eclipse projets maven

On importe des projets "maven" > "Existing maven projects".

On se positionne (browse) sur le répertoire racine de notre esup-uportal et on sélectionne les projets qui nous intéressent (c'est à dire pas forcément tout : pas forcément les portlets-overlay).

On ignore le problème de gmavenplus-plugin - pas très joli car du coup notre pom.xml de uportal-war ne valide pas et est signalé en erreur ... une modification du pom.xml similaire à celle-ci pourrait d'ailleurs sans doute convenir pour éviter de voir le pom.xml marqué en erreur : https://github.com/BroadleafCommerce/BroadleafCommerce/commit/82c3a74f0b4193bc8665ea7aafcd301d816ef52d

Résultat

Résultat, on a quelques chose d'acceptable - cf copie d'écran :