Publier un service Web

Les services Web sont un moyen pratique de rendre une fonctionnalité d'application disponible à différents systèmes et utilisateurs externes. Business Central inclut plusieurs objets qui sont exposés par défaut en tant que services Web en raison de l'intégration à d'autres services Microsoft, mais vous pouvez également ajouter d'autres services Web.

Vous devez configurer un service Web dans le client Business Central. Vous devez ensuite publier le service Web pour le rendre disponible aux demandes de service sur le réseau. Les utilisateurs peuvent découvrir les services Web en pointant un navigateur sur l'emplacement du serveur et en demandant la liste des services disponibles. Lorsque vous publiez un service Web, il est immédiatement disponible sur le réseau pour les utilisateurs authentifiés. Tous les utilisateurs autorisés peuvent accéder aux métadonnées des services Web, mais seuls les utilisateurs ayant les autorisations nécessaires peuvent accéder aux données réelles.

Création et publication d'un service Web

Les étapes suivantes expliquent la procédure de création et de publication d'un service Web.

Création et publication d'un service Web

  1. Choisissez l'icône Ampoule qui ouvre la fonction Tell Me, saisissez Services Web, puis sélectionnez le lien associé.

  2. Sur la page Services Web, sélectionnez Nouveau. Positionnez le curseur sur un champ pour lire une brève description.

    Note

    Les types valides pour les services Web SOAP sont Codeunit et Page. Les types valides pour les services Web OData sont Page et Requête.
    De même, si la base de données contient plusieurs sociétés, vous pouvez choisir un ID objet qui est spécifique à l'une des sociétés.
    Enfin, le nom de service est visible par les clients de votre service Web et sert de base pour identifier et distinguer les services Web, il doit donc être explicite.

  3. Activez la case à cocher dans la colonne Publié.

Lorsque vous publiez le service Web, dans les champs URL OData et URL SOAP, vous pouvez voir les URL générées pour le service Web. Vous pouvez tester le service Web immédiatement en choisissant les liens figurant dans les champs URL OData et URL SOAP. Éventuellement, vous pouvez copier la valeur du champ et pour l'enregistrer pour une utilisation ultérieure.

Important

Pour les codeunits publiés en tant que service Web SOAP, les méthodes exposées dans le codeunit doivent être marquées comme [External] dans le code.

Une fois le service Web publié, il est accessible aux parties externes. Vous pouvez vérifier la disponibilité de ce service Web à l'aide d'un navigateur, ou vous pouvez sélectionner le lien dans les champs URL OData et URL SOAP de la page Services Web. La procédure suivante indique comment vous pouvez vérifier la disponibilité du service Web pour une utilisation ultérieure.

Vérification de la disponibilité d'un service Web

  1. Dans votre navigateur, indiquez l'URL appropriée. Le tableau suivant illustre les types d'URL que vous pouvez entrer pour les différents types de services Web.

    Type Syntaxe Exemple :
    SOAP https://api.businesscentral.dynamics.com/version/tenant/WS/CompanyName/entity/ https://api.businesscentral.dynamics.com/v1.0/a10b3ee6-d9a2-42fe-926f-946e23bb8ddd/WS/CRONUS%20USA%2C%20Inc./Page/InvoiceDocument
    OData V4 https://api.businesscentral.dynamics.com/version/tenant/ODataV4/Company('CompanyName')/entity https://api.businesscentral.dynamics.com/v1.0/a10b3ee6-d9a2-42fe-926f-946e23bb8ddd/ODataV4/Company('CRONUS%20USA%2C%20Inc.')/InvoiceDocument
    Le nom de la société respecte la casse.
  2. Examinez les informations affichées dans le navigateur. Vérifiez que vous pouvez visualiser le nom du service Web que vous avez créé.

Lorsque vous accédez à un service Web, et que vous souhaitez copier des données vers Business Central, vous devez spécifier le nom de la société. Vous pouvez spécifier la société en tant que membre de l'URI comme l'indiquent les exemples, ou vous pouvez spécifier la société comme partie des paramètres de requête. Par exemple, les URI suivants pointent vers le même service Web OData et qu'ils sont tous deux des URI valides.

https://api.businesscentral.dynamics.com/v1.0/OData/Company('CRONUS International Ltd.')/Customer  
https://api.businesscentral.dynamics.com/v1.0/OData/Customer?company='CRONUS International Ltd.'  

Voir aussi

Administration
Services Web Business Central pour les développeurs