Groupe 3 (services applicatifs)
Date de création :	16 octobre 2003
Dernière modification :	01 Février 2005
Diffusion :	internet

Le canal annuaire

Utilisations

Utilisateur

Le canal est accessible directement sur un onglet.
Si vous avez accès à plusieurs annuaire, une liste déroulante vous est proposée. Lorsque vous sélectionnez un annuare, le formulaire se met à jour automatiquement.
Entrez les critères et lancez la recherche.
Si plusieurs résultats correspondent votre recherche, une liste apparait avec des informations partielles. Vous pouvez alors cliquer sur l'une des colonne (en général le nom) pour acceder à la fiche détaillée.
Si il n'y a qu'un résultat, vous arrivez directement sur la fiche détaillée.
Eventuellement, les adresses mail sont cliquables et vous avez accès au canal "mailTo". (cf documentation).

Vous êtes dans le cadre d'un canal, dit "maître", et vous avez besoin de rechercher une personne. Vous arrivez alors sur le formulaire identique à celui obtenu en mode normal. Lorsque vous aurez effectué la recherche, vous pourrez sélectionner 1 ou plusieurs personnes et les ajouter dans le canal "maître".

Depuis un canal, vous gérez ou vous voyez des noms d'utilisateurs, vous aurez un lien. Ce lien va vous permettre d'arriver directement sur la fiche détaillée de la personne.

Développeur

Vous n'avez rien à modifier.

Importez la classe de chargement de l'annuaire

import org.esupportail.portal.channels.CAnnuaire.*;

private IServant annuaireServant; //servant object
private String[] listeNomPers; // liste des personnes récupérées par le formulaire (checkbox)

//create annuaireServant
try
{
	//set static data paramters for servant
	staticData.setParameter("serverView", "*");
	staticData.setParameter("returnServant", "multiple"); // single
	//create annuaire servant
	annuaireServant = CAnnuaireServantFactory.getAnnuaireServant(staticData);

	//set runtime data for servant
	((IChannel)annuaireServant).setRuntimeData(runtimeData);

	 // si on ne doit récupèrer qu'un seul résultat, on vide la hashtable à chaque exécution
	 if (staticData.getParameter("returnServant") != null && staticData.getParameter("returnServant").equals("single")) {
		 listePersMemo.clear();
	 }
}
catch(PortalException e)
{
	LogService.log(LogService.ERROR, "CServantTest: could not create Annuaire servant: " + e);
}

if (annuaireServant != null){

	//while in servant mode, pass runtime data on to the servant
	((IChannel)annuaireServant).setRuntimeData(runtimeData);

	// récupération de la liste des personnes sélectionnées
	listeNomPers = runtimeData.getParameterValues("pers_id[]");

	// ou récupération d'une personne unique
	nomPers = runtimeData.getParameter("pers_id");

	//if servant is finished, remove
	if (((IServant)annuaireServant).isFinished())
	{
		annuaireServant = null;
	}
}

Vous devez connaitre le nom du canal (nom donné par l'administrateur à l'instanciation) et le d'un annuaire accessible dans ce canal. Le dernier paramètre à connaître est bien sûr l'identifiant de la personne.
Créez un lien avec tous ces paramètres pour laisser l'utilisateur accèder à la fiche perso de la personne.
exemple :

"<lienUportal>?uP_fname=CAnnuaire&annuaire=annuaireDuPersonnel&id=sgaudin"

Administrateur

Vous devez déclarer le canal dans le portail de la manière habituelle. Vous pouvez passer le paramètre serverView pour limitter la vision des annuaires pour cette instanciation. Comme valeur de ce paramètre, vous devez inscrire les "codes" des anuaires.
Si vous précisez plusieurs annuaires, vous devez les séparer par des virgules. Vous pouvez aussi mettre "*" pour avoir tous les annuaires déclarés dans le fichier de configuration. (Si vous ne précisez pas de paramètres, cela équivaut à mettre "*".)

Par besoin d'instanciation spécifique.

Pour permettre aux développeur l'utilisation en mode fiche, il faut déclarer le canal comme pour une utilisation standant.

Lors de la déclaration du canal par l'administrateur, celui-ci peut saisir le 'code' (cf name dans la configuration) de l'annuaire concerné dans le parametre "serverView". Il peut éventuellement saisir une liste de code,séparés par des virgules, voire "*" pour tous les annuaires. Dans ces cas, un menu déoulant permet à l'utilisateur de choisir l'annuaire de travail. Par défaut, si le paramètre n'est pas saisi, cela équivaut à mettre "*".

Le menu déroulant s'affiche dans le même ordre que celui saisi par l'administrateur. Le premier annuaire est celui par défaut.

Création : 16 octobre 2003 - Sébastien GAUDIN
Modifications : 22/10/2003 : Vincent Mathieu 14/01/2004 : Sébastien GAUDIN 14/01/2005 : Sébastien GAUDIN 01/02/2005 : Sébastien GAUDIN