REST.Backend.EMSApi.TEMSClientAPI.QueryInstallations

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure QueryInstallations(const AQuery: array of string; const AJSONArray: TJSONArray); overload;
procedure QueryInstallations(const AQuery: array of string; const AJSONArray: TJSONArray; out AObjects: TArray<TInstallation>); overload;

C++

void __fastcall QueryInstallations(const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray)/* overload */;
void __fastcall QueryInstallations(const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray, /* out */ System::DynamicArray<TInstallation> &AObjects)/* 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 d'installations.

QueryInstallations 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". QueryInstallations ajoute ces paires clé-valeur à la requête en tant que paramètres.
  • QueryInstallations remplit AJSONArray avec les résultats provenant du serveur EMS.

Vous pouvez facultativement fournir un tableau d'instances de TInstallation (AObjects) pour que QueryInstallations remplisse le tableau avec les installations renvoyées par le serveur EMS.

Exceptions

Exception Message Description

EEMSClientAPIError

Objet JSON attendu

Vous avez transmis à QueryInstallations un tableau d'instances de TInstallation (AObjects), mais QueryInstallations 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