Accueil Blog Le plugin de personnalisation d'Acumatica : Comment ajouter ou modifier la configuration d'un package

Plugin de personnalisation d'Acumatica : Comment ajouter ou modifier la configuration d'un package

Vinay Koppula | 13 octobre 2022

Plugin de personnalisation d'Acumatica : Comment ajouter ou modifier la configuration d'un package

Introduction

J'ai travaillé sur un bon nombre de solutions d'intégration ISV, et à chaque fois, les tests unitaires dans les nouvelles instances signifient que je dois entrer ou mettre à jour les paramètres requis des intégrations. Ces saisies peuvent être très ennuyeuses et prendre beaucoup de temps. J'ai également remarqué que la plupart des intégrations nécessitent des préconfigurations ou des paramètres, tels que la configuration de l'intégration, la classe de clients, les types de commandes, les valeurs par défaut, la séquence de numérotation par défaut, etc. Chaque fois qu'une solution ISV est mise en œuvre, il y aura une bonne quantité d'efforts manuels pour mettre en place les configurations initiales.

Je me demandais donc s'il était possible d'utiliser les solutions ISV en capturant les paramètres automatiquement, sans effort manuel. En cherchant la solution, j'ai trouvé un article sur la configuration du site à l'aide de la personnalisation par Sergey Marenich, qui explique comment nous pouvons ajouter (ou modifier) la configuration des paquets dans Acumatica ERP directement à partir du plugin de personnalisation. Cet article m'a aidé à comprendre et à travailler sur mon besoin.

Le Custom Plug-In est un fichier de code séparé

Ce que j'ai appris, c'est que le Customization Plug-In est un fichier de code séparé avec une classe qu'Acumatica peut compiler et charger dynamiquement lors de la publication.

Les événements de classe sont automatiquement souscrits et exécutés lors des opérations sur les bases de données et/ou les fichiers.

Les deux événements de classe sont :

  • OnPublished - ici, vous pouvez accéder au système de fichiers et effectuer la configuration appropriée avant le redémarrage de l'application.
  • UpdateDatabase - ici, vous pouvez définir des opérations à exécuter pour assurer vos propres scripts de mise à jour de la base de données.

Voici un exemple de code (un exemple de projet est disponible sur GitHub) :

GitHub : https://github.com/vinayrajk/CustomizationPlugin>

Le fichier de classe ci-dessous est extrait de l'exemple de code de projet de GitHub.

Les paramètres les plus courants des plugins

Vous trouverez ci-dessous les paramètres les plus courants que j'ai utilisés dans l'écran Configuration de l'intégration.

  • Client par défaut -Il peut être utilisé dans le cadre de l'intégration des places de marché si les commandes sont traitées par les places de marché.
  • Classe de clients -Ce paramètre peut être défini si les intégrations permettent de sélectionner la classe de clients.
  • Séquence de numérotation -Définir la séquence de numérotation par défaut, qui peut être modifiée ultérieurement.
  • Types de commande -Si les commandes doivent être identifiées séparément, une valeur par défaut peut être définie dans l'écran de configuration, par exemple pour les intégrations de places de marché telles que eBay, Amazon, Walmart, etc. Un type de commande de base tel que EB ou WM peut être créé et sa valeur peut être renseignée dans les écrans de configuration.
  • Toutes les valeurs par défaut de n'importe quel écran de configuration.

Les paramètres ci-dessus peuvent être créés ou mis à jour dès que le paquet est déployé dans l'instance à l'aide d'un événement UpdateDatabase.

Remarque : nous devons être prudents avec les données mises à jour, qui ne doivent pas avoir d'incidence sur d'autres parties des données sensibles. 

Un exemple de projet est disponible sur GitHub, veuillez suivre le lien suivant https://github.com/vinayrajk/CustomizationPlugin.git

Résumé :

Nous espérons que cet article vous donnera une bonne compréhension de l'utilisation du plugin de personnalisation et vous permettra de brancher et de jouer les solutions ISV avec les paramètres par défaut qui sont fournis avec le paquet.

Bon codage !

Auteur du blog

Au cours des douze dernières années, Vinay a développé des solutions commerciales en utilisant le cadre .NET et a rejoint Kensium où il a passé sept ans à perfectionner ses compétences dans Acumatica. Il est passé de développeur à responsable du développement, élaborant des solutions complexes et des personnalisations au sein d'Acumatica. Il a mené à bien des projets tels que IBS Imperium - une solution OEM pour la gestion immobilière, des intégrations de magasins comme les paiements, des extensions de taxes et des intégrations de places de marché. Dans son rôle de responsable du développement, il contribue à la formation et au mentorat des nouveaux développeurs, les aidant ainsi à atteindre leurs objectifs de carrière.

Recevez les mises à jour du blog dans votre boîte de réception.