El espacio de trabajo de Rational ClearQuest consta de una jerarquía de carpetas en las que se almacenan consultas, públicas e informes. El objeto Workspace (WorkSpaceMgr para Perl) proporciona una interfaz para manipular las consultas, los informes y las gráficas que se han guardado en el espacio de trabajo de Rational ClearQuest.
Puede utilizar este objeto:
Si ya dispone de un objeto Session, puede obtener el objeto Workspace asociado a la sesión actual llamando al método GetWorkSpace del objeto Session.
Si no dispone de un objeto Session, el código de VB puede crear un nuevo objeto Workspace directamente utilizando el método CreateObject, tal como se indica a continuación:
set wkspcObj = CreateObject("CLEARQUEST.WORKSPACE")
El código de Perl utiliza la sintaxis siguiente:
$wkspcObj = new CQWorkSpaceMgr
Para utilizar un objeto Workspace utilizando CreateObject, le debe asignar un objeto Session. Para asignar un objeto Session, debe llamar al método SetSession del objeto Workspace.
Puede utilizar los métodos del objeto Workspace para obtener información sobre el contenido del espacio de trabajo de Rational ClearQuest. Puede obtener una lista de las consultas, las gráficas o los informes del espacio de trabajo. También puede separar elementos en base a si se encuentran en la carpeta Consultas públicas o en la carpeta Consultas personales de un usuario.
Cada tipo de carpeta se designa como una carpeta pública o de usuario (personal), que se enumera en el WorkspaceFolderType. Las dos carpetas superiores de un espacio de trabajo siempre son una carpeta pública y una carpeta personal, que se crean de modo automático al crear la base de datos de usuario de Rational ClearQuest.
También puede utilizar este objeto para volver a guardar consultas en el espacio de trabajo.
Cada elemento del espacio de trabajo tiene un dbid asignado, y el tipo correspondiente se enumera en WorkspaceItemType, en clearquest.bas.