Modelos import/export

• Modelo (campo EXT)

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

• Descr. (campo INTIT)

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

• Activo (campo 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.

• Bloquio de pré parameterização (campo 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.

• Assunto (campo 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.

• Função (campo 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.

• Módulo (campo 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.

• Cód. activ. (campo 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é.

• Código acesso (campo 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.

• Tratamento standard (campo 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.

• Tratamento especifico (campo 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.

• Tipo de ficheiro (campo 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.

• Separador de campo (campo 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.

• Separador de registo (campo 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.

• Delimitador de campo (campo 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 : '

• Formato fich. (campo 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. (campo EXPORT)

Se esta zona está assinalada, será possível de utilizar este modelo em Exportação de dados.

• Crono. export. (campo 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.

• Jogo de caracteres (campo 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).

• Separador décimal (campo 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 ('.').

• Formato das datas (campo 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.

• campo LIBDAT

Intitulé associé au code précédent

• Formato menus locais (campo 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.

• campo LIBMNL

Intitulé associé au code précédent

• Importação (campo IMPORT)

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

• Actualiz. autorizada (campo OPTUPD)

Utilisez ce champ pour modifier un enregistrement existant pendant l'import

• Sas (campo 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. especial (campo 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 (campo 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.

• Nr. (campo NUMFLG)

Ligne courante du tableau.

• Nível (campo 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.

• Indicador (campo 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.

• Tabela (campo FLGFIL)

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

• Chave (campo 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.

• Ligação (campo 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.

• Comprim. (campo RECLEN)

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

• Nr. (campo NUMLIG)

Ligne courante du tableau.

• Indicador (campo 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.

• Tabela (campo 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.

• Campo (campo 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é.

• Descr. (campo COM)

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

• Limite (campo 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.

• Posição (campo 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.

• Comprim. (campo LNG)

Esta zona determina o comprimento do campo sobre o ficheiro sequêncial.

• Formato (campo 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 (campo 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'.

• Baliza (campo 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.

• Obrigatório (campo 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'.

• Nr. da tabela (campo 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.

• campo TYPEXP

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

• client,
• serveur.

• Ficheiro de dados (campo 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.

• Directório final (campo 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.

• Todas as línguas existentes (campo ALLLAN)

Se esta check box está assinalada, todas as línguas são tomadas em conta pela operação.

Se a check box não foi assinalada, tomar-se-á segundo o caso :

• A língua por defeito do utilizador, se nenhum código língua não foi registado.
• A língua registada por outro lado senão.

• Língua (campo LAN)

Permite de definir a língua de geração (quando a check box permitindo de gerar em todas as línguas não foi assinalada).

• Todos os tipos (campo ALLTYP)

Se esta check box está assinalada, todos os tipos de documentação são tomados em conta para a geração. Deve-se referir que, neste caso, limita-se a geração às documentações standard (apenas as documentações de código inferior a X são tomados em conta).

• Tipo (campo TYPEDOC)

Permite definir o tipo de documentação a tomar em conta no tratamento (quando não se assinalou a check box para os tomar todos em conta).

• Desde códigos documentos (campo FUNDEB)

Permite de dar um limite sobre os códigos a ter em conta para a geração de documentação.

• Cód. documentação fim (campo FUNFIN)

• campo GENDOC

Este botão redondo permite criar/atualizar a parametrização da documentação (hierarquia dos parágrafos) a partir dos elementos técnicos encontrados no dicionário dos dados. Pode-se escolher de retomar unicamente as documentações existentes ou criar novas documentações se necessário

As relações de documentação são igualmente tomados em conta. Os parágrafos susceptíveis de serem criados são definidos no anexo técnico correspondante.

• Para todos os grupos (campo ALLCREGRP)

Este campo permite escolher entre :

• Tratar todas as documentações ou ajudas sobre campo indeferentemente do grupo de pertença de utilizador.
• Tratar unicamente as documentações ou ajudas sobre campos cujo grupo de utilizador é equivalente ao grupo criador da documentação encontrada na tabela AOBJGRPDEV

• campo GENFIN

Este botão redondo permite gerar a documentação final a partir do conteúdo dos parágrafos de documentação. Esta documentação foi criada em diferentes sub-directórios do directório definido pelo parâmetro utilizador DIRDOC.

A geração "Completa" trata o conjunto das documentações não tendo código de atividade mas também aquelas tendo os códigos atividades standards (código atividade < "X")

Falta utilizar a geração "segundo o código atividade" para obter a geração das documentações das funções tendo os códigos atividades ativos (quer sejam standards ou específicos).

• Somente as documentações validadas (campo HLPVLD)

Permite gerar o documento final unicamente para as documentações válidas.

• Ajudas sobre campos ligados às documentações (campo HLPLNKFLD)

Si cette case est cochée, sont traitées spécifiquement les aides sur champs relatives aux documentations sur fonction ou objet traitées par ailleurs. Pour savoir quelles sont les aides sur champ à traiter, explorez les écrans associés aux paragraphes de documentation correspondants.

• Outras ajudas sobre campos (campo HLPFLD)

Se esta check box assinalada, cria-se a documentação final a partir do conteúdo dos parágrafos de documentação. Esta documentação foi criada em diferentes sub-directórios FLD do directório definido pelo parâmetro utilizador DIRDOC.

• Códigos ajuda campos inicio (campo HLPDEB)

Permite de dar um limite sobre os códigos a ter em conta para a geração de documentação.

• Cód. ajuda campos fim (campo HLPFIN)

• Directorio de geração (campo REPERT)