Historique de la page

...

• • Déploiement : se placer dans le répertoire /ESCO-Grouper et lancer la commande commande :

ant deploy

• Étape 7 : Modification des fichiers d'aide en ligne si nécessaires (cf. §6.8).

• Étape 8 : Pour le mode portlet, il est nécessaire de copier les css dans les thèmes du portail.

 Le Le fichier à copier se trouve dans le répertoire ESCOGrouper/properties/css.

...

Tomcat prend en compte le nouveau war de la façon suivante suivante :

• En mode remote, prise en compte à chaud
• En mode local, redémarrage de Tomcat

...

Se placer dans le répertoire /ESCO-Grouper et lancer les commandes commandes :

ant init
ant deploy

...

Se placer dans le répertoire /ESCO-Grouper et lancer les commandes commandes :

ant dbinit
ant dbdeploy

...

Se placer dans le répertoire /ESCO-Grouper et lancer les commandes commandes :

ant init
ant dbdeploy
ant deploy

...

L'ensemble des fichiers de configuration à modifier se trouvent dans le répertoire /ESCO-Grouper/properties.

Ancre
build.properties build.properties

build.properties

Il s'agit du fichier d'environnement nécessaire à la compilation via la tâche ant.

Ancre
ESCOGrouper.properties ESCOGrouper.properties

ESCOGrouper.properties

Il s'agit du fichier de propriétés de l'application ESCO-Grouper.

...

• nécessaires à la génération de la base de données,
• communs à l'ensemble de l'application et qui sont nécessaires au bon fonctionnement de l'application.

 global.lang permet de définir les langues utilisées par l'application et ainsi vérifier lors de la génération des fichiers d'internationalisation que les libellés sont paramétrés dans l'ensemble des langues définies.

 default.rule.regexp.* définit l'expression régulière utilisée si aucune autre expression n'est définie pour la validation des champs.

...

Ce fichier concerne le paramétrage des pages relatives aux recherches recherches :

• Recherche de sujets sujets :
  • Personnes
  • Groupes
  • Personnes dans un groupe

• Recherche de dossiers

MyStem.properties

Ce fichier concerne le paramétrage des pages relatives aux dossiers dossiers :

• Propriétés de dossier
  • Attributs

• Création de dossier et Modification de dossier
  • Attributs
  • Modification de l'extension
  • Privilèges

MyGroup.properties

Ce fichier concerne le paramétrage des pages relatives aux groupes groupes :

• Propriétés de groupe
  • Attributs
  • Membres
  • Appartenances
  • Privilèges

• Création de groupe et Modification de groupe
  • Attributs
  • Droits par défaut
  • Type personnalisé
  • Privilèges

MyGroupDynamic.properties

Ce fichier concerne le paramétrage des pages relatives aux groupes dynamique dynamique :

• Onglet groupe dynamique
• Page Tester règle

...

Ce fichier concerne le paramétrage des pages relatives aux groupes groupes :

• Propriétés de personne :
• Attributs
• Appartenances
• Privilèges
• Abonnements

Ancre
Internationalisation Internationalisation

Internationalisation

Labels

Les fichiers contenant les libellés de l'application et qui ne sont pas créés par la génération de la base de données se trouvent dans les répertoires répertoires :

• /ESCO-Grouper/metier/esco-web/src/main/resources/properties/i18n/bundles/screen/
• /ESCO-Grouper/metier/esco-web/src/main/resources/properties/i18n/bundles/
• /ESCO-Grouper/metier/esco-module/dynamique-groupe/src/main/resources/properties/i18n/plugins/screen/

...

Il est possible de différencier les messages d'erreurs selon les écrans. Liste des préfixes pour les exceptions des résumés résumés :

• org.esco.grouperui.group.resume. : préfixe pour l'écran de résumé des propriétés de groupe.
• org.esco.grouperui.person.resume. : préfixe pour l'écran de résumé des propriétés de personne.
• org.esco.grouperui.stemmodification.resume. : préfixe pour l'écran de résumé d'administration d'un dossier.
• org.esco.grouperui.groupmodification.resume. : préfixe pour l'écran de résumé d'administration d'un groupe.

Exemple Exemple :

Par défaut lorsque l'exception ESCOGroupNotSaveException est levée le message « Le « Le groupe n'a pas été enregistré.  » » est affiché.

Si on souhaite avoir un message différent dans le résumé des propriétés de groupe, il suffit de définir une nouvelle clé dans le fichier Error_XX XX :

org.esco.grouperui.group.resume.ESCOGroupNotSaveException=Mon nouveau message

...

Les libellés des aides contextuelles se trouvent dans les différents fichiers d'internationalisation avec les clés se terminant par « « _TITLE »TITLE ».

Si la clé n'existe pas, l'aide contextuelle s'affichera avec "???CLE???".

Pour que l'aide contextuelle ne s'affiche pas, il suffit de retirer le libellé après la clé. Par exemple exemple :

STEM_CREATE_GROUP_TITLE=

Ancre
Strategies Strategies

Stratégies

Recherche de personnes

Le fichier grouper-api-strategy.xml permet de définir quelle stratégie de recherche de personnes est utilisée en fonction d'une expression évaluée.

...

Dans l'exemple ci-dessus, la stratégie "UAIStrategySubjectSearch" sera utilisée pour les groupes dont le path correspond à l'expression régulière indiquée.

Les variables disponibles pour l'expression sont sont:

• term term : le terme de recherche qui peut contenir des caractères joker joker ;
• path path : le chemin à partir duquel on effectue la recherche recherche ;
• person person : la personne effectuant la recherche.

...

Les variables disponibles pour l'expression sont sont :

• field field : attribut sur lequel l'utilisateur effectue la recherche. Les valeurs possibles sont name, displayName et extension extension ;
• type type : le type de la recherche (simple ou pour ajout). Les valeurs possibles sont SIMPLE et ADD ADD ;
• path path : le chemin à partir duquel on effectue la recherche recherche ;
• term term : le terme de recherche qui peut contenir des caractères joker joker ;
• subject subject : la personne effectuant la recherche.

...

Dans l'exemple ci-dessus, la stratégie "UAIStrategyRequestFactory" est utilisée pour les dossiers dont le nom correspond à l'expression régulière indiquée.

Les variables disponibles pour l'expression sont sont :

• stem stem : le dossier dans lequel l'utilisateur créé le groupe groupe ;
• person person : la personne effectuant la création.

Ancre
Profils Profils

Gestion des profils

Afin de pouvoir paramétrer l'application en fonction d'un utilisateur, il est possible de gérer différents profils.

Le profil peut être récupéré de deux manières différentes différentes :

• En passant dans l'url le paramètre profile=*nomDuProfil* si l'application est en mode servlet
• En récupérant le profil de la personne connectée sur le Portail si l'application est en mode portlet.

...

Le contenu d'un fichier de profil correspond à ceci ceci :

<?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd
		http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd">

<bean id="testProfile" class="org.esco.grouperui.web.beans.profile.UserProfile">
	<property name="name" value="testProfile"></property>
	<property name="functions">
		<map>
			<!--entry key="*uneClef*" value="*unBooléen*"></entry-->
			<entry key="org.esco.grouperui.web.stem.properties" value="true"></entry>
		</map>
	</property>
</bean>

<bean class="org.esco.grouperui.web.beans.profile.UserProfileAggregator">
	<description>Add the profile to the list of profiles or modify if exist.</description>
	<property name="profiles">
		<list>
			<ref bean="testProfile"></ref>
		</list>
	</property>
</bean>
</beans>

Ce fichier, par exemple, va créer un profil nommé « testProfile » « testProfile » qui va permettre aux utilisateurs ayant ce profil d'accéder aux propriétés de dossier dans l'application ESCO-Grouper.

Vous trouverez en annexe §7.4 un tableau récapitulatif des clefs possibles.

Ancre
ServeurSMTP ServeurSMTP

Serveur SMTP

Le serveur SMTP permet d'envoyer des mails dans le cas d'une erreur technique intervenu dans l'application.

Ce fichier smtp.xml ne doit être modifié que dans le cas où il existe plusieurs serveurs SMTP dédiés à l'application. Si un seul serveur est utilisé, la configuration s'effectue dans le fichier ESCOGrouper.properties.

Ancre
AideEnLigne AideEnLigne

Aide en ligne

Le fichier Help_XX.properties, qui se trouve dans le répertoire ESCOGrouper/metier/esco-web/src/main/resources/properties/i18n/bundles/screen, effectue le mapping entre les codes écran et l'emplacement des fichiers HTML contenant les aides.

Par exemple pour l'aide en ligne de la zone de navigation navigation :

ONLINE_HELP_NAVIGUATION_AREA_URL=/ESCOGrouper/stylesheets/onlineHelp/en/navigationArea.html

Les fichiers HTML peuvent être modifies à chaud sur le serveur Tomcat.

Remarque Remarque : les fichiers pouvant se trouver n'importe où sur le serveur Tomcat, il faut faire attention au chemin indiqué, surtout si le contexte de déploiement est différent.

...

Les fichiers de configurations modifiés pour installer l'application sont les suivants suivants :

• \ESCOGrouper\metier\esco-web\src\main\filters\filters.properties
• \ESCOGrouper\metier\esco-web\src\main\resources\properties\config.properties
• \ESCOGrouper\metier\esco-web\src\main\resources\properties\env.properties
• \ESCOGrouper\metier\esco-web\src\main\resources\properties\applicationContext.xml

...

Variables d'environnement requises dans grouper.client.properties

Variables d'environnement requises dans sources.xml

Variables d'environnement requises dans grouper.hibernate.properties

Variables d'environnement requises dans log4j.properties

...

Fichier de configuration d'ESCOGrouper lui-même. Il permet de configurer les variables d'environnement nécessaires à l'utilisation de CAS et définir les chemins relatifs d'accès aux médias.

...

Exemple de fichier sources.xml de grouper-ws

...