EMS-Client-Anwendung
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 .
Inhaltsverzeichnis
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
- Vorgabewert:
- URLProtocol. Der URL-Protokollbezeichner für die Anforderung an den EMS-Server.
- Vorgabewert:
http
- Vorgabewert:
- URLBasePath. (Für eine Produktionsumgebung) Virtuelles Verzeichnis von emsserver.dll und dem emsserver.dll-Dateinamen.
- Vorgabewert (Produktionsumgebung):
/emsserver/emsserver.dll
- Vorgabewert (Produktionsumgebung):
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 |
|---|---|
|
EMS-Benutzer abrufen, aktualisieren oder löschen | |
|
EMS-Benutzer und EMS-Gruppen abfragen | |
|
Anmeldung, Abmeldung, Registrierung und Authentifizierung für andere TBackend-Komponenten festlegen | |
|
Eine bestimmte oder benutzerdefinierte EMS-Endpunktressource aufrufen | |
|
EMS-Gruppen hinzufügen, abrufen, aktualisieren und löschen | |
|
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. |