Service Proxy de base de données (server)
{{#images:versionlatest-32x32.png|stock}}
Le service proxy de base de données permet d'accéder aux bases de données à travers le service Sage FRP 1000.
Le service proxy de base de données est utile lorsque les bases de données ne peuvent pas être exposées, par exemple dans un environnement hébergé Web.
Le service proxy est basée sur une interface REST
Service URL.
Le service proxy est accessible à travers l'url de base du service :
https://hostname/service/sql
Ressources URI.
Les identifiants de ressources :
/databaseType/uriType
Entête de requête.
Les requêtes HTTP doivent contenir les entêtes suivantes :
| Entête | Valeur |
|---|---|
| x-ms-version | Version de service proxy |
| x-ms-date | Heurodatage de la requête |
| Authorization | Doit contenir un token de signature de la requête. |
| ContentType | Définit le type de contenu de la requête |
| Accept | Définit le type de contenu de la réponse |
| Cookie | Doit contenir le cookie de session de l'utilisateur |
Authentification de l'utilisateur.
Il existe deux méthodes pour authentifier l'utilisateur :
- Utiliser une connexion de service a travers l'api sdata
- Utiliser le dialogue standard de connexion de l'utilisateur
La méthode utilisant le dialogue standard est préférable parce qu'elle gère l'ensemble des paramètres d'authentification.
Dans les deux cas vous devez obtenir en fin d'authentification le cookie de session de l'utilisateur.
Authentification en utilisant $connect
Authentification en utilisant le dialogue Web d'authentification
Authentification de l'application.
L'application appelante doit être authentifiée et autorisée.
Signature des requêtes.
Les requêtes HTTP émises sur le service proxy doivent être signée, le résultat de la signature est formaté dans un token qui doit être passé dans l'entête Authorization de la requête.
Code de retour
| Code | Usage |
|---|
Type de contenu de la réponse
Les requêtes peuvent renvoyer les données en format XML ou JSON.
Curseurs
Les requêtes de type curseur exécute un select sur une base de données et retourne les données en résultat.
Les types de ressource URI utilisés par un curseur :
| Type | Usage |
|---|---|
| open | Ouverture du curseur |
| next | valeurs suivantes |
| close | Fermeture du curseur |