18.2 Configuration du portlet Organigramme
Pour configurer le portlet Organigramme, procédez comme suit :
|
Étape |
Tâche |
Description |
|---|---|---|
|
1 |
Définissez la relation à afficher |
Vous pouvez utiliser l'une des relations prédéfinies installées avec l'application utilisateur Identity Manager, ou bien en créer une. Pour plus d'informations sur la définition d'une relation, reportez-vous au Section 4.0, Configuration de la couche d'abstraction de l'annuaire. |
|
2 |
Vérifiez que les entités et les attributs que vous voulez utiliser dans la relation sont disponibles dans la couche d'abstraction de l'annuaire |
Pour plus d'informations sur la définition d'une relation, reportez-vous à la Section 18.2.1, Configuration de la couche d'abstraction de l'annuaire. |
|
3 |
Déterminez à quel endroit vous voulez afficher cette relation |
Voulez-vous créer une nouvelle page pour le lancement de l'organigramme ? Ou bien, voulez-vous le lancer à partir du portlet Détails ou d'un autre organigramme ? Pour plus d'informations sur la création de pages et l'ajout de portlets à ces pages, reportez-vous au Section 7.0, Administration des pages. |
|
4 |
Définissez les préférences pour le portlet |
Les préférences permettent de définir :
Pour plus d'informations, reportez-vous à la Section 18.2.2, Définitions des préférences d'organigramme. |
|
5 |
Testez |
Testez les définitions et la présentation de la relation. |
|
6 |
Définissez les droits eDirectory et établissez au besoin les index nécessaires pour améliorer les performances |
Droits effectifs : pour afficher les attributs définis par le portlet, les utilisateurs doivent posséder le droit de lire les attributs. Amélioration des performances : les performances d'affichage de l'organigramme peuvent être améliorées en ajoutant un index de valeur eDirectory à l'attribut enfant de la relation. Cet attribut est en effet utilisé pour effectuer une recherche LDAP. |
18.2.1 Configuration de la couche d'abstraction de l'annuaire
Les entités et les attributs affichés dans un organigramme doivent être définis dans la couche d'abstraction de l'annuaire. Le tableau suivant répertorie les attributs et propriétés que vous devez définir pour chaque entité et attribut affiché dans un organigramme.
|
Type de définition |
Paramètre |
Valeur |
|---|---|---|
|
entité |
afficher |
Sélectionné (Vrai) |
|
attribut |
lire |
Sélectionné (Vrai) |
|
rechercher |
Sélectionné (Vrai) |
Conditions requises pour le lien RechercherLe lien Rechercher permet aux utilisateurs de naviguer dans l'organigramme en effectuant des recherches d'autres objets du même type que la Clé d'entité du parent. Cette clé doit posséder au moins un attribut avec les propriétés d'accès require et search définies comme vraies (sélectionnées dans l'éditeur de la couche d'abstraction de l'annuaire). Sinon, la boîte de dialogue Recherche de l'objet du lien Recherche ne peut pas être renseignée et s'affiche vide.
Pour plus d'informations sur la configuration d'entité et d'attribut, reportez-vous au Section 4.0, Configuration de la couche d'abstraction de l'annuaire.
18.2.2 Définitions des préférences d'organigramme
Vous définissez deux types de préférences :
Préférences de relation d'organigramme
Les préférences de relation d'organigramme sont contenues dans une seule page de préférences.
.
.
.
|
Préférence |
Que faut-il faire ? |
|---|---|
|
Présentations |
Cliquez sur Afficher/Modifier les préférences personnalisées pour accéder aux préférences de présentation. Elles sont décrites dans Préférences de présentation d'organigramme. |
|
Clé de la relation |
Saisissez la clé de la relation. Cette valeur doit correspondre à l'une des clés de relation spécifiées dans la couche d'abstraction de l'annuaire. |
|
Clé d'entité du parent |
Saisissez le DN de l'entité représentant le noeud racine de l'organigramme à afficher. Pour afficher l'organigramme de l'utilisateur courant, saisissez ${User/id}. Le paramètre ${User/id} résout le DN de l'utilisateur courant. Cette valeur doit exister dans les noeuds spécifiés par la propriété search-root dans la couche d'abstraction de l'annuaire, sinon la recherche LDAP échoue. Voici quelques exemples de DN valides (avec l'exemple de données) :
cn=jmiller,ou=users,ou=sample,o=novell
cn=Accounting,ou=groups,ou=sample,o=novell |
|
Profondeur par défaut |
Spécifie la profondeur de l'organigramme au premier affichage.
etc. Si cette valeur est incrémentée à une valeur supérieure à la Profondeur maximale (ci-dessous), la valeur Profondeur maximale prévaut. |
|
Profondeur maximale |
Définit la profondeur maximale qu'un utilisateur peut atteindre dans un organigramme. Ne la confondez pas avec la possibilité de naviguer dans un organigramme restreint par des droits effectifs. |
|
Apparence OrgChart |
Business Card (Carte de visite) eGuide Novell.com Wired (Câblé) True Blue (Bleu intense) |
|
Connecter les câbles aux éléments |
Spécifie si les cartes de l'organigrammes sont reliées par des câbles. Faux signifie qu'elles ne sont pas reliées. |
|
Timeout du menu |
Nombre de millisecondes avant disparition du menu actuellement affiché (pour les liens intégrés). |
|
Présentation sous forme d'arborescence |
Définit l'orientation, la répartition et l'apparence de l'organigramme par niveau de profondeur. Les n premières valeurs définissent l'orientation, la répartition et l'apparence des niveaux 0 à n-1. La dernière valeur est répétée pour les niveaux supérieurs à n-1. Les valeurs doivent être comprises entre 0 et 5. Valeurs : 0 : placer la carte au-dessus d'une liste verticale d'éléments 1 : aligner au-dessus d'une liste verticale d'éléments 2 : placer la carte au-dessus d'une liste horizontale d'éléments 3 : aligner au-dessus d'une liste horizontale d'éléments 4 : placer la carte avant une liste verticale d'éléments 5 : aligner avant une liste verticale d'éléments |
|
Présentation de la page |
Définit l'orientation, la répartition et l'apparence de l'organigramme pour la profondeur maximale d'une branche |
|
Largeur minimum de l'élément |
Cette valeur doit être égale à round('item min height' * 1.618) |
|
Hauteur minimum de l'élément |
Cette valeur doit être égale à round('item min width' / 1.618) |
|
Séparateur pour les attributs à plusieurs valeurs |
Caractère utilisé comme séparateur pour les attributs comportant plusieurs valeurs. |
Préférences de présentation d'organigramme
Ces préférences permettent de définir la présentation HTML pour l'affichage des entrées de l'organigramme. Vous pouvez utiliser l'éditeur HTML de votre choix pour une édition plus précise. Reportez-vous à Pour utiliser un éditeur externe.
Présentation HTML pour les cartes de visite : il s'agit de la présentation par défaut.
Présentation HTML pour l'affichage simple : présentation affichée lorsque la préférence Présentation sous forme d'arborescence est définie à 1.
Éditeur HTMLPour accéder à l'éditeur HTML, cliquez sur le bouton Édition. L'éditeur HTML se présente ainsi :
Utilisation de l'éditeur HTML
L'éditeur HTML offre une interface WYSIWYG pour définir la présentation des pages de l'organigramme. Il offre les fonctions classiques d'un éditeur HTML afin de définir la mise en forme du texte, des listes, des points d'ancrage, des images, etc. Utilisez la liste déroulante Mots-clés pour placer les attributs, les commandes et les URL de navigation dans la zone de conception. Lorsque vous choisissez un mot-clé dans la liste déroulante, il est inséré avec la syntaxe adéquate, mais vous avez également la possibilité d'ajouter du code HTML dans la zone de conception.
Mots-clésLors de la conception de votre présentation, la liste déroulante Mots-clés permet d'insérer des variables qui seront remplacées à l'exécution par des valeurs d'attribut spécifiques. Vous pouvez également saisir les références à ces mots-clés selon la syntaxe suivante :
$[[mot-clé]]
Où mot-clé est la valeur d'un attribut d'entité comme Nom.
Vous pouvez concaténer des attributs en utilisant la syntaxe suivante :
$[[mot-clé+mot-clé]]
Par exemple :
$[[Prénom+Nom]]
Vous pouvez concaténer autant d'attributs que vous le souhaitez, mais aussi inclure des chaînes entre guillemets, de la manière suivante :
$[[mot-clé+”exemple de texte”+mot-clé]]
Cela affichera les valeurs des mots-clés et le texte entre guillemets.
REMARQUE:Si un mot-clé est saisi avec une erreur de frappe dans une présentation, il sera affiché tel quel dans l'organigramme (y compris $[[]]).
Utilisation des fonctions et des mots-clés de l'éditeur HTMLPour utiliser les fonctions et la liste déroulante des mots-clés de l'éditeur HTML :
|
Fonction |
Procédé |
|---|---|
|
Bouton Créer un lien |
Pour insérer un lien : Dans Mozilla :
Dans Internet Explorer :
REMARQUE:Si votre image ou votre URL se trouve dans le quadrant supérieur gauche de l'éditeur HTML, la fenêtre contextuelle la recouvre. Étant donné que cette fenêtre ne peut pas être déplacée, vous devez créer le texte voulu ailleurs dans l'éditeur, puis le couper et le coller au bon emplacement. |
|
Bouton Ajouter une image |
Dans Mozilla :
Dans Internet Explorer :
REMARQUE:Si votre image ou votre URL se trouve dans le quadrant supérieur gauche de l'éditeur HTML, la fenêtre contextuelle la recouvre. Étant donné que cette fenêtre ne peut pas être déplacée, vous devez créer le texte voulu ailleurs dans l'éditeur, puis le couper et le coller au bon emplacement. |
|
Liste déroulante des mots-clés : attributs |
Il s'agit des attributs disponibles pour cette entité. |
|
Liste déroulante des mots-clés : commandes |
Ces commandes permettent au portlet Organigramme de lancer d'autres portlets d'identité ou des fonctions intégrées comme IM ou les outils de messagerie électronique.
Pour des exemples illustrant les boutons générés, reportez-vous à Liens intégrés. |
|
URL |
Lien URL de navigation OrgChart : permet de spécifier une URL ou un attribut d'entité qui s'affichera sous forme de lien. Lorsque les utilisateurs cliquent sur le lien, le portlet Organigramme réapparaît avec l'entité cliquée devenue noeud racine. Restriction : Valide uniquement lorsque les entités Parent et Enfant d'une relation ont le même type d'objet. Par exemple, dans la relation Gestionnaire-Employé, les deux sont des utilisateurs. Conseils d'utilisation : Pour utiliser ce mot-clé, vous devez :
<a href="javascript:$[[@NavUrl]]">someText</a>
où someText est le lien à afficher au moment de l'exécution, ou bien un attribut d'entité. Dans l'exemple suivant, Click here devient un lien activable par clic. <a href="javascript:$[[@NavUrl]]">Click here</a> Dans l'exemple suivant, l'attribut FirstName devient un lien activable par clic : <a href="javascript:$[[@NavUrl]]">$[[FirstName]]</a> Restriction d'utilisation : Avec Internet Explorer, la syntaxe suivante est incorrecte.
<a href="$[[@NavUrl]]">someText</a>
Lors d'une opération d'enregistrement, Internet Explorer ajoute : http://context before $[[@NavUrl]] Ainsi,
<a href="$[[@NavUrl]]">someText</a>
devient
<a href="http://localhost/.../$[[@NavUrl]]">someText</a>
ce qui produira un affichage incorrect à l'exécution. |
|
Lien Clic de navigation OrgChart : utilisez ce mot-clé pour un événement onClick. Cela permet de réactualiser uniquement la zone du portlet Organigramme plutôt que la page entière. Conseils d'utilisation : Pour utiliser ce mot-clé, vous devez :
<A href="javascript:return false;" onClick="$[[@NavClick]]">$[[SomeAttribute]]</A>
où SomeAttribute est un attribut d'entité qui devient un lien activable par clic. Le code "javascript:return false;" est requis. Sinon, une erreur se produira. |
Pour enregistrer votre présentation, cliquez sur Soumettre.
Pour utiliser un éditeur externeProcédez ainsi :
-
Créez le source HTML pour les attributs de l'entité, les commandes et les mots-clés en utilisant l'Éditeur de présentation HTML disponible dans les préférences.
-
Copiez le source HTML dans l'éditeur de votre choix.
-
Effectuez les modifications souhaitées.
-
Lorsque l'édition est terminée, recopiez le source HTML dans l'Éditeur de présentation HTML.
18.2.3 Chargement dynamique des images
Pour afficher des images, comme les photos des utilisateurs, stockées dans le coffre-fort d'identité, vous pouvez ajouter le nom de l'attribut à la carte de visite. Par exemple, ajoutez l'attribut Photo de l'utilisateur à la carte de visite pour afficher la photo de celui-ci.
Si vous stockez des images hors du coffre-fort d'identité, vous devez utiliser la balise IMG: dans le mode Afficher la source de l'éditeur HTML, de la manière suivante :
-
Accédez aux préférences du portlet Organigramme et ouvrez l'éditeur HTML.
-
Cliquez sur Afficher la source.
-
Utilisez la balise IMG: pour combiner un emplacement, une clé d'attribut et une extension de fichier selon la syntaxe suivante :
$[[IMG:”URL” + attribute-key-name + ”fileextension”]]
L'exemple suivant illustre la syntaxe à utiliser si vous avez stocké les photos des employés sous forme d'images JPG par Nom dans le sous-répertoire /images de votre serveur d'applications :
$[[IMG:"http://myhost:8080/images/"+LastName+".jpg"]]
À l'exécution, l'organigramme concatène l'URL avec l'attribut LastName et l'extension de fichier .jpg.
Notez que l'éditeur HTML prend en charge une syntaxe souple. En effet, il admet toute combinaison de texte et d'attributs dans la syntaxe suivante :
$[[IMG:”some text” + attribute-key-name + ...]]