Pages enfant
  • e) Modifications et redéploiements

Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
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}
&nbsp;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}
&nbsp;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"

&nbsp;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)