LocatorServiceProvider

The LocateServiceProvider web service provides access to the default business unit group. It supports the BusinessUnits, DefaultBusinessUnitGroup and BusinessUnitGroups methods.

BusinessUnits

You can use the BusinessUnits method to obtain a list of the available business units. These are represented by the authenticated voucher passed in the authentication parameter. The BusinessUnits method returns the list in a string array. An empty string is returned if the authentication voucher is invalid or no business unit groups are accessible to the user.

string[] BusinessUnits(
    string authentication       //an authentication voucher
)

DefaultBusinessUnitGroup

The DefaultBusinessUnitGroup method is used to obtain the default business unit group for the user represented by the authentication voucher passed in the authentication parameter. The method returns a string containing a valid business unit group if the authentication was valid and the user had a default business unit. The method returns null if the authentication failed or the user did not have a default business unit group.

string DefaultBusinessUnitGroup(
    string authentication       //an authentication voucher
)

BusinessUnitGroups

The BusinessUnitGroups method is used to obtain a list of the available business unit groups that are accessible to the user represented by the authenticated voucher passed in the authentication parameter. It returns the list in a string array. It returns an empty string array if the authentication voucher was invalid or no business unit groups were accessible to the user.

string[] BusinessUnitGroup(
    string authentication       //an authentication voucher
)