...
Demande d’activation ODATA
Afin de bénéficier du webservice ODATA il faut au préalable souscrire à l’option.
Vous trouverez ces informations dans la page dédiée à la saisie de commande dans myBusiness, notamment le chapitre complémentaire dédié à ODATA
| Astuce |
|---|
Rappel : Le service OData est activé par SITE |
Certificat ODATA
Au provisioning de votre demande, le responsable de votre site réceptionnera un email détaillant vos accès, Exemple de certificat démonstration
...
Avec votre adresse de service pour l’accès lié à chaque environnement, exemple:
Exemple ce certificat
Authentification
L’utilisation de l’API OData nécessite un compte ERP. Ce compte est créé depuis DLMT et est un compte utilisateur standard. Seuls les utilisateurs associés au service OData ont un accès aux données via ce service.
Lors de la demande d’activation du connecteur OData sur un site, c’est le compte administrateur qui obtient par défaut les droits (Administrateur@Cxxxxxx.divalto.com) ; il est indiqué dans ce certificat obtenu.
Pour ajouter l’accès OData à un autre compte ERP, il faut passer par un ticket myService pour demander cet ajout. Ce ticket pour l'équipe cloud devra préciser le site et le (ou les) comptes concernés.
| Info |
|---|
Seul les comptes utilisateurs ERP indiqués ont un accès aux données via le service OData |
Accès et informations pratiques
Les informations pratiques sont ici Accès service OData Divalto
Informations concernant ODATA pour l’ERP
L’accès ODATA ERP permet d’accéder aux tables et aux vues dans de nombreux outils qui traitent nativement le protocole ODATA
Il est recommandé de lire les VUES car les noms sont clairs et de nombreuses jointures déjà faites
Certaines tables ne sont pas accessibles (module Paie)
Lors de la connexion, il est fortement conseillé de donner le DOSSIER concerné par la demande, en ajoutant “@” et le code dossier à la fin de l’URL de connexion
Utilisation du protocole HTTPS par requête HTTP
L’accès se fait directement à la base ERP, aucun réplica de base n’est requis, mais l’API gère automatiquement une pagination afin d’optimiser les échanges de données et gérer la charge du serveur SQL
Exemple d’accès ODATA avec Microsoft Excel
Pour utiliser votre accès par exemple via Microsoft Excel, il vous faudra déclarer la connexion à partir d’un flux OData
| Astuce |
|---|
Rappel : l’accès OData fournit un accès à la totalité des données des tables, il n’y a pas de prise en compte des confidentialités des données métiers. |
...
Indiquez l’URL du service OData (indiquée dans le certificat reçu précédemment)
Vous pouvez utiliser un @<code dossier> pour limiter vos requêtes à un dossier précis
...
Pour la connexion sélectionner “De base“ en renseignant votre utilisateur et en sélectionnant votre environnement pour le niveau des paramètres
...
Il vous suffira de sélectionner l’élément que vous voulez charger
...
Et gérer les données chargées dans Excel selon vos besoins. Exemple pour un tableau visualisant les données de la vue ACTION_MATERIEL_V filtrée sur le dossier 998 :
...
| Info |
|---|
L’ERP fournit des VUES qui permettent de rendre plus accessible les données. |
Quelques informations supplémentaires concernant les vues en suivant ce lien ERP via des vues