AcumatiCares
Si vous avez lu le blog AND au cours des derniers mois, vous remarquerez que nous avons fourni des informations/tutoriels sur l'environnement de développement d'Acumatica que les clients et les ISV peuvent facilement exploiter pour obtenir plus de valeur de notre plate-forme. Nous avons fourni des informations sur nos jeux d'API, le débogage simple, les intégrations sous forme d'interviews et d'articles.
Aujourd'hui, je poursuis dans cette voie en vous montrant à quel point il est simple de personnaliser les formulaires dans Acumatica ERP. Dans ce billet, je vous montrerai comment ajouter de nouveaux champs à un formulaire existant, comment effectuer une validation simple et comment travailler avec ces personnalisations à partir de Visual Studio. Dans un prochain article, j'expliquerai comment vous pouvez modifier l'aspect et la convivialité du produit grâce à la "thématisation".
La capacité de personnaliser et d'intégrer des applications externes nouvelles ou existantes et le produit lui-même constitue l'un des principaux atouts de notre produit.
Examinons une personnalisation fondamentale - la création de champs et de gestionnaires d'événements que nous pouvons utiliser pour valider la saisie de données - dont les développeurs et les utilisateurs chevronnés peuvent tirer parti dans le produit. Comme vous pouvez le voir dans la capture d'écran ci-dessous(figure 1), nous avons un formulaire - dans ce cas, un formulaire de transaction de journal - dans lequel nous voulons ajouter un champ personnalisé. Pour ce faire, nous sélectionnons Inspecter l'élément dans le menu Personnalisation, que vous pouvez voir encerclé en rouge foncé ci-dessous.
Ensuite, vous remarquerez que le pointeur de la souris change légèrement pour indiquer que vous êtes sur le point de sélectionner un élément du formulaire à personnaliser. Cliquez maintenant sur l'un des champs du formulaire.
Une fois le champ sélectionné, choisissez Personnaliser [1], Nouveau nom de projet [2], et tapez MonProjet [3] ou un autre nom comme vous pouvez le voir en cascade ci-dessous dans la capture d'écran(figure 3).
La fenêtre suivante du projet de personnalisation apparaît alors(figure 4).
Sélectionnez l'onglet Onglet Ajouter des champs de données [1], Nouveau champ [2], saisissez le nom de votre champ et choisissez votre type de données [3]. Dans mon exemple, je crée un champ ID dont le type de données est Chaîne.
Remarquez que Ledger est en gras dans la deuxième colonne du formulaire. Cela s'explique par le fait que j'ai sélectionné ce champ particulier à l'aide du curseur Inspecter l'élément. Cependant, nous pourrions sélectionner n'importe quel champ dans n'importe laquelle des quatre colonnes afin de positionner notre nouveau champ. Lorsque nous ajoutons le contrôle, il ajoute le champ directement après le champ que nous avons sélectionné. Comme je souhaite positionner le champ après le champ Ledger, c'est ce que j'ai sélectionné sur le formulaire lui-même.
Une fois le champ créé, nous devons enregistrer et publier notre projet avant d'ajouter le contrôle au champ. Le point d'exclamation( !) - à côté du champ Ajouter des champs de données et de la case à cocher illustrée ci-dessous dans la figure 5, nous indique de publier le projet avant d'ajouter des champs personnalisés.
Au cours du processus de publication, nous générons automatiquement du code C# et mettons à jour le site Web d'Acumatica en créant un nouveau fichier .cs appelé JournalTransacations.cs. Lorsque le code se compile, Acumatica valide nos modifications et termine la mise à jour du site Web, comme vous pouvez le voir ci-dessous (entouré en rouge).
Une fois que vous avez obtenu le feu vert - jeu de mots oblige - fermez la fenêtre de compilation, puis sélectionnez l'onglet Events [2], ADD HANDLER - Keep Base Method [3], tout en sélectionnant d'abord l'événement FieldUpdated [4].
La fenêtre suivante de l'éditeur de code apparaît avec le code source généré que vous pouvez éditer ici - à la place, à la ligne 33. Cependant, je vous suggère d'éditer/créer votre code dans Visual Studio afin de profiter de toutes les qualités inhérentes à l'IDE telles que l'intellisense et les capacités de débogage, etc.
A ce stade, republiez votre projet pour mettre à jour le site web avec le code du gestionnaire d'événements généré et ouvrez Visual Studio. Vous devrez vous exécuter en tant qu'administrateur pour ouvrir le site web Acumatica et écrire le code du gestionnaire d'événements FieldVerifying. Après le chargement de Visual Studio, ouvrez le site web en sélectionnant FileOpen Website. La boîte de dialogue suivante apparaît avec une liste des sites web que vous pouvez ouvrir. Dans mon cas, plusieurs instances d'Acumatica sont installées. Ouvrez l'instance appropriée d'Acumatica - comme dans la figure 9 ci-dessous.
Une fois le site Web chargé, le fichier JournalEntry.cs [1] doit être présent dans le dossier App_RuntimeCode, comme le montre la figure 10 ci-dessous.
Vous pouvez voir, comme dans la capture d'écran(figure 8) ci-dessus, le même code qui a été généré - sauf que j'ai entré du code supplémentaire pour vérifier la présence de caractères non alpha-numériques [3] dans la région Event Handlers #region pour le Batch_UtilityIDField_FieldVerifyinghandler[2]. Après avoir saisi votre code, enregistrez le fichier, retournez dans Acumatica et rafraîchissez l'application. Tapez maintenant quelques caractères, y compris des caractères non alphanumériques, et quittez le champ par la touche de tabulation.
Il ne s'est rien passé. C'est parce qu'il nous reste une petite mais importante étape à réaliser. Vous devez mettre à jour la propriété Commit Changes [1] du champ en lui attribuant la valeur "true", puis enregistrer vos modifications [2] et republier [3] votre projet. Voir la figure 11.
Tout devrait fonctionner maintenant que nous avons suivi toutes les étapes que nous avons décrites. Lorsque vous entrez votre texte dans le champ comme indiqué ci-dessus (après avoir quitté la tabulation), vous devriez voir apparaître une jolie petite marque rouge encerclée et un rectangle rouge autour du champ pour vous indiquer que quelque chose ne va pas. Lorsque vous passez la souris sur le champ ou sur le x entouré de rouge, vous verrez apparaître quelque chose comme le message de la figure 12 ci-dessous - 3333## n'est PAS une chaîne alphanumérique. Veuillez saisir uniquement des lettres et des chiffres.
Voilà comment créer des champs et effectuer une validation simple des champs.
Résumé
Passons en revue les étapes et concluons ce billet par un joli petit nœud. Nous vous avons montré comment ajouter de nouveaux champs à un formulaire existant et effectuer une validation simple, ainsi que comment vous pouvez travailler avec ces personnalisations à partir de Visual Studio.
Voici les étapes :
- Utilisez la fonctionnalité Inspecter l'élément du menuPersonnalisation pour apporter des modifications - en ajoutant des champs et une validation à vos formulaires.
- Créez un nouveau projet pour séparer votre travail de celui des autres afin que vos mises à jour n'entrent pas en conflit ou n'interfèrent pas avec le travail des autres.
- Ajoutez un nouveau champ au formulaire en sélectionnant l'onglet Ajouter un champ de données, saisissez le nom de votre champ et sélectionnez son type de données dans la liste déroulante.
- Enregistrez et publiez votre projet, puis prévisualisez votre travail pour vous assurer que vous êtes satisfait de l'emplacement du champ sur le formulaire, etc.
- Ajoutez un gestionnaire d'événement de vérification de champ au champ pour effectuer la validation - en ajoutant votre code dans Visual Studio en ouvrant le site Web d'Acumatica et en éditant le gestionnaire d'événement #Region dans le fichier .cs du formulaire que nous avons généré automatiquement lorsque nous avons créé le champ et ajouté le gestionnaire d'événement - dans notre cas, le fichier JournalEntry.cs.
- Sauvegardez votre travail et retournez dans Acumatica.
- Mettez à jour la propriété Commit Changes pour le champ à "true" et republiez votre projet.
- Actualisez le formulaire Acumatica et testez votre travail.
Tous les formulaires du produit Acumatica sont personnalisables - vous pouvez effectuer des personnalisations très simples telles que celles que nous avons démontrées ici ou des personnalisations beaucoup plus complexes, où vous construisez vos propres formulaires et utilisez diverses sources de données et interagissez avec des applications externes existantes. En tirant parti de nos riches ensembles d'API, dont nous avons parlé dans des articles précédents, vous pouvez consulter les liens fournis ci-dessous. Vous pouvez créer des fonctionnalités robustes pour vos clients, adaptées à leurs besoins commerciaux, en apportant une réelle valeur ajoutée mesurable.
Pour terminer, nous vous invitons à visionner la dernière vidéo de notre récent webinaire, dans laquelle nous démontrons ce dont nous avons parlé ici. En outre, nous vous montrons comment mettre le produit en marque blanche, ce qui sera le sujet de notre prochain article de blog. Présentation et démo sur l'intégration et l'incorporation d'Acumatica Cloud ERP dans vos applications métier
