Application client de RAD Server
Remonter à RAD Server (EMS)
Une application client EMS est une application REST qui utilise les services du serveur EMS.
L'application client EMS effectue des appels d'API REST au serveur EMS afin de récupérer, de créer ou de mettre à jour des données. Pour accéder aux informations et aux ressources du serveur EMS depuis la base de données EMS, votre application client EMS peut utiliser l'API intégrée administrative ou une API personnalisée.
Pour utiliser les services du serveur EMS à partir de votre application client EMS, créez une application de bureau ou une application multi-périphérique et utilisez le composant TEMSProvider pour configurer la connexion au serveur EMS.
Vous pouvez également utiliser les composants FireDAC existants avec votre application client EMS. Voir Tutoriel : Implémentation d'une application client EMS FireDAC.
Sommaire
Connexion à un serveur EMS à partir de votre application client EMS
Utilisez le composant TEMSProvider pour configurer la connexion au serveur EMS. Modifiez les propriétés suivantes pour configurer correctement la connexion.
- URLHost. L'URL du serveur EMS. Utilisez :
localhostsi le serveur EMS s'exécute sur la même machine.- L'adresse IP du serveur EMS distant s'il s'exécute sur une machine différente.
- URLPort. Le port de connexion du serveur EMS.
- Valeur par défaut :
8080
- Valeur par défaut :
- URLProtocol. L'identificateur du protocole de l'URL pour la requête au serveur EMS.
- Valeur par défaut :
http
- Valeur par défaut :
- URLBasePath. (Pour un environnement de production) Répertoire virtuel du emsserver.dll et du nom de fichier de emsserver.dll.
- Valeur par défaut (environnement de production) :
/emsserver/emsserver.dll
- Valeur par défaut (environnement de production) :
Configurez les paramètres Autorisation du serveur EMS nécessaires pour établir la connexion au serveur EMS.
Accès à un point de terminaison de ressource EMS à partir de votre application client EMS
Vous pouvez utiliser les composants suivants dans votre application client EMS pour accéder aux points de terminaison de votre serveur EMS.
| Méthode | Usage |
|---|---|
|
Récupérer, mettre à jour ou supprimer des utilisateurs EMS. | |
|
Requête sur les utilisateurs EMS et les groupes EMS. | |
|
Connexion, déconnexion, inscription et définition de l'authentification pour d'autres composants TBackend. | |
|
Invoquer une ressource de point de terminaison EMS particulière ou personnalisée. | |
|
Ajouter, obtenir, mettre à jour et supprimer des groupes EMS. | |
|
Invoquer une ressource personnalisée EMS, et obtenir ou mettre à jour les tables en utilisant FireDAC. |
- Remarque : Les composants TBackendUsers, TBackendQuery et TBackendAuth fonctionnent également avec Parse et Kinvey (fournisseurs BaaS).
Utilisation d'un composant TBackendEndpoint
Si vous utilisez le composant TBackendEndpoint, vous avez besoin des informations suivantes du point de terminaison de ressource EMS que vous souhaitez accéder :
- Ressource. Le nom de la ressource EMS.
- Suffixe de la ressource. Le suffixe détaillé dans la méthode du point de terminaison de ressource (le cas échéant).
- Méthode. Le type de la méthode du point de terminaison de ressource EMS qui est appelée.
Les méthodes du point de terminaison EMS sont définies dans les ressources EMS. Le tableau ci-après présente les options disponibles :
| Méthode | Usage | Description |
|---|---|---|
|
rmGET |
Pour récupérer les données de la ressource EMS |
Le point de terminaison est appelé à l'aide de HTTP GET. |
|
rmPUT |
Pour insérer des données dans une ressource EMS |
Le point de terminaison est appelé à l'aide de HTTP PUT. |
|
rmPOST |
Pour mettre à jour une ressource EMS complète |
Le point de terminaison est appelé à l'aide de HTTP POST. |
|
rmPATCH |
Pour mettre à jour partiellement des ressources EMS |
Le point de terminaison est appelé à l'aide de HTTP PATCH. |
|
rmDELETE |
Pour supprimer une ressource EMS |
Le point de terminaison est appelé à l'aide de HTTP DELETE. |