Novell Documentation: eGuide 2.1.1 - Parametri dei comandi ed esempi

Parametri dei comandi ed esempi

Nessuna azione

Se non viene sottoposta alcuna azione nella riga di comando e in modalità anonima, viene inizializzata l'azione eGuideForm. Nella modalità di autenticazione obbligatoria, viene caricato AuthForm.

Parametro

Parametro	Descrizione
Nessuno

Esempio

http://www.domainname.com/eGuide/servlet/eGuide

AuthForm

Azione di default in modalità di autenticazione obbligatoria. Questa azione imposta i frame iniziali per le pagine di login e utilizza il file Authform.XSL, il quale inizializza l'azione su AuthHeader e AuthBody.

Parametri

Parametri	Descrizione
Action=AuthForm
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.

Esempi

Modalità di autenticazione obbligatoria:

http://www.domainname.com/eGuide/servlet/eGuide

Modalità di sola autenticazione obbligatoria:

http://www.domainname.com/eGuide/servlet/eGuide?Action=AuthForm

NOTA: durante la creazione di un tema senza frame, rimuovere i collegamenti a AuthHeader e AuthBody presenti in Authform.XSL. Poiché durante il processo di autenticazione il file Authbody.XSL viene caricato per default, Authform.XSL e Authbody.XSL devono contenere le stesse informazioni.

AuthHeader

Questa azione viene richiamata dopo AuthForm per completare la configurazione dei frame. Il file Authheader.XSL viene caricato per default.

Parametri

Parametro	Descrizione
Action=AuthHeader
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.

Esempio

Modalità di sola autenticazione obbligatoria:

eGuide?Action=AuthHeader&User.context=rgyadiof

AuthBody

Questa azione viene richiamata per configurare la pagina HTML di autenticazione principale. È possibile accedere a tale pagina in modalità anonima, mediante l'azione Login. Il file Authheader.XSL viene caricato per default.

Parametri

Parametro	Descrizione
Action=AuthBody
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.

Esempi

Modalità di sola autenticazione obbligatoria:

eGuide?Action=AuthBody&User.context=rgyadiof

Modalità anonima:

eGuide?Action=Login&User.context=rgyadiof

Detail.get

Queste azioni consentono di visualizzare i dettagli della voce LDAP da una directory specificata.

Parametri

Parametro	Descrizione
Action=Detail.get	Azione
User.dn=cn=nome,ou=nome2,o=novell	Nome distinto della voce.
Directory.uid=NomeDirectory	Contattare l'amministratore di sistema di eGuide per informazioni su questo nome.
Object.uid=USER	Categoria di definizione della voce.

Parametro opzionale	Descrizione
User.context=	Controllo della sessione.
stsh=other.xsl	Specifica un foglio di stile diverso da quello di default.
RecurseDN=false	Legge il DN e restituisce le informazioni in esso definite.

Esempio

eGuide?User.context=rytuUjkhhkAi&Action=Detail.get&User.dn=cn=userid,ou=org,o=Novell&Directory.uid=Extensive&Object.uid=USER'

DetailEdit

Vedere Detail.get e sostituire l'azione con le azioni desiderate. L'unica differenza consiste nel fatto che nel documento XML sono presenti informazioni aggiuntive per queste azioni.

DetailModify

Vedere Detail.get e sostituire l'azione con le azioni desiderate. L'unica differenza consiste nel fatto che nel documento XML sono presenti informazioni aggiuntive per queste azioni.

DetailUpdate

Questa azione aggiorna la voce LDAP nella directory e restituisce i risultati.

NOTA: gli attributi modificati vengono restituiti a eGuide con il nome chiave dell'attributo e il valore. Il valore deve essere creato in formato XML e il tag CDATA deve essere utilizzato per la disposizione del testo. Se viene individuata la parola chiave "nochange" per il valore, l'attributo viene ignorato e non viene aggiornato.

Parametri

Parametro	Descrizione
Action=DetailUpdate	Azione
User.dn=cn=nome,ou=nome2,o=novell	Nome distinto della voce.
Directory.uid=NomeDirectory	Contattare l'amministratore di sistema di eGuide per informazioni su questo nome.
Object.uid=USER	Categoria di definizione della voce.
AttributeKeyName=<undefined><value><![CDATA[new value]]</value></undefined>

Parametro opzionale	Descrizione
User.context=	Controllo della sessione.
stsh=other.xsl	Specifica un foglio di stile diverso da quello di default.
RecurseDN=false	Sostituisce il DN con le informazioni sull'utente. Il valore di default è True.

Esempio

<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

Azione di default in modalità anonima o dopo il processo di autenticazione nella modalità di autenticazione obbligatoria.

Parametri

Parametro	Descrizione
Action= eGuideForm	Azione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.

Parametro opzionale	Descrizione
stsh=otherform.xsl	Utilizzato per specificare un foglio di stile diverso da quello di default.

Esempio

Modalità anonima:

eGuide

oppure

eGuide?Action=eGuideForm&User.context=rgyadiof&stsh=otherform.xsl

eGuideHeader

Azione richiamata dal file Eguideform.XSL, che consente di configurare gli attributi e le categorie di ricerca di eGuide.

Parametri

Parametro	Descrizione
Action=eGuideHeader	Azione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.
Search.rows=1	Numero delle righe di ricerca da visualizzare per default.

Parametro opzionale	Descrizione
stsh=otherform.xsl	Utilizzato per specificare un foglio di stile diverso da quello di default.

Esempio

eGuide

oppure

eGuide?Action=eGuideForm&User.context=rgyadiof&stsh=otherform.xsl

eGuide.verifyCredentials

Azione utilizzata durante il processo di autenticazione per eseguire una connessione autenticata alla directory e verificare le credenziali degli utenti.

Parametri

Parametro	Descrizione
Action=eGuide.verifyCredentials	Azione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.
Value1=	DN dell'utente da autenticare.
Value2=	Parola d'ordine.

Parametro opzionale	Descrizione
RememberUserInfo=true	Se impostato su true, memorizza le credenziali sotto forma di cookie nel browser.

Esempio

eGuide?eGuide.verifyCredentials&User.context=rypxSbuoirAi&DN=cn=Admin,o=novell

eGuide.verifyNewPassword

Azione utilizzata quando la parola d'ordine viene riconosciuta come scaduta e deve essere reimpostata.

Parametri

Parametro	Descrizione
Action=eGuide.verifyNewPassword	Azione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.
OldPassword=	Parola d'ordine precedente.
Value1=	Parola d'ordine.
Value2=	Parola d'ordine.

Esempio

eGuide?Action=eGuide.verifyNewPassword&User.context=rypxSbuoirAi&OldPassword=old &Value1=new psswrd&Value2=new psswrd

eGuide.selectContext

Azione utilizzata durante il processo di autenticazione quando vengono individuati più utenti con lo stesso ID di login.

Parametri

Parametro	Descrizione
Action=eGuide.selectContext	Azione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.
DN=cn=nome,o=container	DN selezionato da autenticare.

Esempio

eGuide?eGuide.selectContext&User.context=rypxSbuoirAi&DN=cn=Admin,o=novell

List.get

Richiesta di ricerca con un filtro specifico, che restituisce un elenco come set di risultati. Il filtro di ricerca viene applicato a una o tutte le directory configurate nell'utility di amministrazione di eGuide. Utilizzare la chiave max per memorizzare nella cache i risultati dell'elenco di dimensione superiore al valore impostato, quindi vedere la successiva azione List.get per gli elenchi memorizzati nella cache.

Parametri

Parametro	Descrizione
Action=list.get	Azione
val1=valore	Valore da ricercare.
attr1=attributo	Nome chiave attributo.
crit1=sw	Criterio utilizzato per valutare il valore.
Object.uid=USER	Categoria di ricerca.
Search.attributes=attr1,attr2,attr3,...	Attributi restituiti da una ricerca.

Parametro opzionale	Descrizione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.
Primary.sortkey=attr1	Primo attributo utilizzato per determinare il tipo di ordinamento applicato all'elenco.
Secondary.sortkey=attr2	Secondo attributo utilizzato per determinare il tipo di ordinamento applicato all'elenco.
max=20	Numero di risultati da visualizzare sul browser alla volta; l'esecuzione della richiesta risulta più rapida per l'utente finale.
stsh=otherform.xsl	Specifica un foglio di stile diverso da quello di default.

Esempio

<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 (elenco memorizzato nella cache)

Quando si utilizzano i parametri max e start, questa azione relativa all'elenco recupera le informazioni da un elenco precedentemente memorizzato nella cache. L'uso di un elenco memorizzato nella cache consente agli utenti finali di riscontrare un significativo aumento delle prestazioni. È necessario che nella richiesta list.get originale sia utilizzato il parametro max, al fine di memorizzare nella cache i risultati nella sessione degli utenti. Quindi il valore start indica a eGuide il punto da cui iniziare il recupero delle informazioni nell'elenco memorizzato nella cache. Utilizzare i valori prev e next nel file XML per determinare il valore con cui iniziare.

Parametri

Parametro	Descrizione
Action=list.get	Azione
start=100	Punto di inizio successivo nell'elenco.
max=20	Numero di risultati da visualizzare sul browser alla volta; l'esecuzione della richiesta risulta più rapida per l'utente finale.

Parametro opzionale	Descrizione
stsh=otherform.xsl	Specifica un foglio di stile diverso da quello di default.
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.

Esempio

eGuide?Action=list.get&max=20&start=20&User.context=rypxSbuoirAi

List.get (avanzato)

Richiesta di ricerca con un filtro specifico, che restituisce un elenco come set di risultati. L'azione relativa all'elenco avanzata si differenzia da quella semplice per il fatto che un numero qualsiasi di valori e attributi può essere inviato nell'interrogazione per definire il filtro di ricerca. A qualsiasi numero di valori (parametro val1,val2,val3) inviato deve corrispondere lo stesso numero di attributi (attr1,attr2,attr3) e di criteri di supporto (crit1,crit2,crit3). Ciascun set di attributi, criteri e valori (attr1,crit1,val1), (attr2,crit2,val2) deve essere separato da un valore booleano (aoval1).

Parametri

Parametro	Descrizione
Action=list.get	Azione
val1=valu1&val2=val2&val3=value3
attr1=attribute&attr2=attribute&attr3=attribute3
crit1=sw&crit2=cq&crit3=sw
Object.uid=USER	Categoria di ricerca.
Search.attributes=attr1,attr2,attr3,...	Attributi restituiti dalla ricerca.

Parametro opzionale	Descrizione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.
Primary.sortkey=attr1	Primo attributo utilizzato per determinare il tipo di ordinamento applicato all'elenco.
Secondary.sortkey=attr2	Secondo attributo utilizzato per determinare il tipo di ordinamento applicato all'elenco.
aoval1=and	Per le ricerche avanzate, quando si definiscono più valori su cui eseguire la ricerca.
max=20	Specifica il numero di risultati da visualizzare sul browser alla volta; l'esecuzione della richiesta risulta più rapida per l'utente finale.
stsh=otherform.xsl	Specifica un foglio di stile diverso da quello di default.

Login

Azione richiamata in genere per eseguire l'autenticazione quando eGuide è in modalità anonima. Consente di avviare il processo di autenticazione e di caricare il foglio di stile Authbody.XSL.

Parametri

Parametro	Descrizione
Action=Login	Azione

Parametro opzionale	Descrizione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.

Esempio

eGuide?Action=Login&User.context=rypxSbuoirAi

Org.Chart

Combinazione delle azioni relative all'elenco e ai dettagli. Le informazioni sui responsabili vengono recuperate da una directory specificata, mentre quelle sui subordinati possono essere recuperate da più directory.

Parametri

Parametro	Descrizione
Action=Org.Chart	Azione
Directory.uid=NomeDirectory
Manager.dn=cn=idutente,o=org,o=novell
attr1=Manager
crit1=eq
val1=cn=idutente,o=org,o=novell
Search.attributes=GIVENNAME,LASTNAME,ORGCHARTPARENTDN,ORGCHARTISPARENT
Object.uid=USER
User.dn=cn=idutente,ou=org,o=novell

Parametro opzionale	Descrizione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.
stsh=other.xsl	Specifica un foglio di stile diverso da quello di default.
RecurseDN=false	Restituisce le informazioni sull'utente. Il valore di default è true.

Esempio

eGuide?User.context=rytuUjkhhkAi&Action=Org.Chart&Directory.uid=Extensive&User.dn=cn=nbjensen,ou=eGuide,ou=Demo,o=Novell&Object.uid=USER&Search.attributes=GIVENNAME,INITIALS,LASTNAME,EMAIL,TITLE,ORGCHARTPARENTDN,ORGCHARTISPARENT,&attr1=MANAGER&crit1=eq&Manager.dn=cn=Bgarrett,ou=eGuide,ou=Demo,o=Novell&val1=cn=Bgarrett,ou=eGuide,ou=Demo,o=Novell

OrgChartUpdate

Consente di aggiornare l'attributo mappato alla chiave ORCHARTPARENT.

Parametri

Parametro	Descrizione
Action=Org.Chart	Azione
Directory.uid=NomeDirectory
Manager.dn=cn=idutente,o=org,o=novell
attr1=Manager
crit1=eq
val1=cn=idutente,o=org,o=novell
Search.attributes=GIVENNAME,LASTNAME,ORGCHARTPARENTDN,ORGCHARTISPARENT
Object.uid=USER
TargetDN=cn=idutente,ou=org,o=novell	Utente che apporta la modifica.
AttrTargetValue=cn=admin,o=novell	Valore che si desidera modificare.
AttrTargetName=ORGCHARTPARENTDN	Nome chiave dell'attributo da aggiornare.

Parametro opzionale	Descrizione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.
stsh=other.xsl	Specifica un foglio di stile diverso da quello di default.
RecurseDN=false	Restituisce le informazioni sull'utente. Il valore di default è true.

Esempio

Vedere Org.Chart . Aggiungere tuttavia i parametri TargetDN, AttrTargetValue e AttrTargetName.

PasswordModify

Consente di configurare la vista della pagina per la modifica della parola d'ordine. La vista varia in base al ruolo dell'utente finale. Per un amministratore degli utenti (configurato nell'utility di amministrazione di eGuide) o per un utente a cui è associato il ruolo per la modifica delle parole d'ordine di altri utenti, vengono resi disponibili due campi di input. Per un utente finale standard, i campi di input disponibili sono tre.

Parametri

Parametro	Descrizione
Action=PasswordModify	Azione
User.dn=cn=nome,ou=nome2,o=novell	Nome distinto della voce.
Directory.uid=NomeDirectory	Contattare l'amministratore di sistema di eGuide per informazioni su questo nome.
Object.uid=USER	Categoria di definizione della voce.

Parametro opzionale	Descrizione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.

PasswordUpdate

Parametri

Parametro	Descrizione
Action=PasswordUpdate	Azione
User.dn=cn=nome,ou=nome2,o=novell	Nome distinto della voce.
Directory.uid=NomeDirectory	Contattare l'amministratore di sistema di eGuide per informazioni su questo nome.
Object.uid=USER	Categoria di definizione della voce.
Value1=	Nuova parola d'ordine.
Value2=	Nuova parola d'ordine.
OldPassword=	Parola d'ordine precedente.

Parametro opzionale	Descrizione
User.context=rypxSbuoirAi	Parametro User.context non specificato per la creazione di una nuova sessione.

PhotoModify

Crea la vista della pagina che consente all'utente finale di aggiungere o rimuovere una fotografia e di accettare un contratto per la pubblicazione delle fotografie.

Parametri

Parametro	Descrizione
Action=PhotoModify	Azione
User.dn=cn=nome,ou=nome2,o=novell	Nome distinto della voce.
Directory.uid=NomeDirectory	Contattare l'amministratore di sistema di eGuide per informazioni su questo nome.
Object.uid=USER	Categoria di definizione della voce.

Parametro opzionale	Descrizione
User.context=	Controllo della sessione.
RecurseDN=false	Restituisce le informazioni sull'utente. Il valore di default è true.

NOTA: il parametro User.context consente di tenere traccia della sessione dell'utente attuale. Sebbene sia possibile omettere User.context al momento di una richiesta iniziale, tale parametro deve essere contenuto in qualsiasi pagina successiva.