OmniGroupServer 25.2
OmniGroupServer Reference

# GetUser

Lists all the groups, alternative usernames, and user fields for the user specified by the `UserName` parameter.

The action lists the information for the repositories specified by the `Repositories` parameter. If you do not set the `Repositories` parameter, the action lists the information for all repositories specified by GroupServerDefaultRepositories in the OmniGroupServer configuration file. The results for each repository are concatenated.

    /action=GetUser[&Repository= ]
                    &Username=
                   [&AltUsernames=true/false]

## Parameters

The following action parameters are required.

Parameter | Description
--- | ---
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 get alternative user names.
Redirected | Allows the query to be performed against the repository.
Repository | The repositories from which you want to get user 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 instructs the group server to return information for the user `DOMAIN1\JSmith`.

## Response

Below is an example of an XML 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 2025 Open Text
Version 25.2 | Last updated April 2025

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 MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery OmniGroupServer 25.2

Topic Title: GetUser