REST.Backend.EMSApi.TEMSClientAPI.QueryGroups
Delphi
procedure QueryGroups(const AQuery: array of string;
const AJSONArray: TJSONArray); overload;
procedure QueryGroups(const AQuery: array of string;
const AJSONArray: TJSONArray; out AGroups: TArray<TGroup>); overload;
C++
void __fastcall QueryGroups(const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray)/* overload */;
void __fastcall QueryGroups(const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray, /* out */ System::DynamicArray<TGroup> &AGroups)/* overload */;
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
procedure function |
public | REST.Backend.EMSApi.pas REST.Backend.EMSApi.hpp |
REST.Backend.EMSApi | TEMSClientAPI |
Description
Queries the EMS server for a list of groups.
QueryGroups receives the following parameters:
AQuery
is an array of strings where each string must contain a key-value pair separated by an equal sign, such as "my_parameter=my_value". QueryGroups adds those key-value pairs to the request as parameters.- QueryGroups fills
AJSONArray
with the results from the EMS server.
You may optionally provide an array of instances of TGroup (AGroups
), so that QueryGroups fills the array with the groups that the EMS server returns.
Exceptions
Exception | Message | Description |
---|---|---|
JSON object expected |
You passed QueryGroups an array of instances of TGroup ( The expected structure of the received JSON data is a JSON array of JSON objects. Each one of those objects represents a user. The actual structure of the received JSON data is a JSON array that contains one or more items that are not JSON objects. | |
MasterSecret required |
Authentication is TAuthentication.MasterSecret and ConnectionInfo.MasterSecret is an empty string. | |
Session token required |
Authentication is TAuthentication.Session and you did not log in or the session authentication token that you provided to Login is an empty string. |
See Also
- REST.Backend.EMSApi.TEMSClientAPI.CreateGroup
- REST.Backend.EMSApi.TEMSClientAPI.RetrieveGroup
- REST.Backend.EMSApi.TEMSClientAPI.RetrieveGroupsFields
- REST.Backend.EMSApi.TEMSClientAPI.UpdateGroup
- REST.Backend.EMSApi.TEMSClientAPI.AddUsersToGroup
- REST.Backend.EMSApi.TEMSClientAPI.RemoveUsersFromGroup
- REST.Backend.EMSApi.TEMSClientAPI.RetrieveGroupsNames
- REST.Backend.EMSApi.TEMSClientAPI.RetrieveUserGroups
- REST.Backend.EMSApi.TEMSClientAPI.DeleteGroup