Modèles import/export

• Modèle (champ EXT)

Ce code identifie le modèle d'import / export.

• Intitulé (champ INTIT)

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

• Actif (champ ENAFLG)

Sélectionnez cette case à cocher pour activer la fiche courante.

Les enregistrements non sélectionnés conservent leur contenu et paramétrage, mais ne pourront pas être utilisés en rappelant leur code dans :

• les autres enregistrements, comme les documents et paramètres,
• les traitements en 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. Elle est modifiable uniquement par un utilisateur autorisé, ou via un Workflow de signature.

• Verrou de pré-réglage (champ AFACTORYOW)

Ce champ indique le nom du propriétaire du modèle d'import ou export.

Si le propriétaire est SAGE, vous ne pouvez pas modifier les données à l'écran.

• Objet (champ OBJ)

Ce champ définit le code de l'objet à importer ou exporter. Ce champ est optionnel pour les exports. Le bloc d'identification affiche le nom de la table principale à exporter.

• Fonction (champ FONCTION)

Ce champ initialise le contexte et vérifie les droits d'accès. Il est utile lorsque le même objet est utilisé par plusieurs fonctions. 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)

Sélectionnez un module pour le paramétrage.

Ce champ vous 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é vous permet de :

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

Si le code activité est désactivé :

• l'élément marqué n'est pas utilisable,
• le code associé n'est pas généré ou activé.

• Code d'accès (champ ACS)

Ce code d'accès permet d'interdire l'accès à la fiche courante pour certains utilisateurs.

Si le champ est alimenté, seuls les utilisateurs qui ont des droits de lecture sur ce code d'accès peuvent visualiser l'enregistrement ; et seuls les utilisateurs avec des droits d'écriture peuvent le modifier.

Ce code d'accès permet d'interdire l'accès à la fiche courante pour certains utilisateurs.

Si le champ est alimenté, seuls les utilisateurs qui ont des droits de lecture sur ce code d'accès peuvent visualiser l'enregistrement ; et seuls les utilisateurs avec des droits d'écriture peuvent le modifier.

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)

Ce champ définit le traitement standard dans lequel se trouvent les intitulés 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. La structure de ce programme est décrite en annexe technique. 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)

Ce champ 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)

Ce champ 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)

Indiquez le caractère utilisé comme séparateur entre deux champs.

Pour saisir un caractère non imprimable, saisissez '\' (barre de slash inversée) suivi de 3 chiffres représentant le code ASCII du caractère en base décimale.

• Sép enregistrement (champ SEPREC)

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

Pour saisir un caractère non imprimable, saisissez '\' (barre de slash inversée) suivi de 3 chiffres représentant le code ASCII du caractère en base décimale.

Les séparateurs communément utilisés sont :

• 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" (retour chariot) et "line feed" (\013\010), qui correspond à la fin de ligne dans des fichiers textes Windows.

• Délimiteur de champ (champ FLDLIM)

Le délimiteur de champ est ajouté en première et dernière position des champs de type alphanumérique. Pour les champs numériques et le champs de date, aucun séparateur n'est requis.

Il s'agit généralement d'un des caractères suivants :

• Guillemets simples : '
• Guillemets doubles : "

• Format fichier (champ CODDBA)

Indiquez 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.
• UTF-8 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.
• UCS-2 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 non modifiable 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)

Si vous utilisez le jeu de caractère ASCII, vous pouvez 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 tiers IBM,
• Le code ASCII 7-bit sans accents (les lettres accentuées sont converties en lettres minuscules sans accent).

• Séparateur décimal (champ SEPDEC)

Ce champ définit le séparateur décimal utilisé pour les chiffres. Si ce champ est vide, le séparateur décimal pris en compte est le point (".").

• Format des dates (champ OPTDAT)

Ce champ permet de définir le type de codage des champs de date.

Vous pouvez uniquement définir l'ordre des informations, et le nombre de caractères dans l'année. Pour l'import, tout caractère servant de séparateur entre les champs est filtré. Par exemple, des dates au format DD-MM-YY ou DD/MM/YYYY seront bien interprétées.

Le sous-programme de décodage des dates prend en compte la variable adxdcs du moteur. Cette variable est définie au niveau du paramètre général DCS permettant de définir comment les années sur deux caractères sont décodées. DCS représente une année pivot permettant de déterminer le siècle concerné.

Par exemple, si DCS est égal à "1940" et que l'année est définie sur deux caractères :

• une valeur inférieure ou égale à 40 est considérée comme faisant partie du 21ème siècle,
• une valeur supérieure à 40 est considérée comme faisant partie du 20ème siècle.

Il est ainsi possible d'exprimer les années entre 1940 et 2039 sur deux chiffres.

• 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 ce champ, le modèle va exporter, ou s'attendre à trouver en import :

• 0: 0 : Le choix est un chiffre indiquant le rang du menu dans la table. 1 pour le premier choix, 2 pour le deuxième, etc. Ceci correspond au format interne sous lequel le menu local est stocké dans la base.
• 1 : 1 : Le choix est saisi 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, où ce code interne peut être saisi. C'est la seule utilité de ce code interne, contrairement aux anciennes versions sur caractères où il servait d'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).

Les intitulés sont les libellés affichés à l'écran. Leur rang dans la table est l'information qui est stockée dans la base de données. Il est possible de modifier l'intitulé d'un menu local lors d'un import pour que l'algorithme de recherche fonctionne correctement. Cette modification est uniquement possible en mode mono-utilisateur. Cette opération n'est pas conçue pour les transferts réguliers ou automatiques.

• champ LIBMNL

Intitulé associé au code précédent

• Import (champ IMPORT)

Si ce champ est sélectionné, il est possible d'utiliser ce modèle en import de données.

• Mise à jour autorisée (champ OPTUPD)

Utilisez ce champ pour modifier 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)

Ce champ indique 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 imports personnalisés est décrite en annexe. Les actions suivantes sont disponibles :

• $RAZCRE directement appelée par l'import,
• $SAIMSK directement appelée par l'import à chaque enregistrement lu, et remplace l'appel SAIMSK standard (affectation et contrôle des champs de l'écran à partir de la classe [F])

• Workflow (champ ENAWRK)

Si cette case est désactivée, les événements de workflow relatifs aux opérations de base (création ou modification en gestion d'objet) ne sont plus appelés. Si des imports sont lancés et qu'ils génèrent des mises à jour en masse, cette option permet ainsi d'éviter de déclencher une multitude d'événements. En effet, cela pourrait avoir un impact sur les performances de l'import et causer un envoi massif de messages.

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

• No (champ NUMFLG)

Ligne courante du tableau.

• Niveau (champ FLGLEV)

Ce champ 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)

Ce champ identifie le groupe par un code constitué de 5 caractères au maximum. Ce code est repris dans le tableau des champs de la section suivante, 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)

Ce champ 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)

Ce champ définit l'expression de lien. Cette expression est 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, vous devez indiquer nombre de caractères de chaque enregistrement.

• No (champ NUMLIG)

Ligne courante du tableau.

• 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)

Ce champ indique la table de base de données où sont définies les données à importer ou exporter. Remarques :

• Ce champ est obligatoire, même s'il n'est pas nécessairement utilisé. Si une expression du calcul est indiquée sur le modèle d'export, elle peut faire référence à des champs de différentes tables.
• La table concernée n'est pas nécessairement la table principale du groupe. Il peut s'agir d'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 la première section, de réaliser ce lien manuellement. Par exemple, en déclarant la table dans l'action IMP_OUVRE, et la lecture de la table dans l'action IMP_LIENS.

• Champ (champ FLD)

Ce champ permet d'indiquer le nom du champ de la table à importer ou exporter. Différentes syntaxes sont admises pour définir les informations à extraire ou intégrer :

• Le 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 FIELD(index), 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 affiche alors les choix possibles.
• Si on saisit ici une constante chaîne de caractères encadrée entre des guillemets doubles ("), 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 constituée d'une chaîne de caractères avec une longueur maximum de 100. Vous devez l'affecter à un processus personnalisé 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 égal (=). Cette expression permet d'appeler des constantes, des fonctions, des variables, des opérateurs ou des champs provenant d'autres tables. La syntaxe est vérifiée lors de la saisie. Le contrôle du contexte, permettant par exemple de vérifier que des variables existent, ne peut pas être vérifié.

• Intitulé (champ COM)

Ajoutez un commentaire qui permette de comprendre plus facilement votre configuration.

• Borne (champ SEL)

Trois choix sont possibles dans ce champ :

• Non saisie signifie qu'aucune borne de début-fin pour ce champ ne sera saisie au lancement de l'export.
• Saisie signifie qu'une borne de début-fin pour ce champ pourra être saisie au lancement de l'export.
• Non transférée signifie 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 est uniquement utilisée pour les formats à longueur fixe. Dans ce cas, la position donne le décalage par rapport au début du bloc ou de l'enregistrement. Les positions sont 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 formatage droit étant utilisé par défaut),
• préfixés ou post-fixés par le caractère +. Ce signe obligatoire avant ou après le chiffre,
• préfixés par le caractère *. Le séparateur décimal ne doit pas apparaître. Le tableau ci-dessous montre des exemples, de formatage 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.

Lorsqu'un fichier XML est créé, davantage d'informations sont requises. C'est le cas notamment si vous souhaitez 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 saisie pour le fichier XSD.

Si ce champ est renseigné, le fichier XSD contiendra une spécification de type :
pattern value="value_entered_in_the_pattern_field"

Des tutoriels comme celui-ci sont disponibles en ligne pour en savoir plus sur la syntaxe des schémas ou "patterns".

• Balise (champ BAL)

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

Lorsqu'un fichier XML est créé, davantage d'informations sont requises. C'est le cas notamment si vous souhaitez 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.

Lorsqu'un fichier XML est créé, davantage d'informations sont requises. C'est le cas notamment si vous souhaitez 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

Sélectionnez le type d'export que vous souhaitez effectuer. Les options possibles sont :

• client,
• serveur.

• Fichier de données (champ FILEXT)

Ce champ définit le chemin du fichier de données par défaut, suggéré au lancement du processus d'export ou d'import. Ce fichier de données est utilisé en mode automatique dans le cas d'un enchaînement d'imports ou d'exports. Ce chemin peut être relatif. Dans ce cas, le répertoire de base de données est le répertoire d'installation du logiciel.

Ce chemin peut inclure le caractère #. Dans ce cas, la gestion des numéros séquentiels (chronos) s'applique :

• En import : Tous les fichiers dont le modèle correspond au chemin sont parcourus, et # représente 5 chiffres. Les fichiers sont intégrés dans l'ordre croissant, selon leur numéro.
• En export : Un fichier est créé avec la valeur formatée du chrono [C]EXPORT sur 5 chiffres. Cela implique que la case à cocher Gestion chrono soit sélectionnée lors du lancement de la fonction d'export.

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

• Répertoire final (champ REPFIN)

Ce champ 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.