Balise Wiki |
---|
h2. Généralités
h3. Paramètres globaux
La modification des paramètres du portail (sources de données, authentification, attributs, |
Généralités
Paramètres globaux
...
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. h3. |
...
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). |
...
h3. 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 |
...
Pour réinitialiser le déploiement :
...
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 |
...
h2. Attributs utilisateurs |
...
Article détaillé : [Attributs utilisateurs (esup-3)|ESUPMU:Attributs utilisateurs (esup-3) |
...
] * 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
...
h2. Groupes Article détaillé sur les groupes : [Groupes (esup-3)|ESUPMU:Groupes (esup-3) |
...
Groupes PAGS
...
] h3. 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 |
...
Avec des fichiers d'import
...
portail \\ h3. Groupes locaux\\ \\ h4. 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 \\ * 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" |
Import de tous les groupes du dossier :
Bloc de code |
---|
{code} Import de tous les groupes du dossier : \\ {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 "pattern" accepte les expressions |
...
régulières \\ h4. Avec l'interface |
...
\\ Utilisez le canal "Gestionnaire de groupes" (Group Manager) |
...
Canaux
...
h2. Canaux Article détaillé : [Publication de canaux (esup-3) |
...
|ESUPMU: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"
|
Import de tous les canaux du dossier :
Bloc de code |
---|
{code} Import de tous les canaux du dossier : \\ {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 (esup-3)]
h3. 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/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
h3. Fragments de profils
h4. 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
* 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/group_membership -Dpattern="nom_groupe\.group_membership"
Import de tous les groupes du dossier :\\ ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/group_membership -Dpattern=".*\.group_membership"
\\ \\
le paramètre "pattern" accepte les expressions régulières\\
h4. Avec l'interface\\
Utilisez le canal "Gestionnaire de groupes" (Group Manager) |