Item

Description

Returns the specified item in the collection.

The argument to this method can be either a numeric index (itemNum) or a String (name).

Syntax

VBScript

collection.Item(itemNum)
collection.Item(name)

Perl

$collection->Item(itemNum);
$collection->ItemByName(name);

Identifier

Description

collection

A Groups collection object, representing the set of groups associated with the current schema repository (master database).

itemNum

A Long that serves as an index into the collection. This index is 0-based so the first item in the collection is numbered 0, not 1.

name

A String that serves as a key into the collection. This string corresponds to the unique key of the desired Group object.

Return value

The Group object at the specified location in the collection.

Example

VBScript

set adminSession = CreateObject("ClearQuest.AdminSession")
adminSession.Logon "admin", "", ""
set groupList = adminSession.Groups
numGroups = groupList.Count
For x = 0 to numGroups -1
   set groupObj= groupList.Item(x)
   groupName = groupObj.Name
   msgbox groupName
Next

Perl

$adminSession= CQAdminSession::Build();
$adminSession->Logon ("admin", "", "");
$groupList = $adminSession->Groups();
$numGroups = $groupList->Count();
for (x = 0;$x < $numGroups ; $x++){
   $groupObj = $groupList->Item($x);
   $groupName = $groupObj->Name();
   print $groupName,"\n";
   }
CQAdminSession::Unbuild($adminSession);