Formats d'importation/exportation

1 Introduction

Les exportations depuis IDL.KONSIS et les importations vers IDL.KONSIS servent à la fois d'interfaces avec d'autres systèmes d'information et de transfert de données entre deux installations IDL.KONSIS. Ces fonctionnalités sont disponibles pour la plupart des données IDL.KONSIS (voir Actions/applications ultérieures de l'application IMPORT ).

Les interfaces tant externes qu'internes doivent être définies pour permettre une transmission correcte des données. Cette définition est utilisée dans IDL.KONSIS en tant que format d'importation/exportation (abrégé : IMPFORM) et stocké dans trois tables de base de données, chacune disposant d'une application récapitulative et d'une application à taux unique :

IMPFORM

désigne l'en-tête d'un format d'importation/exportation. Définit les propriétés communes en plus du nom du format.

IMPDEF

donne une vue d'ensemble des cellules qui peuvent ou doivent être incluses dans une définition de

IMPFIELD

Définit quelles sont ces cellules dans un format et quelles sont leurs propriétés spécifiques.

Vous pouvez spécifier le format d'importation/exportation lors de l'exportation de données à partir d'IDL.KONSIS ou de l'importation de données vers IDL.KONSIS.

2 Ident de format d'importation/exportation (IMPFORM)

2.1 Clés

La clé d'un format d'importation/exportation se compose de deux parties :

• Le type d'objet représente la base de données à laquelle ce format s'applique. La liste de sélection des types d'objet est fournie par IDL et inclut les ensembles de données pour lesquels une fonction d'importation est actuellement disponible (voir ci-dessus).
• L'ID de format distingue différents formats pour chaque type d'objet. Il existe des formats définis par IDL, reconnaissables par le « # » de premier plan, mais les formats personnalisés peuvent également être définis via un ID de format distinct. Le format par défaut fourni par IDL est #TXT.

La clé d'un type d'objet correspond généralement à l'ID de menu de l'application de soins associée. Il existe des exceptions dans le domaine des données permanentes, car les nouvelles applications (...DEF) sont généralement utilisées. Gérer les données de différents types d'objets. Par exemple, l'application « FLUDEF » inclut la maintenance des types d'objet flux (SPI), domaine de flux (SBE), colonnes de flux (SSP), regroupements de clés comptables (BSG) et clé de saisie (BSL). Les types d'objet sont alors nommés en fonction des applications individuelles précédentes.

Les formats commençant par '#' dans l'ID de format sont gérés exclusivement par IDL et livrés avec les métadonnées lors du changement de version. Elles ne doivent pas être modifiées du côté du client.

2.2 Vue d'ensemble (IMPFORM)

Le type d'objet et l'ID de format sont des champs obligatoires dans le filtre de la vue d'ensemble de l'IMPFORM, mais les entrées ambiguës (sous-clé+'%') sont également autorisées. Par exemple, les deux cellules sont préremplies avec '%' (toutes les données) lors du premier appel de l'application. En outre, la langue est un champ d'entrée facultatif dans le filtre qui permet de contrôler la langue des désignations affichées dans la table.

Le tableau présente les ID de format sélectionnés et leurs propriétés. Les informations relatives à la dernière modification ne concernent que les modifications apportées à ces enregistrements eux-mêmes, et non les modifications apportées aux spécifications de format enfant.

Vous pouvez utiliser la barre d'outils ou le menu contextuel pour effectuer les actions courantes d'insertion, de modification et d'efface d'un ID de format d'importation/exportation, ainsi que d'affichage, de modification et d'efface du texte d'aide. Les applications suivantes sont également disponibles dans le menu contextuel :

Mappage de cellules IDL à des formats

Accès à la vue d'ensemble du mappage des cellules IDL aux formats ( IMPFIELD ) avec les clés de la définition de format sélectionnée

Cellules des formats IDL

Affichage de la synthèse des cellules de format d'importation/exportation ( IMPDEF ) avec les clés de la définition de format sélectionnée

2.3 Application spécifique (IEFE)

L'application d'ensemble de phrases détaillées 'IEFE' peut définir les propriétés suivantes d'un format :

Désignation et texte court

permettent une annotation vocale du format

Format

établit une distinction entre les types de formats d'importation/exportation de base suivants :

• 'TABLE' indique que l'interface se présente sous la forme d'une table de base de données. Ces tables sont définies par IDL dans la base de données IDL.KONSIS (voir application 'IMPJOB'). Par conséquent, ce format ne peut être spécifié qu'avec le format #DB par défaut.
• « TXT » désigne les formats qui se présentent sous la forme de fichiers orientés ligne (un enregistrement par ligne). Il peut s'agir d'un format à longueur de champ fixe (comme le format standard #TXT) ou d'un format délimité par des séparateurs spécifiques entre les cellules (formats CSV).
• XML désigne des formats au format XML. Actuellement, seuls quelques types de données (BALSOL, BALIC, VARIMM) les prennent en charge. Le format par défaut #XML est le format XML par défaut utilisé en interne par IDL. D'autres formats XML, tels que le format de l'interface CODA (Format-ID '#XMLCODA'), doivent spécifier les règles de transformation entre ces formats (définition xslt) dans le texte d'aide associé.

séparateur

spécifie le séparateur entre les cellules pour les formats CSV. La virgule (,), le point-virgule (;), l'espace (SPACE) et la tabulation (TAB) sont autorisés.

caractère de masquage

spécifie un autre caractère spécial qui inclut les cellules et les interprète comme une cellule, même si elles contiennent le séparateur (par exemple, dans les désignations). Seul le guillemet ( ») est actuellement pris en charge.

Inverser la valeur

Cette cellule n'a actuellement aucune signification.

page de codes

spécifie un jeu de caractères différent pour le fichier d'entrée.

groupe de transfert

spécifie un groupe de transfert (application DATACONV ) à appliquer par défaut dans le cadre d'un format d'exportation/importation.

ID objet de la table Imp/Exp

Spécifie le nom de la table de base de données IDL.KONSIS dans laquelle les données sont écrites lors de l'importation

Nom de fichier par défaut

Le nom de fichier par défaut définit la présélection des données à indiquer du nom de fichier pour l'importation et l'exportation dans les boîtes de dialogue appropriées, mais il peut également être remplacé. Pour l'exportation, le nom de fichier peut également être associé à des composants variables (voir ci-dessous. ).

Pertinence de l'API d'importation

Cette information n'est pertinente qu'en interne à IDL et ne doit pas être utilisée pour les formats personnalisés.

Préfixe XML

Cette cellule n'est nécessaire que pour les formats XML définis par IDL.

Chaîne de commentaire

Dans le cas d'un fichier au format TXT, vous pouvez spécifier la chaîne au début d'une ligne qui marque cette ligne comme ligne de commentaire à ignorer lors de l'importation, par exemple « ** » pour les formats standard #TXT.

Nombre fixe de lignes de commentaire

Ce nombre indique, pour un fichier au format TXT, le nombre de lignes au début du fichier (par exemple : en-tête de tableau) comme des lignes de commentaires à ignorer lors de l'importation.

Exporter en-têtes de table / Exporter lignes de commentaire

Ces commutateurs ne sont évalués qu'au moment de l'exportation et déterminent si seules les lignes de données pures doivent être exportées ou si l'en-tête de la table ou les autres lignes (lignes vides, lignes totales, sommes de contrôle, etc.) doivent également être exportées.

Numéro d'ordre d'importation

Cette information est particulièrement utile pour la fonction d'exportation d'IDL.XLSLINK lorsque le fichier Excel contient des références d'exportation de différentes tables. Ce numéro est utilisé pour déterminer l'ordre dans lequel les données sont importées afin d'éviter les erreurs dues à l'absence de références. Cette spécification n'est maintenue que pour l'ID de format par défaut #TXT.

Les cellules Invert et Page de codes ne sont pas encore activées.

2.4 Espace réservé dans les noms de fichiers par défaut

Les caractères génériques suivants sont actuellement disponibles pour rendre le chemin d'accès et/ou le nom de fichier plus flexible :

Dans les exemples suivants, la boîte de dialogue d'options suppose que le chemin d'accès d'importation est C:\IDL\BATCH\ :

C:\XYZ\Import_Salden.ABC

==> C:\XYZ\Import_Salden.ABC (aucune modification n'a été spécifiée pour le lecteur et le suffixe, et aucun espace réservé)

BALSOL

==> C:\IDL\BATCH\BALSOL.TXT (ajout du chemin d'importation et du suffixe, car il n'y a pas de valeur par défaut)

%SOC\%PER\KTOSAL_%DATTYP

==> C:\IDL\BATCH\001\200712\KTOSAL_I4.TXT (si défini à l'avance, # = '001', Période = '12.2007' et type de données = 'I4')

L'utilisation des variables dépend des paramètres disponibles dans les applications. Le tableau ci-dessous indique les variables actuellement autorisées pour quel format sont fournies par le menu d'importation :

3 Cellules pour les formats d'importation/exportation (IMPDEF)

3.1 Description succincte

L'application cellules de format d'importation/exportation (IMPDEF) affiche les cellules utiles d'un format d'importation/exportation flexible. Ces données sont fournies et conservées par IDL.

3.2 Choix

Les cellules suivantes permettent la sélection :

Type d'objet

Vous pouvez sélectionner ici les ressources de données disponibles.

ID CELLULE

La première cellule décrit s'il s'agit d'une cellule technique de IDL.KONSIS ('KON') ou d'une cellule générale ('IAR'). Les entrées de la deuxième cellule sont des clés valides, des sous-clés+% ou %. Les noms de champs utilisés ici sont également définis côté IDL.

Type d'objet de conversion

La sélection affiche les types d'objet pour lesquels un réadressage entre des clés externes et internes peut être défini au sein d'un groupe de réadressage. La sélection selon le type d'objet permet d'avoir une vue d'ensemble des endroits où les groupes de transfert peuvent être utilisés lors de l'importation ou de l'exportation.

langue

Permet d'afficher les étiquettes de champs dans différentes langues.

Valide à partir de

Cela simplifie considérablement l’importation des données de base, car les systèmes en amont ne sont souvent pas en mesure de fournir ces informations, mais elles sont obligatoires dans IDL Konsis. De plus, les utilisateurs peuvent sélectionner la spécification « Valide à partir de » souhaitée de manière transparente et adaptable, éliminant ainsi le besoin de la stocker de manière rigide dans la définition du format d’importation.

3.3 Colonnes du tableau

Le tableau affiche les colonnes suivantes :

Type d'objet d'importation/exportation

s. Options de sélection

ID de projet, ID de cellule

s. Options de sélection

Désignation, titre de la colonne, texte court

Considérations de la cellule concernée

Type de données IE

Désigne le type de données techniques de la cellule, par exemple : CHAR (chaîne), DATE (date) ou DECIMAL (nombre avec séparateur décimal)

F

L'addendum au format de champ indique si les lettres d'une cellule sont automatiquement converties en majuscules.

E

Le type d'entrée de cellule IMPFORM indique si une cellule est obligatoire (M) ou facultative (K).

PN

L'activation de paramètre indique si la cellule peut être définie via une spécification de paramètre (filtre de l'application IMPORT, spécification « #KEY » dans un contrôle automatique) et par quel paramètre elle est attribuée.

IoA

L'indicateur d'initialisation pour les attributs facultatifs '*' indique que le contenu existant d'une cellule peut être supprimé en spécifiant '*' dans l'enregistrement d'importation, tandis que la spécification vide conserve le contenu de la cellule. En revanche, les cellules sans l'indicateur d'initialisation pour les attributs facultatifs sont vides ou supprimées.

GUI Col ID

Référence interne à IDL pour identifier la cellule à émettre dans l'application IDL.KONSIS

Type, étiquette de transfert.

Type d'objet de réadressage (voir Options de sélection ), complété ici par la restriction de réadressage, telle que définie dans les groupes de réadressage

Chemin XML

Donnée interne à IDL : Le chemin d'accès XML doit être entré si le format par défaut #TXT est également #XML.

propriété

Donnée interne à IDL : La propriété doit être entrée si ce format est utilisé par l'API d'importation. Le format décrit l'aide sur la cellule.

4 Mappage cellules d'importation aux formats (IMPFIELD)

4.1 Description sommaire

L'application Correspondances cellules d'importation/exportation de format (IMPFIELD) affiche toutes les correspondances de cellule à un format d'importation/exportation sélectionné, ainsi que leurs propriétés. Les propriétés dépendent du type de format.

4.2 Possibilités de sélection

Les cellules suivantes permettent la sélection :

Format

Il s'agit des types d'objet et des ID de format possibles, tels que définis dans l'application IMPFORM, que vous pouvez sélectionner.

langue

Permet d'afficher les étiquettes de champs dans différentes langues.

4.3 Colonnes du tableau

Le tableau présente les colonnes suivantes, qui sont définies en partie dans l'application IMPDEF et en partie dans l'application IMPFIELD elle-même :

ID CELLULE

Nom de la cellule référencée

GUI Col ID

Référence interne à l'IDL pour identifier la cellule à émettre dans l'application IDL.KONSIS selon le tableau IMPDEF

Désignation, titre de la colonne

Considérations de la cellule concernée

Points de départ ou N° colonne

Agrégation de la cellule dans le fichier d'importation (uniquement pour les formats TXT) : Pour les longueurs de champ fixes, il s'agit de l'agrégation à laquelle la cellule commence (position de départ), pour les formats CSV, il s'agit de l'ordre des cellules et correspond au nombre de séparateurs précédents moins 1 (n° colonne).

longueur

Longueur de la cellule dans le fichier d'entrée (uniquement pour les formats TXT à longueur de champ fixe)

E

Type d'entrée de la cellule IMPFORM selon le tableau IMPDEF (voir ci-dessus.)

PN

Activation des paramètres IMPFORM selon le tableau IMPDEF (voir ci-dessus.)

IoA

Indicateurs d'initialisation pour les attributs facultatifs tels que définis dans la table IMPDEF (voir ci-dessus.)

Type de données IE

Type de données d'importation/exportation selon la table IMPDEF (voir ci-dessus.)

F

Mention supplémentaire de format de champ selon le tableau IMPDEF (voir ci-dessus.)

Chaîne de format

est utilisé pour interpréter et convertir des dates et des heures dans des formats spécifiques (par exemple, dd.MM.yyyy).

par défaut

Valeur par défaut : Ici, une valeur par défaut (par exemple, constante de texte) au cas où le fichier source ne fournit pas de valeur. Pour appliquer les paramètres définis (voir la colonne PN), vous devez entrer #KEY ici. La valeur qui figure dans le fichier d'entrée est prioritaire. La valeur saisie ici n'est appliquée que si le fichier d'entrée ne contient aucune valeur.

Type, étiquette de transfert.

Type d'objet de transfert et contrainte d'objet de transfert selon la table IMPDEF (voir ci-dessus.)

4.4 Application unique (IEFFELE)

L'application de taux unique associée à la vue d'ensemble permet de gérer les propriétés affichées dans le tableau, à moins qu'elles ne soient déjà définies par l'application IMPDEF. Il s'agit :

• Position de départ ou Numéro de colonne
• longueur de champ
• Facteur (actuellement non utilisé)
• Chaîne de format
• Valeur par défaut

La clé doit être l'ID de cellule. Seules les cellules spécifiées dans la table IMPDEF pour chaque type d'objet sont disponibles en tant que cellules, les clés de champ commençant par « I » étant exclusivement réservées au format « #DB » et ne pouvant donc pas être utilisées pour des formats individuels.

La chaîne de format est utilisée pour convertir les dates du fichier d'entrée au format interne. Les différents styles (voir tableau) peuvent être utilisés avec/sans séparateur. Exemple : dd.MM.yyyy = format par défaut de date de début de validité. En spécifiant une chaîne de format à partir de plusieurs zéros (par exemple, « 00000 ») peut spécifier que les valeurs numériques correspondantes (par exemple : Les numéros de compte) peuvent être étendus à la longueur spécifiée (5 chiffres dans l'exemple) par des zéros de début. Ceci est notamment utile lorsque les clés définies alphanumériquement dans IDL.KONSIS sont définies uniquement numériquement dans des systèmes étrangers. Les chaînes suivantes peuvent être utilisées pour spécifier la chaîne de format :

5 Exemples

5.1 Soldes de compte sous forme d'une simple liste de soldes dans Excel

Société Une seule fournit ses soldes de compte dans une feuille de calcul Excel qui contient uniquement les colonnes N° compte et Montant. Cette feuille de calcul Excel peut être enregistrée au format CSV et être utilisée pour l'importation.

Pour ce faire, un format doit être défini dans l'IMPFORM avec les attributs suivants :

L'ID de format, les mentions et le nom de fichier par défaut sont fournis avec des exemples de noms et peuvent être choisis à volonté. Les cellules suivantes sont attribuées à ce format dans IMPFIELD :

En d'autres termes, le fichier d'importation, comme indiqué ci-dessus, ne contient que les informations relatives au numéro de compte et au montant en monnaie locale. Les autres informations contenues dans les enregistrements résultants de la base de données sont les suivantes :

• Société Les clés de la période, du type de données et de la période sont spécifiées en tant que paramètres (par exemple, dans le filtre de l'application IMPORT) lors de l'importation. Le cas échéant, un secteur d'activités peut être indiqué ici de la même manière.
• Le plan comptable société est déterminé par les types de données ou par les deux.
• L'indicateur de débit/crédit est déterminé par l'identifiant bilan/P&P du compte.