Guide des formats

De Wiki1000
(Différences entre les versions)
(Mise en œuvre)
 
(41 révisions intermédiaires par 4 utilisateurs sont masquées)
Ligne 1 : Ligne 1 :
=Principe de fonctionnement=
+
{{new|650}}
  
Les formats décrivent un format de fichier et les correspondances entre les données à générer et le modèle métier.
+
Les formats de fichier permettent de décrire les correspondances entre une structure de données variable et un modèle métier.  
  
''' Avant Tahoe '''
+
Une fois cette correspondance établie il est possible d'importer ou d'exporter des fichiers correspondants à cette structure.
  
{{#images:avant_tahoe.jpg|formats}}
+
==Vue globale==
 +
{{#images:apres_tahoe.jpg|formats}}
  
 +
==Administration==
 +
Les formats sont stockés dans le référentiel.
  
''' Depuis Tahoe '''
+
{{#images:formats_admin.png|formats}}
  
{{#images:apres_tahoe.jpg|formats}}
+
===Filtres de caractères ===
 +
{{#images:formats_filtres_car.png|formats}}
 +
 
 +
Pour les formats de génération, il est possible de filtrer les données écrites dans le fichier généré.
 +
 
 +
Pour cela, quatre choix sont possibles.
 +
 +
* Aucun
 +
* CFONB
 +
: [[TextToCFONBText_(rtl)|Voir le fonctionnement du filtre]]
 +
* EDI
 +
: [[TextToEDIText_(rtl)|Voir le fonctionnement du filtre]]
 +
* Personnalisé
 +
: Pour chaque caractère de la chaîne à filtrer:
 +
:: si le caractère appartient à la liste des caractères autorisés il n’est pas filtré.
 +
:: sinon on enlève ses éventuels accents.
 +
:: si le caractère sans accent n’appartient toujours pas à la liste des caractères autorisés, il est remplacé par un blanc.
 +
 
 +
Exemple de filtre personnalisé, caractères autorisés "abcde" :
 +
 
 +
: "aa" donne "aa"
 +
: "azza" donne "a  a"
 +
: "aéèêa" donne "aeeea"
 +
 
 +
===Schémas===
 +
Pour les formats de type xml, un schéma (fichier xsd) est requis à l'exécution.
 +
 
 +
Lorsque le schéma est chargé, il apparaît dans les documents xml associés (lui ainsi que les schémas qu'il référence)
  
=Mise en œuvre=
+
==Mise en œuvre==
  
==La trace==
+
===Importer un fichier===
 +
L'importation d'un fichier en utilisant un format de définition peut s'effectuer
  
La trace générée se situe dans [container L1000]/logs
+
* Dans un processus métier par script métier
  
Trois niveaux de trace sont disponibles
+
Utiliser la méthode d'[[ImportByFormatDef (rtl)|importation de fichier en utilisant un format]].
  
* '''Format_Log_Level_None''' : aucune trace
+
* A partir de l'assistant d'importation
* '''Format_Log_Level_Data_Errors''' : trace les erreurs d'accès au données (formule erronée...)
+
Cochez "Format de fichier" puis sélectionner le format de définition souhaité.
* '''Format_Log_Level_Verbose''' : trace l'exploration du fichier / du modèle (trace importante)
+
  
==Intégrer un fichier==
+
{{#images:format7.png|formats}}
  
'''procedure IntegrateByFormatDef(const aCodeFormat:string;const aData:TStrings;aRefObject:TitObject;const aLogLevel:integer);'''
+
{{tip|En général l'importation de fichier structuré complexe nécessite un processus pour transformer et compléter les informations de sorte que cette méthode utilisant l'assistant d'importation est rarement utilisable.}}
  
'''aCodeFormat''' : code du format
+
===Exporter un fichier===
 +
Utiliser la méthode de [[ExportByFormatDef (rtl)|génération de fichier en utilisant un format]].
  
'''aData''' : fichier à intégrer
+
==Gestion des formats==
 +
Si les formats sont stockés sous forme xml dans le référentiel pour des raisons de performance, la définition des formats s'effectue dans une base métier. (La conception d'un format peut ainsi s'effectuer en web).
  
'''aRefObject''' : objet qui tient les objets qui seront créés
+
Ainsi, il est nécessaire d'enregistrer le format dans le référentiel pour que les modifications apportées soient prises en compte lors de l'exécution.
  
'''aLogLevel''' : niveau de log
+
{{#images:SCRFORMGENXML_ACTION.png|formats}}
  
==Générer==
+
Utiliser les interfaces utilisateurs situées dans le menu "Outils/Définition des formats"
  
'''function GenerateByFormatDef(const aCodeFormat:string;aRefObject:TitObject;const aLogLevel:FormatLogLevel):String'''
+
{{#images:format1.png|formats}}
  
retourne une chaine représentant le fichier généré
+
{{#images:format2.png|formats}}
  
'''aCodeFormat''' : code du format
+
Pour créer un format utilisez l'assistant de création de format :
  
'''aRefObject''' : l'objet à générer
+
{{#images:format6.png|formats}}
  
'''aLogLevel''' : niveau de log
+
{{tip|La duplication est une solution simple pour apporter des modifications à format système}}
  
 +
Voir aussi :
  
===Gestion des formats systèmes===
+
[[Reference_format_fichier|Référence des formats de fichiers]]
  
Lorsque on crée un format en adminLevel=99, ce format et système, il ne peut être modifié/supprimé (sauf mécanique de patch)
+
[[Category:RTL Format de fichier]]
 +
[[Category:Version650]]

Version actuelle en date du 4 novembre 2017 à 11:57

version650-48x48.png

Les formats de fichier permettent de décrire les correspondances entre une structure de données variable et un modèle métier.

Une fois cette correspondance établie il est possible d'importer ou d'exporter des fichiers correspondants à cette structure.

Sommaire

Vue globale

apres_tahoe.jpg

Administration

Les formats sont stockés dans le référentiel.

formats_admin.png

Filtres de caractères

formats_filtres_car.png

Pour les formats de génération, il est possible de filtrer les données écrites dans le fichier généré.

Pour cela, quatre choix sont possibles.

  • Aucun
  • CFONB
Voir le fonctionnement du filtre
  • EDI
Voir le fonctionnement du filtre
  • Personnalisé
Pour chaque caractère de la chaîne à filtrer:
si le caractère appartient à la liste des caractères autorisés il n’est pas filtré.
sinon on enlève ses éventuels accents.
si le caractère sans accent n’appartient toujours pas à la liste des caractères autorisés, il est remplacé par un blanc.

Exemple de filtre personnalisé, caractères autorisés "abcde" :

"aa" donne "aa"
"azza" donne "a a"
"aéèêa" donne "aeeea"

Schémas

Pour les formats de type xml, un schéma (fichier xsd) est requis à l'exécution.

Lorsque le schéma est chargé, il apparaît dans les documents xml associés (lui ainsi que les schémas qu'il référence)

Mise en œuvre

Importer un fichier

L'importation d'un fichier en utilisant un format de définition peut s'effectuer

  • Dans un processus métier par script métier

Utiliser la méthode d'importation de fichier en utilisant un format.

  • A partir de l'assistant d'importation

Cochez "Format de fichier" puis sélectionner le format de définition souhaité.

format7.png

Tip-20px.png Tip : En général l'importation de fichier structuré complexe nécessite un processus pour transformer et compléter les informations de sorte que cette méthode utilisant l'assistant d'importation est rarement utilisable.

Exporter un fichier

Utiliser la méthode de génération de fichier en utilisant un format.

Gestion des formats

Si les formats sont stockés sous forme xml dans le référentiel pour des raisons de performance, la définition des formats s'effectue dans une base métier. (La conception d'un format peut ainsi s'effectuer en web).

Ainsi, il est nécessaire d'enregistrer le format dans le référentiel pour que les modifications apportées soient prises en compte lors de l'exécution.

scrformgenxml_action.png

Utiliser les interfaces utilisateurs situées dans le menu "Outils/Définition des formats"

format1.png

format2.png

Pour créer un format utilisez l'assistant de création de format :

format6.png

Tip-20px.png Tip : La duplication est une solution simple pour apporter des modifications à format système

Voir aussi :

Référence des formats de fichiers





Whos here now:   Members 0   Guests 1   Bots & Crawlers 1
 
Outils personnels