WebService de répartition de l’imputation analytique par axes

Généralités

Introduction

Ce document vous décrit comment gérer la répartition analytique des postes de commandes en provenance de la place de marché Quadrem.

Pour ce faire, le module d’intégration XML (également appelé connecteur) vous permet de préciser un ensemble d’axes analytiques avec le pourcentage de répartition en entrée de ce WebService.

Des contrôles automatiques permettent de vérifier la cohérence des données issues du connecteur : valeur de l’élément de plan (définie dans la table P_PLE), total du pourcentage de répartition, contrôle de validité des dates des éléments de plan,…

Aspect technique

Ce service fait partie des librairies standard livrées avec le mode web (extension « .jar »). Le web-module concerné est « webservices » et le service à déclencher est : « GCEService ».

Par contre, dans votre fichier de configuration (« configuration.xml »), il suffit de vérifier la présence des applications modules « GCEService » et « GestionAnalytique » (respectivement définis dans les répertoires « fr\ACE\metier\bc4j\integration » et « fr\ACE\metier\bc4j\analytique ») et la présence des viewObjects suivants : « JP_5axView », « JEvyeView », « JEvydView », « JIaeView » et « JP_PleView ».

Pour tester l’intégration d’un flux xml via ce connecteur, utilisez le client « WebServiceIntegration ».

Principes

Les différentes étapes de l’interfaçage avec eGx et de l’intégration dans les tables ACE des données issues du connecteur.

le web-module « GCEService » analyse le flux XML et appelle l’API GestionAnalytiquecreerAnalytique en utilisant, en paramètres d’entrée, soit une liste de plans analytiques, soit une liste d’axes analytiques.
Selon le paramétrage de l’imputation analytique pour l’événement, le niveau de gestion analytique est déterminé.
Si aucun élément de plan, ni aucun axe analytique n’est renseigné en entrée de l’API, le WebService recherche des différents plans analytiques composant l’axe analytique à partir du guide analytique (recherche par couple QUI-QUOI).
Si une liste d’axes de répartition analytique est renseignée, les pourcentages sont cumulés par axe analytique afin de contrôler que la somme des répartitions pour un même axe est égal à 100%. Pour chaque axe analytique, le WebService crée un enregitrement dans la table des détails de l’imputation analytique (EVYD) et un autre enregistrement dans la table des e n-têtes de l'imputation analytique (EVYE ) pour le poste de commande.
Un contrôle supplémentaire est effectué en création du détail analytique : la valeur de l’élément de plan doit être définie dans la table P_PLE et cet élément ne doit pas se situer en dehors de la période de validité (par rapport à la date d’événement ou à la date client).

Mise en oeuvre

Schéma d’entrée du connecteur

Une branche « analyticalAxis » de type liste d’éléments est disponible sous le nœud « EventItemInfo ».

Correspondance entre les attributs du schéma GCEService et les rubriques de la table :

analyticalAxis	Rubrique de la table
code (Analytical axis code)	p_5axcod (code axe)
heading (Analytical heading element)	p_plecodpr (valeur du code rubrique)
section (Analytical section element)	p_plecodpb (valeur du code section)
secondary1 (Analytical secondary 1 element)	p_plecods1 (valeur du code secondaire 1)
secondary2 (Analytical secondary 2 element)	p_plecods2 (valeur du code secondaire 2)
secondary3 (Analytical secondary 3 element)	p_plecods3 (valeur du code secondaire 3
percentage (Analytical percentage distribution)	pourcent (% de répartition)
amount (Analytical amount distribution)	montant (montant de répartition)

Attention

Dans le connecteur, une balise « action », également présente dans l’objet « AnalyticalAxis », doit avoir la valeur « creation » afin que le système génère l’analytique sur le poste.

API GestionAnalytiquecreerAnalytique

Pour en savoir plus sur les schémas d’entrée et de sortie de cette API, consultez la documentation de référence « GestionAnalytiquecreerAnalytique ».

Paramétrage

Pour répartir l’imputation analytique par axe analytique, il suffit d’utiliser les paramètres suivants au niveau des cibles utilisées pour l’intégration des données du flux XML :

GESANA ,
P_PHI (A1 = « O », c’est-à-dire l’utilisation d’ACE Négoce avec ACE Finance).

Pour en savoir plus sur le paramétrage des fonctions, consultez la documentation "Le Configurateur Fonctionnel".

Une nature d’imputation (table IAE) doit être définie pour le type d’événement géré (code Achat/Vente et type d’événement).