GetAccessibleDatabases

Descripción

Devuelve una lista de las bases de datos que están disponibles para que el usuario especificado inicie la sesión.

Este método sólo devuelve las bases de datos para las que el usuario especificado tiene permitido el inicio de sesión. Si el parámetro user_login_name contiene una serie vacía, este método devuelve una lista de todas las bases de datos asociadas al repositorio de esquemas especificado (base de datos maestra).

Puede examinar cada objeto DatabaseDesc para obtener el nombre de la base de datos correspondiente, el nombre del conjunto de bases de datos y otra información que necesite para iniciar la sesión en la misma.

Nota: El método GetAccessibleDatabases no requiere un inicio de sesión de usuario; se puede llamar desde un objeto Session construido antes de un inicio de sesión de usuario. Si se ha habilitado la autenticación LDAP, el nombre de inicio de sesión del usuario puede no ser el mismo que el nombre del usuario de Rational ClearQuest. Consulte el apartado Impacto sobre las API existentes para obtener más información.

Sintaxis

VBScript

session.GetAccessibleDatabases
(master_db_name,
user_login_name,database_set) 

Perl

session->GetAccessibleDatabases(master_db_name,
user_login_name,database_set) 
Identificador
Descripción
session
El objeto Session que representa la sesión de acceso a la base de datos actual.
master_db_name
Un valor String que especifica el nombre de la base de datos lógica de Rational ClearQuest del repositorio de esquemas. En la mayoría de los casos, este valor es "MASTR".
user_login_name
Un valor String que especifica el nombre de inicio de sesión del usuario. Al utilizar una serie vacía para este argumento, se indica a esta función que devuelva una lista de todas las bases de datos asociadas a este repositorio de esquemas, no sólo aquellas a las que puede acceder un usuario específico.
database_set
Un valor String que especifica el conjunto de bases de datos en el que buscar bases de datos a las que se puede acceder. De forma predeterminada, este argumento debe contener la serie vacía, puesto que causa que la función utilice el nombre del conjunto de bases de datos del producto predeterminado (es decir, el número de versión del producto).
Valor de retorno
Para VBScript, una matriz de variantes, conteniendo cada un objeto DatabaseDesc.

Para Perl, una recopilación del objeto DatabaseDescs.

Ejemplo

VBScript

set sessionObj = GetSession 

' Get the list of databases in the 
' master database set. 
databases = sessionObj.GetAccessibleDatabases("MASTR","admin","")
for each db in databases 
   ' Get the name of the database 
   dbName = db.GetDatabaseName 
   sessionObj.UserLogon "admin", "", dbName, AD_PRIVATE_SESSION, ""

   dbConnectString = db.GetDatabaseConnectString
Next



The following code provides a MsgBox indicating the connect vendor 
information and logical name for all the user databases in a specific dbset.

Sub Test()

Dim  session 

Dim databases

Dim dbConnectString

Dim dbConnectName

Dim db

Set session = CreateObject("CLEARQUEST.SESSION")

databases = session.GetAccessibleDatabases("MASTR", "admin", "")

session.UserLogon "admin", "", "SAMPL", AD_PRIVATE_SESSION, ""

For Each db In databases

   dbConnectString = db.GetDatabaseConnectString

   dbConnectName = db.GetDatabaseName

   MsgBox dbConnectString

   MsgBox dbConnectName

Next

End Sub 

Perl

use CQPerlExt;

#Start a Rational ClearQuest session

$sessionObj = CQSession::Build();

#Get a list of accessible databases
$databases = $sessionObj->GetAccessibleDatabases("MASTR", "admin", "");
$count = $databases->Count();

#Foreach accessible database, login as joe with password gh36ak3

for($x=0;$x<$count;$x++){

   $db = $databases->Item($x);
   $dbName = $db->GetDatabaseName();
   # Logon to the database 
   $sessionObj->UserLogon( "joe", "gh36ak3", $dbName, "" );
   #...
   }
CQSession::Unbuild($sessionObj); 

Feedback