EMS-Client-Anwendung

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Enterprise Mobility Services (EMS)


Eine EMS-Client-Anwendung ist eine REST-Anwendung, die Dienste vom EMS-Server verwendet.

Die EMS-Client-Anwendung führt REST-API-Aufrufe des EMS-Servers durch, um Daten abzurufen, zu erstellen oder zu aktualisieren. Um auf die EMS-Serverressourcen und -informationen aus der EMS-Datenbank zuzugreifen, kann Ihre EMS-Client-Anwendung die integrierte administrative API oder eine benutzerdefinierte API verwenden.

Um mit der Verwendung der EMS-Serverdienste aus Ihrer EMS-Client-Anwendung zu beginnen, erstellen Sie eine Desktop-Anwendung oder eine geräteübergreifende Anwendung und richten mit der TEMSProvider-Komponente die Verbindung zum EMS-Server ein.

Sie können mit Ihrer EMS-Client-Anwendung auch vorhandene FireDAC-Komponenten verwenden. Siehe Tutorial: Implementieren einer FireDAC-EMS-Client-Anwendung .

Herstellen der Verbindung mit einem EMS-Server von Ihrer EMS-Client-Anwendung aus

Richten Sie mit der Komponente TEMSProvider die Verbindung mit dem EMS-Server ein. Ändern Sie die folgenden Eigenschaften, um die Verbindungseigenschaften zu konfigurieren.

  • URLHost. Der URL des EMS-Servers. Verwenden Sie:
    • localhost, wenn der EMS-Server auf demselben Computer ausgeführt wird.
    • Die IP-Adresse des Remote-EMS-Servers, wenn er auf einem anderen Computer ausgeführt wird.
  • URLPort. Der Verbindungs-Port des EMS-Servers.
    • Vorgabewert: 8080
  • URLProtocol. Der URL-Protokollbezeichner für die Anforderung an den EMS-Server.
    • Vorgabewert: http
  • URLBasePath. (Für eine Produktionsumgebung) Virtuelles Verzeichnis von emsserver.dll und dem emsserver.dll-Dateinamen.
    • Vorgabewert (Produktionsumgebung): /emsserver/emsserver.dll

Konfigurieren Sie die für die Verbindung mit dem EMS-Server benötigten EMS-Server-Autorisierungseinstellungen.

Zugreifen auf einen EMS-Ressourcenendpunkt aus Ihrer EMS-Client-Anwendung

Sie können mit den folgenden Komponenten in Ihrer EMS-Client-Anwendung auf die Endpunkte Ihres EMS-Servers zugreifen.

Methode Verwendung

TBackendUsers

EMS-Benutzer abrufen, aktualisieren oder löschen

TBackendQuery

EMS-Benutzer und EMS-Gruppen abfragen

TBackendAuth

Anmeldung, Abmeldung, Registrierung und Authentifizierung für andere TBackend-Komponenten festlegen

TBackendEndpoint

Eine bestimmte oder benutzerdefinierte EMS-Endpunktressource aufrufen

TBackendGroups

EMS-Gruppen hinzufügen, abrufen, aktualisieren und löschen

TEMSFireDACClient

Eine benutzerdefinierte EMS-Ressource aufrufen und Tabellen mit FireDAC abrufen oder aktualisieren

Hinweis: Die Komponenten TBackendUsers, TBackendQuery und TBackendAuth arbeiten auch mit Parse und Kinvey (als BaaS-Provider).


Verwenden der Komponente TBackendEndpoint

Wenn Sie die Komponente TBackendEndpoint verwenden, benötigen Sie die folgenden Informationen aus dem EMS-Ressourcenendpunkt, auf den Sie zugreifen möchten:

  • Ressource. Der Name der EMS-Ressource.
  • Ressourcensuffix. Das Suffix, das in der Methode des Ressourcenendpunkts angegeben ist (bei Bedarf).
  • Methode. Den Typ der Methode des EMS-Ressourcenendpunkts, die aufgerufen wird.

Die EMS-Endpunktmethoden sind in den EMS-Ressourcen definiert. Die folgende Tabelle enthält die verfügbaren Optionen:

Methode Verwendung Beschreibung

rmGET

Zum Abrufen von Daten aus der EMS-Ressource

Der Endpunkt wird mit HTTP GET aufgerufen.

rmPUT

Zum Einfügen von Daten in eine EMS-Ressource

Der Endpunkt wird mit HTTP PUT aufgerufen.

rmPOST

Zum Aktualisieren einer kompletten EMS-Ressource

Der Endpunkt wird mit HTTP POST aufgerufen.

rmPATCH

Zum Aktualisieren von teilweisen EMS-Ressourcen

Der Endpunkt wird mit HTTP PATCH aufgerufen.

rmDELETE

Zum Löschen einer EMS-Ressource

Der Endpunkt wird mit HTTP DELETE aufgerufen.

Siehe auch