REST.Backend.EMSApi.TEMSClientAPI.QueryResource

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure QueryResource(const AResource: string;  const AQuery: array of string; const AJSONArray: TJSONArray; AReset: Boolean; const AAddParameters: TProc = nil);

C++

void __fastcall QueryResource(const System::UnicodeString AResource, const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray, bool AReset, const System::Sysutils::_di_TProc AAddParameters = System::Sysutils::_di_TProc());

Propriétés

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


Description

Demande au serveur EMS une liste de ressources du type de ressource spécifié.

QueryResource reçoit les paramètres suivants :

  • AResource est le type de ressource cible.
  • 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". QueryResource ajoute ces paires clé-valeur à la requête en tant que paramètres.
  • QueryResource remplit AJSONArray avec les résultats provenant du serveur EMS.
  • AReset détermine si QueryResource doit réinitialiser les paramètres de requête (True) ou générer votre nouvelle requête par dessus les paramètres de votre requête précédente (False).

    Par exemple, si vous voulez effectuer plusieurs requêtes sur une ligne qui contient les mêmes paramètres et que vous ciblez simplement une autre ressource, vous pouvez transmettre False comme AReset pour de meilleures performances.

Exceptions

Exception Message Description

EEMSClientAPIError

MasterSecret requis

Authentication a la valeur TAuthentication.MasterSecret, et ConnectionInfo.MasterSecret est une chaîne vide.

Token de session requis

Authentication est 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