REST.Backend.EMSApi.TEMSClientAPI.QueryInstallations

• Übergeordnet: TEMSClientAPI

Delphi

procedure QueryInstallations(const AQuery: array of string; const AJSONArray: TJSONArray); overload;
procedure QueryInstallations(const AQuery: array of string; const AJSONArray: TJSONArray; out AObjects: TArray<TInstallation>); overload;

C++

void __fastcall QueryInstallations(const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray)/* overload */;
void __fastcall QueryInstallations(const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray, /* out */ System::DynamicArray<TInstallation> &AObjects)/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	REST.Backend.EMSApi.pas REST.Backend.EMSApi.hpp	REST.Backend.EMSApi	TEMSClientAPI

Beschreibung

Fragt den EMS-Server nach einer Installationenliste ab.

QueryInstallations übernimmt die folgenden Parameter:

• 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". QueryInstallations fügt der Anforderung diese Schlüssel/Wertepaare als Parameter hinzu.
• QueryInstallations füllt AJSONArray mit den Ergebnissen vom EMS-Server.

Sie können optional ein Array mit TInstallation-Instanzen (AObjects) angeben, damit QueryInstallations das Array mit den vom EMS-Server zurückgegebenen Installationen füllt.

Exceptions

Exception	Meldung	Beschreibung
EEMSClientAPIError	JSON-Objekt erwartet	Sie haben an QueryInstallations ein Array mit TInstallation-Instanzen (AObjects) übergeben, aber QueryInstallations 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. Jedes dieser Objekte repräsentiert einen Benutzer. 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	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.CreateAndroidInstallationObject
• REST.Backend.EMSApi.TEMSClientAPI.CreateIOSInstallationObject
• REST.Backend.EMSApi.TEMSClientAPI.UploadInstallation
• REST.Backend.EMSApi.TEMSClientAPI.UpdateInstallation
• REST.Backend.EMSApi.TEMSClientAPI.DeleteInstallation
• REST.Backend.EMSApi.TEMSClientAPI.RetrieveInstallation
• REST.Backend.EMSApi.TEMSClientAPI.RetrieveInstallationsChannelNames
• REST.Backend.EMSApi.TEMSClientAPI.RetrieveInstallationsFields
• REST.Backend.EMSApi.TEMSClientAPI.PushBroadcast
• REST.Backend.EMSApi.TEMSClientAPI.PushToTarget
• REST.Backend.EMSApi.TEMSClientAPI.PushToChannels
• REST.Backend.EMSApi.TEMSClientAPI.PushWhere

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

• REST.Backend.EMSServices.TEMSQueryAPI.Query

• REST.Backend.EMSApi.TEMSClientAPI.QueryResource