Formats de reprise

Back-Office > Échanges de données > Reprise de données > Paramétrage > Formats de reprise

Le principe est que chaque format d’importation est associé à une provenance de données (ex : reprise par défaut) et un type de données (ex : CLI pour Clients). Notez qu’un même type de données peut être utilisé dans plusieurs provenances de données.

Onglet Caractéristiques

Chaque format d’importation comporte des paramètres définis dans l’onglet Caractéristiques :

Champs	Description
Nom de la table	Nom de la table de la base de données à alimenter (Exemple : CLIENT).
En-tête de ligne fixe	Si cette option est cochée, le champ Identifiant de l’enregistrement contient les 3 premiers caractères de chaque ligne du fichier à en-tête à reprendre : CLI par exemple pour les clients.
Ne pas mettre à jour la base avec les champs vides du fichier	Cette option permet, si elle est cochée, de ne pas mettre à jour les champs de la base pour les données du fichier qui ne sont pas renseignées. Si une valeur par défaut est définie, le champ sera alimenté avec cette valeur.

Tous les champs présents dans la table sélectionnée apparaissent : les champs devant être repris doivent être basculés à droite. De même, les flèches directionnelles haut et bas permettent d’agir sur l’ordre des champs sélectionnés.

Dans un format d’importation par défaut, les champs requis sont déjà basculés à droite.

Onglet Format

Chaque format d’importation comporte un onglet de paramétrage du format du fichier à importer. Cet onglet est essentiel pour permettre l’import de divers fichiers avec des enregistrements :

de longueur fixe ou variable, avec choix du séparateur de champ,
avec un format de date particulier : il est possible de spécifier pour chaque paramétrage d’importation le format de date qui est utilisé dans le fichier à importer,
avec un format particulier pour les booléens,
avec choix du nombre et du séparateur de décimales.

Séparateur de champs

L’utilisation d’un séparateur de champs entraîne la modification de l’affichage de l’écran de paramétrage du format d’importation. Les notions de Position et Longueur des champs repris étant remplacées par leur numéro de Colonne dans le fichier importé :

Notez que si un champ est paramétré avec le numéro de colonne "0", il est alors alimenté par la valeur par défaut.

Fichier avec en-tête de colonne

L’activation de l’option Fichier avec en-tête de colonne permet un paramétrage en fonction du titre des colonnes afin d’importer des fichiers avec en-tête de colonne. Dans ce cas, ce n’est plus le numéro de la colonne qu’il faut utiliser pour alimenter un champ, mais le nom de la colonne :

Notez que si un champ est paramétré sans nom de colonne, il est alors alimenté par la valeur par défaut.

Exemple de format de fichier avec en-tête de colonne et séparateur de champs :

TAIC1 ;Code;Libelle;Abrege;Type

TAIC1 ;XL;Taille XL;XL;DI1

TAIC1 ;L;Taille L;L;DI1

TAIC1 ;M;Taille M;M;DI1

TAIC1 ;S;Taille S;S;DI1

Rappels

Si le format Fixe est sélectionné, la position et la longueur de chaque champ dans le fichier doivent être spécifiés dans le format d’importation. Comme vu précédemment, la position 0 correspond au septième caractère de la ligne reprise, c'est-à-dire le début véritable des données à importer, hors en-tête de fichier. Si le format Séparateur est sélectionné, le numéro de la colonne doit être spécifié, ou son nom si le paramètre Fichier avec en-tête de colonne est coché.

Actions connexes

Filtrer l’affichage des champs disponibles

L’option Filtre, disponible dans la partie inférieure gauche de l’écran, permet de filtrer l’affichage des champs disponibles sur le nom, le type ou le libellé :

Choisir le type d’affichage des champs

Les options d’affichage des champs, disponibles dans la partie inférieure droite de l’écran, permettent, pour une meilleure compréhension, d’afficher le type et le libellé du champ à alimenter dans la base de données :

Définir une valeur par défaut

Ce bouton permet d’initialiser par défaut les champs non repris, ou un champ dont la valeur reprise dans le fichier est vide.

Définir une formule de calcul

Ce bouton permet, en fonction des champs, de gérer des formules plus au moins complexes. Pour les champs de type numérique, la formule doit impérativement être encadrée par des parenthèses. En cas d’utilisation d’une formule, une coche s’affiche dans la colonne Fo. du champ concerné.

Pour en savoir plus, veuillez consulter le chapitre Utilisation des formules d’importation.

Saisir les tables de correspondance

Ce bouton permet, pour un champ donné, de définir une table de correspondance. Il s’agit d’associer des valeurs connues dans la base de données à des valeurs différentes contenues dans le fichier importé.

Une fois définie, la table de correspondance est disponible : elle doit ensuite être activée en cochant la colonne Co. du champ concerné.

Le caractère joker % en fin de chaîne peut être utilisé afin de limiter la taille de cette table.

Notez qu’au sein d’une même provenance de données, une table de correspondance saisie sur un champ sera commune à tous les champs portant le même suffixe.

Par exemple, une table de correspondance disponible sur T_ETABLISSEMENT se retrouvera également sur GP_ETABLISSEMENT.

Dans l'exemple ci-dessous :

Les champs T_TIERS, T_EAN, T_PAYEUR et T_FACTURE seront repris à partir de la position 0 et sur une longueur de 17 caractères dans le fichier d’import (ces 4 champs seront donc alimentés de la même manière, par les 17 caractères situés à partir de la position 0).
Le champ T_LIBELLE sera repris à partir de la position 17 et sur une longueur de 35 caractères.
Le champ T_ABREGE sera également repris à partir de la position 17, mais sur une longueur de 17 caractères seulement.
......
Le champ T_NATUREAUXI ne sera pas repris dans le fichier (position 0, longueur 0), mais il sera initialisé à l’aide du bouton [Valeurs par défaut].
.....

Contrôler la saisie des champs obligatoires

Des contrôles sont ajoutés afin de faciliter la saisie du paramétrage d’import. Lors de l’enregistrement du format, en cas de problème détecté, l’enregistrement ne s’effectue pas. D’autre part, en cas de champs obligatoires non présents, un message d’avertissement indique la liste des champs manquants.

Ce bouton permet de contrôler, en cours de saisie du format, que les champs obligatoires ont bien été saisis.

Contrôler la longueur des champs

Un contrôle sur la longueur du champ est ajouté lors de la saisie, ainsi qu’à la validation du paramétrage sur les champs de type VARCHAR, COMBO et BOOLEAN (en cas de format fixe). Ce contrôle prend la forme d’un message du type : "La longueur maximale pour le champ XX est X caractères".

Notez que ce contrôle n’est pas effectué si une formule est associée au champ ou si le champ ne possède pas de table de correspondance associée.

Lors de l’importation, en cas d’intégration d’une donnée de taille supérieure à la taille du champ, un message d’avertissement est inséré dans le rapport d’intégration indiquant que le champ a été tronqué.