Modèles import/export

• Modèle (champ EXT)

Code qui identifie le modèle d'import-export.

• Intitulé (champ INTIT)

Permet de définir un intitulé associé à chaque fiche.

• Actif (champ ENAFLG)

Cette case à cocher permet d'activer ou de désactiver la fiche courante sans pour autant perdre son contenu.

Une fiche désactivée ne peut pas être utilisée (par appel de son code) dans d'autres fiches (documents, paramétrages...), ou lors de traitements de masse.

Les habilitations sur une fonction donnée peuvent interdire la création d'une fiche active. Dans ce cas, la case est désactivée par défaut, et est modifiable uniquement par un utilisateur autorisé, ou via un circuit de signature défini par Workflow.

• Objet (champ OBJ)

Définit le code de l'objet a importer ou exporter. Dans le cas de l'export, cette zone est facultative; le nom de la table principale à exporter est indiqué dans le bloc des identificateurs.

• Fonction (champ FONCTION)

Permet d'initialiser le contexte (notamment si un même objet est utilisé par plusieurs fonctions) et de vérifier les droits d'accès. En effet, les utilisateurs doivent avoir les droits d'accès idoines à la fonction pour pouvoir se servir du modèle.

Ce champ est obligatoire.

• Module (champ MODULE)

Module d'appartenance du paramétrage. Ce champ permet de renseigner si l'écran doit être créé dans la base de données du dossier. Il l'est si le module auquel l'écran est rattaché est actif pour le dossier.

• Code activité (champ CODACT)

Un code activité permet :

• de rendre optionnel un élément du dictionnaire si la valeur associée au code activité est nulle.
• de signer les éléments spécifiques dès lors qu'ils sont marqués par un code commençant par X, Y ou Z.
• de dimensionner un nombre de lignes maximum lorsque le code activité marque des éléments d'un tableau.

Ainsi, si le code activité est non actif, l'élément marqué ne sera pas utilisable, et le code associé (s'il y en a) ne sera pas généré ni activable.

• Code d'accès (champ ACS)

Ce code d'accès permet de restreindre l'accès à la fiche courante à certains utilisateurs.
Si la zone est renseignée, seuls les utilisateurs disposant de ce code d'accès dans leur profil peuvent visualiser et modifier cette fiche.

Le droit d'exécution attaché à un code utilisateur est traité de façon particulière dans le cas des modèles d'import-export : si un utilisateur n'a pas le droit d'exécution, il ne pourra pas utiliser le modèles pour importer ou exporter des données.

• Script standard (champ TRTIMP)

Définit le traitement standard dans lequel que se trouvent les étiquettes des actions qui sont appelées dans les traitements d'import-export.

Ces traitements permettent de faire des initialisations, des contrôles complémentaires, et des mises à jour si nécessaire. On trouvera en annexe technique la structure d'un tel programme. Il est à noter que des traitements standards nommés en général IMPXXX, XXX étant le code de l'import, sont fournis pour un certain nombre d'imports.

Pour plus d'information sur ces actions, cf. la documentation annexe correspondante.

• Script spécifique (champ SPEIMP)

Définit le traitement spécifique, qui est appelé avant le traitement standard, et qui permet de réaliser les mêmes actions en désactivant si nécessaire ce que fait le traitement standard.

Les actions possibles sont notamment des initialisations, des contrôles complémentaires, et des mises à jour si nécessaire.

Pour plus d'information sur ces actions, cf. la documentation annexe correspondante.

• Type de fichier (champ TYPFIL)

Définit la structure utilisée pour gérer les données dans le fichier à importer ou exporter. Pour plus d'informations, cf. le paragraphe correspondant.

• Séparateur de champ (champ SEPFLD)

Définit le séparateur entre deux champs.

Pour saisir un caractère non imprimable, il faut entrer un '\' (barre de fraction inversée) suivi de 3 chiffres représentant le code ascii du caractère en base décimale.

• Sép enregistrement (champ SEPREC)

Définit le séparateur entre deux enregistrements (groupes de données).

Pour saisir un caractère non imprimable, il faut entrer un '\' (barre de fraction inversée) suivi de 3 chiffres représentant le code ascii du caractère en base décimale.

Souvent, on utilise :

• le caractère line feed (\010), qui correspond à la fin de ligne dans des fichiers textes sous Unix
• la combinaison des deux caractères carriage return, line feed (\013\010)n qui correspond à la fin de ligne dans des fichiers textes Windows.

• Délimiteur de champ (champ FLDLIM)

Le délimiteur de champ (généralement le caractère " ) est ajouté en première et dernière position des champs de type alphanumérique. Les champs numériques et dates ne sont pas concernés par ce délimiteur.

Il s'agit fréquemment d'un des caractères suivants :

• 'simple quote'
• "double quote"

• Format fichier (champ CODDBA)

Définit le format des caractères utilisés dans le fichier :

• ascii est le format classique où un caractère équivaut à un octet dans le fichier. Ce type de format permet de traiter les caractères occidentaux classiques, avec différents jeux de caractères possibles, définis dans le champ correspondant.
• utf8 correspond à un format UNICODE où le nombre de caractères est variables (il va de 1 à 4, 1 correspondant au jeu de caractère latin non accentués). Ce format permet de gérer tous les types de caractères, et notamment les caractères chinois.
• ucs2 correspond à un format standard Microsoft, dans lequel les caractères sont systématiquement stockés sur 2 octets.

• Export (champ EXPORT)

Si cette zone est cochée, il sera possible d'utiliser ce modèle en Export de données.

• Chrono export (champ CHRNUM)

Ce champ, uniquement affiché, stocke la valeur du numéro de chrono lorsque le dernier export a eu lieu. Ceci permet, lorsqu'on réalise des exports chronologiques, de ne traiter que ce qui a été modifié depuis que le dernier export a eu lieu.

• Jeu de caractères (champ OPTCHA)

Lorsqu'on utilise le jeu de caractère ascii, il est possible d'utiliser différents formats standardisés :

• Le code ISO 8859 (qui est par ailleurs le jeu interne d'Adonix lorsqu'on travaille en ascii)
• Le code IBM PC
• Le code ASCII 7 bits (sans accents : les lettres accentuées sont converties dans la minuscule correspondante.)

• Séparateur décimal (champ SEPDEC)

Définit le séparateur décimal utilisé pour les chiffres. Si cette zone est vide, on va considérer que le séparateur décimal est le '.' (point).

• Format des dates (champ OPTDAT)

Définit la manière dont sont codés les champs de type date (ordre et nombre de caractères pour l'année). 

Seul l'ordre des chiffres et le nombre de caractères de l'année peut ainsi être spécifié. A l'import, d'éventuels caractères de séparation entre champs sont filtrés; ainsi des dates sous la forme 29-05-59, ou 09/04/1991 sont décodés correctement.

Le sous-programme de décodage tient compte de la variable adxdcs du moteur, renseignée par le paramètre DCS se trouvant dans les paramètres généraux pour définir la manière dont est décodée une année sur deux chiffres. DCS représente l'année « pivot » qui définit le changement de siècle.

Par exemple, si DCS vaut 1940, toute année sur deux chiffres inférieure ou égale à 40 sera considérée comme faisant partie du vingt-et-unième siècle, et toute année supérieure sera considérée comme faisant partie du vingtième siècle. On sera ainsi capable d'exprimer les années entre 1940 et 2039 sur deux chiffres.

Le format AAAA-MM-JJ est réservé pour les exports de type XML.

• champ LIBDAT

Intitulé associé au code précédent.

• Format menus locaux (champ OPTMNL)

Les champs de type "menu local" sont stockés sous forme d'un nombre représentant leur rang dans la table.

Selon la valeur de cette zone le modèle va exporter (ou s'attendre à trouver en import) :

• 0 : dans ce cas, on écrit le choix sous la forme d'un chiffre indiquant le rang du menu dans la table : 1 pour le premier choix, 2 pour le deuxième, etc. Ceci correspond d'ailleurs au format interne sous lequel le menu local est stocké dans la base.
• 1 : on écrit alors le choix en utilisant le code (sur un caractère) associé à chaque choix de menu local. Ce code n'est pas visible en gestion des menus locaux. Il peut être défini dans les fonctions de développement, en gestion des messages : on a la possibilité de saisir ce code interne (qui ne sert qu'à cette fin, ce n'est plus, comme dans d'anciennes versions caractères, un accélérateur de saisie).
• n : (n>1) les n premiers caractères du libellé affiché en saisie. Lorsqu'on utilise cette option, l'algorithme de reconnaissance recherche sur le premier caractère, puis sur le deuxième, et ainsi de suite, jusqu'à ce qu'un seul intitulé corresponde. Ainsi, si on cherche à reconnaître CHQ dans un menu local dont les intitulés sont Espèces, Virement, Chèque, Traite, Carte Bleue, l'algorithme va reconnaître Chèque (seul intitulé dont les deux premières lettres correspondent).

Compte tenu du fait que les intitulés du menu local ne sont que des libellés utilisés en affichage, la valeur stockée dans la base étant le rang dans la table, il est parfaitement possible de changer l'intitulé des menus locaux le temps d'un import, pour que l'algorithme de reconnaissance fonctionne correctement. Attention toutefois, le fait de changer des intitulés de menus locaux ne peut être fait qu'en mode mono-utilisateur, aussi ceci n'est pas envisageable dans des transferts réguliers ou automatisés.

• champ LIBMNL

Intitulé associé au code précédent.

• Import (champ IMPORT)

Si cette zone est cochée, il sera possible d'utiliser ce modèle en Importation de données.

• Mise à jour autorisée (champ OPTUPD)

Permet d'autoriser la modification d'un enregistrement existant pendant l'import

• Sas (champ AOWSTA)

Lorsque cette case est cochée, l'import de données alimente le sas d'import-export avec les données erronées. Le fait d'alimenter le sas n'empêche pas par ailleurs de créer un fichier d'erreur.

• Import spécial (champ OPTSPE)

Signale que l'intégration des données dans la base se fait en utilisant des actions spécifiques définies dans le traitement dont le nom est donné dans la rubrique Traitement import. Ce traitement spécifique possède un nombre restreint de points d'entrée et nécessite donc d'écrire un traitement incluant tous les contrôles que l'on, souhaite faire.

Son intérêt réside dans le fait qu'on peut ainsi regrouper des contrôles afin d'optimiser le programme d'import. La structure des traitements d'imports spécifique est décrite en annexe.On devra notamment y trouver les actions suivantes :

• une étiquette $RAZCRE qui est directement appelée par l'import.
• une étiquette $SAIMSK qui est directement appelée par l'import à chaque enregistrement lu et remplace le Call SAIMSK standard (affectation et contrôle des zones du masque à partir de la classe [F])

• Workflow (champ ENAWRK)

Si cette case n'est pas cochée, les événements de workflow relatifs aux opérations élémentaires (création, modification en gestion d'objet) ne sont plus appelés. Ainsi, si on lance des imports aboutissant à des mises à jour en masse, on évite le déclenchement d'une multitude d'événements de ce type, ce qui peut être préjudiciable aux performances de l'import et provoquer l'envoi de messages en masse.

Pour autant, les événements de workflow relatifs au déclenchement de l'import ne sont pas désactivés.

• No (champ NUMFLG)

• Niveau (champ FLGLEV)

Définit le niveau d'imbrication du groupe. Le niveau 1 est le niveau principal, un niveau N+1 définit un sous-détail du niveau N qui le précède.

• Indicateur (champ FLGREC)

Identifie le groupe par un code de 5 caractères maximum, code qui sera repris dans le tableau des champs de l'onglet suivant, et dans le fichier lui-même, comme en-tête de groupe.

• Table (champ FLGFIL)

Ce tableau des indicateurs définit la structure des groupes d'enregistrements. Cf le paragraphe correspondant.

• Clé (champ FLGKEY)

Définit la clé de la table liée utilisée pour accéder au détail des enregistrement du groupe, à partir de valeurs de champs des tables de niveau supérieur utilisées dans l'expression de lien.

• Lien (champ FLGLNK)

Définit l'expression de lien, c'est-à-dire une suite de valeurs, séparées par un point-virgule, qui donne les valeurs de clé qui lient la table de détail à l'enregistrement d'en-tête.

• Longueur (champ RECLEN)

Dans le cas d'un type de fichier de longueur fixe, il faut indiquer le nombre de caractères de chaque enregistrement.

• No (champ NUMLIG)

• Indicateur (champ TYP)

Cette zone, n'est saisie que si le tableau des identificateurs de groupes de l'onglet précédent n'est pas vide. Elle permet de rattacher l'information à exporter ou importer à un groupe de données.

• Table (champ FIL)

Définit la table de la base de données où est définie la donnée à importer ou exporter. Il est à noter que :

• Ce champ est obligatoire même s'il ne sert pas forcément (si on est dans un modèle d'export et que l'on définit une expression calculée, celle-ci peut référencer des champs issus de plusieurs tables).
• La table en question n'est pas forcément la table principale associée au groupe, mais peut être une table liée à la table principale de ce groupe ou d'un des groupes précédents de niveau supérieur. Si aucun lien n'est trouvé, une message d'avertissement est affiché : Lien automatique non géré. Cela signifie qu'il est du ressort du traitement d'import ou d'export (saisi dans le premier onglet) de réaliser ce lien manuellement (en déclarant par exemple la table dans l'action IMP_OUVRE, et la lecture de la table dans l'action IMP_LIENS).

• Champ (champ FLD)

Permet d'indiquer le nom de la zone de la table à importer ou exporter. Différentes syntaxes sont ici possibles pour définir les informations à extraire ou intégrer :

• Le caractère /  (slash) signifie qu'un indicateur de groupe est écrit à l'export ou recherché lors de l'import. Dans un modèle permettant l'import, lorsque plusieurs groupes existent, ce séparateur est obligatoire pour chaque groupe. Le séparateur de groupe est censé être un champ normal (encadré par des séparateurs de champs et des délimiteurs si un modèle de type Délimité est utilisé).
• La syntaxe la plus simple est CHAMP(indice), lorsqu'un champ issu de la table déclarée dans la colonne précédente est importé ou exporté.  Une fenêtre de sélection permet de faire apparaître les champs possibles.
• Si on saisit ici une constante chaîne de caractères encadrée entre des double-quotes ( " ), le champ sera écrit tel quel dans le fichier en export, et ignoré en import.
• Si on ne saisit rien, ceci signifie qu'il y aura un champ vide dans le fichier exporté (encadré par des délimiteurs de champ si le modèle est de type Délimité). En import, cela signifie que le champ correspondant doit être ignoré.
• La syntaxe *N, où N est un nombre compris entre 1 et 99, est également possible. Ceci permet d'affecter (en import) ou de lire (en export) la variable GIMP(N). GIMP est une variable globale, de type chaîne de caractères, de longueur maximale égale à 100, qui devra être affectée dans un traitement spécifique associé à l'import ou à l'export.
• La dernière possibilité, utilisable uniquement en export, consiste à définir une expression calculée quelconque, précédée du signe égale ( = ). Cette expression, qui peut faire appel à des constantes, des fonctions, des variables, des opérateurs, et des champs issus de tables en ligne, est vérifiée syntaxiquement à la saisie (le contrôle du contexte, en particulier le fait que les variables existent, ne peut bien sûr pas être vérifié).

• Intitulé (champ COM)

Indiquer un commentaire pour faciliter lacompréhension du paramètrage.

• Borne (champ SEL)

Trois choix sont possibles dans cette zone :

• Non saisiesignifie qu'aucune borne de début-fin pour ce champ ne sera saisie au lancement de l'export.
• Saisiesignifie qu'une borne de début-fin pour ce champ pourra être saisie au lancement de l'export.
• Non transféréesignifie qu'une borne de début-fin pourra être saisie pour ce champ au lancement de l'export, mais que le champ ne sera pas transféré lors d'un import ou d'un export.

• Position (champ LOC)

Cette colonne n'est utile que dans le cas d'un format en longueur fixe ; dans ce cas, la position donne le décalage par rapport au début du bloc ou de l'enregistrement ( positions données en nombre d'octets, 1 signifiant que l'on se trouve au début du bloc ou de l'enregistrement). Les positions doivent être compatibles avec la taille de l'enregistrement.

• Longueur (champ LNG)

Cette zone détermine la longueurdu champ sur le fichier séquentiel.

• Format (champ FMT)

Cette colonne n'est saisie que si le format est en longueur fixe. Pour les montants numériques, le format saisi est défini sous la forme nnn ou nnn.mmm, sachant que ces chiffres peuvent être préfixés par < ou > (cadrage gauche ou droite en complétant avec des zéros, le formattage droit étant utilisé par défaut), préfixés ou post-fixés par le caractère + (signe obligatoire avant/après le chiffre), et préfixé par le caractère * (le séparateur décimal ne doit pas apparaître). Le tableau ci-dessous montre des exemples, de formattage pour un montant donné (les espaces sont ici remplacés par des # ) :

Pour un format alphanumérique, les seules directives de formatage possibles sont < ou > (cadrage à droite ou à gauche, sachant que les chaînes de caractères sont complétées par des espaces).

• Pattern (champ PATTERN)

Ce champ est utilisé lorsqu'on réalise des imports/exports au format XML.

En effet, lorsqu'un fichier XML est créée, on a besoin de davantage d'informations, notamment pour pouvoir créer un fichier XSD décrivant la structure du fichier XML et ainsi contrôler sa validité avec des outils de vérification de syntaxe intégrés aux différents logiciels ETL.

Ce champ définit si un modèle doit être associé à la description faite dans la description XSD.

Si ce champ est renseigné, le fichier XSD contiendra une spécification de type :

pattern value="valeur_saisie_dans_le champ_pattern"

On retrouvera dans des tutoriels en ligne (tel celui-ci) les syntaxes qui peuvent être utilisées pour les patterns.

• Balise (champ BAL)

Ce champ est utilisé lorsqu'on réalise des imports/exports au format XML.

En effet, lorsqu'un fichier XML est créée, on a besoin de davantage d'informations, notamment pour pouvoir créer un fichier XSD décrivant la structure du fichier XML et ainsi contrôler sa validité avec des outils de vérification de syntaxe intégrés aux différents logiciels ETL.

Ce champ définit le code de la balise décrivant le champ exporté dans le modèle, telle qu'elle apparaîtra dans le fichier XML.

• Obligatoire (champ OBL)

Ce champ est utilisé lorsqu'on réalise des imports/exports au format XML.

En effet, lorsqu'un fichier XML est créée, on a besoin de davantage d'informations, notamment pour pouvoir créer un fichier XSD décrivant la structure du fichier XML et ainsi contrôler sa validité avec des outils de vérification de syntaxe intégrés aux différents logiciels ETL.

Ce champ définit si le champ est obligatoire ou non. Si la valeur de ce champ est égal à Oui, le fichier XSL contiendra une spécification de type minOccurs="1"

• Numéro de table (champ NUMTAB)

Ce numéro, s'il existe, fait référence à une table de transcodage utilisable pour transcoder le champ lu et le rendre conforme au format attendu.

• champ TYPEXP

• Fichier de données (champ FILEXT)

Permet de définir le chemin d'un fichier de données par défaut qui sera proposé lors du lancement de l'import ou de l'export (et utilisé de façon automatique en cas de lancement d'un enchaînement d'import ou d'export).  Si le chemin fichier est relatif,  le répertoire de base est supposé être le répertoire de base d'installation du progiciel.

Le chemin peut intégrer le caractère #. Si c'est le cas, il y aura gestion des numéros séquentiels :

• En import, cela signifie que l'on va rechercher tous les fichiers dont le modèle correspond au chemin, avec # représentant 5 chiffres (on intègre ces fichiers dans l'ordre croissant des numéros)
• En export, cela signifie que l'on crée un fichier intégrant la valeur formattée du compteur [C]EXPORT sur 5 chiffres . Ceci va normalement de pair avec le fait de cocher la case Gestion chrono lors du lancement de la fonction d'export.

Par exemple, si le chrono export est égal à 156, /u/tmp/fic# permet de générer le fichier /u/tmp/fic00156.

• Répertoire final (champ REPFIN)

Permet d'imposer un répertoire final dans lequel le fichier va être transféré après avoir été importé. En l'absence de valeur, on utilise le répertoire donné dans les paramètres généraux de l'import/export.