Publier un service web

Les services web constituent un moyen léger de rendre les fonctionnalités d'application disponibles à différents types de systèmes et d'utilisateurs externes. Par défaut, Business Central expose plusieurs objets en tant que services web pour une meilleure intégration avec d'autres services Microsoft. Vous pouvez ajouter d'autres services web selon les besoins de votre entreprise.

Configurez un service web dans Business Central, puis publiez le service web afin qu'il soit disponible pour les utilisateurs authentifiés. Tous les utilisateurs autorisés peuvent accéder aux métadonnées des services web, mais seuls les utilisateurs disposant d'autorisations suffisantes peuvent accéder aux données réelles.

Créer et publier un service web

Les étapes suivantes expliquent comment créer et publier un service web.

Pour créer et publier un service web

1. Sélectionner Rechercher (Alt+Q) dans le coin supérieur droit, saisissez Services web, puis choisissez le lien associé.

2. Sur l' Services web page, choisissez Nouveau. Survolez un champ pour lire une courte description.

   Remarque

   Remarque:
   Codeunit et Page sont des types valides pour les services web SOAP. Page et Requête sont des types valides pour les services web OData. À partir de la version 16.3, Codeunit est également un type valide pour les services web OData v4, mais dans ce cas, aucune URL n'est affichée dans l'interface utilisateur. De plus, si la base de données contient plusieurs sociétés, vous pouvez choisir un ID d'objet spécifique à l'une des sociétés.
   Enfin, le nom du service est visible par les consommateurs de votre service web et sert de base pour identifier et distinguer les services web. Vous devez donc lui donner un nom significatif.

3. Cochez la case dans la Publié colonne.

Lorsque vous publiez le service web, les URL OData et URL SOAP champs affichent les nouvelles URL. Toutefois, pour les codeunits exposés en tant qu'actions indépendantes OData v4, les champs URL ne s'affichent pas.

Vous pouvez tester le service web immédiatement en choisissant les liens dans les URL OData et URL SOAP champs. Vous pouvez également copier la valeur du champ et la sauvegarder pour une utilisation ultérieure. Pour tester les codeunits exposés en tant qu'actions indépendantes OData v4, suivez les instructions dans la Vérification de la disponibilité du service web section dans le contenu pour développeurs.

Remarque

Remarque:
Si les objets que vous exposez en tant que services web ne doivent pas être accessibles depuis Business Central en ligne, vous devez marquer les méthodes exposées dans le code comme [Scope('OnPrem')]. Pour plus d'informations, consultez Attribut Scope.

Après avoir publié un service web, il est disponible pour les parties externes. Vous pouvez vérifier la disponibilité de ce service web à l'aide d'un navigateur, ou en choisissant le lien dans la URL OData et URL SOAP champs sur les Services web page. La procédure suivante illustre comment vérifier la disponibilité du service web pour une utilisation ultérieure.

Pour vérifier la disponibilité d'un service web

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

   Type	Syntaxe	Exemple
   SOAP	https://api.businesscentral.dynamics.com/*version*/*tenant*/Production/WS/*CompanyName*/*entity*/	https://api.businesscentral.dynamics.com/v2.0/7acc9d3d-d354-4616-8bbd-c4fc9f2b15b3/Production/WS/CRONUS%20USA%2C%20Inc./Page/InvoiceDocument
   OData V4	https://api.businesscentral.dynamics.com/*version*/*tenant*/Production/ODataV4/Company('*CompanyName*')/*entity*	https://api.businesscentral.dynamics.com/v2.0/7acc9d3d-d354-4616-8bbd-c4fc9f2b15b3/Production/ODataV4/Company('CRONUS%20USA%2C%20Inc.')/InvoiceDocument Le nom de la société est sensible à la casse.

2. Examinez les informations affichées dans le navigateur. Vérifiez que vous pouvez voir le nom du service web que vous avez créé.

Lorsque vous accédez à un service web et que vous souhaitez réécrire des données dans Business Central, vous devez spécifier le nom de la société. Vous pouvez spécifier la société dans l'URI comme indiqué dans les exemples; vous pouvez également la spécifier dans les paramètres de requête. Par exemple, les URI suivants pointent vers le même service web OData et 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.'  

Informations connexes

Administration
Services web Business Central pour les développeurs
Limites des requêtes OData

Trouvez des modules d'apprentissage en ligne gratuits pour Business Central ici