Activation
L’activation du service OData est soumis à licence SaaS, veuillez vous rapprocher de votre interlocuteur habituel Divalto pour souscrire à son abonnement. Le service est disponible depuis les versions SaaS : 5 de divalto weavy et 10 de divalto infinity.
Point d’accès
L’URL principale d’accès au service OData est https://odata.one.divalto.com/odata
URL par projet
L’URL d’accès au service OData est https://odata.one.divalto.com/odata/<codeProjet>
NB : pour les projets ERP il est possible de limiter le parcours de données à un dossier en complétant l’URL selon ce modèle : https://odata.one.divalto.com/odata/<codeProjet>@<dossier>
Code projet
Pour les projets CRM, le code projet est le même que celui qui est utilisé par les outils d’accès au CRM
Pour les projets ERP, le code projet fait l’objet d’une création à la demande lors de la souscription à l’accès OData
Identification
L’accès OData requiert un login et un mot de passe.
Confidentialité des données
L’accès OData se fait sur l’ensemble des données du projet. Dans la version actuelle il n’y a pas de gestion de confidentialité des lignes ou des colonnes.
Un paramétrage permet de limiter les tables et vues qui sont accessibles via le protocole OData, il est ainsi possible de ne pas rendre disponibles les données de ces table ou vues via cet accès.
Quota d’utilisation
Le service permet la lecture d’un nombre limité de lignes par jour par site (qui se compte en millions de lignes). Quand cette limite est dépassée, les API OData retournent des erreurs de type HTTP 429 (Too Many Requests).
C’est le niveau d’option de la souscription à ODATA qui détermine ce quota du nombre de lignes.
Un quota concernant le nombre de requêtes par 24h glissante est également fixé.
Conditions d’utilisation
Mise en cache
Le service OData gère un cache des schémas de données qui a une durée de 10 minutes. Il est donc nécessaire d’attendre ce délai avant de pouvoir observer les modifications effectuées sur un schéma (ex : ajout d’une colonne à une table ou à une vue, ajout d’une table, …).
Performances
Les requêtes OData doivent répondre en moins de 30 secondes, cela implique donc que la base de données doit répondre aux sollicitations OData en moins de 30 secondes également. Cela requiert donc le respect des bonnes pratiques SQL (en lien avec la performance de lecture des données) dans la définition des vues ou de l’indexation de données. Le non respect de ces temps de réponse provoque le retour d’erreurs HTTP 422 (Unprocessable Entity).