Généralités Import/Export

 

 

Contenu dans cette page

Généralités

Passerelle d'import

Passerelle d’export

Passerelle de paramétrage

 

 

 

Généralités

Une passerelle permet de transférer des données d’un progiciel vers un autre.

Un fichier est généré et envoyé à Cegid Orli ou à partir de Cegid Orli, ‎selon un paramétrage rigoureux permettant le transfert.

‎On peut également établir un lien entre les données via une recodification, ‎permettant de traduire les données qui peuvent être différentes entre Cegid Orli et l’autre progiciel.

• Un import correspond à un transfert de données d’un autre progiciel vers Cegid Orli :
  èfonction XC20B
• Un export correspond à un transfert de données de Cegid Orli vers un autre progiciel :
  èfonction XC300

 

 

Définitions

 

code EDI

représente « l’interlocuteur » ou le « partenaire » de Cegid Orli (soit celui qui envoie, soit celui qui reçoit)

 

code Provenance

représente l'application externe avec laquelle Cegid Orli dialogue

exemple : WMS pour la logistique, BTOC pour le E.Commerce

 

code Origine

représente le format de données

exemple : ART pour Article, FOU pour Fournisseur

 

paramétrages

• des fonctions de paramétrage d'import (TA440) ou d'export (TA450) vont lister pour chaque code EDI quels sont les couples provenance/origine à traiter
• ces couples provenance/origine seront pris en compte par les fonctions d'import (XC20B) ou d'export (XC300)
• des fonctions de paramétrage de contenu, en import (TA350) ou en export (JP562), décrivent la liste des champs pour une provenance/origine

N.B. :
pour les imports de fichiers avec séparateur, le nombre des champs décrits dans TA350 doit correspondre exactement au nombre des champs présents dans le fichier à importer ; si ce n'est pas le cas, il y aura potentiellement des effets de bord (champs ignorés ou renseignés avec des mauvaises informations).

 

standards

• chaque provenance/origine gérée par Cegid Orli est livrée dans un format standard
  (via les fonctions JP350 / JP450 / DB398)
• chaque provenance/origine peut être dupliquée pour vous permettre des adaptations de format 
  (via les fonctions TA350 / JP562)

N.B. :
certains traitements fonctionnant avec les codes provenance / origine définis par Cegid, il convient avant toute évolution / duplication de vous renseigner auprès du Cegid Customer Care pour exprimer votre besoin et en valider sa faisabilité.

 

 

Contenu des fichiers, type d’enregistrement, titres

Les données d’un fichier peuvent être structurées en plusieurs types d’enregistrement.

Une ligne spéciale supplémentaire peut contenir les titres de chaque donnée (colonne).

Pour les exports, Cegid Orli peut générer ou non cette ligne de titres ‎(paramétrage via JP561 / type format).

Si elle est présente, cette ligne offre plus de lisibilité en cas de diagnostic à réaliser sur le contenu du fichier, mais elle n’a aucun intérêt informatique, et doit donc être ignorée par le logiciel qui intègre les données ; pour Cegid Orli, paramétrage via TA350, avec possibilité d’ignorer la 1^ère ligne (fichier sans type d’enregistrement), ou d’ignorer les lignes comportant une chaîne de caractères spécifique (fichier avec un ou plusieurs types d’enregistrement).

 

 

Normalisation des noms de fichiers pour les passerelles

Le nommage des fichiers requiert plusieurs éléments :

<XXXx>_<Y>_<Z>.<N>

 

qui se décompose de la manière suivante :

 

XXX

Indicatif correspondant au code origine Cegid Orli
‎(exemple : BON = import Colisage expédition)

x

Obligatoire, il est utilisé pour les imports composées de plusieurs fichiers séquentiels (exemple : Entête et Lignes). Dans ce cas, sa valeur correspond au type de fichier paramétré dans TA350 (2^ème onglet)

 

Y

Code EDI du destinataire des données

 (= paramètre EDI_ORLI_SIT)

 

Z

Code EDI de l’expéditeur des données

 

N  Numéro du lot (obligatoire sans quoi le fichier est ignoré)

 

 

IMPORTANT :

• le planificateur de tâches recense les XC20B par origine-provenance-EDI, avec des fichiers normées.
• tant que ces tâches sont en cours, XC20B va rejeter tout autre nouvelle tâche XC20B pour un même code EDI :

« import expéditeur déjà en cours »

• la solution consiste donc, soit à faire un enchaînement JP025, avec toutes les passerelles de ce code EDI, soit éventuellement à prévoir des heures de lancement différentes par provenance-origine.

 

Cette particularité permet d’assurer une sécurité dans le flux des données, en évitant les problématiques de chevauchement intempestif ou d’aspiration de fichiers involontaire (si fichiers non normés ou mal nommés).

‎ 

 

Consultation des fichiers séquentiels générés par les passerelles

Il est possible de consulter via JP530 les fichiers séquentiels générés par les passerelles.

 

Installation d’un Serveur d’ÉDITION Cegid :
Le serveur Cegid Orli va dialoguer avec un Serveur d’ÉDITION, ‎et ce via à un répertoire « racine » :

• D:\orli\...

• C:\orli\...

‎ 

Passerelle d’import

 

Documentation de chaque import

Chaque import dispose d’une documentation dédiée, composée de :

• documentation fonctionnelle avec
  • Principe général
  • Description
  • Données à renseigner

     

• tableau (.xlsx) avec
  • onglet pour chaque type d’enregistrement
  • liste de chaque champ, avec
    • Colonne Réceptacle
    • Long : longueur
    • Position : n° ordre
    • Type don. : C(haracter) / N(umber) / D(ate)
    • Obl.
    • Libellé
    • Ex : exemple de donnée
    • Commentaire

 

Formats d'import

Pour réaliser l’intégration, vous devez générer un fichier "plat" (exemple : via un tableur Excel) contenant les enregistrements qui décrivent les données souhaitées.

La description et la structure du fichier sont imposées et fournies par Cegid.

Ce fichier doit ensuite être accessible du poste duquel l’intégration sera lancée.

Cette passerelle a pour but d’extraire les données du fichier, de les contrôler puis de les insérer dans les tables Cegid Orli correspondantes.

 

Les données du fichier ne doivent pas contenir de caractères spéciaux tels que :

• _
  Souligné

• '
  apostrophe

• /

• %

 

N.B. : le 1^er caractère d'un code doit être inclus dans les plages [0-9] ou [A-Z]
(les codes ne sont JAMAIS en minuscule)

‎

 

Schéma général d’un import

‎ 

Lancement de l’import

XC20B : Import des données

La première page permet d’indiquer le code provenance et le code origine fournis par Cegid et correspondant à un paramétrage particulier, ainsi que le code EDI et le lot.

4 possibilités de lancer l’intégration : 

• 0 = traitement du fichier, contrôles, intégrations des éléments ou rejet des ceux en anomalie, édition rapport.
• 1 = traitement du fichier, chargement dans le sas temporaire.
• 2 = Lancement de la procédure de contrôles à partir du sas, intégrations des éléments ou rejet des ceux en anomalie, édition rapport.
• 3 = 1 + Lancement de la procédure de contrôles à partir du sas temporaires mais pas d’intégration des éléments qui ont passé le contrôle.

 

La seconde page permet de renseigner les différents paramètres utilisés pour l’import ; l’accès à cette page est conditionné par la définition ou non de paramètres lors du paramétrage réalisé par Cegid.

 

Contrôles, initialisations, et mise à jour des données

Plusieurs types de contrôles sont réalisés à des étapes différentes dans l’import.

 

Dans un premier temps, lors de l’extraction des données du fichier pour intégration dans les tables réceptacles, un premier contrôle est réalisé.

Celui-ci consiste à vérifier :

• Si le type de l’enregistrement n’est pas erroné
• Si tous les champs obligatoires sont présents dans l’enregistrement
• Si le type des champs est correct : numérique, caractère, date, ...

 

Le type d’enregistrement permet d’identifier de manière unique un enregistrement dans un fichier : il s’agit de la clé.

Seuls les enregistrements pour lesquels aucune erreur de structure n’aura été détectée, sont intégrés dans les tables réceptacles.

Les enregistrements à problème (exemple : champ obligatoire non présent) sont rejetés et insérés dans un fichier de sauvegarde de structure identique au fichier reçu. L’utilisateur peut venir le consulter s’il le souhaite sous le répertoire $ODIE/XC200.

Les noms des différents fichiers générés lui seront remis le jour du paramétrage.

 

Chaque anomalie rencontrée donne lieu à l’écriture d’une ligne d’erreur dans la table des anomalies qui est ensuite éditée.

Toutefois, à chaque intégration, 3 types de fichiers peuvent être présents dans le répertoire $ODIE/XC200 :

• .err
  enregistrements sortis en anomalie contenant l’enregistrement à intégrer avec une phrase explicative de l’erreur
• .rej
  enregistrements rejetés contenant tous les enregistrements pour lesquels une anomalie a été détectée (à chaque anomalie présente dans le fichier .err correspond un enregistrement dans le fichier .rej)
• .temp
  fichier temporaire utilisé par le traitement (il est toujours vide).

Si ces fichiers sont vides, ils sont automatiquement détruits à la fin du traitement.

 

Principes génériques d’un import

Chaque passerelle réagit à des paramètres généraux, des options, et des paramètres d’import.

 

Récupération des fichiers

Les fichiers sont tout d’abord stockés en base (pour ré-import éventuel), puis stockés sur le serveur de TRAITEMENT dans un répertoire temporaire : ils sont alors automatiquement renommés afin de conserver intact les fichiers d’origine, puis archivés dans le répertoire $LOG_ODIE sous le nom

YYMMDDHHMMSS. “ nom du fichier à importer ”.

Un numéro de lot leur est ensuite affecté. Ce numéro de lot est un numéro séquentiel attribué à chaque fichier traité pour un même numéro de demande et permettant d’effectuer un suivi des transactions. Une fois les fichiers renommés, un enregistrement est créé dans une table assurant le suivi des transactions et consultable par JP031.

Le paramétrage TA350 permet de déclencher l’ouverture d’une page (type explorateur Windows) lors du lancement du moteur d’import XC20B. Vous pouvez alors rechercher votre fichier Excel et le sélectionner. Si besoin est, il est possible de paramétrer un répertoire et nom de fichier afin d’automatiser le traitement d’import (planificateur de tâches).

 

Lancement de l’import 

Le lancement de l'import s’effectue par XC20B. L’utilisateur doit saisir les codes provenance (SEPARAT ou FIXE) et origine correspondant à l’import.

Ces 2 données permettent de déterminer la source émettrice des fichiers.

Les fichiers sont en fait « triés » par provenance et origine.
‎Un code EDI destinataire devra être préalablement défini et la provenance / origine saisies pour ce code EDI destinataire dans TA440.

 

Import des fichiers dans les tables réceptacles Cegid Orli

À ce niveau, seuls des tests de structure des enregistrements sont effectués :
Type d’enregistrement erroné, Champ obligatoire ou non, Test sur le type de champ (numérique, caractère, date).

Cette étape a donc pour but de vérifier l’intégrité des données reçues et d’importer les données extraites dans les tables réceptacles prévues à cet effet. Ces tables servent ensuite de base à tous les traitements effectués avant l’import réel des affectations dans les tables définitives.

 

Contrôles de cohérence & Anomalies

Les contrôles et initialisations de données sont effectués dans cette phase : tous les contrôles effectués par Cegid Orli lors d’une saisie « normale » sont donc appliqués aux données à importer.

 

1) 1^er contrôle réalisé à l’export des données du fichier pour import en tables réceptacles

Celui-ci (technique) consiste à vérifier :

Si tous les champs obligatoires sont renseignés dans l’enregistrement

• Si le type des champs (numérique, caractère, date) est correct 

 

Seuls les enregistrements pour lesquels aucune erreur de structure n’aura été détectée sont importés dans la table réceptacle. Les enregistrements à problème (exemple : champs obligatoires non présent) sont rejetés. L’utilisateur peut venir consulter le fichier correspondant dans JP530 ‎(les noms des différents fichiers générés lui seront remis le jour du paramétrage).

 

Chaque anomalie rencontrée donne lieu à l’écriture d’une ligne d’anomalie qui est ensuite éditée.

2 types d'anomalie sont tracées dans JP530 :

 

• RECYCLABLES
  è anomalies fonctionnelles, en lien avec les données Cegid Orli, ‎mais incohérentes selon le contexte
  exemple : "n° BP déjà facturé"
  ‎è stoppe l’import du fichier en cours, puis passe au suivant

   

• FATALES
  ‎è anomalies bloquantes
  exemple : "n° BP inconnu"
  ‎è stoppe l’import de TOUS les fichiers
  ‎(le partenaire envoyant un fichier avec des informations qui ne concernent pas la base)

 

 

2) Initialisations et contrôles (fonctionnels)

 

Import des données

Seuls les enregistrements qui ont passé avec succès tous les contrôles cités ci-dessus peuvent être importés dans les tables définitives. Une fois l’import terminé, la liste des anomalies au niveau de la lecture du fichier est éditée.

Vocabulaire : Un fichier est un ensemble de données regroupées sous un même nom. Il est composé d’un enregistrement. Un enregistrement représente une ligne d’un fichier, il est composé de champs présents chacun dans une colonne. Un enregistrement est composé de plusieurs champs ou données.

 

Description des fonctions d’un import

Avant la première utilisation d’une passerelle d’import, une phase de paramétrage est indispensable. Celle-ci est réalisée EXCLUSIVEMENT par Cegid. Elle permet de décrire la structure du fichier et de vous affecter un code provenance et un code origine pour le lancement de l’import.

Ce paramétrage est standard et correspond au format de fichier imposé par Cegid.

Le descriptif du fichier est fixé. Toute demande de modification, évolution de la structure du fichier doit faire l’objet d’une demande auprès du service ingénierie Cegid.

Les fonctions concernées peuvent être scindées en plusieurs parties :

• PARAMÉTRAGE AVANT IMPORT
  Un shell ou la fonction DB398 peuvent être utilisés afin d’initialiser TA350 avec la description du fichier à importer, pour les provenances SEPARAT / FIXE et l’origine.
  Ce paramétrage ne doit pas être modifié sans une intervention Cegid.
  Le 4^ème onglet indique l’ordre des informations à renseigner. La première colonne précise l’ordre et la seconde la dimension maximum. Les données renseignées ne doivent pas avoir une taille supérieure au chiffre de la seconde colonne. Un fichier Excel peut être fourni avec des entêtes de colonnes qui devront servant d’aide à la saisie. Lors de la mise à disposition du fichier, ces entêtes devront être supprimés du fichier sous peine d’empêcher l’import.
• LANCEMENT DE L’IMPORT
  XC20B IMPORT DE FICHIERS SÉQUENTIELS
• CONTRÔLES ET INITIALISATIONS DES DONNÉES
  Plusieurs possibilités de lancer l’import : 
  • 0 = traitement du fichier, contrôles, imports des éléments ou rejet des ceux en anomalie, édition rapport.
  • 1 = traitement du fichier, chargement dans tables temporaires.
  • 2 = Lancement de la procédure de contrôles à partir des tables temporaires,
    ‎ et import des éléments ou rejet des ceux en anomalie, édition rapport.
  • 3 = 1 + Lancement de la procédure de contrôles à partir des tables temporaires
    ‎ mais pas d’import des éléments qui ont passé le contrôle.
• SUIVI DE L’IMPORT
  JP530 et JP031
  À la fin du traitement, la liste des anomalies d’import est éditée.

 

Principe d’ACQUITTEMENT

L’acquittement permet d’indiquer à leur expéditeur‎ que les données reçues ont été correctement importées (ou non, avec la raison du refus).

Ce « renvoi » d’informations est géré par XC300 standard,‎ via la fonction dédiée XC456 « Export Acquittement Pass.Import »

Les passerelles concernées par l’acquittement bénéficient de 2 paramètres d’import dédiés :

• ENVOI_ACQUIT
  ‎cocher par X pour déclencher l’acquittement
• CODE_ORIG_ACQ
  ‎choix du code origine à utiliser dans XC300 pour renvoyer l’acquittement
  ‎(ACQ par défaut, sinon valeur saisie, pouvant être égale au code origine de l’import),
  ‎le code provenance à utiliser dans XC300 étant quant à lui égal à ACQUITTE par défaut.

 

Un type de flux, associé à des champs « clé », permet de connaitre la nature des données renvoyées :

 

Paramétrages préalables

Le paramètre général EDI_ORLI_SIT doit obligatoirement contenir le code EDI relatif à votre site.

 

TA350 : Paramétrage import fichier externe

TA350W01
Cette fonction permet de paramétrer l'ensemble des données nécessaires à l'utilisation des passerelles d’import

 

Ce paramétrage est initialisé par Cegid Orli à l’installation de la passerelle.

En général, l'import des données s'effectue en 3 phases :

1. Remplissage des tables réceptacles à partir des fichiers reçus
2. Lancement des contrôles
3. Import des données dans Cegid Orli

 

4 onglets :

1. PROVENANCES / ORIGINES
   ‎ (Paramétrage import fichiers externes)
2. FICHIERS
   ‎ (Définition des fichiers externes)
3. TABLES
   ‎ (Fichiers à importer et réceptacles externes)
4. COLONNES
   ‎ (Structure des fichiers externes)

‎

• Onglet PROVENANCES / ORIGINES

 

Il permet de paramétrer, pour chaque provenance de fichier et chaque origine,
‎la manière dont l'import va être réalisée.

 

Les champs Provenance, Origine et Libellé sont obligatoires mais de saisie libre.

 

Fctn

Détermine le mode de fonctionnement de l'import, c'est-à-dire le mode de travail souhaité :

• 0 : MAJ des tables réceptacles, contrôle et import (phases 1+2+3)
  ‎èValeur standard
• 1 : MAJ des tables réceptacles uniquement (phase 1 seulement)
• 2 : Contrôle et import à partir des tables réceptacles (phase 2 +3)

 

N.B. :
cette fonctionnalité était utilisée par l’ancien XC200
è elle est désormais remplacée dans XC20B par le Mode de travail

 

Programme AVANT (1)

Ce programme sera lancé après la mise à jour des tables réceptacles et avant le lancement du programme standard d'import dans les tables Cegid Orli, si nécessité particulière du client

Programme STANDARD (2)

Ce programme est lancé afin de réaliser la mise à jour des tables Cegid Orli à partir des tables réceptacles. Il peut éventuellement effectuer des contrôles d'intégrité.

Programme APRÈS (3)

Ce programme est exécuté après le lancement du programme standard, si nécessité particulière du client.

N.B. :
saisie du nom du programme sur 5 caractères seulement ‎(son véritable nom comportant 8 caractères)

 

Sas

Pour les passerelles gérant un sas de validation (exemple : portail fournisseur), permettant d’importer les données en 3 étapes :

1. Chargement des données dans les tables réceptacles.
2. Via MUL spécialisé, le responsable valide ou rejette les données reçues.
3. Via ce MUL, il valide l’import définitif dans Cegid Orli qui exécute automatiquement XC20B en mode 4 selon les critères de recherche utilisés dans le MUL.

 

Type d'import

Champ obligatoire

Cette zone permet de préciser l'utilisation qu'il souhaite faire de la passerelle concernée.

 

2 cas de figure peuvent se présenter :

1. La passerelle peut être utilisée dans le cadre d'échanges de messages entre Cegid Orli et des logiciels externes (voire un autre Cegid Orli).
   Dans ce cas, le type d'import doit être à 0.
2. La passerelle peut être utilisée dans le cadre de reprise de données pour l'installation d'un nouveau site. Dans ce cas, le type d'import doit être à 1.

 

 

 

Niveau conceptuel XC20B

Cette zone permet de définir un ordre de priorité pour l'exécution des différentes passerelles d’un même lot (cas de passerelles dont l'exécution est conditionnée par la récupération de certaines informations issues d'autres passerelles d'import).

exemple : La récupération des commandes fournisseur PF ne peut s'effectuer que si les passerelles assurant la récupération des composants, articles et nomenclatures ont déjà été lancées :

Dans un premier temps, la fonction XC20B constitue un fichier avec la liste des passerelles rattachées au code EDI dans TA440 (2^ème onglet) dans l’ordre du niveau conceptuel (TA350, 1^er onglet) et du code origine.
Dans cette liste, il enlève les passerelles suspendues dans TA440.

Il lit ensuite chaque ligne de ce fichier.
‎Pour chacune d’entre elle, il liste tous les fichiers à traiter.

exemple : cette première liste correspond à tous les fichiers feuilles de route (exemple : FRO*) présents dans le répertoire de dépôt.

Il lit ensuite chaque ligne de ce fichier. Pour chacune d’entre elle,
‎il ajoute tous les fichiers avec le même numéro de lot.
exemple : on se retrouve avec tous les fichiers FRO et les autres fichiers ayant le même numéro de lot que les fichiers FROEnfin, il trie ce fichier par numéro de lot et niveau conceptuel.Il déplace ces fichiers dans un répertoire temporaire (tmp).Il intègre ces fichiers dans les tables réceptacles et lance les passerelles d’import.

On passe ensuite à l’origine suivante et on recommence.

 

• code origine associé à la « Feuille de Route » (exemple : « FRO » ci-dessus) paramétrable pour plus de souplesse (coche « FR » dans TA440, avec une seule origine par code EDI, ‎et Provenance/Origine avec Niveau Conceptuel et nom de fichier Normalisé dans TA350).

• le fichier Feuille de Route est repéré par XC20B
• son contenu n’est pas traité
• ‎le journal JP530 ne le mentionne pas
• ‎ainsi il n’y a pas de perte de temps générée à cause de la feuille de route

 

 

• Onglet FICHIERS

 

Provenance et Origine doivent avoir été préalablement saisies dans le premier onglet.

Il convient au préalable de bien visualiser la cinématique des imports, ‎avec les termes propres à chacune des étapes 

 

Norme

Cette coche va indiquer que le nom du fichier est aux normes XC20B.
‎

Normalisé :

Dans ce cas, le nom est directement défini par Cegid :

"Origine""Type Fichier"_"Code EDI Site"_"Code EDI Expéditeur"."N° de Lot"
‎(chacun de ces éléments est obligatoire, l’utilisateur ne peut en aucun cas modifier la structure)

NON Normalisé :

zone à blanc, et saisie libre du nom de fichier dans le champ suivant
‎(cas de passerelles spécifiques à certains clients).

èméthode déconseillée car elle suppose que tout fichier expédié soit immédiatement importé sous peine d'être écrasé par un prochain envoi.

 

Fichier à IMPORTER

• Normalisé :
  on propose par défaut le code Origine, et la structure du nom du fichier sera alors imposée selon des règles définies ci-dessus, mais il est possible d’ajouter une extension au fichier importé.

exemple :

ARTP_ORL_B2B.26101801.csv

ARTP_ORL_B2B.26101802.txt

• NON Normalisé :
  Saisie libre du nom de fichier, avec ou sans extension.
  exemple :

.txt

‎

Type (d’enregistrement)

Plusieurs types sont possibles, mais sont entièrement libres. En règle générale, on utilise les lettres suivantes, mais vous pouvez gérer ce type comme vous le souhaitez.

exemple :
P pour principal, E pour en-tête, L pour Lignes

Un fichier contenant des entêtes de commandes aura pour type « E », et le fichier contenant les lignes de ces commandes aura pour type « L ». Ce type d'enregistrement sera concaténé au code ORIGINE et au NUMÉRO de LOT (généré automatiquement, équivalent au numéro de demande).

La valeur ainsi obtenue correspondra au nom des fichiers d'erreurs.

 

Séparateur

Exclusivement si les fichiers à traiter sont de type longueur variable, donc avec séparateur.

Il faut indiquer ici la nature du séparateur du fichier à récupérer.

Ce peut être  une virgule, un point-virgule.

Pour gérer le séparateur tabulation mettre « T ».

 

Répertoire INTERNE

En standard, ne rien renseigner, le répertoire du serveur de TRAITEMENT étant par défaut :

• $ODIE/XC200 (Cegid Orli OnPremises)
• répertoire temporaire du Serveur de TRAITEMENT (Cegid Orli OnDemand SaaS)

Sinon : Répertoire du Serveur de TRAITEMENT dans lequel se trouvent les fichiers à importer
‎(variable Unix ‘$’ autorisée).

N.B. :
la recherche des fichiers à importer est récursive (sous-répertoires compris) 
‎è ne jamais faire de sauvegardes de fichiers sous ce niveau, car ils seraient pris en compte.

 

Purge

Nombre de jours limite de conservation des fichiers traités archivés. Si ce nombre de jour n'est pas renseigné, le nombre de jour défini dans le paramètre général NB_JOUR_PUR est utilisé.

 

Upload

èFonctionne avec XC20B (manuel), uniquement pour les provenance-origine Mono-Fichier.

èPermet le téléchargement du fichier depuis le poste de l’utilisateur
‎ (Le fichier est alors copié vers le répertoire sur le Serveur de TRAITEMENT)

Cette fonctionnalité est disponible dans le cadre d’un lancement manuel de XC20B avec les 3 critères Provenance / Origine / Code EDI renseignés.

 

Reformatage des données

Uniquement à la suite d’un Upload pour les provenance-origine Mono - Fichier / Mono - type enregistrement, la sélection de cette coche permet d'obtenir le reformatage automatique d'un fichier Excel (Téléchargement) en fichier plat avec séparateur ';'. un seul type d'enregistrement est alors saisissable dans l'onglet 3 (Fichiers à importer et réceptacles externes).

‎

Fichier à CHARGER

Si saisi, nom du fichier à transférer dans le cas d'un téléchargement (coche UPLOAD)

Si non saisi, l'utilisateur sera amené via un explorateur à le choisir au moment du transfert.

Normalisé :

Le fichier à charger doit respecter la structure de la norme, avec le N°lot pour seul suffixe (8 chiffres maximum, sans espaces)

èsi préfixe non normalisé, erreur

basename: extra operand ‘..’

èsi suffixe .csv ou .xlsx, erreur

ORA-00904 … invalid identifier

 

Répertoire EXTERNE

Dans le cas d'un téléchargement (coche UPLOAD) :
‎information facultative pour indiquer le répertoire du poste client où se situe le fichier à transférer
è Si non indiqué, la valeur du paramètre général REP_INTEG_PC variable par utilisateur
‎(Valeur par défaut C:\Temp\) sera utilisée.

 

Dans le cas d'un chargement automatique :

cette valeur indiquera le répertoire externe (JP015) dans lequel aller chercher le ou les fichiers à importer. Le mode « multi-fichiers » dépend de la présence (1 fichier précis) ou non (quel que soit le suffixe) du critère N°lot (8 chiffres maximum, sans espaces).

 

 

• Onglet TABLES réceptacles
  ‎

Il comporte 2 notions, les fichiers à importer et les réceptacles des fichiers externes.
‎La première partie permet de récupérer, en fonction du code provenance, code origine et type de fichier, la position de la zone clé dans les enregistrements du fichier.

Cette zone clé correspond à la clé primaire.

La zone EXTENSION, si elle est cochée, indique qu'il existe une clé secondaire qui sera définie au niveau des réceptacles des fichiers externes.

Si cette zone est nulle, cela signifie qu'il n'y a pas de clé secondaire.

La deuxième partie permet d'associer à chaque groupement : Provenance-origine-Type de fichier les différents types d'enregistrements présents dans le fichier, leur taille, (données indispensables pour pouvoir effectuer la lecture séquentielle du fichier) et la table du réceptacle Cegid Orli qui est mise à jour. De plus, la position de la zone de rupture est indiquée pour chacun des enregistrements.

 

Cas particulier :

Si la taille et la table réceptacle ne sont pas renseignées pour un type d'enregistrement, les zones EXTENSION début et fin indiquent la position de début et de fin de la clé secondaire dans l'enregistrement courant (La concaténation des clés primaire et secondaire correspondra à un type d'enregistrement pour lequel une taille, une table réceptacle et une position de rupture seront précisées.)

Le type d'enregistrement n'est pas modifiable, vous devez en premier supprimer puis recréer.
‎La suppression entraînera la suppression automatiquement des données contenues par rapport à la structure de ces fichiers pour la même provenance, même origine, même type de fichier et même type d'enregistrement.

 

Fonctionnement des informations suivantes : Zone clé DÉBUT et FIN et « type enregistrement » (valeur de la clé)

(Le fonctionnement expliqué ci-dessous ne prend pas en compte l’utilisation de la coche « Extension »)

 

Cas fichier séparateur :

 

Valeurs des positions DÉBUT et FIN

0 et 0
è On peut gérer un type d’enregistrement mais il ne sera pas retenu

1 et 1
è Zone clé d’une longueur de 1 caractère dans la première colonne.

1 et 3
è Zone clé d’une longueur de 3 caractères dans la première colonne.

17 et 2
è Zone clé d’une longueur de 2 caractères dans la colonne 17.

(La valeur de fin est nécessaire mais ne permet pas de limiter la lecture de la clé à n caractères.
‎La valeur de la clé doit être identique, dans la colonne renseignée, à celle du type d’enregistrement).

 

Type d’enregistrement renseigné

Cas Type = ENTETE => Toutes les lignes ayant cette valeur de clé seront retenues pour l’import.

Attention, cette clé doit être trouvée dans la colonne définie dans « Zone clé DEBUT ».

exemple :
fichier : 00P ; ARTICLE ; COLORIS ; ENTETE ; 10 ;
il faudra saisir 4 dans « Zone clé DEBUT » pour indiquer qu’on va trouver la clé dans la quatrième colonne.

 

exemple :
fichier : ENTETE ;00P ; ARTICLE ; COLORIS ;  10 ;
il faudra saisir 1 dans « Zone clé DEBUT » pour indiquer qu’on va trouver la clé dans la première colonne.

 

Saisir la longueur  de cette clé dans « Zone clé FIN ».

exemple :
clé = « ENTETE », il faudra saisir 6 dans « Zone clé FIN » car il y a 6 caractères dans la clé.

 

1. Type d’enregistrement non renseigné (ou cas 0 et 0 dans début et fin)
   è Toutes les lignes seront retenues pour l’import.

 

 

Cas fichier structure fixe :

Valeurs des positions DÉBUT et FIN

0 et 0
è on peut gérer un type d’enregistrement mais il ne sera pas retenu

1 et 1
è Zone clé d’une longueur de 1 caractère à la position 1.

1 et 3
è Zone clé d’une longueur de 3 caractères à la position 1.

17 et 2
è Zone clé d’une longueur de 2 caractères à la position 17.

 

Type d’enregistrement renseigné

La clé saisie est recherchée à la position indiquée par « Zone clé DEBUT » et « Zone clé FIN »
‎ (sauf cas 0 et 0).

Si une ligne possède cette clé, à la  bonne position, elle est retenue.

Les lignes sans cette clé ne sont pas retenues.

 

1. Type d’enregistrement non renseigné (ou cas 0 et 0 dans début et fin)
   è Toutes les lignes seront retenues pour l’import.

 

Fonctionnement de l’EXCLUSION DE LIGNES : zone ‘Exclusion’ et coche ‘S’

 

Pré-requis : La coche « Extension » ne doit pas être renseignée.

Une valeur, saisie dans « Exclusion », permet d’exclure les lignes possédant cette clé.

Les zones extension DEBUT et FIN sont alors utilisées pour définir la position de cette clé.

En fichier structure fixe il s’agit de la position de début et fin de la clé.

En fichier avec séparateur il s’agit de la position de la colonne où trouver la clé (la valeur de fin est nécessaire mais ne permet pas de limiter la lecture de la clé à n caractères. La valeur de la clé doit être identique dans la colonne renseignée).

La coche ‘S’ permet de supprimer, si elle est cochée, la première ligne du type d’enregistrement.
‎Pour les fichiers multi-enregistrements, seule la première ligne du fichier sera traitée quel que soit le paramétrage. Dans le cas où on ne souhaite pas conserver dans le fichier importé les titres des colonnes car non utilisés. Le fait de cocher, évite une manipulation supplémentaire de l’utilisateur lors de l’import pour supprimer cette ligne inutile.

But :

Possibilité d’avoir le titre des colonnes dans les fichiers en entrées comme en sorties, ce qui permet d’augmenter la visibilité sur le contenu des données, en cas de recherche de problèmes.

 

N.B. : Il est possible de visualiser le contenu d’un fichier traité par la passerelle d’import (XC20B) ou les passerelles d’export (XC300) via les fonctions de consultations de traitements (JP530 et JP031).

‎

Mise en œuvre dans les passerelles d’import (XC20B) :

• Possibilité de conserver la ligne de titre des colonnes dans le fichier en entrée et paramétrer la passerelle pour ne pas la traiter comme données à importer.

N.B. :
surtout utile dans le cas de fichier avec séparateur qui augmente la visibilité au travers d’un outil comme XL ; néanmoins, ceci s’applique également pour les fichiers en format fixe, mais est moins pratique du fait qu’on ne voit pas le titre de la colonne en entier.
Il est préférable d’utiliser des fichiers avec séparateur car est plus pérenne en cas d’augmentation des tailles de champ. Dans la fonction « Paramétrage import fichier externe » (TA350), onglet « Fichiers à importer et réceptacles externe », coche « S » pour supprimer la 1^ère ligne du fichier correspondant au type d’enregistrement.

 

• Mise en œuvre dans les passerelles d’export (XC300) :
  • Permet de rajouter une ligne en début de fichier qui contient les entêtes de colonnes, ceci pour améliorer la visibilité du contenu
  • Dans la fonction « Paramétrage client export édition JP561 », onglet « Type de format »  coche permettant d’ajouter une ligne en début de fichier qui contient les entêtes de colonnes
  • Ouvert pour tout type d’export

exemple : pour fichier (avec séparateur) AVEC type enregistrement renseigné

Zone clé DÉBUT: 3

Zone clé FIN : 5

Type enregistrement: LIGNE

Extension DÉBUT: 5

Extension FIN : 2

Exclusion : @@

 

Si ‘S’ (coche de suppression de la première ligne du type d’enregistrement) n’est pas coché :

Sais; Article ; LIGNE ; 4 ; 5 ; 6 ; è ligne retenue

00P ; 7M658-TU ; LIGNE ; 12.54 ; GM ; ZZZZ ; è ligne retenue

00P ; PM354-LM ; LIGNE ; 12.54 ; GM ; ZZZZ ; è ligne retenue

00P ; 7M658-TU ; LIGNE ; 12.54 ; @@ ; ZZZZ ; è ligne ignorée

 

Si ‘S’ (coche de suppression de la première ligne du type d’enregistrement) est coché :

Sais; Article ; LIGNE ; 4 ; 5 ; 6 ; è ligne ignorée

00P ; 7M658-TU ; LIGNE ; 12.54 ; GM ; ZZZZ ; è ligne retenue

00P ; PM354-LM ; LIGNE ; 12.54 ; GM ; ZZZZ ; è ligne retenue

00P ; 7M658-TU ; LIGNE ; 12.54 ; @@ ; ZZZZ ; è ligne ignorée

‎ 

exemple : paramétrage pour fichier (avec séparateur) SANS type enregistrement

Zone clé DÉBUT : 0

Zone clé FIN : 0

Type enregistrement:

Extension DÉBUT: 5

Extension FIN : 2

Exclusion : @@

 

• Si ‘S’ (coche de suppression de la première ligne du type d’enregistrement non cochée) n’est pas coché:

  Sais ; Article ; LIGNE ; 4 ; 5 ; 6 ; è ligne retenue

  00P ; 7M658-TU ; LIGNE ; 12.54 ; GM ; ZZZZ ; è ligne retenue

  00P ; PM354-LM ; LIGNE ; 12.54 ; GM ; ZZZZ ; è ligne retenue

  00P ; 7M658-TU ; LIGNE ; 12.54 ; @@ ; ZZZZ ; è ligne ignorée

   

• Si ‘S’ (coche de suppression de la première ligne du type d’enregistrement) est coché :

Sais ; Article ; LIGNE ; 4 ; 5 ; 6 ; è ligne ignorée

00P ; 7M658-TU ; LIGNE ; 12.54 ; GM ; ZZZZ ; è ligne retenue

00P ; PM354-LM ; LIGNE ; 12.54 ; GM ; ZZZZ ; è ligne retenue

00P ; 7M658-TU ; LIGNE ; 12.54 ; @@ ; ZZZZ ; è ligne ignorée

‎ 

• Onglet COLONNES réceptacles
  ‎Cet onglet définit la structure de chacun des enregistrements pour le groupement suivant :

• Provenance
• Origine
• Type de fichier
• Type d'enregistrement

 

On peut ainsi préciser les champs, avec leur position de début et leur position de fin dans le fichier à importer, ainsi que leur type, leur caractère obligatoire ou facultatif, et enfin, la colonne correspondante dans la table réceptacle (colonne qui va recevoir la valeur de ce champ), ainsi que le nom de la colonne externe (défini dans le fichier XML), et son préfixe associé.

N.B. :
pour un fichier à longueur variable avec séparateur, la position Début est la position relative du champ dans l’enregistrement, c'est-à-dire le numéro d’ordre dans le fichier.

Si vous indiquez le chiffre 0 dans les positions de début et de fin, la colonne de la table réceptacle sera alimentée du numéro de ligne de l'enregistrement dans le fichier importé. Ceci fonctionne même si vous importez un fichier avec séparateur.

Le type peut prendre pour valeur :

• C : caractère
• N : numérique
• D : date

 

Si le type est DATE (D) le format de la date devra être saisi (voir aide champ).

La coche Obl activée signifie que ce champ devra obligatoirement être renseigné.

La coche Recod (en bout de ligne) activée signifie qu’il faudra déclarer dans TA446 les recodifications des données pour établir un lien entre les deux progiciels pour le champ en question.
Dans ce cas, le champ Table à recodifier doit être obligatoirement renseigné.
Valeur par défaut traite les cas de valeur fixe à enregistrer si la zone reçue ne contient pas de donnée.

 

 

TA440 : Référencement général des codes EDI

TA440W01
Cette fonction permet de gérer les codes EDI utilisés pour les traitements d’import/export

 

L’option TA440W01/GES_EDI_ORL_REF permet de gérer ou non le recensement toutes bases comprises de l'ensemble des Expéditeurs ou Destinataires susceptibles d'adresser ou de recevoir des échanges de données avec Cegid Orli.

• 0 : Dans ce cas (Standard), l'utilisateur ne renseigne pas l’onglet ‘Codes EDI génériques’ qui devient inaccessible. Il devra donc définir les différents interlocuteurs susceptibles de dialoguer avec le site dans l’onglet ‘Codes EDI’.
• 1 : Dans ce cas, l'utilisateur renseigne les différents interlocuteurs (via leur code EDI) avec lesquels il souhaite dialoguer au niveau de l’onglet ‘Codes EDI génériques’.

 

Il est conseillé de laisser l’option à 0.

 

Description des onglets :

Codes EDI

Cet onglet permet à l'utilisateur de définir, pour chaque site, les différents expéditeurs ou destinataires avec lesquels le site est susceptible de dialoguer (Export ou Import de données). Chaque interlocuteur est identifié par un code EDI qui doit être unique.

L'utilisateur peut également utiliser cette fonction pour suspendre (momentanément ou définitivement) les échanges de données avec un expéditeur ou un destinataire donné. Pour ce faire, il lui suffit de cocher la zone "Suspension Export" ou la zone "Suspension Import" (ces deux zones étant testées par le traitement assurant le routage de l'import ou de l'export).

 

Profil culturel

Le profil culturel du partenaire EDI peut être utilisé dans le cadre des passerelles d'export.
‎Il ne concerne que la traduction des libellés dans la langue du profil (Sous Réserve que la passerelle fonctionnelle assure cette gestion). Il ne concerne pas les formats de date : ceux-ci dépendent du type de format décrit dans le paramétrage d'export saisi dans TA450.

 

Coche Verrou Import

Cette zone permet d'ôter le verrou posé par le Pilote d'Import.
‎Cette zone n'est accessible que si elle est cochée et si l'option ACCES_VERROU=1

 

Imports par Code EDI

Cet onglet permet à l'utilisateur de définir, pour chaque site, et chaque expéditeur, les différents imports de données susceptibles d'être adressées. Un lien est établi entre le code EDI, le code provenance et le code origine. Si ce lien n’est pas créé ici, vous ne pourrez pas lancer la passerelle de ce code EDI/code provenance/code origine.

L'utilisateur peut également utiliser cette fonction pour suspendre (momentanément ou définitivement) les échanges de données concernant une passerelle et un expéditeur donné. Pour ce faire, il lui suffit de cocher la zone "Suspension Import" (cette zone étant testée par le traitement assurant le routage de l'import). En cas d'anomalie fatale lors des imports, cette zone est mise à jour automatiquement par le pilote d'import afin de préserver la chronologie des flux.

La coche ‘Suivi’ permet de paramétrer l'affichage de la page de suivi dans le PDF résultant de l'import. Cette page est éditée juste après la page de garde (contenant les critères).Ceci peut être utile pour des interfaces automatisées toutes les 10mn pour lesquels le rapport peut devenir polluant. A décocher dans ce cas.

La coche ‘Trace’ permet à l'utilisateur de rendre visible des traces fonctionnelles supplémentaires que l'on visualise dans l'onglet TRACES de JP031.

La notion de ‘Surveillant permet, en cas d'anomalie fatale, de spécifier l’utilisateur vers lequel le routage automatique du journal à son adresse mail doit s'effectuer en lieu et place de l'utilisateur ayant lancé le traitement. Pour l'interface avec Cegid SCM, cette information est également utilisée pour le routage par mail des anomalies fonctionnelles.

La coche ‘NON Suspension import’ (Avant notion surveillant) permet à l'utilisateur, pour des cas très particuliers, d'indiquer qu'il souhaite que lorsque des anomalies fatales fonctionnelles sont détectées par le pilote, celui-ci ne suspende pas les imports suivants même si la réparation de l'anomalie n'a pas été réalisée.

N.B. :
ceci ne permet plus de certifier la sécurité chronologique des flux. Cegid estime que son utilisation doit être faite en toute connaissance de cause et désengage sa responsabilité quant aux effets de bord liés au non-respect chronologique des imports.

La notion ‘Jeu de caractères’ ne concerne que Cegid Orli NON Unicode, qui, par défaut, se protège en rejetant l'import de fichiers reçus au format Unicode. Ce paramétrage vous permet de signifier et accepter que l'expéditeur pour cette provenance/origine vous adresse des fichiers au format UTF8 ou UTF16. Dans ce cas, Cegid Orli assure (sans contrôle) la conversion UTF8 ou UTF16 vers ISO (iso8859-9) des fichiers reçus avant import dans Cegid Orli.

La coche ‘Mode Web Service’ indique le comportement des passerelles d'import via Web Service. Lorsqu'elle est décochée, les tables temporaires sont remplies puis l'import via XC20B est exécutée.

Dans le cas contraire, seules les tables sont remplies, sans exécution de XC20B.

‎ 

Association entité Cegid Orli

Cet onglet permet d’associer un code EDI à une entité Cegid Orli selon la nature de votre interlocuteur. Ces entités sont :

• Magasin matière
• Magasin produits finis
• Atelier
• Fournisseur
• Client
• Circuit

 

Ainsi, si vous devez échanger des données avec votre fournisseur FOUR01, vous devrez déclarer dans cet onglet un lien entre le code EDI et le fournisseur FOUR01.

N.B. :
Il est parfaitement possible d'associer un même code EDI à une valeur différente dans les 4 entités Cegid Orli recensées (Ex: Le code EDI "A01" correspond au magasin "ORL01", mais aussi à l'atelier "ATE01", au fournisseur "FOUR01" et au client "42300001"). Si tel est le cas, les fonctions connexes assurant le contrôle et l'import des données reçues auront à leur charge le décryptage de la zone Cegid Orli correspondante (Magasin, Atelier, Fournisseur ou Client).

 

Codes EDI génériques

Onglet accessible ou non selon l’option GES_EDI_ORL_REF.

Permet de déclarer les codes EDI de toutes les bases.

 

 

Gestion des alertes et suspension des traitements

Dans TA440, il est possible de cocher ‘pas de suspension si anomalie fonctionnelle’ dans le 2^ème onglet.

Dans ce cas, la passerelle ne se suspend pas en cas d’anomalies fonctionnelles.

Il est également possible de saisir un surveillant afin que le fichier de rapport d’anomalies lui soit routé. Il n’est pas possible d’avoir plusieurs surveillants, mais il est possible de créer un surveillant qui soit associé à un mail correspondant à une liste de diffusion.

Si aucune anomalie ou alerte, le surveillant ne reçoit rien.

 

Le principe est le suivant :

• Si anomalie non bloquante (=alerte) :
  • message visible dans JP031.
• Tous les enregistrements corrects ou avec anomalies non bloquantes sont importés, les autres sont rejetés en attente de recyclage.

   

• Si Anomalie bloquante (=anomalie) :
  • message visible dans JP031
  • routage par mail du fichier rapport d’anomalies (contient le nombre d’anomalies consultables ensuite en JP031 à partir du numéro de demande).
  • Import non fait :
    • nécessité de régler le problème selon le cas, soit :
      • En corrigeant les infos à l’origine du blocage (ex : saisie du PRI manquant).
      • Modifier par XC800 les erreurs (exemple : supprimer une réception car déjà faite).
    • Puis relancer manuelle l’import (XC20B en mode recyclage).

 

TA446 : Recodification des données EDI

TA446W01
Cette fonction permet, pour chaque code EDI, et chaque table traduisible (JP044), de relier les valeurs internes "code Cegid Orli" aux valeurs "code externe"

 

Ces recodifications sont valables aussi bien dans le sens des exports (recherche du code externe si coche "Rec" dans JP562/lignes) que celui des imports (recherche du code Cegid Orli si coche "Recod" dans TA350/onglet 4).

 

• Exemple de recodification

Dans Cegid Orli, vos catégories de taille sont codifiées ainsi :

T01 prêt-à-porter femme du 38 au 52

E01 prêt-à-porter enfant du 3 mois au 24 mois

E02 prêt-à-porter enfant du 2 ans au 16 ans

C01 chaussures du 36 au 43

 

Dans votre autre progiciel, les catégories de tailles sont codifiées ainsi :

 Z124 prêt-à-porter femme du 38 au 52

 Y451 prêt-à-porter enfant du 3 mois au 24 mois

 Y678 prêt-à-porter enfant du 2 ans au 16 ans

 W895 chaussures du 36 au 43

 

Vous souhaitez reprendre les données de vos articles de votre progiciel vers Cegid Orli, avec les catégories de tailles.

Dans TA350, après avoir renseigné les codes provenance, origine, dans l’onglet ‘Structure des fichiers’, vous constaterez que la colonne CODE_TAIL est déclarée en recodification.

La table associée à cette recodification est libellée TAILLE.

 

Dans TA446, il faut sélectionner le code EDI que vous avez préalablement déclaré dans TA440.

Dans le champ Table, vous pouvez sélectionner la table dans la liste de valeurs, ou saisir directement son nom, si vous le connaissez.
Dans notre exemple, il s’agit de la table TAILLE.

Vous obtenez alors la liste suivante :

 

Il faut renseigner la colonne Code Externe avec les codes de l’autre progiciel, de la façon suivante :

 

N.B. :
1 même code Cegid Orli peut correspondre à x codes externes (cas de regroupements en Import) ; dans ce cas, un Export va appliquer le premier code externe trouvé, par ordre alphabétique.
A l'inverse, 1 même code externe peut correspondre à x codes Cegid Orli (cas de regroupements en Export) ; dans ce cas, un Import va appliquer le premier code Cegid Orli trouvé, par ordre alphabétique.

 

Passerelles

XC20B : Import fichier séquentiel

XC20BW01
Cette fonction permet de lancer les traitements d’import, à partir de fichiers ou de tables

 

Les critères « Provenance » et « Origine » sont ceux que vous aurez déclarés dans TA350.

Le critère « EDI » est celui déclaré dans TA440 pour lequel les codes provenance et origine sont associés (onglet ‘Imports par Code EDI’)

Le critère « n° de lot » n’est utilisable dans la pratique que dans le contexte de fichiers ‘normalisés’. Sinon il est initialisé avec le n° de demande du prime import et devient utile en mode reprise.

Le critère Mode de travail définit les modalités de l’import ‎(autrefois gérées dans XC200 par la fonctionnalité de TA350).

Sachant que le processus de travail classique est le suivant :

• Remplissage des tables réceptacles à partir des fichiers reçus
• Lancement des fonctions de contrôles
• Import des données dans Cegid Orli

 

‎Les 5 modes possibles ( de 0 à 4 ) sont :

• 0 - Tables réceptacles et import :
  la fonction remplira les tables réceptacles, puis effectuera l’import des données à partir du fichier de départ
  (exemple : fichier texte).
  ‎Lors de cette seconde étape, seules les lignes en anomalie resteront dans les tables réceptacles (phases 1 + 2 + 3)
• 1 – Tables réceptacles uniquement : la fonction remplira les tables réceptacles et ne lancera pas d’import de données ; tables réceptacles visibles dans XC800 (phase 1)
• 2 – Recyclage à partir tables réceptacles : la fonction effectuera l’import des données à partir des tables réceptacles des anomalies fonctionnelles rejetées lors du prime import ; à utiliser suite correction des anomalies, en général via XC800 qui permet, via le bouton « Imprimante », d’enchaîner directement ce mode de recyclage.
• 3 – Tables réceptacles et contrôle données : la fonction effectue l’import des données dans les tables réceptacles et lance tous les contrôles des données, mais sans faire l’import définitif (cas peu utilisé).

N.B. :
ce mode 3 n’est pas pris en compte en standard dans toutes les passerelles.

 

Passerelles standard qui gèrent le mode = 3

• XC005
  Import création BP
• XC045
  Import Gestion des personnes
• XC113
  Import Répartition fabric. article
• XC114
  Import Répartition fabric. matière
• XC118
  Import Référence produit atelier
• XC226
  Import Réc. Cross-Docking et Transfert
• XC249
  Import Coût façon négoce
• XC260
  Import Client
• XC274
  Import Regroupements commerciaux
• XC425
  Import Retour client PF
• XC496
  Import SLSRPT (AVANT)
• XC497
  Import SLSRPT (APRES)
• XC711
  Import STOCK COLOMBUS èCegid Orli
• XC825
  Import Identifiant ESKER

• 4 – Import à partir tables réceptacles : signifie que la fonction effectue l’import des données à partir des tables réceptacles et non à partir du fichier de départ. Mode à utiliser lorsque vous alimentez vous-mêmes directement les tables réceptacles sans passer par un fichier plat
  (phases 2 + 3).

‎ 

Type d’import

• 0 – Échange EDI : signifie qu’il s’agit d’un échange de données courant.
  ‎Ce type d’import peut s’effectuer de façon régulière, quotidienne, hebdomadaire, mensuelle…
• 1 – Reprise de données : il s’agit ici d’une reprise de données lors d’un changement de site ou changement de logiciel. Ce type d’import n’est à effectuer qu’une seule fois, lors du changement. Selon le type d’import choisi, ce ne sont pas les mêmes tables qui sont mises à jour.
  La table des anomalies est la table ORL_ANOMALIE.

Les anomalies sont listées par Origine/provenance/lot (JP031), stockées dans ORL_ANOMALIE.

 

Particularité :

La passerelle pour l’expédié ne peut pas être lancée en mode reprise. En cas d’anomalies,
‎la passerelle ne traite rien. Il faut aller corriger les données erronées et relancer la passerelle comme lors d’un premier lancement. Il ne faut pas la relancer en mode reprise.

 

• Import multi-niveaux
  Le cas typique est celui de l’export des commandes fournisseur PF, ‎qui doit engendrer celle des informations constituant la commande fournisseur PF, soit :
• Les FICHES des produits à fabriquer
• Les NOMENCLATURES des produits
  • Les fiches des composants utilisés
  • Les fiches des produits semi-finis utilisés
• Les GAMMES OPÉRATOIRES des produits
  • Les fiches des opérations effectuées

 

Numéro de Lot

Des fichiers séquentiels pour des origines d’imports différentes sont générés.

Le principe du multi-niveaux concerne la phase d’import car l'intégrité du message est assurée par l’ensemble de ses différentes composantes.

 

Le nom des fichiers normalisés comporte une extension basée sur le numéro de lot.

À ce niveau elle est primordiale et tous les fichiers générés dans cet enchaînement doivent être suffixés par le même numéro de lot.

 

Niveau Conceptuel

Dans cette architecture, le pilote doit exécuter les imports dans un ordre très précis. En effet, s’il exécute celle des gammes opératoires avant les opérations, l’import final des gammes provoquera des erreurs fatales car des fiches opération seront sans doute inexistantes.

Il utilise donc une notion de niveau conceptuel pour ordonner l’ordre du chargement des fichiers séquentiels. Celui-ci se paramètre par la fonction TA350 (colonne NIV_CONC).

Elle doit contenir un nombre de 1 à 99 représentatif de l’ordre (inverse) à utiliser.

 

 

Pilote

La gestion du multi-niveaux engendre un comportement particulier du pilote :

Son lancement nécessite uniquement le choix de l’import des O.F

Lorsqu’il trouve un fichier à importer, il complète sa recherche par celle d’autres fichiers de même numéro de lot provenant de l’expéditeur traité.

Il constitue une liste des fichiers triés par niveau conceptuel et déplace l’ensemble de ces fichiers dans le répertoire de travail.

Ensuite il déroule l’exécution de l’import pour chacune des origines.

 

 

• Aide pour trouver les incohérences de format dans un fichier

 

Le critère ‘Contrôle structure fichier’ dans l’onglet ‘Fonctionnels’ (0 = Inactif, 1 = Actif, en lieu et place de l’ancienne option XC20B/DEBUG_NUM_DAT), permet de générer une liste des champs Number/Date incorrects dans le fichier plat, et ainsi de retrouver facilement les erreurs de structure de fichier (uniquement pour relancer l’import des données après import incorrect, car la durée du traitement est plus longue quand ce critère est actif).

‎ 

Upload

Il est possible d’uploader des fichiers .xls ou .xlsx comportant plusieurs types d’enregistrements.
‎Le principe nécessite un paramétrage TA350 (coche Upload) non livré en standard.
‎

La démarche à suivre est la suivante :

• Créer une feuille Excel correspondant à un type d’enregistrement
• Créer une feuille Excel correspondant à un second type d’enregistrement
• Enregistrer chaque feuille en format .csv
• Cumuler tous les fichiers .csv pour n’en faire plus qu’un (exemple : via NotePad)

C’est la seule solution pour gérer plusieurs types d’enregistrements dans un même fichier.

 

Cas de fichiers Excel directs :

Ce principe complémentaire à l’Upload nécessite également un paramétrage TA350 (coche REFORM.) non livré en standard qui permet d’uploader directement un fichier .xls/.xlsx (sans avoir besoin des outils Office sur le poste), puis de le reformater (type .csv avec séparateur).

 

Certaines précautions doivent être prises pour assurer le bon fonctionnement de ce principe :

• Uniquement pour des provenances mono-fichier
• À l’intérieur de ce fichier, ou peut trouver un ou plusieurs types d’enregistrements ; dans ce dernier cas, ou pourra avoir des enregistrements de longueurs variables, qu’il faut alors obligatoirement « matérialiser » avec un caractère spécial (exemple : X) dans la colonne qui suit la dernière colonne utile (sans quoi, si cette dernière colonne utile a une valeur vide, elle ne sera pas reformatée)
• Le fichier ne doit pas comporter de cellules (voire des lignes) vides inutiles
• Pour vérifier le contenu du fichier sous Excel :
  • Atteindre (raccourci F5)
  • Bouton Cellules
  • Sélectionner Cellules vides
  • Les cellules concernées sont alors repérées visuellement
  • Il faut alors les Supprimer (raccourci Ctrl -)
    ‎en choisissant Décaler les cellules vers le haut

‎ 

Cas de PAS-CDE :

Cette passerelle est paramétrée pour recevoir un fichier par type d’enregistrement ‎(un fichier entête, un fichier ligne, un fichier remise….).
‎Pour uploader plusieurs fichiers XLS comportant plusieurs type d’enregistrements, ‎il faut paramétrer pour gérer 1 seul fichier avec un type d’enregistrement indiqué en début de ‎chaque ligne permettant de savoir s’il s’agit d’un enregistrement entête ou d’un enregistrement ligne…

 

exemple :
pour le fichier PAS-CDE  à importer : On aura un seul fichier avec un type d’enregistrement ou il est indiqué en début de chaque ligne s’il s’agit d’un enregistrement entête ou d’un enregistrement ligne…

 

ENT...

LIG...

LIG...

LIG...

LIG...

ENT...

LIG...

LIG...

 

 

Ainsi, on a besoin d’une feuille Excel avec :

TYPE TOUS CHAMPS ENTETE            TOUS CHAMPS LIGNE

Entêtetous champs d’entête 1^ère cde  vide

Ligne vide     tous champs lignes remplis

Entêtetous champs d’entête 2^ème cde  vide

Ligne vide     tous champs lignes remplis

 

…Etc…

‎ 

 

Numérotation des enregistrements

Il existe une possibilité de récupérer le N° de ligne de l’enregistrement dans le fichier, en insérant ‎une colonne dans la table réceptacle, avec le champ nommé NUM_LIGN, en position (0,0) :

• cela permet de faire un ORDER BY séquentiel sur les enregistrements du fichier
• le moteur XC20B alimente lui-même cette colonne si elle est présente dans la table (TA350)

 

Provenances par défaut

Il existe 2 provenances par défaut dans Cegid Orli :

1. SEPARAT
2. FIXE

 

Particularités de SEPARAT :

• Les champs sont séparés par un séparateur ( ; par défaut)
• Le nombre de champ doit correspondre au nombre attendu de champ
• Pour les nombres avec des décimales, la virgule doit être systématiquement passée.

 

Particularités de FIXE :

• Les champs caractères sont cadrés à gauche et complétés à droite par des espaces
• Les champs numériques sont cadrés à droite et complétés à gauche par des zéros.
• Pas de séparateur entre chaque champ
• La longueur des enregistrements doit être respectée.
• Pour les nombres avec des décimales, la virgule doit être systématiquement passée. Ainsi, si le nombre est déclaré en 3,2 :
  • pour transférer la valeur  100 
    è  100,00
  • pour transférer la valeur  45,45 
    è  045,45
  • pour transférer la valeur  50,5  
    è  050,50
• Les prix ou montants exprimés doivent être envoyés en centimes de la monnaie d’expression et sans le point décimal.
  • pour l'Euro qui gère 2 décimales,
    ‎ le montant 100,50 EUR sera transféré 10050
  • pour une autre monnaie qui ne gère pas de décimales,
    ‎ le montant 10000 sera transféré 10000

 

Pour tous les formats :

Il est indispensable de respecter le caractère obligatoire ou facultatif des différents champs des fichiers pour conserver une cohérence dans les enregistrements.

N.B. : de façon générale, les champs Numérique et Date sont considérés comme obligatoires ‎(sinon, suspension passerelle et arrêt immédiat)

 

 

Journal XC20B

En résumé, l’exécution d’un import enchaine les étapes suivantes :

N.B. :
dès lors que le fichier à traiter est chargé en base, si on relance dans JP530 une demande XC20B (littéralement, « réexécution d’une demande d’import »), une pop-up et un écran permettent de sélectionner si vous voulez importer les mêmes fichiers (sans quoi il faut importer un nouveau fichier) :

 
‎

 

L’exécution d’un import génère un journal, avec la structure suivante :

‎

 

Option

CLE_ENREG_COL_1
option utilisée par le moteur XC20B afin de récupérer la clé des enregistrements :

• 0=mode "séparateur" (par défaut)
  on considère que la clé à rechercher est dans la PREMIÈRE colonne de chaque enregistrement
• 1
  il est possible de lire une clé dans TOUTE AUTRE colonne de l'enregistrement
  (position indiquée dans TA350 / onglet Tables / Zone clé début)

 

 

 

Maintenance et surveillance

 

JP031 : Surveillance Imports/Exports

JP031W01
Cette fonction permet de consulter les caractéristiques techniques des différentes traitements d’import/export

 

Onglet ‘Liste traitements’

• liste des différents traitements d'échanges de données lancés avec, pour chaque traitement, les informations essentielles permettant de l'identifier (notamment N° demande, provenance, origine et code EDI de l'expéditeur).
  Les informations affichées sont les suivantes :
  • Icône Anomalie
  • Tâche
  • Demande
  • Provenance
  • Origine
  • Lot
  • Code EDI
  • Date/Heure Fin traitement
  • Flag Anomalie
  • Fichier traité (Ref = Nom éventuel originel du fichier reçu)

• On peut effectuer une sélection sur tous les champs présents dans cette page ; les enregistrements sont triés par tâche et N° Demande (du plus récent au plus ancien).

  Une zone de recherche libre permet de lister tous les traitements pour lesquels on trouve le texte recherché dans les anomalies ou les traces. On peut ainsi retrouver une pièce via son n° dans un message d’anomalie.

 

Onglet ‘Détail traitement’

• pour la demande courante, visu de l'ensemble des informations récoltées lors de l'exécution du traitement (heure début traitement, heure fin traitement, indicatif sur la présence d'anomalie, indicatif suspension des imports/exports...)

N.B. :
Les flags 'Anomalie' sont cochés dès lors que le pilote détecte une erreur fatale

 

Par défaut cette détection s'accompagne de la suspension de la passerelle et la date est également mémorisée dans cet onglet 'Suspension des échanges le' (Sauf selon paramétrage 2^ème onglet TA440 ou TA450 du champ 'Susp' permettant de ne pas provoquer la suspension)

Si le flag anomalie est coché, la date de fin n'est pas renseignée.

Si la date de fin est vide ainsi que le flag, ‎c'est le pilote lui-même qui a subi une erreur ou a été stoppé.

 

Selon option XC20BW01/HIST_JP530 et XC300W01/HIST_JP530, ‎on peut visualiser les fichiers importés par XC20B, et les fichiers générés par XC300.

En cas d'anomalie d'import ou d'export, ‎on visualise le rapport d'anomalie en plus des fichiers importés/générés

 

Onglet ‘anomalies’

• visualiser toutes les anomalies qui ont été détectées lors des traitements d'import ou d'export.

 

Onglet ‘Journal’

• traces d'import générées par XC20B, traces d'export générées par XC300.

‎ 

 

JP931 : Liste imports / exports

JP931W01
Cette fonction permet permet d’accéder à JP031 par circularité, avec toutes les possibilités de tri offertes par les MUL, et une liste de critères enrichis

 

CD360 : Maintenance commande externe

Fonction équivalente à XC800 mais réservé aux commandes.

La table des anomalies est la table ORL_POR_CDE_ANO (les anomalies sont listées par Origine/provenance/lot)

N.B. : XC800 non prévu pour les origines concernées (CDE / COM / POR)

 

FA051 : Maintenance import Bons/factures

Fonction équivalente à XC800 mais réservé aux factures et BE.

La table des anomalies est la table ORL_ANOMALIE (les anomalies sont listées par Origine/provenance/lot)

XC800 non prévu pour les origines concernées (FAL / FAC / AFI / RFI / VFI)

 

 

XC800 : Maintenance import données

XC800W01
XC800 – Cette fonction permet la visualisation et la maintenance des données présentes dans les tables réceptacles d'import

 

Cette fonction concerne uniquement les données en anomalie si vous avez lancé la fonction XC20B en mode 0 (import) ; par contre cela concerne toutes les données si vous avez lancé XC20B ‎en mode 1 (Tables réceptacles uniquement).

L'entête contient la provenance et l'origine, ainsi que la liste des tables réceptacles pour chaque entité provenance, origine.

En double-cliquant sur le nom de la table vous pourrez accéder à la maintenance des données, en choisissant entre deux types de présentation, ou par les touches Ctrl + PgUp :

 

Pavé Ligne (bloc multi lignes)

Dans les lignes, vous pouvez modifier les données erronées afin de relancer l’import avec les données correctes.
exemple : un code circuit mal libellé peut être modifié dans la ligne concernée afin de relancer l’import.

 

Navigation

La navigation, bloc suivant, bloc précédent, permet, lorsque vous êtes dans la maintenance des données, d'accéder à la maintenance de la table suivante ou précédente sans avoir à passer par la liste des tables.

 

Lorsque vous êtes dans la maintenance d'une table, pour revenir à la liste des tables,
‎vous pouvez soit cliquer sur l'en-tête code provenance, code origine, soit cliquer sur le bouton "FERMER", ainsi vous verrez apparaître une boîte de dialogue demandant si vous désirez vraiment sortir,
‎si vous répondez non, vous reviendrez à la liste des tables.

Le bouton "imprimer" entraîne le ré-import des données des tables réceptacles, pour la provenance, origine, saisie en en-tête.

N.B. :
Seules les données de la provenance, origine en cours de traitement seront ré-importées.

‎

Sécurité

 

Le pilote assure également :

 

Trace sur disque et en table de toutes les opérations menées par lui-même ou les fonctions exécutées
(exemple : fonction d’import finale)

 

Contrôle des erreurs Oracle ou Unix de ses actions ainsi que celles restituées par les fonctions exécutées

 

Auto-création des répertoires nécessaires

 

Gestion de la chronologie (Méthode de suspension)

 

Archivage sur disque des fichiers séquentiels importés sous :

$LOG_ODIE/arc/<n° demande>

‎ 

Purge des données

 

Deux types de purge existent :

 

1. PU400 (Purge historique éditions/passerelles) ‎permet de purger l'historique des éditions et passerelles jusqu'à une date donnée.
   ‎Ces historiques sont les informations consultables par JP530 et JP031.
   ‎Il est conseillé de créer un filtre avec une date relative afin de le paramétrer dans le planificateur de tâches pour être exécuté une fois par mois.
   ‎L’option PU400W01/DUREE permet de fixer, par sécurité, le nombre de mois minimum à conserver.
2. Une seule fois par jour et quel que soit l’export demandé, ‎XC20B exécute une purge de :

• Traces sur disque
• Archives des fichiers sur disque
• Répertoires temporaires des traitements
• Tables de collecte historiques

Son action est basée sur le paramètre général NB_JOUR_PUR qui contient le nombre de jours à conserver (8 jours minimum quelle que soit sa valeur). Cette opération est tracée dans le compte-rendu de son traitement.

‎

Passerelles en mode reprise

Le mode reprise permet de relancer une passerelle après correction des anomalies rencontrées.

 

XC20B : Import fichier séquentiel en mode reprise

Pour relancer une passerelle après correction, il faut sélectionner dans XC20B les codes provenance, origine et EDI de la passerelle désirée.

Le n° de lot. Ce numéro correspond au numéro de demande générée lors des précédentes passerelles. Il permet de savoir quels enregistrements de la table réceptacle il faut utiliser.

Ce numéro est listé dans JP031.

Le mode de travail : il faut sélectionner la valeur 2, qui permet de lancer un import à partir des tables réceptacles.

Le type d’import reste le même que lors de votre précédente passerelle.

 

CD62B : Validation des commandes externes

Fonction équivalente à XC20B en mode reprise, mais réservé aux commandes importées.

N.B. :
si une erreur a été générée lors de la passerelle, il faut tout d’abord relancer un CD62B pour le n° de lot concerné ; cela peut permettre de traiter sans aucune intervention certaines erreurs (ensuite, il faut consulter CD360 pour les erreurs restantes).

 

Si le critère de présentation « Edition par secrétaire commerciale » est activé, ‎il n'y pas d'édition PDF finale, mais des fichiers PDF par secrétaire commerciale (sorte de routage automatique fonctionnel). Ces fichiers PDF sont alors distribués à l'imprimante ou au mail de chaque secrétaire commerciale trouvée. Les associations « secrétaire commerciale / imprimante » et « secrétaire commerciale / mail » se font dans TA455, le « nom logique » étant le nom logique de l’imprimante, renseigné dans JP015.

Si l'édition est lancée à l'écran, les fichiers PDF ne sont accessibles que depuis JP530 (dans le bloc du bas), ils ne sont ni imprimés ni envoyés par mail.

 

 

CD622 : Maintenance pour accusés de réception

Fonction de type "MUL action" réservée aux accusés de réception de commandes externes

 

 

FA052 : Reprise import bons/factures

Fonction équivalente à XC20B en mode reprise, mais réservé aux factures et BE.

 

Passerelle d’export

Schéma général d’un export

 

Paramétrages préalables

 

TA440 : Référencement général des codes EDI

Fonction commune aux passerelles d’import et d’export.

 

 

TA450 : Paramétrage export fichier

TA450W01
Cette fonction permet de paramétrer l'ensemble des données nécessaires à l'utilisation des passerelles d’export

 

• Paramétrage des exports

Cet onglet permet de paramétrer la manière dont l'export des données va être réalisé, et ce, pour chaque "provenance" et chaque "origine" de fichier.

Il est composé de 2 parties :

1. La première permet de préciser par provenance/origine, la fonction d'export finale qui génère les données dans la table de collecte, le nom de cette dernière, l'indicatif du fichier généré, le répertoire de travail dans lequel devra être déposé le fichier. Le répertoire par défaut est $ODIS/XC300.
2. La seconde permet d'indiquer des paramètres qui sont ensuite récupérés par les fonctions de traitement de données (export).

N.B. : en cas de valeur manquante sur un paramètre obligatoire, le message suivant sera notifié dans le journal :
"Paramétrage supprimé. Poursuite du traitement impossible."

 

• Exports par codes EDI

Cet onglet gère par site et code EDI Cegid Orli, les différents exports de données Cegid Orli que le site autorise vers ce destinataire.

Définition du destinataire

Ce champ permet à l'utilisateur de sélectionner le destinataire dont il veut définir les possibilités de dialogue. (Le destinataire est identifié par l'intermédiaire de son code EDI)

Une fois le destinataire sélectionné, l'utilisateur accédera au second bloc qui lui permettra de renseigner les différentes passerelles d'export que le site autorise au destinataire en cours de traitement.

‎ 

Définition des passerelles d'export autorisées

N.B. : chaque origine n'est autorisée qu'UNE seule fois pour chaque code EDI (si 2 formats distincts étaient envisagés pour une même origine, cela nécessiterait alors 2 codes EDI distincts)

 

L'utilisateur doit renseigner les informations suivantes :

 

Code Provenance / Code Origine :

L'association " Provenance/Origine " renseignée par l'utilisateur devra préalablement avoir été définie dans le premier onglet référençant les différentes passerelles d'export gérées par Cegid Orli.

Considérant qu'un destinataire ne peut importer les fichiers d'export pour une origine donnée que sous un seul format ("Provenance" dans le 1^er onglet), un contrôle est effectué afin de s'assurer qu'une même Origine n'est présente que pour un seul format "Provenance" (Pas 2 enregistrements pour un destinataire et une origine donnés)

 

Format export et type de format :
‎Formats et types créés dans la fonction JP562 utilisés pour générer les fichiers extraits.

 

Nom du fichier : 

• à renseigner uniquement si le nom du fichier n'est PAS normalisé
• cas des noms de fichiers extraits normalisés :

<XXX>_<YYY>_<ZZZ>.<N> 

• <XXX>
  Code origine = APF
  (TA450 - 1er onglet)
• <YYY>
  Code EDI destinataire = MAN
  (TA450 - 2ème onglet)
• <ZZZ>
  Code EDI de l’expéditeur des données = CHN
  (Paramètre EDI_ORLI_SIT)
• <N>
  N° de demande
  exemple : APF_MAN_CHN.12345678

 

Transfert des fichiers vides (coche) :

‎En standard, les fichiers générés via paramétrage JP562 qui sont vides ne sont pas transmis au destinataire. Sélectionner cette zone permet de demander qu'ils soient tout de même transmis.

 

Répertoire externe :

Permet de paramétrer le transfert des fichiers extraits vers le répertoire du destinataire, via le code du périphérique de transfert (serveur/répertoire) dans JP015 (2^ème onglet).

 

Jeu de caractères :

composé de 2 informations distinctes 

1. Choix du codage des caractères dans lequel les fichiers générés doivent être mis à disposition dans le répertoire de dépôt. Valeur par défaut (vide) : aucune conversion. Sinon les transcodages possibles sont ISO (iso8859-9), UTF8 ou UTF16.
2. Plateforme / Système d'Exploitation

Valeur par défaut (vide) : MS-DOS
(AVEC carriage return ^M).

Sinon, valeur UNIX
(SANS carriage return ^M).

N.B. :
ce paramétrage ne s'applique qu'aux exports standards paramétrés avec un code format géré via JP562.

 

Suivi :

Cette coche permet de conditionner l'affichage de la page de suivi dans le PDF résultant de l'export. Cette page est éditée juste après la page de garde (contenant les critères).

N.B. :
dans le cas d'interfaces automatisés toutes les 10mn pour lesquels le rapport peut devenir polluant, il est souhaitable de décocher la zone

 

Trace :

Cette coche permet de rendre visible des traces fonctionnelles supplémentaires ‎que l'on visualise dans l'onglet TRACES de la fonction JP031. Ces traces peuvent correspondre à des informations complémentaires pour la compréhension d'une anomalie.

 

Suspension export :

Cette coche permet à l'utilisateur d'indiquer qu'il souhaite suspendre momentanément ou définitivement les exports de données vers le destinataire concerné (Code EDI). En cas d'anomalie fatale lors des exports, cette zone est mise à jour automatiquement par le pilote d'export (afin de préserver la chronologie des flux).

 

Non suspension export (coche AVANT Surveillant) :

Lorsque des anomalies fatales fonctionnelles sont détectées, cette coche évite (cas très particuliers) ‎de suspendre les exports suivants, même si la réparation de l'anomalie n'a pas été réalisée.

 

Surveillant :

en cas d'anomalie fatale, cet utilisateur (s’il est paramétré) indique que ‎le routage automatique du journal s'effectue à son adresse mail (en lieu et place de l'utilisateur ayant lancé le traitement). Pour l'interface avec Cegid SCM, cette information est également utilisée pour le routage par mail des anomalies fonctionnelles.

N.B. :
ce code surveillant est indépendant de la coche Non suspension export

 

R :

Cette coche « Rupture » (1 fichier par entité) permet de réaliser un export avec une rupture de fichier selon une entité définie par la fonction réalisant l’export. Celui-ci doit déterminer la rupture et implémenter son champ NUM_EXEC afin que le pilote puisse séparer les données et les générer dans différents fichiers.

N.B. :
toutes les fonctions de gestion des codes EDI Cegid Orli et de leur paramétrage doivent être sous la responsabilité de personnes averties. Dès que les mécanismes sont opérationnels, la maintenance de ces données nécessite de grandes précautions.

 

• Association code EDI Cegid Orli -entité externe

Association code EDI Cegid Orli -entité externe

Le troisième onglet permet de gérer par site les liens entre un code EDI et ses différentes représentations sous Cegid Orli. La saisie n'est pas mémorisée dans une table mais directement dans des champs des tables des entités Cegid Orli.

Sa cinématique est la suivante :

Un bloc d'entête pour la sélection du code EDI Cegid Orli

Plusieurs blocs lignes pointant chacun sur une entité Cegid Orli. Chacun d'eux est composé de plusieurs lignes car un code EDI Cegid Orli peut être lié à différents codes Cegid Orli (exemple : Magasin tissu et magasin fourniture externe = code EDI unique).

 

 

AS450 : Initialisation table import

AS450W01
Cette fonction permet d’initialiser chaque export par code Origine / code EDI

 

En plus de l'initialisation (Création), le mode de travail permet (Suppression) de réaliser une suppression d’un lancement fait par erreur.

 

 

JP562 : Paramétrage export

JP562W01
Cette fonction permet de paramétrer la structure des fichiers à générer par les passerelles d’export

 

Fonction similaire à la fonction de paramétrage d'export des éditions (fonction JP561),
‎qui comporte toutefois des paramètres supplémentaires permettant de répondre aux besoins complexes des fichiers d'export (Multi-enregistrements, données libres ou conditionnelles…).

 

 

 

Un même export peut comporter différents paramétrages selon les destinataires.

Certains destinataires requérant des recodifications de données, la coche Rec (en bout de ligne) vous permet de déclarer ces recodifications dans la fonction TA446 pour établir un lien entre les deux progiciels pour le champ en question.

Dans ce cas, le champ Table à recodifier (en bas de l’écran) doit être obligatoirement renseigné.

N.B. :
il est nécessaire de faire intervenir l’équipe Ingénierie pour paramétrer cette fonction.

 

Titre champ personnalisé

Cette 'Colonne Libre' offre de nombreuses possibilités pour personnaliser le contenu des informations extraites.

 

A) Colonne Libre NON liée à un champ mis à disposition

Il est possible d'insérer une ligne sans lien avec un champ pour ajouter une colonne dont le contenu peut être :

• La valeur statique saisie dans cette zone (Ex: Votre code chez le destinataire)
• Un nombre d'espaces égal à la taille définie en ne saisissant rien dans cette zone.
• La date du jour en saisissant le mot clé $SYSDATE$ et en spécifiant le type (D)ate pour la colonne auquel vous pouvez associer le format date que vous voulez
  ‎(exemple : DD/YYYY = Mois/Année).
• Le numéro d'ordre de l'enregistrement dans le fichier en saisissant le mot clé $ROWNUM$ (vous pouvez le déclarer en type 'N' ou 'C' selon votre besoin avec la taille désirée)
  ‎Variante possible : $ROWNUM$-2$ produira N°Ordre -2
• Le nombre total d'enregistrements dans le fichier en saisissant le mot clé $ROWTOT$. Vous pouvez le déclarer en type 'N' ou 'C' selon votre besoin avec la taille désirée. A utiliser obligatoirement en enregistrement de Fin du fichier. Le Nombre inclut cet enregistrement final.
• Un numéro automatique unique basé sur deux séquences Oracle en saisissant le mot clé $ROWNUME$ ou $ROWNUML$. Vous pouvez le déclarer en type 'N' ou 'C' selon votre besoin avec la taille désirée. Cegid Orli ne mémorise nulle part les numéros attribués qui ne peuvent donc pas être utilisés lors d'un retour d'information par le destinataire.
• Le nom du fichier qui sera généré en saisissant le mot clé $NOMFIC$
• Le numéro de version du fichier (qui est en fait les 3 derniers caractères du nom du fichier aux normes du destinataire) en saisissant le mot clé $NOMFIC$6$3$
  ‎(syntaxe identique au SUBSTR)

   

• Un macro code conditionnel $DECODE$ ou $NVL$ pouvant contenir sans limitation toute instruction imbriquée « SQL »

Ex :

$DECODE(----$TABLE.CHAMP$----)$ ou $NVL(----$TABLE.CHAMP$----)$

permettent de gérer une valeur statique conditionnelle au contenu d'un champ table.
TABLE.CHAMP peut ne pas faire partie des données de l'enregistrement.

Autre exemple : « date de création BP + 10 jours »

$DECODE(1,1,$DISTRIB_BP_ENT.DAT_CRE+10$)$

‎ 

B) Personnalisation contenu Colonne Liée à un champ mis à disposition

 

Paramétrage champ Caractère pour un LPAD

Cas pratique : No de pièce en CHAR (à très juste titre) dans la table « XIMP ».

Descriptif fichier demande une justification à droite par des zéros.

Saisir dans cette zone $LPAD$0$. Bien sûr ce peut être tout à fait autre chose que 0 et n’est pas limité à un seul caractère. Existe également pour RPAD

 

Paramétrage champ table de type Number en Caractère

Cas pratique : Descriptif fichier demande que le N° de ligne de commande soit extrait dans un format caractère standard.

Saisir dans cette zone $TOCHAR$

 

Paramétrage Multiplication sur un Champ Numérique

Cas pratique : Descriptif fichier demande que les quantités de produits finis soient multipliées par 1000.

Saisir dans cette zone $*1000$.
‎ce peut être $*xxxx$ (xxxx étant n’importe quel nombre, même décimalisé à multiplier)

 

Paramétrage Partie d'un Champ Caractère Table ET/OU via un Champ Libre (SUBSTR)

Cas pratique : Descriptif fichier demande que le RIB client soit décomposé dans le fichier en différents champs de 5 caractères alors que le champ de la table « XIMP » est unique.

Pas ergonomique mais on y arrive, ce cas extrême pouvant s'appliquer à des scenarii plus simples.

Pour cet exemple :

1. Choisir le champ de la table (RIB dans notre cas) saisir dans cette zone $SUBSTR$1$5$
2. Comme le champ de la table ne peut être choisi qu'une seule fois, ajouter une colonne libre et saisir $SUBSTR($TABLE.CHAMP$,6,5)$ etc...

 

Paramétrage clause restrictive NON Nul ou clause restrictive TOUS ensemble NON Nul

Concerne les formats dits pivotés pour lesquels tous les champs possédant le même numéro de colonne donneront lieu à un enregistrement distinct dans le fichier texte final. 2 mots clé disponibles:

 

$!NUL$

è Si ce champ est NULL, l'enregistrement ne sera pas généré quel que soit le contenu des autres champs y compris d'autres champs fonctionnels de la même colonne. Variante $!NULZ$ pour Idem avec Zéro au lieu NULL

 

$!!NUL$

è L'enregistrement ne sera pas généré si différents champs fonctionnels associés à cette clause sont Tous Nuls. Donc au moins 2 champs fonctionnels doivent être associés à cette clause.

‎ 

 

DB562 : Duplication format d'export

DB562W01
Cette fonction permet de simplifier la duplication des formats fournis par Cegid (_xxx), internes à la base courante, pour générer un format spécifique (à la manière de DB398 pour les paramétrages de passerelle)

 

 

Fonction à dupliquer / Format d’export d’origine / Nouveau format d’export

 

 

TA446 : Recodification des données EDI

Fonction commune aux passerelles d’import et d’export.

N.B. :
si pour un code donné, on ne trouve pas de recodification dans TA446, ‎alors on conserve la valeur d’origine (code Cegid Orli).

 

 

AS450 : Initialisation table export

Cette fonction est utilisée quand l’export n’est pas basée sur un trigger sur table, ‎c’est-à-dire sur un élément déclencheur dans Cegid Orli.

exemple : pour l’export des BP à destination d’un WMS : c’est la création du BP qui est l’élément déclencheur pour la génération du fichier. En revanche, dans le cas de l’export d’un catalogue article où l’utilisateur souhaite choisir les données à envoyer, il n’y a pas d’éléments déclencheurs et il est donc indispensable d’initialiser avant le premier traitement la table d’export (XC_FIC) pour le code origine et le code EDI paramétrés dans TA450. Cette opération ne devra être réalisée qu’une seule fois.
‎ 

 

Passerelle

XC300W01
Cette fonction permet d’effectuer les exports de fichiers de Cegid Orli vers un autre progiciel.

 

Les seuls critères de sélection (facultatifs) sont : code origine et EDI.

 

Fonctionnement de la passerelle :

La mémorisation des informations à extraire s’effectue par l’utilisation des Triggers Oracle ‎sur les Tables Cegid Orli.

 

Cette méthode présente les avantages suivants :

• Mémorisation quel que soit la fonction
• Indépendance vis à vis du produit Cegid Orli et de son évolution
• Possibilité de collecter les Suppressions
• Personnalisation facilitée selon les besoins du site, sans pollution du progiciel
• (les Triggers réalisés sont systématiquement spécifiques au site)
• Facilité d’évolution des événements déclencheurs de la mémorisation
• (niveau conceptuel et non pas logiciel)
• Pouvoir décisionnel fiabilisé pour mémoriser les maintenances,
• ‎grâce à la connaissance des valeurs avant et après la mise à jour.

 

Table de Collecte

La mission du Trigger consiste à mémoriser dans une table unique XC_FIC les enregistrements qui seront à extraire quelle que soit leur nature et ceci par destinataire.

‎ 

 

Traitement complémentaire

XC300 peut piloter une procédure stockée complémentaire spécifique client qui sera exécutée en complément APRES la procédure standard Cegid Orli de constitution des données dans les tables intermédiaires mais AVANT la génération des fichiers plats selon paramétrage JP562.

Ceci permet entre autres d'effectuer des modifications de données dans les tables XIMP avant génération du fichier plat mais aussi de faire des insertions dans des tables complémentaires utilisées par des traitements spécifiques client.

La procédure client doit se nommer Z_XXxxxWxx sachant que XXxxxWxx est en fait le nom de la 'Fonction export' paramétrée dans le 1^er onglet de TA450.

Si cette fonction est XXxxx seulement, la procédure client doit toutefois être Z_XXxxx

 

 

Maintenance et surveillance

 

JP031 : surveillance imports exports

Fonction commune aux passerelles d’import et d’export.

 

 

XC301 : Recyclage des exports

XC301W01
Cette fonction sert de reprise en cas d’incident : si les fichiers sont supprimés par erreur, on peut alors les re-générer à partir d’historiques

 

Lors des exports, les enregistrements de la table de collecte XC_FIC qui ont été traités sont détruits de celle-ci mais archivés dans une table XC_FIC_HIST

XC301 permet de recharger dans la table XC_FIC un numéro de traitement donné à partir des enregistrements de la table XC_FIC_HIST.

La recherche du traitement s’effectue via une interrogation sur les critères écran.

‎ 

Remarques

Numéro de lot différent du numéro de demande en export

Ceci est lié au fait que XC300 est un automate et que lors de l’attribution du numéro de lot, il ne sait pas s’il va générer 1 ou plusieurs fichiers (qui devraient avoir des numéros de lot différents). Donc, le numéro de lot est basé sur le numéro de demande mais au cours de l’export, il est amené à évoluer en fonction du traitement indépendamment du numéro de demande.

 

Purge des données

Deux sortes de purge existent :

è PU400 (Purge historique éditions/passerelles) permet de purger l'historique des éditions et passerelles jusqu'à une date donnée.

Ces historiques sont les informations consultables par JP530 et JP031.

Il est conseillé de créer un filtre avec une date relative afin de le paramétrer dans le planificateur de tâches pour être exécuté une fois par mois.

 

Une option DUREE permet de fixer, par sécurité, le nombre de mois minimum à conserver.

 

è 1 seule fois par jour et quelle que soit l’export demandé, XC300 exécute une purge de :

• Traces sur disque
• Archives des fichiers sur disque
• Répertoires temporaires des traitements
• Tables de collecte historiques

 

Son action est basée sur le paramètre général NB_JOUR_PUR qui contient le nombre de jours à conserver (8 jours minimum quelle que soit sa valeur).

Cette opération est tracée dans le compte-rendu de son traitement.

‎ 

Passerelle de paramétrage

Transfert de paramétrages Passerelles entre 2 environnements.

Ceci regroupe TA440 / TA450 / TA350 / JP562 / TA446 / JP015, ‎à savoir les descriptions provenance / origine / code EDI, les formats import, ‎les formats export, les recodifications, les périphériques.

Ceci permet de synchroniser les paramétrages de passerelle entre plusieurs bases / environnements.

 

 

AS460 : Récupération param. extr. / intg.

Export via génération d’un fichier plat (JP561)

 

 

XC20B / XC465 : Import param. export / import.

 

Import via provenance/origine « ORLI / PAR »

‎ 

Détail des contenus transférés pour les EXPORTS

• Les données de la partie haute du 1^er onglet de TA450
  ‎"01 / Paramétrage exports"
• Les données de la partie basse du 1^er onglet de TA450
  ‎"02 / liste des paramètres pour les couples provenances origines"
• Les données du 2^ème onglet de TA450
  ‎"03 / Exports par code EDI"
• Les données de la partie haute de JP562
  ‎"04 / liste des triplets fonction/format/type"
• Les données de la partie médiane de JP562
  ‎"05 / liste des enregistrements des fonctions"
• Les données de la partie basse de JP562
  ‎"06 / liste du paramétrage des champs des enregistrements"
• Les données de TA446
  ‎"07 / Recodification des données EDI"
• Les données de JP015
  ‎"08 / Périphériques"

 

Détail des contenus transférés pour les IMPORTS

• Les données du 2^ème onglet de TA440
  ‎"09 / Imports par code EDI"
• Les données de la partie haute du 1^er onglet de TA350
  ‎"10 / Paramétrage imports"
• Les données de la partie basse du 1^er onglet de TA350
  ‎"11 / liste des paramètres pour les couples provenances origines"
• Les données du 2^ème onglet de TA350
  ‎"12 / Définition des fichiers externes"
• Les données de la partie haute du 3^ème onglet de TA350
  ‎"13 / Fichiers à importer"
• Les données de la partie basse du 3^ème onglet de TA350
  ‎"14 / Réceptacles fichiers externes"
• Les données du 4^ème onglet de TA350
  ‎"15 / Structure des fichiers externes"
• Les données de TA446
  ‎"16 / Recodification des données EDI"

‎ 

 

Format de chaque fichier résultant

(Le contenu dépend du contexte, chacun étant repéré par une "zone type" de 2 chiffres)

(*) : « A » = alphanumérique ; « N » = numérique ; « D » = date

 

01 / Paramétrage exports

Table

PARAM_EXT

 

02 / liste des paramètres pour les couples provenances origines

Table

PARAM_EXT_OPT

‎

03 / Exports par code EDI

Table

EDI_ORLI_SIT_EXT

 

04 / liste des triplets fonction/format/type

Table

FSEQ_FORMAT_ENT

 

05 / liste des enregistrements des fonctions

Table

FSEQ_FORMAT_ENRG

 

06 / liste du paramétrage des champs des enregistrements

Table

FSEQ_CHAMP_FORMAT

 

07 / Recodification des données EDI

Table

EDI_RECOD

 

08 / Périphériques

Table

PERI

 

09 / Imports par code EDI

Table

EDI_ORLI_SIT_INT

 

10 / Paramétrage imports

Table

PARAM_INTEG_PROV

 

11 / liste des paramètres pour les couples provenances origines

Table

PARAM_INTEG_PROV_LGN

 

12 / Définition des fichiers externes

Table

CORRES_FIC_EXT_ORL

 

13 / Fichiers à importer

Table

DEF_FIC_INTEG_CDE

 

14 / Réceptacles fichiers externes

Table

DEF_CTL_INTEG_CDE

 

15 / Structure des fichiers externes

Table

DEF_STRUCT_INTEG_CDE

 

16 / Recodification des données EDI

Table

EDI_RECOD

 

Récapitulatif des Purges

Les archives de fichiers sur le Serveur de TRAITEMENT sont réparties par BASES, ‎sur plusieurs répertoires, traités de la façon suivante :

• $LOG_ODIE
  ‎(/data2/orli/spool/odi/entree/log/BASE)
  ‎On y trouve :
  ‎
  • Fichiers journaux LOG concernant les fichiers importés dans Cegid Orli
    > PURGE à chaque import XC20B,
    ‎ via un nombre de jours de conservation
    ‎ (soit TA350/onglet 2, soit paramètre NB_JOUR_PUR par défaut)
    ‎
  • $LOG_ODIE/tmp
    ‎Avant d’importer un fichier, XC20B déplace ce fichier,
    ‎ du répertoire de réception paramétré
    ‎ vers le répertoire temporaire $LOG_ODIE/tmp
    ‎
  • $LOG_ODIE/arc/<n° demande>
    ‎Après traitement d’un fichier, XC20B déplace ce fichier,
    ‎du répertoire temporaire $LOG_ODIE/tmp
    ‎vers le répertoire d’archive $LOG_ODIE/arc/<n° demande>

    N.B. : Les fichiers n’étant pas copiés mais déplacés, si l’import a été brutalement interrompue de manière anormale (erreur ORACLE ou autre), les fichiers peuvent donc être encore stockés dans $LOG_ODIE/tmp, et ne sont donc pas archivés dans $LOG_ODIE/arc/<n° demande>
    

• $LOG_ODIS

  (/data2/orli/spool/odi/sortie/log/BASE)
  ‎Fichiers journaux LOG concernant les fichiers extraits de Cegid Orli
  ‎ dans le répertoire "sortie" ($ODIS)
  è PURGE à chaque export XC300,
  ‎ via un nombre de jours de conservation (paramètre NB_JOUR_PUR par défaut)

• $LOG
  ‎(/data2/orli/spool/log/BASE)
  ‎Fichiers journaux divers (installations)
  è pas de PURGE automatique
  ‎
  ‎
• $SPO
  ‎(/data2/orli/spool/spo/BASE)
  ‎è non utilisé par Cegid Orli

 

Mémo

 

XC300

Au lancement, les fichiers doivent se générer, d'abord dans le serveur édition ‎ (rep TEMP pour la demande), et ensuite sur le serveur cible éventuel.

 

Que faire si un fichier ne se génère pas depuis XC300 :

 

1. paramétrage TA450 avec routage répertoire ?
2. AS450 pour initialiser XC_FIC ?

    

3. JP917 pour l'option JP530_HIST (Conservation fichiers générés ou téléchargés) qui donne ou non l’accès aux fichiers dans le 2^ème onglet de JP530

   N.B. : remplace l’ancienne option XC300W01/HIST_ JP530

    

4. Shell spécifique type XC300W01.DEB_xxx 
   • possibilité d’exécuter des traitements sur les données en base qui vont être extraites

 

 

XC20B

Si le message

« Aucune intégration Potentielle déclarée »

apparaît au lancement du XC20B :

è cela signifie que vous intégrez une deuxième fois un fichier avec le même numéro de lot.

Ce message se produit quand on intègre des fichiers avec des noms normés et donc un numéro de lot précis. Lorsqu’un traitement est rejeté avec des anomalies, au lieu de corriger par XC800 et ensuite recycler, l’utilisateur corrige dans le fichier et réintègre donc le fichier avec le même numéro de lot. C’est au moment du recyclage du premier traitement en anomalie que ce message apparaît (avec pour but d’éviter d’intégrer deux fois le même fichier).

 

Que faire si un fichier ne s’intègre pas avec XC20B :

 

1. Provenance / Origine déjà suspendue dans TA440 pour un code EDI :
   • non décelé avant l’exécution de XC20B
   • dans le répertoire interne :
     ‎on conserve le(s) fichier(s) après l’exécution de XC20B
     ‎ (en vue de la dé-suspension / ré-exécution)

      

2. Provenance / Origine non référencée dans TA440 pour le code EDI
   • non décelé avant l’exécution de XC20B
   • dans le répertoire interne :
     ‎on conserve le(s) fichier(s) après l’exécution de XC20B
     ‎ (en vue de ce référencement)

      

3. Erreur ou Rejet si import multi-fichiers
   • dans le répertoire interne :
     ‎on conserve le(s) fichier(s) qui sui(ven)t le dernier fichier traité sans erreur
     • il faut alors choisir manuellement ce(s) fichier(s) dans JP530/onglet 2
     • télécharger manuellement par le bouton (attention option JP017)
     • retraiter ce(s) fichier(s) en mode Upload
       ‎(compatible avec le mode Répertoire externe)

        

4. Erreur ou Rejet si import mono-fichier
   • dans le répertoire interne :
     ‎on ne conserve PAS ce fichier (il y était conservé avant Edt20)

      

5. Erreur contrôle fonctionnel sur un fichier
   • dans le répertoire interne :
     ‎on ne conserve pas ce fichier

      

6. Shell spécifique type XC20BW01.DEB_xxx (cf. page suivante)
   • possibilité d’exécuter des traitements
     ‎(et ce en amont de tout programme « avant » ou « standard »)
   • si traitements sur le contenu des fichiers, ils sont réalisés dans le répertoire interne
     ‎donc plus aucune possibilité de le faire car les fichiers n’y sont plus conservés
     ‎
7. Relance possible via JP530 après échec XC20B :

Question « intégrer les mêmes fichiers » (que ceux en base)

 

 

Traitements spécifiques

 

Les procédures ci-dessous seront recherchées successivement sous :

• $X/

• $FRM/

• $ORLI_HOME_CLI/x/

 

 

En import :
XC20B peut exécuter des traitements spécifiques clients à différentes étapes.

 

1 / Au tout début du traitement, c'est la première action du XC20B :

   ‎XC20BW01.DEB_$ORLI_CLIENT

èexemple : modifier le fichier avant import‎ (ne fonctionne pas avec un répertoire externe)

2 / Avant d'exécuter l'import du fichier dans les tables réceptacles :

XC20BW01.FIC_$ORLI_CLIENT

èexemple : renommer le fichier

3 / Pour exécuter le programme spécifique (programme Avant / Standard / Après dans TA350) :

XC20B.STR_$ORLI_CLIENT

èExécute le shell correspondant au paramétrage TA350.
exemple : ZSTE1W01

4 / À la fin du traitement, c'est la dernière action du XC20B :

   ‎XC20BW01.$ORLI_CLIENT

èPermet d'agir sur les données préalablement intégrées

 

 

En export :
XC300 peut exécuter des traitements spécifiques clients à différentes étapes.

 

1 / Au tout début du traitement, c'est la première action du XC300 :

   ‎XC300W01.DEB_$ORLI_CLIENT

èPermet d'agir sur les données en base qui vont être extraites

2 / Pour exécuter le programme spécifique (programme d'export dans TA450) :

XC300.STR_$ORLI_CLIENT

èExécute le shell correspondant au paramétrage TA450.
  exemple : ZSTE2W01

3 / Avant la génération du fichier :

‎XC300W01.FIC_$ORLI_CLIENT

èexemple : personnaliser le nom du fichier généré

4 / Après l'export des données et mise à disposition dans les tables réceptacles, ‎et avant génération du fichier :

‎ XC300W01.FSEQ_$ORLI_CLIENT

èPermet d'agir sur les données extraites

5 / À la fin du traitement, c'est la dernière action du XC300 :

‎XC300W01.$ORLI_CLIENT

èexemple : modifier le fichier généré