Généralités
Paramètres globaux
La modification des paramètres du portail (sources de données, authentification, attributs,
...
thèmes...)
...
se
...
fait
...
en
...
modifiant
...
des
...
fichiers
...
de
...
configuration
...
et
...
en
...
redéployant
...
le
...
portail.
...
Beaucoup
...
de
...
paramètres
...
se
...
modifient
...
dans
...
le
...
fichier
...
config.properties.
...
Pour
...
les
...
autres,
...
le
...
principe
...
est
...
d'utiliser
...
le
...
répertoire
...
custom
...
,
...
prévu
...
pour
...
les
...
personnalisations
...
de
...
l'établissement
...
:
...
Créez
...
le
...
fichier
...
de
...
paramètre
...
dans
...
ce
...
répertoire
...
(ou
...
copiez
...
le
...
à
...
partir
...
du
...
répertoire
...
update)
...
en
...
respectant
...
l'arborescence
...
(basez-vous
...
sur
...
le
...
répertoire
...
update)
...
et
...
modifiez-le.
...
Pour
...
prendre
...
en
...
compte
...
les
...
modification,
...
relancez
...
les
...
tâches
...
ant
...
init
...
et
...
ant
...
deploy
...
puis
...
redémarrez
...
le
...
portail.
...
Entités
...
du
...
portail
...
La
...
création
...
ou
...
la
...
modification
...
d'entités
...
du
...
portail
...
(Canaux,
...
Profils/fragments,
...
Groupes
...
locaux,
...
utilisateurs
...
locaux...)
...
peut
...
se
...
faire
...
:
...
- soit
...
- par
...
- l'import
...
- de
...
- fichier
...
- de
...
- définition
...
- de
...
- l'entité
...
- soit
...
- par
...
- l'interface
...
- du
...
- portail
...
Si
...
vous
...
utilisez
...
l'interface
...
du
...
portail,
...
il
...
est
...
conseillé
...
de
...
créer
...
quand
...
même
...
un
...
fichier
...
de
...
définition,
...
de
...
manière
...
à
...
pouvoir
...
le
...
rejouer,
...
surtout
...
en
...
période
...
de
...
tests.
...
Pour
...
créer/modifier
...
une
...
entité
...
avec
...
un
...
fichier
...
de
...
définition,
...
créez
...
ce
...
fichier
...
dans
...
l'arborescence
...
custom/uPortal/uportal-impl/src/main/resources/properties/db/mini
...
(basez-vous
...
sur
...
le
...
répertoire
...
update),
...
puis
...
utilisez
...
la
...
tâche
...
ant
...
db.import
...
pour
...
importez
...
les
...
objets
...
voulus
...
(ou
...
les
...
tâches
...
ant
...
init
...
db.init
...
pour
...
réimporter
...
toute
...
la
...
base).
...
Réinitialisation
...
du
...
déploiement
...
Il
...
n'y
...
a
...
pas
...
de
...
tâche
...
de
...
réinitialisation
...
du
...
répertoire
...
des
...
sources
...
uPortal
...
(TODO
...
:
...
Ajouter
...
dans
...
une
...
prochaine
...
version).
...
Quand
...
un
...
fichier
...
est
...
inclut
...
dans
...
les
...
sources
...
à
...
partir
...
des
...
répertoires
...
update
...
ou
...
custom avec la tâche ant init, il ne sera jamais supprimé.
Pour réinitialiser le déploiement :
- Supprimez le dossier Portail/uPortal-rel-3.2.4
...
- ant
...
- unzip
...
Attributs
...
utilisateurs
...
Article
...
détaillé
...
:
...
...
...
...
- Copiez le fichier update/uPortal/uportal-impl/src/main/resources/properties/contexts/personDirectoryContext.xml
...
- sous
...
- la
...
- même
...
- arborescence
...
- dans
...
- custom
- Editez le fichier custom/uPortal/uportal-impl/src/main/resources/properties/contexts/personDirectoryContext.xml
...
- Redéployez
...
- le
...
- portail
...
- :
...
- ant
...
- init
...
- deploy
...
- Relancez
...
- le
...
- portail
...
Groupes
Article détaillé sur les groupes : Groupes (esup-3)
...
Groupes PAGS
- Recopier le fichier update/uPortal/uportal-impl/src/main/resources/properties/groups/PAGSGroupStoreConfig.xml
...
- dans
...
- le
...
- répertoire
...
- custom
...
- selon
...
- la
...
- même
...
- arborescence
...
- Editez
...
- ce
...
- fichier,
...
- en
...
- conservant
...
- les
...
- groupes
...
- pags_root
...
- et
...
- all_users
...
- Déployez
...
- :
...
- ant
...
- init
...
- deploy
...
- Relancez
...
- le
...
- portail
Groupes locaux
Avec des fichiers d'import
- Pour chaque groupe, créez un fichier avec l'extension ".group_membership"
...
- dans
...
- le
...
- répertoire
...
- custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/group_membership
...
- ,
...
- en
...
- vous
...
- basant
...
- sur
...
- ceux
...
- du
...
- répertoire
...
- update
...
- .
...
- Dans
...
- la
...
- balise
...
- <name>,
...
- indiquez
...
- le
...
- nom
...
- du
...
- groupe
...
- Dans
...
- la
...
- balise
...
- <entity-type>,
...
- indiquez
...
- s'il
...
- s'agit
...
- d'un
...
- groupe
...
- de
...
- personnes
...
- (org.jasig.portal.security.IPerson)
...
- ou
...
- d'une
...
- catégorie
...
- de
...
- canaux
...
- (org.jasig.portal.ChannelDefinition)
...
- Dans
...
- la
...
- balise
...
- <children>,
...
- indiquez
...
- les
...
- membres
...
- du
...
- groupe
...
- La
...
- balise
...
- <children>
...
- accepte
...
- comme
...
- membre
...
- :
...
- <literal>
...
- :
...
- un
...
- utilisateur
...
- (groupe
...
- de
...
- personnes
...
- uniquement)
...
- <group>
...
- :
...
- un
...
- groupe
...
- local,
...
- un
...
- groupe
...
- PAGS
...
- (groupe
...
- de
...
- personnes)
...
- ou
...
- un
...
- groupe
...
- de
...
- canaux
- canaux
- Importez le ou les groupes :
Import d'un
...
groupe :
| Bloc de code |
|---|
: \\ {code} ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/group_membership -Dpattern="nom_groupe\.group_membership" {code} Import de tous les groupes du dossier : \\ {code} |
Import de tous les groupes du dossier :
| Bloc de code |
|---|
ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/group_membership -Dpattern=".*\.group_membership"
{code}\\
le paramètre |
le paramètre "pattern"
...
accepte
...
les
...
expressions
...
régulières
Avec l'interface
...
Utilisez
...
le
...
canal
...
"Gestionnaire
...
de
...
groupes"
...
(Group
...
Manager)
...
Canaux
Article détaillé : Publication de canaux (esup-3)
...
- Pour chaque canal, créez un fichier avec l'extension
...
- ".channel"
...
- dans
...
- le
...
- répertoire
...
- custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/channel
...
- ,
...
- en
...
- vous
...
- basant
...
- sur
...
- ceux
...
- du
...
- répertoire
...
- update
...
- .
...
- Importez
...
- le
...
- ou
...
- les
...
- canaux:
...
Import
...
d'un
...
canal :
| Bloc de code |
|---|
: \\ {code} ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/channel -Dpattern="nom_canal\.channel" {code} Import de tous les canaux du dossier : \\ {code} |
Import de tous les canaux du dossier :
| Bloc de code |
|---|
ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/channel -Dpattern=".*\.channel"
{code}
h2. Profils utilisateurs
Article détaillé : [ESUPMU:Profils utilisateurs |
Profils utilisateurs
Article détaillé : Profils utilisateurs (esup-3)
...
Référencement des profils
Si le fichier dlm.xml
...
doit
...
être
...
modifié
...
(ajout
...
de
...
profil
...
modification
...
des
...
droits)
...
:
...
- Recopier
...
- le
...
- fichier
...
- update/uPortal/uportal-impl/src/main/resources/properties/
...
- dlm.xml
...
- dans
...
- le
...
- répertoire
...
- custom
...
- selon
...
- la
...
- même
...
- arborescence
...
- Editez
...
- ce
...
- fichier
- Déployez : ant init deploy
- Relancez le portail
Fragments de profils
Avec des fichiers d'import
- Pour chaque fragment, créez un fichier avec l'extension ".fragment_layout" dans le répertoire custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/
...
- fragment_
...
- layout,
...
- en
...
- vous
...
- basant
...
- sur
...
- ceux
...
- du
...
- répertoire
...
- update.
- Importez le ou les fragments :
Import d'un fragment :
| Bloc de code |
|---|
*. ** Dans la balise <name>, indiquez le nom du groupe ** Dans la balise <entity-type>, indiquez s'il s'agit d'un groupe de personnes (org.jasig.portal.security.IPerson) ou d'une catégorie de canaux (org.jasig.portal.ChannelDefinition) ** Dans la balise <children>, indiquez les membres du groupe ** La balise <children> accepte comme membre : *** <literal> : un utilisateur (groupe de personnes uniquement) *** <group> : un groupe local, un groupe PAGS (groupe de personnes) ou un groupe de canaux * Importez le ou les groupes : \\ Import d'un groupe :\\ ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/groupfragment_membershiplayout -Dpattern="nom_groupefragment\.groupfragment_membershiplayout" |
Import
...
de
...
tous
...
les
...
fragments du
...
dossier :
| Bloc de code |
|---|
:\\ ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/groupfragment_membershiplayout -Dpattern=".*\.groupfragment_membershiplayout" \\ \\ le paramètre "pattern" accepte les expressions régulières\\ h4. Avec |
Avec l'interface
...
Utilisez
...
le
...
canal
...
"Gestionnaire
...
de
...
fragments"
...
(
...
Fragment Manager)
Thèmes
Voir article détaillé : TODO
Personnalisation de thème d'uPortal
Pour personnaliser un thème livré avec uPortal :
- Copiez le fichier update/uPortal/uportal-war/src/main/webapp/media/skins/universality/nom_theme/esup-portal.css sous la même arborescence dans custom
- Surchargez les styles du thème (portal.css et portlet.css) dans ce fichier
- Placez éventuellement les images propres à votre thème dans un sous-dossier images du dossier nom_theme
- Déployez : ant init deploy
Création de thème
Pour créer un nouveau thème :
- Copiez le fichier de la liste des thèmes d'uPortal vers le répertoire custom :
- Fichier pour navigateur : Portail/uPortal_rel-3.2.4/uportal-war/src/main/webapp/media/skins/universality/skinList.xml
- Fichier pour mobile : Portail/uPortal_rel-3.2.4/uportal-war/src/main/webapp/media/skins/muniversality/skinList.xml
- Copiez le dossier d'un des thèmes d'uPortal vers le répertoire custom (en respectant l'arborescence) :
- Dossier thème pour navigateur : Portail/uPortal_rel-3.2.4/uportal-war/src/main/webapp/media/skins/universality/nom_theme
- Dossier thème pour mobile : Portail/uPortal_rel-3.2.4/uportal-war/src/main/webapp/media/skins/muniversality/nom_theme
- Renommez le dossier en votre nouveau thème
- Modifiez les styles
- Ajoutez votre thème dans le fichier custom/uportal-war/src/main/webapp/media/skins/universality/skinList.xml
- Déployez : ant init deploy