Description
Returns
a list of DBIDs of workspace items based on the input criteria.
Note: This
method became available in version 2002.05.00. In version 7.0.0.0 the limit
on the number of records that can be stored increased so the range of DBIDs
also increased. However, Rational ClearQuest clients earlier
than version 7.0.0.0 cannot display records with database identifiers (DBIDs)
higher than the former limit. For more information on DBIDs, see
Mit Datensätzen arbeiten
Syntax
VBScript
workspace.GetWorkspaceItemDbIdList folder_type, item_type, parent_dbid, entdef_name
Perl
$workspace->GetWorkspaceItemDbIdList
(folder_type, item_type, parent_dbid, entdef_name);
- Identifier
- Description
- workspace
- The Workspace object obtained from the current session.
- folder_type
- A Long containing the folder type as enumerated by WorkspaceFolderType.
The workspace folder types are:
Public folder items (_WORKSPACE_PUBLIC_FOLDER
= 1)
Personal folder items (_WORKSPACE_USER_FOLDER
= 2)
- item_type
- A Long containing a WorkspaceItemType enumerated constant.
- parent_dbid
- A Long corresponding to the DBID of the parent folder.
Set this to 0 for retrieving top folders.
- entdef_name
- A String containing the EntityDef name associated with
the workspace item. This argument can be empty.
- Return value
- For Visual Basic, returns an array of Variants (each containing
a String) that make up the list of DBIDs of workspace items. Each String names
one DBID.
For Perl, returns a reference to an array of
strings containing the DBID list.
Examples
VBScript
// Retrieves dbid for top public folder (returns a list of 1 item)
GetWorkspaceItemDbIdList(AD_WORKSPACE_PUBLIC_FOLDER, AD_WORKSPACE_FOLDER, 0,
"")
// Retrieves dbid for children folders of public query folder
GetWorkspaceItemDbIdList(AD_WORKSPACE_PUBLIC_FOLDER, AD_WORKSPACE_FOLDER,
33554440, "")