REST.Backend.EMSApi.TEMSClientAPI.QueryGroups

• Aller au parent : TEMSClientAPI

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 */;

Propriétés

Type	Visibilité	Source	Unité	Parent
procedure function	public	REST.Backend.EMSApi.pas REST.Backend.EMSApi.hpp	REST.Backend.EMSApi	TEMSClientAPI

Description

Demande au serveur EMS une liste de groupes.

QueryGroups reçoit les paramètres suivants :

• AQuery est un tableau de chaînes où chaque chaîne doit contenir une paire clé-valeur séparée par un signe égal, comme "mon_paramètre=ma_valeur". QueryGroups ajoute ces paires clé-valeur à la requête en tant que paramètres.
• QueryGroups remplit AJSONArray avec les résultats provenant du serveur EMS.

Vous pouvez facultativement fournir un tableau d'instances de TGroup (AGroups) pour que QueryGroups remplisse le tableau avec les groupes renvoyés par le serveur EMS.

Exceptions

Exception	Message	Description
EEMSClientAPIError	Objet JSON attendu	Vous avez transmis à QueryGroups un tableau d'instances de TGroup (AGroups), mais QueryGroups ne peut pas compléter ce tableau car la structure des données JSON reçues du serveur EMS est inattendue. La structure attendue des données JSON reçues est un tableau JSON d'objets JSON. Chacun de ces objets représente un utilisateur. La véritable structure des données JSON reçues est un tableau JSON contenant un ou plusieurs éléments qui ne sont pas des objets JSON.
	MasterSecret requis	Authentication a la valeur TAuthentication.MasterSecret, et ConnectionInfo.MasterSecret est une chaîne vide.
	Token de session requis	Authentication a la valeur TAuthentication.Session, et vous ne vous êtes pas connecté ou le token d'authentification de session fourni lors de la connexion est une chaîne vide.

Voir aussi

• 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

• REST.Backend.EMSApi.TEMSClientAPI.QueryUsers
• REST.Backend.EMSApi.TEMSClientAPI.QueryModules
• REST.Backend.EMSApi.TEMSClientAPI.QueryModuleResources
• REST.Backend.EMSApi.TEMSClientAPI.QueryInstallations

• REST.Backend.EMSServices.TEMSQueryAPI.Query

• REST.Backend.EMSApi.TEMSClientAPI.QueryResource