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 int AQuery_High, System::Json::TJSONArray* const AJSONArray, bool AReset, const System::Sysutils::_di_TProc AAddParameters = System::Sysutils::_di_TProc());
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
protected | REST.Backend.EMSApi.pas REST.Backend.EMSApi.hpp |
REST.Backend.EMSApi | TEMSClientAPI |
Beschreibung
Fragt den EMS-Server nach einer Liste von Ressourcen mit dem angegebenen Ressourcentyp ab.
QueryResource übernimmt die folgenden Parameter:
AResource
ist der Zieltyp der Ressource.AQuery
ist ein Array mit Strings, wobei jeder String ein durch ein Gleichheitszeichen getrenntes Schlüssel/Wertepaar enthält, z. B. "my_parameter=my_value". QueryResource fügt der Anforderung diese Schlüssel/Wertepaare als Parameter hinzu.- QueryResource füllt
AJSONArray
mit den Ergebnissen vom EMS-Server. AReset
legt fest, ob QueryResource die Anforderungsparameter zurücksetzen (True
) oder anhand der Parameter Ihrer vorherigen Anforderung eine neue Anforderung erstellen soll (False
).Wenn Sie beispielsweise mehrere Anforderungen hintereinander erstellen möchten, die dieselben Parameter enthalten und nur eine anderes Ressource als Ziel haben, können Sie
False
alsAReset
übergeben, um eine bessere Leistung zu erzielen.
AAddParameters
(optional) ist eine Prozedur ohne Parameter, mit der Sie die Anforderung aktualisieren können. Beispielsweise können Sie der Anforderung Parameter hinzufügen.
Exceptions
Exception | Meldung | Beschreibung |
---|---|---|
MasterSecret erforderlich |
Authentication ist TAuthentication.MasterSecret und ConnectionInfo.MasterSecret ist ein leerer String. | |
Sitzungs-Token erforderlich |
Authentication ist TAuthentication.Session, und Sie haben sich nicht angemeldet oder das bei der Anmeldung (Login) angegebene Sitzungsauthentifizierungs-Token ist ein leerer String. |