Sommaire
| Table of Contents |
|---|
1. Introduction
Dans le langage EDI, un document commercial tel qu’un bon de commande, une facture ou un avis préalable à l’expédition constitue un « message ».
...
La description de la structure des messages (Segments),
Le mappage des données sources et destinations (Eléments de données),
Les traitements SQL à exécuter avant ou après le traitement du fichier informatique pour mettre à jour ou filtrer les données avant la tâche d’intégration ou d’émission,
La mise en place de contrôles spécifiques personnalisés bloquants ou non dont la trace sera visible dans le rapport de fin des traitements.
2. L’application
Le mode Liste présente l’ensemble des messages configurés dans Silog avec le type de message, « I » pour intégration et « E » pour émission, puis une description.
...
Le mode Page présente le détail d’un message.
...
2.1. L’onglet Général
 |  |
Masque des clés
Code Message : Saisir un code message. Saisir le nom du message EDI, exemple ORDRERS, DESADEV…
...
Le listage de présélection suivant sera présenté lors de l’exécution de la tâche manuellement. Le résultat de la sélection est enregistré dans une table de sélection dont le nom est dans le Tag #TABLE_SELECTION.
...
2.2. L’onglet « Structure ».
C’est dans cet onglet que la structure du message doit être déclarée.
...
2.2.1. Les blocs SQL
Le traitement d’un message EDI est effectué en plusieurs étapes, chaque étape est basée sur une table de données spécifique. Des points d’entrées permettent d’intervenir sur le contenu de ces différentes tables, il s’agit de blocs de champs textes saisissables en langage SQL.
...
Il est nécessaire de comprendre comment le traitement d’exécution du message EDI procède pour savoir où interviennent les différents blocs SQL dans l’intégration ou l’émission EDI.
2.2.1.1. Exemple 1 : Prenons l’exemple d’un message simple de type intégration suivant :
...
Ce message est composé de deux segments : « ROOT » (la racine, segment toujours présent quel que soit le message) et « ART » qui contient les données « Article », dans l’exemple.
...
Sql après message : #TABLE_SOURCE
2.2.1.2. Exemple 2 : Prenons l’exemple d’un message simple de type émission en CSV suivant
...
Schéma du processus d’émission :
...
| Info |
|---|
Remarque : Il est possible d'utiliser des tables fixes plutôt que les table # dans les taches d’intégration mais ces tables doivent à minima contenir les champs suivants NoEnreg NUMERIC(19,0) IdEvent NUMERIC(19,0) Filename VARCHAR(500) Flag SMALLINT Suppression SMALLINT Lien VARCHAR(MAX) DesactiverAction SMALLINT Dans ce cas, seuls les champs ayant exactement le même nom que les tables standards seront mappées automatiquement. Pour les autres champs, il faudra utiliser les fonctions « e_MEC », « e_MEN ».... dans les fichiers évènements (voir chapitre « Les instructions permises dans les fichiers évènements : »). |
2.2.1.3. Bloc sql avant d’alimenter les tables « segment » (uniquement en intégration)
Lorsque la tâche d’intégration est exécutée, le fichier en entrée est inséré dans une table temporaire pour permettre d’être manipulé en langage SQL.
...
Ce qui permet de nettoyer la table source avant qu’elle ne soit traitée pour alimenter les tables segments.
...
2.2.1.4. Bloc sql avant (Intégration et émission)
Avant de saisir des données dans ce bloc, il est important d’avoir défini la structure des segments du message.
...
Dans l’exemple ci-dessous, la variable ‘@DateMessage’ prend la valeur de la date système, cette valeur est utilisée dans certains champs dates du segment pour initialiser une valeur par défaut lorsque cette date n’est pas renseignée.
2.2.1.5. Bloc sql après (Intégration et Emission)
Chaque segment contient le mappage des données avec les tables Silog (voir : structure des segments du message).
...
En émission, le TAG permettant d’obtenir le nom de la table source du fichier est #TABLE_SOURCE.
Exemple :
...
2.2.2. Segments du message
22.2.1. Introduction
Cette partie permet de décrire la structure du message en segments. Cette description est arborescente, elle est multi-niveau. A l’issue de cette description, une table par segment sera automatiquement créée.
...
Pour cet exemple, le fichier émis est de ce type :
...
22.2.2. Création/Modification/Duplication et consultation des segments
La création de l’arborescence est effectuée à l’aide du menu contextuel en mode création ou modification.
...
Il faut sélectionner les champs a importer et valider. Les champs sélectionnés sont associés au segment :
...
22.2.3. Champs du segment
La description des champs appartenant à un segment s’effectue dans la partie « Champs du segment ». Il faut être en mode « Création ou Modification ».
Cette description permet d’affecter chaque élément de données du fichier source (séparé par un caractère séparateur déclaré dans la description) au segment en cours dans le but de créer les tables segments. Il est donc important de saisir les champs dans l’ordre où ils apparaissent dans le fichier d’intégration ou dans l’ordre où ils apparaitront dans le fichier en émission, la séquence doit être respectée.
22.2.3.1. Les champs
...
Le menu contextuel permet d’insérer, de modifier ou de supprimer des champs dans le segment sélectionné.
...
Il suffit de sélectionner le champ concerné, pour que la variable associée soit insérée :
Exemple :
...
22.2.3.2. La légende
...
Ligne en rouge : Longueur fixe non définie.
...
Ligne en gras : Le champ est une clé.
22.2.4. Champs bloqués du segment :
Ces zones sont les champs supplémentaires des tables nécessaires aux traitements. Il ne s’agit pas de zones appartenant au message EDI.
...
22.2.4.1. Les champs
NoEnreg : Numéro de l’enregistrement
...
Modifier ces zones si les tables de données ne sont pas les tables gérées par le traitement en standard.
Exemple :
...
22.2.4.2. La légende
...
Ligne en rouge : Longueur fixe non définie.
...
Ligne en gras : Le champ est une clé.
2.3. L’onglet « Contrôle».
Cet onglet permet de lister les contrôles de données personnalisés mis en place.
...
Pour ne pas lancer le traitement d’intégration des commandes si un code article n’existe pas dans la base de données.
...
2.4. L’onglet « Recherche ».
Cet onglet permet de rechercher du texte ou une partie de texte dans tous les éléments du message.
...
Contrôles : Dans les contrôles.
2.5. Les traitements
...
2.5.1. Initialiser la structure :
Cette option permet d’initialiser la structure du message EDI en cours à partir d’un fichier de paramétrage d’extension «.ini » de l’ancienne version de l’EDI Silog.
...
Remarque : Le fichier doit être présent sur le serveur SQL.
...
Valider.
2.5.2. Tester la structure :
Ce traitement permet de repérer les anomalies du message.
...
Dans l’exemple, la source de l’erreur se trouve dans le bloc SQL avant du message.
...
2.5.3. Publier un message
Ce traitement permet de générer un fichier XML contenant la structure du message. Le but de cette action est de permettre d’installer la structure du message sur une autre base de données de l’ERP.
...
Le fichier généré se trouve dans le répertoire « EDI_CONFIG\SetUp\MESSAGE » de l’ERP Silog. Il porte le nom du message.
Exemple :
...
2.5.4. Installer un message
Ce traitement permet d’installer un message qui a été publié dans un fichier XML par le traitement précédent.
...