Descrizione
Crea
un account utente Rational ClearQuest con
un'autenticazione LDAP. Imposta il nuovo account utente AuthenticationMode
come LDAP_AUTHENTICATION.
Questo metodo utilizza due argomenti:
- Un nome di accesso utente LDAP (LDAP_login_name)
- Un nome del profilo utente Rational ClearQuest
(CQ_user_name)
Il metodo CreateUserLDAPAuthenticated copia
un valore dell'attributo LDAP dall'account utente LDAP nel campo profilo utente ClearQuest
per associare un nome utente LDAP ad un nome utente Rational ClearQuest.
Per prima cosa, il metodo verifica
il repository schema per accertare che non siano presenti conflitti con un altro valore del
campo
CQLDAPMap dell'utente abilitato LDAP attivo per garantire
valori univoci per gli utenti abilitati LDAP attivi.
Nota: il campo del profilo utente
Rational ClearQuest
utilizzato per il collegamento di record utente LDAP ai record utente ClearQuest
è il campo
CQLDAPMap.
Se CQ_LOGIN_NAME è stato configurato
come il campo di associazione (utilizzando il comando secondario installutil setcqldapmap per
specificare quale campo del profilo utente Rational ClearQuest
viene utilizzato per il collegamento di LDAP e di account utente ClearQuest),
il parametro CQ_user_name deve essere identico
a LDAP_login_name o deve essere impostato su una stringa nulla.
Nota: il chiamante
di questo metodo deve disporre dei privilegi di Amministratore per richiamare questo metodo
(ovvero, il valore UserPrivilegeMaskType, USER_ADMIN).
L'errore si verifica se:
- Il chiamante del metodo non dispone dei privilegi di Amministratore per eseguire questa
operazione
- Non è possibile individuare l'account utente LDAP (LDAP_login_name)
- Esiste un account utente Rational ClearQuest in
conflitto (CQ_user_name) con lo stesso nome
- Il valore dell'attributo LDAP utilizzato per associare un LDAP ad un utente Rational ClearQuest
non viene richiamato
- CQ_LOGIN_NAME è configurato come il campo di associazione ma
il parametro CQ_user_name non è identico a LDAP_login_name o
è impostato su una stringa nulla.
- L'attributo LDAP da inserire all'interno del campo CQLDAPMap è in conflitto
con un altro attributo esistente, valore del campo CQLDAPMap abilitato LDAP.
Nota: questo metodo
è disponibile nella versione 2003.06.14.
Sintassi
VBScript
adminSession.CreateUserLDAPAuthenticated(LDAP_login_name, CQ_user_name)
Perl
$adminSession->CreateUserLDAPAuthenticated(LDAP_login_name, CQ_user_name);
- Identificativo
- Descrizione
- adminSession
- L'oggetto AdminSession rappresenta la sessione di accesso corrente del repository schema.
- LDAP_login_name
- Una stringa contenente il nome di accesso utente per l'autenticazione LDAP (ad esempio,
myUniqueName@ibm.com).
- CQ_user_name
- Una stringa contenente il nome del profilo utente Rational ClearQuest
che verrà memorizzato nel database ClearQuest. Tale nome non
deve corrispondere ad alcun nome account utente ClearQuest esistente.
- Valore di ritorno
- Nessuno in caso di operazione riuscita, in caso contrario restituisce un'eccezione.
Esempi
VBScript
' Create a Rational ClearQuest admin session
set adminSession = CreateObject("ClearQuest.AdminSession")
' Logon as admin
adminSession.Logon "admin", "admin", ""
' Create an LDAP authenticated user
Dim cquser2 ' a user object
Dim ldap_login
Dim cq_username
Dim mode
' the user authentication mode
ldap_login = "myusername@us.ibm.com"
cq_username = "myusername"
StdOut "Creating LDAP authenticated user " & ldap_name & vbCrLf
Set cquser2 = admin_session.CreateUserLDAPAuthenticated(ldap_login, cq_username)
' verify the user authentication mode:
StdOut "Getting authentication mode for user " & cquser2.name & vbCrLf
mode = cquser2.GetAuthenticationMode
StdOut "user mode: " & CStr(mode) & vbCrLf
Perl
use CQPerlExt;
#Create a Rational ClearQuest admin session
$adminSession= CQAdminSession::Build();
#Logon as admin
$adminSession->Logon( "admin", "admin", "" );
my $ldap_login = "myusername@us.ibm.com";
my $cq_username = "myusername";
my $newUserObj;
$newUserObj = $adminSession->CreateUserLDAPAuthenticated($ldap_login, $cq_username);
# ...
CQAdminSession::Unbuild($adminSession);