CreateUserLDAPAuthenticated

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);

Feedback