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
Utilisation d'enregistrements
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, "")