Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

Authentification

L’utilisation de l’API OData nécessite un compte ERP. Ce compte est créé depuis DLMT et est un compte utilisateur standard.

Lors de la demande d’accès du connecteur OData, le ou les comptes devant pouvoir utiliser le connecteur OData doivent être spécifiés car l’accès OData sera restreint à ces comptes.
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.

Demande d’activation ODATA

Afin de bénéficier du webservice ODATA il faut au préalable souscrire à l’option.

...

https://divalto.atlassian.net/wiki/spaces/DIVALTO/pages/11047667478/myBusiness+Saisir+une+nouvelle+commande#Commandes-pour-activation-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:

...

Exemple de certificat démonstration

...

Avec votre adresse de service pour l’accès lié à chaque environnement, exemple:

...

image-20240514-123339.pngImage Added

Exemple ce certificat

image-20240514-123056.pngImage Added

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 via à 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)

...