REST.Backend.EMSServices.TEMSQueryAPI.Query

• Übergeordnet: TEMSQueryAPI

Delphi

procedure Query(const AClass: TBackendMetaClass;  const AQuery: array of string; const AJSONArray: TJSONArray); overload;
procedure Query(const AClass: TBackendMetaClass;  const AQuery: array of string; const AJSONArray: TJSONArray; out AObjects: TArray<TBackendEntityValue>); overload;

C++

void __fastcall Query(const Rest::Backend::Metatypes::TBackendClassValue AClass, const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray)/* overload */;
void __fastcall Query(const Rest::Backend::Metatypes::TBackendClassValue AClass, const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray, /* out */ System::DynamicArray<Rest::Backend::Metatypes::TBackendEntityValue> &AObjects)/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	protected	REST.Backend.EMSServices.pas REST.Backend.EMSServices.hpp	REST.Backend.EMSServices	TEMSQueryAPI

Beschreibung

Fragt den EMS-Server nach einer Liste von Objekten mit dem angegebenen Typ ab.

Query übernimmt die folgenden Parameter:

• AClass legt die Klasse der abzufragende Objekte fest.
• 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". Query fügt der Anforderung diese Schlüssel/Wertepaare als Parameter hinzu.
• Query füllt AJSONArray mit den Ergebnissen vom EMS-Server.

Wenn Sie Benutzer, Gruppen oder Installationen abfragen, können Sie optional ein Array mit TBackendEntityValue-Instanzen (AObjects) angeben, damit Query das Array mit den vom EMS-Server zurückgegebenen Objekten füllt.

Hinweis: Query unterstützt AObjects nur für Benutzer, Gruppen und Installationen. Sie können mit AObjects keine Module oder Modulressourcen abfragen.

Exceptions

Exception	Meldung	Beschreibung
EEMSClientAPIError	JSON-Objekt erwartet	Sie haben an Query ein Array mit TBackendEntityValue-Instanzen (AObjects) übergeben, aber Query kann dieses Array nicht füllen, weil die vom EMS-Server erhaltenen JSON-Daten eine unerwartete Struktur haben. Die erwartete Struktur der erhaltenen JSON-Daten ist ein JSON-Array mit JSON-Objekten. Die tatsächliche Struktur der erhaltenen JSON-Daten ist ein JSON-Array, das mindestens einen Eintrag enthält, der kein JSON-Objekt ist.
	MasterSecret erforderlich	Der Authentifizierungstyp ist TAuthentication.MasterSecret, und die Eigenschaft MasterSecret der Verbindungsinformationen des zugrunde liegenden EMS-Backend-Dienstes ist ein leerer String.
	Sitzungs-Token erforderlich	Der Authentifizierungstyp ist TAuthentication.Session, und Sie haben sich nicht angemeldet.
	Nicht unterstützter Backend-Abfragetyp: <AClass.BackendDataType>	Query unterstützt den Backend-Datentyp der angegebenen Klasse der abzufragenden Objekte nicht.

Siehe auch

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