Envoyez facilement des demandes POST à Acumatica à l’aide de WebHooks

Introduction

Aujourd'hui, je veux partager avec mes collègues développeurs une méthode simple pour envoyer des requêtes POST à ​​Acumatica ERP. Pour ce faire, il vous suffit de créer un nouveau projet personnalisé nommé WebHooksConfiguration et de le publier .

Ensuite, vous devez créer une bibliothèque d'extensions.

Dans le projet « WebHooksConfiguration », vous devez créer une classe implémentant l'interface IWebhookHandler . Dans notre cas, c'est la classe TestWebHooks. Nous allons aussi créer un exemple complet de transmission d'objets JSON à des fins de test. Pour ce faire, nous allons d'abord ajouter la classe ObjectJSON afin de désérialiser l'objet et la méthode. Notez aussi que le modificateur d'accès de la classe doit être « Public ». Sinon, dans la capture d'écran SM304000 (WebHooks), ce WebHook ne sera pas disponible.

Le code que vous voyez ci-dessus est contenu dans le GIST ci-dessous.

L’ESSENTIEL

Après avoir créé une classe qui implémente l’interface « IWebhookHandler ».

Construire le projet

Allez dans Personnalisation -> Fichiers -> Ajouter un nouvel enregistrement -> et sélectionnez le projet contenant votre classe IWebhookHandler . Sauvegardez et cliquez sur Publier le projet actuel.

Ensuite, allez à la page SM304000 (WebHooks).

Dans le champ Nom du webhook , entrez un nom. Dans notre cas, je l'ai nommé TestHook .

Dans le sélecteur de classe d'implémentation, sélectionnez votre classe. Ici, vous pouvez constater qu'elle s'appelle WebHooksConfiguration.TestWebHooks . Notez encore une fois que le modificateur d'accès de la classe doit être Public .

Cliquez maintenant sur Enregistrer . Acumatica générera l'URL qui vous permettra d'y accéder.

Allez dans Personnalisation -> Webhooks -> Ajouter un nouvel enregistrement et sélectionnez le webhook que vous venez de créer. Cochez la case Prédéfini et cliquez sur Publier le projet actuel .

Pour effectuer des tests, créez une nouvelle application console et une classe ObjectJSON identique afin de sérialiser l'objet qui sera transmis à Acumatica. Notez ensuite l'URL générée par Acumatica.

Encore une fois, pour votre commodité, j’ai placé le code pour vous dans le GIST suivant:

GIST : https://gist.github.com/yuriycto/b1f42b4a116f106aa2e073f2a55e9793

Maintenant, nous allons placer un point d'arrêt dans notre projet « WebHooksConfiguration -> debug -> attach to process » et exécuter ConsoleApp1 .

Dans l'application console, vous devriez obtenir une réponse OK .

Et c’est tout.  Aussi simple que cela puisse être... tant que vous suivez les étapes que j’ai décrites ci-dessus. J’espère que ce post est clair et le rend juste un peu plus facile pour vous de poster des demandes dans Acumatica en utilisant WebHooks.

Bon codage!