Il seguente codice da un'applicazione esterna mostra alcuni dei metodi Session e DatabaseDesc. È necessario un oggetto Session per connettersi al database. L'oggetto Session consente di acquisire informazioni sul database (come la stringa di connessione SQL) e sull'utente attualmente collegato. È necessario effettuare tre passaggi:
Per ulteriori informazioni, consultare l'oggetto Session e l'oggetto DatabaseDesc.
Il seguente codice stampa le informazioni memorizzate nell'oggetto DatabaseDesc di Session, nonché tutte le informazioni relative all'utente. Questa routine secondaria utilizza un'altra routine denominata StdOut che stampa i relativi argomenti in una casella di messaggio.
' Connect via OLE to Rational ClearQuest
Set session = CreateObject("CLEARQUEST.SESSION")
' login_name, password, and dbname are Strings that have
' been set elsewhere
session.UserLogon "joe","", dbname, AD_PRIVATE_SESSION, ""
Set dbDesc = session.GetSessionDatabase
StdOut "DB name = " & dbDesc.GetDatabaseName
StdOut "DB set name = " & dbDesc.GetDatabaseSetName
' You must log in with superuser privilege or an error will be
' generated by GetDatabaseConnectString
StdOut "DB connect string = " & dbDesc.GetDatabaseConnectString
StdOut "user login name = " & session.GetUserLoginName
StdOut "user full name = " & session.GetUserFullName
StdOut "user email = " & session.GetUserEmail
StdOut "user phone = " & session.GetUserPhone
StdOut "misc user info = " & session.GetUserMiscInfo
StdOut "user groups:"
Set userGroups = session.GetUserGroups
If IsArray(userGroups) Then
for each onename in userGroups
StdOut " group " & onename
next
End If
REM Start of Global Script StdOut
sub StdOut(Msg)
msgbox Msg
end sub
REM End of Global Script StdOut
use lib "E:\\Program Files\\Rational\\common\\lib";
use CQPerlExt;
$CQsession = CQSession::Build();
$CQsession->UserLogon("admin", "", "perl2", "");
$dbDesc = $CQsession->GetSessionDatabase();
print "DB name = ", $dbDesc->GetDatabaseName(), "\n";
print "DB set name = ", $dbDesc->GetDatabaseSetName(), "\n";
print "DB connect string = ", $dbDesc->GetDatabaseConnectString(), "\n";
print "User login name = ", $CQsession->GetUserLoginName(), "\n";
print "User full name = ", $CQsession->GetUserFullName(), "\n";
print "User email = ", $CQsession->GetUserEmail(), "\n";
print "User phone = ", $CQsession->GetUserPhone(), "\n";
print "Misc user info = ", $CQsession->GetUserMiscInfo(), "\n";
print "User groups: \n";
$userGroups = $CQsession->GetUserGroups();
if (!@$userGroups) {
#Code to handle if no user groups exist
print "This user does not belong to any groups\n";
}
else {
# print out all groups
foreach $groupname (@$userGroups) {
print "Group $groupname\n";
}
}
CQSession::Unbuild($CQsession);