Novell Confidential Manual (FRA) 28 October 2003
E
Commandes d’opérations eGuide
Ce chapitre décrit les paramètres qui permettent à la servlet Novell
®
eGuide d’exécuter certaines opérations. Ces commandes peuvent également être utilisées par d’autres applications pour communiquer avec la servlet eGuide.
Affichage des commandes d’opérations
1
2
3
Dans l’utilitaire d’administration eGuide, cliquez sur Débogage.
Sur la page Débogage, cochez la case Débogage.
Dans le fichier journal de eGuide ou sur la console du serveur d’applications, recherchez le terme Key: (Clé).
Pour chaque opération, les valeurs transmises à partir de l’URL ou via un formulaire de type
Post seront affichées avec Key: Name=value.
Paramètres de commandes et exemples
Aucune opération
Si aucune opération n’est indiquée sur la ligne de commande et en mode anonyme, l’opération eGuideForm est déclenchée. En mode d’authentification forcée, AuthForm est chargé.
Paramètre
Il n’existe aucun paramètre pour cette commande.
Exemple
http://www.nom_domaine.com/eGuide/servlet/eGuide
AuthForm
Il s’agit de l’opération par défaut en mode d’authentification forcée. Cette opération configure les cadres initiaux des pages de login et utilise authform.XSL qui déclenche l’opération vers
AuthHeader et AuthBody.
Paramètres
Paramètres
Action=AuthForm
Description
Commandes d’opérations eGuide
61
Novell Confidential Manual (FRA) 28 October 2003
AuthHeader
Cette opération est appelée après AuthForm pour terminer la configuration des cadres. Le fichier authheader.xsl est chargé par défaut.
Paramètres
Paramètre
Action=AuthHeader
User.context=rypxSbuoirAi
Description
Paramètre User.context vide qui crée une session
Exemple
Mode d’authentification forcée uniquement :
eGuide?Action=AuthHeader&User.context=rgyadiof
AuthBody
Paramètres
User.context=rypxSbuoirAi
Description
Paramètre User.context vide qui crée une session
Exemples
Mode d’authentification forcée :
http://www.nom_domaine.com/eGuide/servlet/eGuide
Mode d’authentification forcée uniquement :
http://www.nom_domaine.com/eGuide/servlet/eGuide?Action=AuthForm
Remarque :
Lorsque vous créez un thème sans cadre, supprimez les liens de Authform.xsl vers AuthHeader et AuthBody. Comme le processus d’authentification charge le paramètre authbody.xsl par défaut, authform.xsl et authbody.xsl doivent contenir les mêmes informations.
Cette opération est appelée pour configurer la page HTML d’authentification principale. Elle est accessible en mode anonyme à l’aide de l’opération Login. Le fichier authbody.xsl est chargé par défaut.
Paramètres
Paramètre
Action=AuthBody
User.context=rypxSbuoirAi
Description
Paramètre User.context vide qui crée une session
62
Guide d’administration de Novell eGuide 2.1.2
Novell Confidential Manual (FRA) 28 October 2003
Exemples
Mode d’authentification forcée uniquement :
eGuide?Action=AuthBody&User.context=rgyadiof
Mode anonyme :
eGuide?Action=Login&User.context=rgyadiof
Detail.get
Ces opérations affichent les détails de l’entrée LDAP à partir d’un annuaire spécifié.
Paramètres
Paramètre
Action=Detail.get
User.dn=cn=name,ou=name2,o=novell
Directory.uid=DirectoryName
Object.uid=USER
Description
Action
Nom distinctif de l’entrée
Ce nom vous sera communiqué par l’administrateur système de eGuide.
Catégorie de définition de l’entrée
Paramètre facultatif
User.context= stsh=other.xsl
RecurseDN=false
Description
Contrôle de session
Spécifie une feuille de style autre que celle par défaut.
Lit le DN et renvoie les informations qui y sont définies.
Exemple
eGuide?User.context=rytuUjkhhkAi&Action=Detail.get&User.dn=cn=userid,ou=org
,o=Novell&Directory.uid=Extensive&Object.uid=USER’
DetailEdit
Reportez-vous à « Detail.get », page 63 et remplacez l’opération par les opérations voulues. La
seule différence est que le document XML contient des informations supplémentaires pour ces opérations.
DetailModify
Reportez-vous à « Detail.get », page 63 et remplacez l’opération par les opérations voulues. La
seule différence est que le document XML contient des informations supplémentaires pour ces opérations.
Commandes d’opérations eGuide
63
Novell Confidential Manual (FRA) 28 October 2003
DetailUpdate
Cette opération met à jour l’entrée LDAP dans l’annuaire et renvoie les résultats.
Remarque :
Les attributs modifiés sont renvoyés à eGuide avec le nom clé de l’attribut et la valeur. La valeur doit être créée au format XML et codée avec la balise CDATA. Si le mot-clé « nochange » est détecté pour la valeur, l’attribut est ignoré et n’est pas mis à jour.
Paramètres
Paramètre
Action=DetailUpdate
User.dn=cn=name,ou=name2,o=novell
Directory.uid=DirectoryName
Description
Action
Nom distinctif de l’entrée
Ce nom vous sera communiqué par l’administrateur système de eGuide.
Object.uid=USER
AttributeKeyName=<undefined><value><![CDA
TA[new value]]</value></undefined>
Catégorie de définition de l’entrée
Paramètre facultatif
User.context= stsh=other.xsl
RecurseDN=false
Description
Contrôle de session
Spécifie une feuille de style autre que celle par défaut.
Remplace le DN par les informations sur l’utilisateur. Le paramètre par défaut est True.
Exemple
<form action="eGuide?&Action=DetailUpdate method="post" >
<input name=Directory.uid type=hidden value="novell">
<input name="User.context" type="hidden" value="eiadyda">
<input name="Object.uid" type="hidden" value="USER">
<input name="User.dn" type="hidden" value="cn=name,ou=organUnit,o=novell">
<input name="TITLE" type="text" value="<undefined><value> <![CDATA[new value]]>
</value> </undefined>" >
</form>
eGuideForm
Il s’agit de l’opération par défaut en mode anonyme ou après le processus d’authentification en mode d’authentification forcée.
Paramètres
Paramètre
Action= eGuideForm
Description
Action
64
Guide d’administration de Novell eGuide 2.1.2
Novell Confidential Manual (FRA) 28 October 2003
Paramètre
User.context=rypxSbuoirAi
Description
Paramètre User.context vide qui crée une session
Paramètre facultatif
stsh=otherform.xsl
Description
Spécifie une feuille de style autre que celle par défaut.
Exemple
Mode anonyme : eGuide ou eGuide?Action=eGuideForm&User.context=rgyadiof&stsh=otherform.xsl
eGuideHeader
Cette opération est appelée à partir du fichier eguideform.xsl et configure les catégories et attributs de recherche eGuide.
Paramètres
Paramètre
Action=eGuideHeader
User.context=rypxSbuoirAi
Search.rows=1
Description
Action
Paramètre User.context vide qui crée une session
Nombre de lignes de recherche à afficher par défaut
Paramètre facultatif
stsh=otherform.xsl
Description
Spécifie une feuille de style autre que celle par défaut.
Exemple
eGuide ou eGuide?Action=eGuideForm&User.context=rgyadiof&stsh=otherform.xsl
Commandes d’opérations eGuide
65
Novell Confidential Manual (FRA) 28 October 2003
eGuide.verifyCredentials
Cette opération est utilisée dans le processus d’authentification pour établir une connexion authentifiée à l’annuaire et vérifier les références des utilisateurs.
Paramètres
Paramètre
Action=eGuide.verifyCredentials
User.context=rypxSbuoirAi
Value1=
Value2=
Description
Action
Paramètre User.context vide qui crée une session
DN de l’utilisateur à authentifier
Mot de passe
Paramètre facultatif
RememberUserInfo=true
Description
Lorsque la valeur est true, ce paramètre stocke les références dans un cookie du navigateur.
Exemple
eGuide?eGuide.verifyCredentials&User.context=rypxSbuoirAi&DN=cn=Admin,o=nov ell
eGuide.verifyNewPassword
Cette opération est utilisée lorsque le délai d’expiration du mot de passe doit être redéfini.
Paramètres
Paramètre
Action=eGuide.verifyNewPassword
User.context=rypxSbuoirAi
OldPassword=
Value1=
Value2=
Description
Action
Paramètre User.context vide qui crée une session
Ancien mot de passe
Mot de passe
Mot de passe
Exemple
eGuide?Action=eGuide.verifyNewPassword&User.context=rypxSbuoirAi&OldPasswor d=old &Value1=new psswrd&Value2=new psswrd
66
Guide d’administration de Novell eGuide 2.1.2
Novell Confidential Manual (FRA) 28 October 2003
eGuide.selectContext
Cette opération est utilisée dans le processus d’authentification lors de la détection de plusieurs utilisateurs ayant le même ID de login.
Paramètres
Paramètre
Action=eGuide.selectContext
User.context=rypxSbuoirAi
DN=cn=name,o=container
Description
Action
Paramètre User.context vide qui crée une session
DN sélectionné à authentifier
Exemple
eGuide?eGuide.selectContext&User.context=rypxSbuoirAi&DN=cn=Admin,o=novell
List.get
Il s’agit d’une requête de recherche avec un filtre spécifié. Le résultat obtenu est une liste. Le filtre de recherche est appliqué à l’un ou à l’ensemble des annuaires configurés dans l’utilitaire d’administration de eGuide. Utilisez la clé max pour mettre en cache les résultats de liste supérieurs au jeu de valeurs, puis consultez l’opération List.get suivante pour connaître les listes en mémoire cache.
Paramètres
Paramètre
Action=list.get
val1=value attr1=attribute crit1=sw
Object.uid=USER
Search.attributes=attr1,attr2,attr3,...
Description
Action
Valeur de recherche
Nom de la clé d’attribut
Critères utilisés pour évaluer la valeur
Catégorie de recherche
Attributs renvoyés par une recherche
Paramètre facultatif
User.context=rypxSbuoirAi
Primary.sortkey=attr1
Secondary.sortkey=attr2
Description
Paramètre User.context vide qui crée une session
Premier attribut permettant de déterminer l’ordre de tri de la liste.
Deuxième attribut permettant de déterminer l’ordre de tri de la liste.
Commandes d’opérations eGuide
67
Novell Confidential Manual (FRA) 28 October 2003
Paramètre facultatif
max=20 stsh=otherform.xsl
Exemple
<form action="eGuide?&Action=List.get&Object.uid=USER&User.context=" method="post" >
<input name="Search.attributes" type="hidden" value="GIVENNAME,LASTNAME,DEPARTMENT">
<input name="Primary.sortkey" type="hidden" value="LASTNAME">
<input name="Secondary.sortkey" type="hidden" value="GIVENNAME">
<select name="crit1">
<option value="co">contains</option>
<option value="eq">equals</option>
<option selected="true" value="sw">starts with</option>
</select>
<select name="attr1">
<option value="GIVENNAME">First Name</option>
<option selected="true" value="LASTNAME">Last Name</option>
</select>
<input size="20" type="text" name="val1">
<input type="Submit">
</form>
List.get (liste en cache)
L’opération de liste, lorsqu’elle utilise les paramètres max et start, récupère les informations d’une liste précédemment mise en cache. L’utilisateur final observe une hausse significative des performances avec une liste mise en cache. La requête list.get initiale doit utiliser le paramètre max pour mettre en cache les résultats dans la session des utilisateurs. La valeur start indique ensuite à eGuide le point de départ dans la liste en cache. Utilisez les valeurs prev et next dans le fichier
XML pour déterminer la valeur start.
Paramètres
Paramètre
Action=list.get
start=100 max=20
Description
Nombre à afficher à tout moment dans le navigateur ; ce paramètre accélère la réalisation de la requête pour l’utilisateur final.
Spécifie une feuille de style autre que celle par défaut.
Description
Action
Spécifie le point de départ suivant de la liste.
Nombre à afficher à tout moment dans le navigateur ; ce paramètre accélère la réalisation de la requête pour l’utilisateur final.
Paramètre facultatif
stsh=otherform.xsl
User.context=rypxSbuoirAi
68
Guide d’administration de Novell eGuide 2.1.2
Description
Spécifie une feuille de style autre que celle par défaut.
Paramètre User.context vide qui crée une session
Novell Confidential Manual (FRA) 28 October 2003
Exemple
eGuide?Action=list.get&max=20&start=20&User.context=rypxSbuoirAi
List.get (avancé)
Il s’agit d’une requête de recherche avec un filtre spécifié. Le résultat obtenu est une liste. La différence entre l’opération de liste et l’opération de liste avancée tient au fait qu’il peut y avoir un nombre quelconque de valeurs et d’attributs envoyés dans la requête pour définir le filtre de recherche. Quel que soit le nombre de valeurs (paramètre val1,val2,val3) soumis, il doit y avoir le même nombre d’attributs (attr1,attr2,attr3) et de critères correspondants (crit1,crit2,crit3) soumis.
Les groupes d’attributs, de critères et de valeurs (attr1,crit1,val1), (attr2,crit2,val2) doivent être séparés par une valeur booléenne (aoval1).
Paramètres
Paramètre
Action=list.get
val1=valu1&val2=val2&val3=value3 attr1=attribute&attr2=attribute&attr3= attribute3 crit1=sw&crit2=cq&crit3=sw
Object.uid=USER
Search.attributes=attr1,attr2,attr3,...
Description
Action
Catégorie de recherche
Attributs renvoyés par la recherche
Paramètre facultatif
User.context=rypxSbuoirAi
Primary.sortkey=attr1
Secondary.sortkey=attr2 aoval1=and max=20 stsh=otherform.xsl
Description
Paramètre User.context vide qui crée une session
Premier attribut permettant de déterminer l’ordre de tri de la liste.
Deuxième attribut permettant de déterminer l’ordre de tri de la liste.
Pour les requêtes avancées, lors de la définition d’une recherche portant sur plusieurs valeurs
Spécifie le nombre à afficher à tout moment dans le navigateur ; ce paramètre accélère la réalisation de la requête pour l’utilisateur final.
Spécifie une feuille de style autre que celle par défaut.
Commandes d’opérations eGuide
69
Novell Confidential Manual (FRA) 28 October 2003
Login
Cette opération est généralement appelée pour authentifier le mode anonyme de eGuide.
Elle démarre le processus d’authentification et la feuille de style authbody.xsl est chargée.
Paramètres
Paramètre
Action=Login
Description
Action
Paramètre facultatif
User.context=rypxSbuoirAi
Description
Paramètre User.context vide qui crée une session
Exemple
eGuide?Action=Login&User.context=rypxSbuoirAi
OrgChart
Combinaison d’opérations de liste et d’opérations de détails. Cette opération récupère les informations sur le responsable dans un annuaire spécifié. Les subordonnés peuvent, quant à eux,
être récupérés dans plusieurs annuaires.
Paramètres
Paramètre
Action=Org.Chart
Directory.uid=DirectoryName
Manager.dn=cn=userid,o=org,o=novell attr1=Manager crit1=eq
Description
Action val1=cn=userid,o=org,o=novell
Search.attributes=GIVENNAME,LAST
NAME,ORGCHARTPARENTDN,ORG
CHARTISPARENT
Object.uid=USER
User.dn=cn=userid,ou=org,o=novell
70
Guide d’administration de Novell eGuide 2.1.2
Novell Confidential Manual (FRA) 28 October 2003
Paramètre facultatif
User.context=rypxSbuoirAi stsh=other.xsl
RecurseDN=false
Description
Paramètre User.context vide qui crée une session
Spécifie une feuille de style autre que celle par défaut.
Renvoie des informations sur l’utilisateur. Le paramètre par défaut est True.
Exemple
eGuide?User.context=rytuUjkhhkAi&Action=Org.Chart&Directory.uid=Extensive&U ser.dn=cn=nbjensen,ou=eGuide,ou=Demo,o=Novell&Object.uid=USER&Search.attrib
utes=GIVENNAME,INITIALS,LASTNAME,EMAIL,TITLE,ORGCHARTPARENTDN,ORGCHARTISPAR
ENT,&attr1=MANAGER&crit1=eq&Manager.dn=cn=Bgarrett,ou=eGuide,ou=Demo,o=Nove ll&val1=cn=Bgarrett,ou=eGuide,ou=Demo,o=Novell
OrgChartUpdate
Cette opération permet de mettre à jour l’attribut assigné à la clé ORCHARTPARENT.
Paramètres
Paramètre
Action=Org.Chart
Directory.uid=DirectoryName
Manager.dn=cn=userid,o=org,o=novell
Description
Action attr1=Manager crit1=eq val1=cn=userid,o=org,o=novell
Search.attributes=GIVENNAME,LAST
NAME,ORGCHARTPARENTDN,ORG
CHARTISPARENT
Object.uid=USER
TargetDN=cn=userid,ou=org,o=novell Modification utilisateur
AttrTargetValue=cn=admin,o=novell
AttrTargetName=ORGCHARTPAREN
TDN
Valeur à modifier
Nom de la clé d’attribut à mettre à jour
Commandes d’opérations eGuide
71
Novell Confidential Manual (FRA) 28 October 2003
Paramètre facultatif
User.context=rypxSbuoirAi stsh=other.xsl
RecurseDN=false
Description
Paramètre User.context vide qui crée une session
Spécifie une feuille de style autre que celle par défaut.
Renvoie des informations sur l’utilisateur. Le paramètre par défaut est True.
Exemple
Reportez-vous à « OrgChart », page 70 , mais ajoutez TargetDN, AttrTargetValue et
AttrTargetName en tant que paramètres.
PasswordModify
Cette opération permet de configurer l’affichage de la page en vue de modifier le mot de passe.
L’utilisateur final visualisera l’écran correspondant à son rôle. Un administrateur responsable d’utilisateurs (configuration dans l’utilitaire d’administration de eGuide) ou un utilisateur dont le rôle lui permet de modifier le mot de passe d’autres utilisateurs verra s’afficher deux champs d’entrée. Un utilisateur normal verra s’afficher trois champs.
Paramètres
Paramètre
Action=PasswordModify
Description
Action
User.dn=cn=name,ou=name2,o=novell Nom distinctif de l’entrée
Directory.uid=DirectoryName Ce nom vous sera communiqué par l’administrateur système de eGuide.
Object.uid=USER Catégorie de définition de l’entrée
Paramètre facultatif
User.context=rypxSbuoirAi
Description
Paramètre User.context vide qui crée une session
72
Guide d’administration de Novell eGuide 2.1.2
Novell Confidential Manual (FRA) 28 October 2003
PasswordUpdate
Cette opération permet de configurer l’affichage de la page en vue de modifier le mot de passe.
Paramètres
Paramètre Description
Action=PasswordUpdate Action
User.dn=cn=name,ou=name2,o=novell Nom distinctif de l’entrée
Directory.uid=DirectoryName
Object.uid=USER
Ce nom vous sera communiqué par l’administrateur système de eGuide.
Catégorie de définition de l’entrée
Value1=
Value2=
OldPassword=
Nouveau mot de passe
Nouveau mot de passe
Ancien mot de passe
Paramètre facultatif
User.context=rypxSbuoirAi
Description
Paramètre User.context vide qui crée une session
PhotoModify
Crée l’écran dans lequel l’utilisateur final ajoute ou supprime une photo et autorise l’affichage de sa photo.
Paramètres
Paramètre Description
Action=PhotoModify Action
User.dn=cn=name,ou=name2,o=novell Nom distinctif de l’entrée
Directory.uid=DirectroyName
Object.uid=USER
Ce nom vous sera communiqué par l’administrateur système de eGuide.
Catégorie de définition de l’entrée
Commandes d’opérations eGuide
73
Novell Confidential Manual (FRA) 28 October 2003
Paramètre facultatif
User.context=
RecurseDN=false
Description
Contrôle de session
Renvoie des informations sur l’utilisateur. Le paramètre par défaut est True.
Remarque :
User.context permet d’assurer le suivi de la session de l’utilisateur actuel. Lors d’une requête initiale, le paramètre User.context peut être omis. En revanche, toutes les pages suivantes doivent contenir ce paramètre.
74
Guide d’administration de Novell eGuide 2.1.2
Public link updated
The public link to your chat has been updated.