REST.Backend.EMSApi.TEMSClientAPI.QueryResource
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 System::NativeInt 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
commeAReset
pour de meilleures performances.
AAddParameters
(facultatif) est une procédure sans paramètres que vous pouvez utiliser pour mettre à jour la requête. Par exemple, vous pouvez ajouter des paramètres à la requête.
Exceptions
Exception | Message | Description |
---|---|---|
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. |