Formats d'intégrateur Négoce

L’intégrateur s’articule autour des fonctionnalités suivantes :

• saisie des paramètres de lancement de l’intégrateur,
• compte-rendu des Intégrations,
• relance des Intégrations,
• purge des données Intégrations & Rejets.

Deux bases permettent de mémoriser les données propres à l’intégrateur : table des Intégrations (ITG) et table des Rejets (IRJ).

Pour la partie Finances, une fonctionnalité identique, l’Intégrateur Finances, permet d’intégrer des données externes à ACE (plans, comptes, écritures comptables, etc.).

L'intégrateur permet également d'afficher dans le fichier journal du traitement d'édition une série de messages informatifs afin de mieux comprendre le déroulement du traitement d'intégration.

Ces messages ne sont pas des messages d'erreur, ils justifient le traitement normal de l'intégrateur et ne sont pas édités en standard car ils peuvent occasionner un fichier journal trop volumineux. Ils sont donc conditionnés par le positionnement dans la maquette du mot clé :

P TRT="mess_normaux_log".

Format fixe

Les valeurs des champs à intégrer doivent être positionnées à l’emplacement prévu (en position, taille) par l’enregistrement à intégrer (voir la documentation des enregistrements d’intégration). Dans ce format, le fichier doit être dans une police de caractère mono-octet (il ne peut dont pas être en UTF8).

Par ailleurs, les champs marqués ‘UTF8’ dans la colonne type sont ceux acceptant de l’UTF8 avec le format variable. Pour ces champs, en format fixe, ne pas dépasser le nombre de caractères (précisé dans la colonne ‘Désignation’de la description du format d’intégration, sinon = taille/4).

Format variable

Depuis la version ACE 1.6.0, pour les nouveaux fichiers d’intégration, il est préconisé d’utiliser le format variable (FVxx) (voir documentation INTEG_FV). Le format variable FV01 permet de s’adapter à l’internationalisation selon la façon dont sont générés les fichiers à intégrer.

Si le serveur de traitement est paramétré en UNICODE (ou UTF8), il faut utiliser le format FVxx et un fichier à intégrer au format UTF8.

Attention : disponible uniquement sur INTEGR (pas disponible sur l’intégrateur finance).

Attention Le format variable est disponible pour les formats de type ‘INTEG_xxx’. Il n’est pas possible de l’utiliser dans l’intégrateur Finance (P_2ITF).

ACE ECHANGE fonctionne avec un nom de fichier par traitement.

Le fichier à intégrer subit un contrôle préliminaire pour répondre à certains contextes d'utilisation.

Depuis la version ACE 1.6.0, les fichiers des formats d’intégration peuvent contenir un ‘\r’ (fichier DOS déposé sous UNIX sans transformation), ce caractère étant simplement ignoré.

Attention A la fin du fichier à intégrer, il faut toujours ajouter un saut de paragraphe (retour chariot), sinon le dernier enregistrement du fichier n'est pas intégré. Toutes les dates doivent être formatées de la manière suivante : AAAAMMJJ (année, mois, jour).

Le mode standard de fonctionnement d’ACEest le suivant : le fichier à intégrer possède un nom fixe et doit être « disponible » dans le répertoire des fichiers prêts à être intégrés. Rappelons qu'il est toutefois possible d'utiliser des noms avec un caractère joker (voir ci-après).

Comme le fichier peut être verrouillé par d’autres traitements non ACE, ce qui n'est pas le mode de fonctionnement normal d’ACE, le contrôle d'existence du fichier est renforcé par un contrôle de « disponibilité » du fichier (non verrouillé par un autre process).

Si le fichier n’est pas disponible, une erreur est enregistré dans le fichier .log (message ‘Pb fichier !’) et l’intégration des données cesse. Ce fichier ‘Trace’ peut être consulté par la fonction UEDI.

Le statut du traitement est toutefois positionné à la valeur ‘5 : traitement incorrect’.

Une tâche automatique (UPRC) peut ou non (choix de paramétrage de la tâche) entraîner une autre tâche. Cette fonctionnalité permet notamment de traiter le cas de figure suivant : est-il cohérent, pour le fonctionnement de l'application, d'effectuer le traitement à la date D2 alors que celui de la date D1 a rencontré une difficulté ?

Ce contrôle permet d'éviter l'arrêt complet du processus d'intégration avec nécessité d'une relance manuelle. Mais il ne règle pas la fluidité des intégrations.

Attention Il est donc indispensable pour le bon fonctionnement de déposer dans le répertoire adéquat un fichier qui restera toujours disponible.

Au niveau du lancement de l’intégrateur, le nom de ficher avec joker peut être saisi comme un fichier à intégrer. Ce code peut être programmé et utilisé de manière récurrente.

Le caractère joker prévu est l’astérisque ‘*’.

Pour permettre le suivi des fichiers sur les différents serveurs et les reprises sur incidents de transmission, il faut avoir unicité sur les noms de fichiers. Le type d’interface est défini dans le nom du fichier.

Le nom du fichier, sur 25 caractères, est codifié de la façon suivante : EDI_aaaaaaaaaa_bbbbbbbbbb.

Les fichiers sont localisés sur le serveur où est installé ACE (répertoire logique de 5 caractères défini dans le Generix.ini).

La chaîne de caractères acceptée par l’intégrateur comprend donc 30 positions (longueur du nom du répertoire logique : 5 caractères + longueur du nom du fichier : 25 caractères).

Règles de gestion

Au début de traitement, le nom du fichier à intégrer est automatiquement analysé.

S’il ne possède pas de caractères joker, le traitement continue.

S’il contient au moins 1 caractère joker, une recherche sur le répertoire est lancée, correspondant avec le nom du fichier donné. Le fichier à intégrer est le premier trouvé.

Dans la fonction INTEG, si l’on spécifie en position 3 du fichier d’intégration une fonction en particulier et que l'on veut positionner un paramètre de contrôle (sur la quantité ou le prix par exemple), il faut le positionner à la fois sur la fonction différée INTEGR et la fonction spécifiée dans le fichier.

Par exemple: le paramètre CTRQTE pour la gestion des commandes (GCOV).

Pour ce qui est des données intégrées entre ACE et AGIL, voir la documentation INTEG_AGILIX.

Description technique des champs de cet écran.

Cette fonctionnalité, accessible par le menu ‘Compte-Rendu’, permet de visualiser les différentes informations propres aux intégrations.

Intégration n° : le compteur NUMINTEG doit être défini au préalable dans la gestion des compteurs (fonction UCPT).

Chaque intégration est identifiée par ce numéro et on y associe des informations complémentaires.

Code état : état de l’intégration

N° d’édition : numéro attribué automatiquement par le traitement différé.

Fichier Interface : nom du fichier intégré.

N° d’intégration de la relance : dans le cas où l’intégration a été relancée, numéro attribué par le système.

Fonctionnalités accessibles par popup à partir de cet écran : Permet d’accéder au fichier journal (.log) en consultation. Pour accéder à ce popup, il faut positionner le paramètreINTLOG.

Pour connaître le nom du fichier et le numéro d’intégration sans voir les fichiers « log », utilisez le bloc d’édition integr_b95.

Description technique des champs de cet écran.

Cette fonctionnalité est accessible par le menu ‘Interface’.

Description technique des champs de cet écran.

Cette fonctionnalité, accessible par le menu ‘Relance Fiche rejet’, permet de relancer des Intégrations.

	Il est possible de traiter les rejets en utilisant le paramètre INTREJ.
	Pour en savoir plus sur le paramétrage des fonctions, consulter la documentation "Le Configurateur Fonctionnel".

Trois options sont possibles :

Génération d’un fichier de relance

La première option crée un fichier à partir des données de la table des Rejets.

Relance de l’intégration

La seconde relance l’intégration à partir du fichier dont le nom est sauvegardé dans la table des Intégrations (entrée modifiable).

Génération + relance de l’intégration

Enfin, la troisième génère le fichier des rejets à partir de la table des Rejets et relance l’intégration directement après. Attention, les données sauvegardées dans la table des Rejets vont être rapatriées directement de la base de données afin de créer le fichier source pour l’intégration ; celles-ci ne sont donc pas modifiées depuis la première intégration.

Format		Maquette
Texte (ASCII)		INTEGE1
Blocs d’édition :	INTEGR

Cette fonctionnalité permet d’identifier clairement chaque processus d’intégration (attribution d’un numéro unique) et d’y rattacher les éventuels éléments rejetés.

De cette manière, les données erronées peuvent être corrigées et l’intégration portant uniquement sur ces erreurs peut être relancée.

Sauvegarde des éléments rejetés de l’intégration

Les éléments rejetés de l’intégration sont sauvegardés dans une table et clairement identifiés par rapport à l’intégration origine.

Exemple de la logique utilisée pour la gestion des rejets par cet exemple : en cas d’erreur sur un poste (transaction sur événement), l’ensemble des enregistrements liés à l’événement est sauvegardé dans la table des rejets.

Pour les intégrations dont la taille de l’enregistrement dépasse 1000 caractères, les rejets sont mémorisés sur 2 enregistrements consécutifs. Pour les versions V500 V450 V440, le premier enregistrement, la zone LIGI01 contient 50 *, les autres zones contiennent la totalité de l’enregistrement rejeté. Pour la version V501, une zone a été ajoutée, INDSUI. Quand elle est positionnée ‘O’, cela signifie qu’un second enregistrement suit avec la suite du l’enregistrement.

Attention La sauvegarde des données rejetées est consommatrice de mémoire. Par défaut, le fonctionnement autorise la sauvegarde.

Visualisation des erreurs

Le fichier journal de l’intégration est toujours généré identifiant le type d’erreur rencontrée sur l’élément. Les processus de correction peuvent alors être conçus.

Génération d’un fichier de relance

Un fichier créé à partir des données de la table des rejets est alors généré en vue d’une relance de l’intégration.

Relance des éléments corrigés de l’intégration

Il est alors possible de relancer l’intégration originelle qui s’est mal terminée. Un nouveau traitement différé est exécuté, qui est automatiquement associé à l’intégration originelle.

Description technique des champs de cet écran.

Cette fonctionnalité, accessible par le menu ‘Purge’, permet de supprimer des données d’intégration et de rejets selon des critères de sélection.