REST.Backend.EMSApi.TEMSClientAPI.QueryResource

• Übergeordnet: TEMSClientAPI

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());

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 als AReset ü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
EEMSClientAPIError	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.

Siehe auch

• REST.Backend.EMSApi.TEMSClientAPI.AddResource
• REST.Backend.EMSApi.TEMSClientAPI.PutResource
• REST.Backend.EMSApi.TEMSClientAPI.DeleteResource

• 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