Envoyer facilement des requêtes POST à Acumatica à l'aide de WebHooks

Introduction

Aujourd'hui, je souhaite expliquer à mes collègues développeurs comment envoyer facilement des requêtesPOSTà l'ERP Acumatica. Pour ce faire, vous devez créer un nouveau projet personnalisénommé « WebHooksConfiguration »et lepublier.

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

Dans le projet « WebHooksConfiguration », vous devez créer une classe qui implémentera l'interfaceIWebhookHandler. Dans notre cas, il s'agit de la classe TestWebHooks. De plus, nous allons créer un exemple complet de transmission d’objets JSON à des fins de test. Nous allons donc commencer par ajouter la classe «ObjectJSON» afin de désérialiser l’objet et la méthode. Notez également que le modificateur d’accès de la classe doit être « Public ». Sinon, dans la capture d’écranSM304000(WebHooks), ce WebHook ne sera pas disponible.

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

GIST

Après avoir créé une classe qui implémente l'interface "IWebhookHandler".

Construire le projet

Accédez à « Personnalisation » -> « Fichiers » -> « Ajouter un nouvel enregistrement » ->puis sélectionnez le projet contenant votre classeIWebhookHandler. Enregistrez, puis cliquez sur « Publier le projet actuel ».

Rendez-vous ensuite sur la pageSM304000(WebHooks).

Dans le champ «Nom du Webhook», saisissez un nom. Dans notre cas, je l'ai appelé «TestHook ».

Dans le sélecteur «Implementation Class», sélectionnez votre classe. Ici, vous pouvez voir qu'elle s'appelleWebHooksConfiguration.TestWebHooks. Une fois encore, notez que le modificateur d'accès de la classe doit être «Public ».

Cliquez maintenant sur «Enregistrer ». Acumatica générera l'URL à laquelle vous pourrez accéder.

Accédez à «Personnalisation » -> « Webhooks » -> « Ajouter un nouvel enregistrement», puis sélectionnezle Webhook que vous venez de créer. Cochez la case « Prédéfini » et cliquez sur «Publierle projet actuel ».

À des fins de test, créez une nouvelle application console et créez la même classeObjectJSONpour 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 dans la GIST suivante :

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

À ce stade, nous allons placer un point d'arrêt dans notre projet« WebHooksConfiguration » → « debug » → « attach to process »,puislancerConsoleApp1.

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

Et c'est tout. C'est aussi simple que possible... tant que vous suivez les étapes que j'ai décrites ci-dessus. J'espère que cet article est clair et qu'il vous facilitera un peu la tâche pour envoyer des requêtes dans Acumatica à l'aide de WebHooks.

Bon codage !