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
- window > preferences > maven > installations
- window > preferences > java > installed jre
On le configure également pour ne pas valider certaines choses qui :
- prennent beaucoup de temps cpu
- 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 :
