Amélioration du lettrage des comptes

page en cours de rédaction
En attente de relecture

1 Analyse de l'existant
2 Cahier des charges
- 2.1 Besoins fonctionnels
- 2.2 Besoins non fonctionnels
3 Démarche de travail

Analyse de l'existant

Actuellement Néogia dispose, au niveau du composant Comptabilité, d'interfaces permettant d'effectuer des lettrages comptables sur les comptes tiers et bancaires, mais aucune interface n'est disponible pour les visualiser, les rechercher ou encore les gérer.

Cahier des charges

Besoins fonctionnels

Rajouter un écran de recherche avancée (avec plusieurs paramètres) sur les lettrages au même style que celui de recherche sur les écritures.
Rajouter un service permettant la gestion des lettrages. La gestion des lettrages comprend la possibilité de casser un lettrage et de remplacer une ligne d'écriture par une ou plusieurs autres dont les comptes et les montants correspondent.

Besoins non fonctionnels

Etre le moins invasif sur le code existant.
Respecter les bonnes pratiques du projet Néogia.

Démarche de travail

Les étapes proposées pour procéder à cette amélioration sont données comme suit :

Recherche sur les lettrages

Au niveau de l'interface

Commencer par créer deux fichiers ftl pour la recherche sur les lettrages SearchReconcileAccEntry.ftl et FindReconcileAccEntry.ftl. Dans ces deux fichiers nous décrivons la structure de l’interface de recherche :
- Disposition et labels des boutons et des champs,
- La nature des champs : champs de saisie, un drop-down, une date à partir du calendrier.
- D’où provient la valeur des différents champs (appel d’une URI à l’aide d’une fonction JavaScript).
Dans le fichier SearchReconcileAccEntry.ftl nous avons fais de façon à ce que les champs de la transaction et de l'écriture soient remplis à partir des pages de recherche ayant des URI à définir dans controller.xml.
Dans controller.xml, nous créons l'URI LookupAcctgTransactionItem et nous le mappons avec le screen LookupAcctgTransactionItem défini dans LookupScreens.xml. Dans ce dernier fichier nous mentionnons que la description de la page sera dans le fichier FormsAcctgTransactionItem.xml.
Dans le fichier FormsAcctgTransactionItem.xml, on ajoute la description des formes findLookupAcctgTransactionItem et listLookupAcctgTransactionItem

Au niveau de service

On commence par modifier la vue GlEntryAccountView définie dans le fichier entitymodel-view.xml en y ajoutant des jointures avec les deux entités ReconcileAccEntry et UserLogin car on a besoin de certains champs provenant de ces deux entités pour l'affichage des infos concernant les lettrages.
On crée le fichier FormsReconcileAccEntry.xml (puisqu'il n'est pas généré faute d'absence de tags) et on définit les deux forms de notre écran de recherche searchReconcileAccEntry et listReconcileAccEntry (on utilise la vue GlEntryAccountView modifiée pour l'affichage).
On passe ensuite à définir le service de recherche sur les lettrages dans le fichier services.xml en donnant le nom de la classe et de la méthode invoquée lors de l'appel de ce service.
Enfin, on développe la méthode findReconcileAccEntry dans la classe ReconcileAccEntryServices.java à l'aide de l’objet DynamicViewEntity qui va retourner comme résultat un map à utiliser pour l’affichage de la liste.