OmniGroupServer 23.3

# GetGroups

Lists all the groups, alternative usernames, and user fields for users. When multiple users match the query, the resulting groups, alternative usernames and fields in the response are merged.

You can filter the users that match the query using the following parameters:

- Use the `Repository` parameter to restrict the query to specific repositories. If you do not set the `Repository` parameter, the action lists the information for all repositories specified by GroupServerDefaultRepositories in the OmniGroupServer configuration file.
- Use the `UserName` parameter to match a specific user name.
- Use the `FieldName` and `FieldValue` parameters to return information for users that have the field specified by `FieldName` with the value specified by `FieldValue`.

## Parameters

You must set either UserName, or FieldName and FieldValue:

Parameter | Description
--- | ---
FieldName | Return information for users that have this field with the value specified by FieldValue. This parameter is ignored if you set UserName.
FieldValue | Return information for users that have the field specified by FieldName with this value. This parameter is ignored if you set UserName.
UserName | The name of the user whose information is returned.

This action accepts the following optional parameters.

Parameter | Description
--- | ---
AltUsernames | A Boolean that specifies whether to return alternative user names.
Redirected | Allows the query to be performed against the repository.
Repository | The repositories from which you want to get information.

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
FileName | The file to write output to.
ForceTemplateRefresh | Forces the server to load the template from disk.
Output | Writes output to a file.
ResponseFormat | The format of the action output.
Template | The template to use for the action output.
TemplateParamCSVs | A list of variables to use for the specified template.

## Example

    /action=GetGroups&UserName=DOMAIN1%5cJSmith

This action instructs the group server to return information for the user `DOMAIN1\JSmith`.

    /action=GetGroups&FieldName=CompanyDepartment&FieldValue=Finance

This action instructs the group server to return information for any users that have the field `CompanyDepartment` with the value `Finance`.

## Response

The following is an example response to the action:

    action=GetGroups&UserName=DOMAIN1%5cJSmith&Repository=NT,eRoom

    <responsedata>
       <Groups>DOMAIN1\GROUPA</Groups>
       <Groups>DOMAIN1\GROUPB</Groups>
       <Groups>DOMAIN1\GROUPC</Groups>

       <Groups>DOMAIN2\GROUPA</Groups>
       <Groups>DOMAIN2\GROUPB</Groups>
       <Groups>DOMAIN2\GROUPC</Groups>
       <GroupCount>6</GroupCount>

       <UserName>DOMAIN1\JSMITH</UserName>
       <UserName alias_for="DOMAIN1\JSMITH">JohnS</UserName>
       <UserName alias_for="DOMAIN1\JSMITH">JS</UserName>

       <DisplayName>John Smith</DisplayName>
       <GivenName>John</GivenName>
       <Surname>Smith</Surname>
       <mail>john.smith@domain1.com</mail>

       <Error>Repository 'eRoom' not recognized</Error>
    </responsedata>

If you set both `GroupServerShowAlternativeNames=TRUE` and `GroupServerNumberAlternativeNames=TRUE`, the response instead contains:

    <UserName>DOMAIN1\JSMITH</UserName>
    <UserName0>DOMAIN1\JSMITH</UserName0>
    <UserName1>JohnS</UserName1>
    <UserName2>JS</UserName2>

TIP: It is expected that the primary username appears twice. The `alias_for` attribute is not included.

Setting `GroupServerNumberAlternativeNames=TRUE` is not recommended.

Copyright 2023 Open Text
Version 23.3 | Last updated June 2023

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL OmniGroupServer 23.3

Topic Title: GetGroups