Balise de champ FSD

L'élément champ spécifie un seul champ dans les données d'entrée ou de sortie.

Attributs

• name

  Spécifie le nom du champ. Si l'attribut output est défini sur yes, le système utilise ce nom comme nom de balise XML dans la sortie et pour rapprocher la sélection d'une balise XML lors de l'entrée.

• output

  Spécifie si le champ doit être compris ou non dans la sortie. Les valeurs valides de cet attribut sont :

  • yes

    l'enregistrement génère une balise dans la sortie

  • no

    le champ ne décrit que la structure de données et peut être utilisé pour ignorer des données.

  La valeur par défaut est yes.

• record-sep

  Spécifie une chaîne de séparation de champ facultative pour le champ. Il peut s'agir de n'importe quelle valeur de chaîne. Vous pouvez également utiliser les valeurs suivantes :

  • \r

    le caractère de retour chariot

    \n

  • le caractère de changement de ligne

  • \t

    le caractère de tabulation.

  Les données sont de longueur fixe. Si aucun séparateur de champs n'est spécifié, le système se sert de l'attribut max-length pour lire les données.

  Le dernier champ de l'enregistrement utilise le séparateur d'enregistrements, pas le séparateur de champs.

• valid-value

  Définit une valeur fixe pour le champ. Le système utilise cette valeur pour valider les données plates, ainsi que dans le cadre de l'élément sélection pour faciliter le mappage de schéma. Lors d'une inscription de données plates, le système inscrit la valeur fixe 'valid-value' dans les données plates si vous définissez l'attribut output sur no.

• leading-chars

  Spécifie une chaîne qui, si elle est trouvée, doit être retirée du début d'un champ. Lorsque des données sont inscrites dans le fichier plat et que l'attribut 'trailing-chars' n'est pas spécifié, le premier de ces caractères sert à remplir à gauche les positions inutilisées de la valeur pour lui donner une longueur correcte (telle que déterminée par l'attribut 'min-length').

• trailing-chars

  Spécifie une chaîne qui, si elle est trouvée, doit être retirée de la fin d'un champ. Le premier de ces caractères sert à remplir à droite les positions inutilisées de la valeur si celle-ci est plus courte que la longueur spécifiée par l'attribut 'min-length'.

• output-if-empty

  Spécifie si un champ doit être écrit, même s'il est vide. Les valeurs valides de cet attribut sont yes et no. La valeur par défaut est no.

• max-length

  Définit la longueur maximum des données. Le système utilise cette valeur pour déterminer la quantité de données qu'il doit lire. La valeur par défaut est 128.

• min-length

  Définit la longueur minimum des données. Le système utilise cette valeur pour valider, filtrer par élément de sélection et remplir les positions inutilisées lorsque les attributs leading-chars ou trailing-chars sont spécifiés. La valeur par défaut est 0.

• truncate

  Si cet attribut est défini sur yes, les données inscrites en format fichier plat seront ramenées à la longueur maximum spécifiée par le biais de l'attribut max-length. La valeur par défaut est no.

• quoted

  Cette option détermine si les données sont à placer entre guillemets. Cette valeur permet de faire apparaître le caractère de séparation de champ dans les données réelles (en effet, le processeur FSD ne cherchera pas le séparateur de champ dans une chaîne entre guillemets). Cette attribut possède les valeurs suivantes :

  • No

    Les données ne sont pas à traiter comme une chaîne entre guillemets, autrement dit elles seront inscrites mot pour mot dans le fichier plat, en entrée et en sortie.

  • Yes

    Les données sont à traiter comme une chaîne entre guillemets. Au moment de convertir les données du format plat en XML, le système supprime tous les guillemets de délimitation et convertit les guillemets échappés en guillemets simples.

  Au moment de convertir du format XML en format plat, les données sont placées entre guillemets. Tout guillemet existant est échappé (autrement dit, un guillemet fermant est ajouté à tout guillemet ouvrant. C'est à dire que " devient "" etc.

• Auto

  Cette option ne s'applique qu'en cas de conversion de données de fichier plat délimitées en XML. Si les données contiennent le séparateur de champ, le système les traite comme si l'attribut entre guillemets était défini sur yes.

  La valeur par défaut est auto.