Dans ce formulaire, vous décrivez une version de norme, c'est-à-dire le format d'un fichier d'échange qui sera appliqué à une interface.
Informations générales
- Version : Identifiant de la version. Il doit être unique pour une norme donnée.
- Libellé : Description de la version. Précisez si nécessaire la différence avec la version précédente.
- Active : Si cette case n'est pas cochée, la version ne peut pas être applicable pour la norme.
- Norme : Norme à laquelle appartient la version.
- Séparateur : Symbole(s) de séparation des champs au sein d'un enregistrement.
- Lignes d'en-tête : Nombre de lignes d'en-tête, à ignorer, sans compter l'en-tête automatique.
- En-tête automatique : A cocher si la ligne d'en-tête contenant le code de l'interface et du système externe est présente dans le fichier.
Liste des enregistrements
Cette liste contient les différents types de lignes de données du fichier.
Un enregistrement doit impérativement correspondre à un objet dans un objet d'intégration, parmi ceux de l'interface à laquelle est destinée la version.
Création des enregistrements
Il est fortement conseillé de créer les enregistrements en utilisant l'option "Recherche objets d'intégration" du menu de création
.
Il vous suffira ensuite de :
- supprimer les enregistrements secondaires et les champs que vous n'utilisez pas,
- modifier le préfixe des enregistrements et l'ordre des champs,
- ajouter éventuellement un champ pour permettre la mise à jour des éléments existants (ex : WO::code).
Description des enregistrements
- Enregistrement : Préfixe de la ligne, permettant d'identifier son contenu.
Dans certains cas, il peut être nécessaire de ne pas utiliser de préfixe (voir Type "Principal sans préfixe").
- Description : Commentaire relatif au contenu de la ligne.
- Type : Indiquez si la donnée est de type "Principal", "Secondaire" ou "Principal sans préfixe".
- Alias objet : Alias de l'objet auquel correspond la ligne.
- Enregistrement père : Ligne principale dont dépend la ligne secondaire en cours.
- Alias collection : A préciser pour les objets de type collection. Exemple : wo_processes pour les opérations d'une intervention.
- Icône
ou
: Ouvre le formulaire des transformations et contrôles pour l'enregistrement.
Type
Une donnée secondaire dépend d'une donnée principale qui doit être préalablement définie.
Par exemple, si le fichier contient des interventions et leurs opérations, les lignes d'interventions sont principales, et les lignes d'opérations sont secondaires.
Le cas "Principal sans préfixe" est utile lorsque le flux d'échange (en import ou en export) est constitué d'un seul type d'enregistrements et qu'il n'est pas nécessaire de distinguer ces enregistrements via un préfixe.
Par exemple, un fichier contenant simplement une ligne par intervention, sans ligne secondaire associée.
Ce type sans préfixe ne devra donc être utilisé que dans le cas où les données échangées sont homogènes et constituées selon un format unique.
Liste des champs
Cette liste contient les champs, ou colonnes, qui composent un enregistrement du fichier.
Un champ doit impérativement correspondre à un attribut dans l'objet d'intégration.
- Ordre : Numéro de colonne du champ dans la ligne.
- Alias attribut : Alias de l'attribut dans l'objet d'intégration.
- Suffixez l'alias de ::code s'il correspond à un objet référencé par son code, ou de ::id s'il est référencé par son identifiant.
- L'alias d'un champ à ignorer est indifférent.
- Libellé : Décrit le contenu du champ.
- Type de valeur : A renseigner en cas de transformation ou de format, pour permettre à l'application de l'appliquer correctement.
- A ignorer : Cochez cette case si le champ ne correspond pas à une donnée de CARL Source.
- Longueur fixe : A renseigner uniquement si la norme décrit un fichier à positions fixes. Il s'agit de la taille du champ, qui détermine la position du champ suivant.
Le préfixe de la ligne a une longueur de 20 par défaut. Ce nombre peut être modifié dans le dictionnaire, objet RECORD, attribut rowName, propriété "Nb caractères".
- Les numéro d'ordre doivent être affectés de 1 à n, sans doublon et sans discontinuité.
- Tous les alias doivent être différents dans un enregistrement donné.