NGOGetGroupListExt

This call is used to get the List of Groups available in the Cabinet. The gGroups can be fetched and sorted on Name or Index. Sorting can be done on ascending or descending order. The gGroup lLists fetched are in batches. User has to specify the Previous index Index value and Previous ssort field value. The call returns the total number of gGroups in the sSystem and the number of gGroups fetched in the current batch.

All Groups, of which a particular User is a member, can also be fetched through the call. UserIndex can be specified to get the gGroups for that particular User (i.e., the gGroups of which the User is a member).

Input Parameter description	View sample InputXml
Output Parameter description	View sample OutputXml
Errors and Warnings

Input Parameters description

Name	Parent Tag	Description	Valid Values	Default Values
Option	Root	Unique option for the call.	NGOGetGroupList Ext	N/A
CabinetName	Root	Name of the Cabinet to which the User wants to connect.		N/A
UserDBId	Root	UserDatabase ID, which that is returned in the NGOConnect Cabinet call.		N/A
UserIndex	Root	UserIndex can be specified to get the groupGroups for that particular User (i.e., the groupGroups of which the User is member).		Not considered
GroupType	Root	Type of the groups whichGroups that are to be fetched in the groupGroup listList.	‘G’ – General ‘A’ – Reserved ‘B’ - Both	‘G’
OrderBy	Root	Indicates the field on which the groupGroup lList will be sorted. For example, e.g. Name of the GroupGroup, Index of Groupthe Group etc.	1 – GroupGroupIndex 2 - GroupName	N/A
SortOrder	Root	Indicates whether groupGroup lList is to be sorted in Ascending order or Descending order.	‘A’ – Ascending ‘D’ - Descending	‘A’
PreviousIndex	Root	This tag is meant for the last Index of the groupGroup received in the previous batch. For the first batch 0 is to be sent.	Integer >= 0	N/A
NoOfRecords ToFetch	Root	Specifies the Number of rRecords to be fetched in the current batch.	Integer > 0	N/A
LastSortField	Root	This tag is meant for the value of the sorted column of the last groupGroup received in the previous batch.		Blank
MainGroup Index	Root	This parameter is Reserved . The default value can be sent.	Integer >= 0	0

Output Parameters description

Name	Parent Tag	Description
Option	Root	Unique option for the call.
Status	Root	Status of the call. If the Status is 0, then the call is successful.
NoOfRecordsFetched	Root	Number of rRecords fetched in the current batch.
TotalNoOfRecords	Root	Used for getting groupGroup lList in batches. The value for the TotalNoOfRecords fetched in output will be one greater than the NoOfRecordsFetched; if more records exist in the database otherwise both the values will be the same.
Groups	Root	Contains information about the groupGroups fetched in the current batch.
Group	Groups	Contains information about one groupGroup of the current batch.
GroupIndex	Group	Index of the groupGroup.
MainGroupIndex	Group	This parameter is Reserved.
GroupName	Group	Name of the groupGroup.
CreationDateTime	Group	Date and Time of creation of the groupGroup.
ExpiryDateTime	Group	Date and Time of expiry of the groupGroup.
Privileges	Group	Privileges of the groupGroup.
OwnerIndex	Group	Index of the Owner of the groupGroup.
OwnerName	Group	Name of Owner of the groupGroup.
Comment	Group	Any comment associated with the groupGroup.
GroupType	Group	Type of the groupGroup, namely ‘G’ for General, ‘A’ is Reserved.

Errors returned from call

Code	Message	Comments
-50074	Invalid parameters.	Some parameters passed to the call are invalid. For example, E.g. GroupType specified is not valid. It can be either “G”,”A”,”B”.