| Volet | ||
|---|---|---|
| ||
Portlet Esup Lecture – Guide d'installation
|
| Sommaire | ||||||
|---|---|---|---|---|---|---|
|
Installation
Installer la portlet
...
- Télécharger
- lecture-portlet-<VERSION>.war
...
- depuis
...
...
...
...
- projet
- Depuis le répertoire contenant ESUP-Portail lancer : ant portlet.deploy -DportletApp=/path/to/war/lecture-portlet-<VERSION>.war
...
- En
...
- tant
...
- qu'administrateur
...
- de
...
- uPortal
...
- lancer
...
- le
...
- portlet
...
- manager
...
- pour
...
- ajouter
...
- ESUP-Lecture
...
- en
...
- tant
...
- que
...
- nouvelle
...
- portlet
| Remarque |
|---|
| } Vous pouvez préciser une préférence de portlet avec le nom " *context *" afin de pouvoir utiliser N instances de cette même portlet avec des configurations différentes. Voir le guide de configuration pour plus d'information sur l'utilisation de cette préférence. {note} * Adapter le fichier * |
- Adapter le fichier properties/config.properties
...
Paramètre | Description | Version | Exemple |
|---|---|---|---|
datasource.bean | Valeurs possible : JDBCDataSource ou JNDIDataSource | 2.0 | JNDIDataSource |
jpa.database.type | Ce paramètre est utiliser par la couche JPA afin de connaître le type de base de données utilisée | 2.0 | MYSQL |
jdbc.connection.driver_class |
...
Driver |
...
JDBC |
...
2.0 |
...
com.mysql.jdbc.Driver |
...
jdbc.connection.url |
...
Url |
...
d'accès |
...
à |
...
la |
...
base |
...
de |
...
données |
...
2.0 |
...
jdbc:mysql://localhost/lecturev2 |
...
jdbc.connection.username |
...
Utilisateur |
...
ayant |
...
accès |
...
à |
...
la |
...
base |
...
de |
...
données |
...
2.0 |
...
user1 | |
jdbc.connection.password |
...
Mot |
...
de |
...
passe |
...
de |
...
l'utilisateur |
...
ayant |
...
accès |
...
à |
...
la |
...
base |
...
de |
...
données |
...
2.0 |
...
truc%55 | |
jndi.datasource |
...
Nom |
...
de |
...
la |
...
source |
...
JNDI |
...
à |
...
utiliser |
...
2.0 |
...
jdbc/lectureDB |
...
smtp.host |
...
Nom |
...
du |
...
serveur |
...
SMTP |
...
utilisé |
...
pour |
...
l'envoi |
...
de |
...
mails |
...
2.0 |
...
smtp.univ-rennes1.fr |
...
smtp.port |
...
Port |
...
du |
...
serveur |
...
SMTP |
...
2.0 |
...
25 | |
smtp.user |
...
Utilisateur |
...
utilisé |
...
pour |
...
se |
...
connecté |
...
au |
...
serveur |
...
SMTP |
...
(laisser |
...
à |
...
vide |
...
pour |
...
une |
...
utilisation |
...
en |
...
mode |
...
anonyme) |
...
2.0 |
...
| |
smtp.password |
...
Mot |
...
de |
...
passe |
...
de |
...
l'utilisateur |
...
utilisé |
...
pour |
...
se |
...
connecté |
...
au |
...
serveur |
...
SMTP |
...
2.0 |
...
| |
smtp.fromEmail |
...
Adresse |
...
utilisée |
...
pour |
...
construire |
...
le |
...
from |
...
des |
...
mails |
...
envoyés |
...
au |
...
serveur |
...
SMTP |
...
2.0 |
...
webmaster@univ-rennes1.fr |
...
smtp.fromName |
...
Nom |
...
utilisée |
...
pour |
...
construire |
...
le |
...
from |
...
des |
...
mails |
...
envoyés |
...
au |
...
serveur |
...
SMTP |
...
2.0 |
...
Web |
...
Master |
smtp.interceptAll |
...
Les |
...
mails |
...
doivent-ils |
...
être |
...
intersectés | 2.0 |
...
false | |
smtp.interceptEmail |
...
Adresse |
...
utilisée |
...
pour |
...
construire |
...
le |
...
to |
...
des |
...
mails |
...
intersectés |
...
2.0 |
...
webmaster@univ-rennes1.fr |
...
smtp.interceptName |
...
Nom |
...
utilisée |
...
pour |
...
construire |
...
le |
...
to |
...
des |
...
mails |
...
intersectés |
...
2.0 |
...
Web |
...
Master |
...
exceptionHandling.email |
...
Adresse |
...
utilisée |
...
pour |
...
construire |
...
le |
...
to |
...
des |
...
mails |
...
d'exception |
...
2.0 |
...
webmaster@univ-rennes1.fr |
...
serverName | Nom du serveur utilisé par CAS doit être de la forme protocol:hostName:port | 2.0 | http://uportal.univ-rennes1.fr/lecture-portlet |
...
casServerUrlPrefix | Non du serveur CAS |
...
de |
...
si |
...
celui-ci |
...
n'est |
...
pas |
...
exécuté |
...
à |
...
la |
...
racine |
...
du |
...
serveur |
...
2.0 |
...
https://sso-cas.univ-rennes1.fr |
...
casService.service |
...
Nom |
...
du |
...
service, |
...
tel |
...
que |
...
construit |
...
par |
...
le |
...
uPortal |
...
pour |
...
la |
...
portlet, |
...
requérant |
...
un |
...
proxy |
...
ticket |
...
CAS |
...
|
...
: |
...
Bien |
...
comprendre |
...
comment |
...
uPortal |
...
construit |
...
cette valeur ! | 2.0 |
...
http://129.20.129.80:8080/lecture-portlet |
...
casService.proxyCallbackUrl |
...
Url |
...
utiliser |
...
par |
...
CAS |
...
pour |
...
transmettre |
...
le |
...
proxy |
...
ticket |
...
à |
...
la |
...
portlet |
...
|
...
est |
...
de |
...
la |
...
forme |
...
: |
...
https:// |
...
hostName |
...
: |
...
port |
...
/ |
...
contextePortlet |
...
/proxy/receptor |
...
2.0 |
...
https://uportal.univ-rennes1.fr/lecture-portlet/proxy/receptor |
...
Ajouter des ressources ESUP-Lecture
...
dans
...
uPortal
...
ESUP-Lecture
...
utilise
...
au
...
maximum
...
les
...
ressources
...
(styles
...
CSS
...
et
...
scripts
...
javaScript)
...
fournis
...
par
...
le
...
portail.
...
Néanmoins
...
il
...
nécessite
...
l'ajout
...
de
...
2
...
fichiers
...
dans
...
l'environnement
...
du
...
portail :
- lecture.css
...
- pour
...
- les
...
- styles
...
- CSS
...
- esup-lecture.js
...
- pour
...
- le
...
- javaScript
...
Ces
...
deux
...
fichiers
...
peuvent
...
être
...
trouvés
...
dans
...
le
...
fichier
...
war
...
de
...
la
...
portlet.
...
Respectivement :
- /media/lecture.css
...
- /media/js/esup-lecture.js
...
Pour
...
que
...
ces
...
fichiers
...
soient
...
pris
...
en
...
compte
...
il
...
faut
...
y
...
faire
...
référence
...
dans
...
le
...
fichier
...
skin.xml
...
de
...
uPortal.
| Remarque |
|---|
| } uPortal contient potentiellement plusieurs skins chacun ayant son propre fichier *skin.xml *. De plus, uPortal gère un mode standard (" *universality *") et un mode mobile (" *muniversality *"). Chacun de ces modes ayant ses propres skins. Il convient donc de modifier tous les fichiers *skin.xml *correspondant aux différents skins proposés aux utilisateurs du portail. {note} h3. Mode opératoire pour le package |
Mode opératoire pour le package ESUP-Portail
...
de
...
uPortal
| Remarque |
|---|
| } Les exemples donnés ici concerne le skin uPortal " *uportal3 *" et le mode standard (" *universality *"). De plus, nous utilisons le répertoire " *custom *" proposé par le package qui permet de conserver les modifications locales indépendamment des sources livrées avec le package. {note} * A la racine du package, créer l'arborescence suivante : ** * |
- A la racine du package, créer l'arborescence suivante :
- custom/uPortal/uportal-war/src/main/webapp/media/skins/universality/
...
- avec
...
- ses
...
- sous
...
- répertoires :
- common/javascript/uportal
- répertoires :
...
- uportal3
- Déposer le fichier esup-lecture.js
...
- dans
...
- custom/.../universality/common/javascript/uportal
...
- Déposer
...
- le
...
- fichier
...
- lecture.css
...
- dans
...
- custom/.../universality/uportal3
...
- Copier
...
- depuis
...
- la
...
- racine
...
- du
...
- package
...
- le
...
- fichier
...
- update/uPortal/uportal-war/src/main/webapp/media/skins/universality/uportal3/skin.xml
...
- dans
...
- le
...
- répertoire
...
- custom/.../universality/uportal3
...
- Editer
...
- le
...
- fichier
...
- custom/.../universality/uportal3/skin.xml
...
- pour
...
- ajouter
...
- en
...
- fin
...
- de
...
- fichier
...
- les
...
- lignes
...
- suivantes
...
- <css>lecture.css</css>
...
- <js>../common/javascript/uportal/esup-lecture.js</js>
...
- Pour
...
- que
...
- ces
...
- modifications
...
- soient
...
- prises
...
- en
...
- compte
...
- il
...
- faut,
...
- à
...
- la
...
- racine
...
- du
...
- package,
...
- lancer
...
- la
...
- commande
...
- suivante :
- ant init deploy
Servlet mode
Le mode servlet est possible mais n'est pas documenté. Il est essentiellement utilisé pour le développement. Pour être parfaitement fonctionnel le mode servlet doit utiliser un Web Service du portail qui expose les groupes. Ce Web Service n'a pas obligatoirement vocation à perdurer avec la montée en puissance de Grouper. Pour autant Grouper n'est pas encore pris en compte dans ESUP-Lecture.