Anveo EDI Connect / Config / Mappings / Le convertisseur TEXT
This is an automatic translation. The original post is available in Anglais.

Le convertisseur TEXT

Le convertisseur de texte peut être utilisé pour importer et exporter des fichiers texte. Le convertisseur prend en charge les fichiers de longueur fixe, ainsi que les fichiers variables (csv). Il est également possible de convertir des formats de données basés sur des enregistrements tels que VDA, qui ont un type d’enregistrement de champ au début de chaque enregistrement.

Nous supposons que vous savez comment travailler avec les lignes de mappage et comment accéder aux propriétés EDI.

Utilisation de l’assistant

Parce que les fichiers texte peuvent avoir n’importe quelle structure, nous ne pouvons pas détecter le format à partir d’un fichier exemple. Le convertisseur de texte a un support limité pour générer le mappage à partir d’un fichier de description. Pour utiliser l’assistant, commencez par créer un mappage et configurer les propriétés de l’en-tête. Ensuite, vous pouvez démarrer l’assistant et utiliser un fichier CSV de la structure suivante :

Exemple de fichier de structure pour la création de mappage de texte

La première colonne Name est obligatoire, ainsi que la ligne d’en-tête. Les colonnes Length et Type sont optionnelles. Le fichier doit être dans la locale Windows actuelle et non encodé en Unicode.

Commandes spécifiques au convertisseur

Ce convertisseur ne supporte pas les commandes.

Importation / Exportation

Nous discuterons séparément des propriétés et des caractéristiques des importations et des exportations.

Importation de données de texte

Après avoir créé le mappage, la première chose à faire est de vérifier si les propriétés de l’en-tête sont correctement définies. Ensuite, vous pouvez commencer à créer des lignes de mappage, soit en utilisant l’assistant, comme décrit ci-dessus, soit en les ajoutant manuellement.

Vous pouvez utiliser des filtres à l’intérieur des boucles de table d’écriture, pour créer un enregistrement seulement, si les données attendues sont fournies. Vous pouvez configurer si plusieurs filtres sont cochés dans les propriétés de l’en-tête. Vous l’utilisez généralement, par exemple, pour différencier différentes structures en fonction d’un type d’enregistrement.

Si vous avez besoin d’écrire des données dans une table, mais que vous ne voulez pas créer plus d’un enregistrement, vous pouvez utiliser la Max. Repeat propriété de la boucle. Dans le convertisseur de texte, le réglage de cette propriété limitera le nombre d’enregistrements qui seront écrits. Le convertisseur de texte ne lancera pas d’erreur, si le nombre maximal de répétitions est atteint.

Si vous devez créer un enregistrement et que vous n’avez pas de champ correspondant dans le fichier, vous pouvez utiliser une astuce : Ajoutez un champ de longueur fixe de longueur 0 en tant qu’enfant de la ligne de table d’écriture, pour créer un enregistrement, sans se fier aux données réelles du fichier. Veuillez vous assurer de définir la valeur de la Max. Repeat propriété à un dans ce cas, sinon le module va essayer de créer un nombre infini d’enregistrements.

Importer les propriétés d’en-tête

Direction

Si vous voulez importer ou exporter des données. Pour importer un fichier texte dans Microsoft Dynamics 365 Business Central, définissez ce paramètre sur Import.

Encoding

L’encodage à utiliser. Veuillez noter que l’encodage est limité

Default

L’encodage interne utilisé par Microsoft Dynamics 365 Business Central.

Windows-1252

Utilisez l’encodage Windows. Selon l’installation Microsoft Dynamics 365 Business Central, il peut s’agir d’une page de code différente de celle de Windows-1252. Dans la mesure du possible, nous utilisons l’encodage interne de la Microsoft Dynamics 365 Business Central sous le nom « Windows ».

MS Dos

Utilisez un codepage DOS.

IBM-500

Non pris en charge dans les nouvelles versions de Microsoft Dynamics 365 Business Central utilisant le ServiceTier. Un vieil encodage mainframe. Ne plus utiliser.

Default Field Type

Vous pouvez mélanger des zones de longueur fixe et des zones séparées par un ou plusieurs caractères de contrôle dans le même mappage. Cette propriété spécifie le type par défaut, afin que vous n’ayez pas à le sélectionner sur chaque ligne de mappage.

Fixed Length

La longueur du champ doit être spécifiée et est un nombre fixe de caractères.

Variable

La zone est terminée par un ou plusieurs caractères de contrôle.

Default Limiter

Vous pouvez utiliser cette propriété pour spécifier des valeurs globales par défaut pour l’ensemble du mappage. Vous pouvez remplacer cette propriété sur chaque ligne de mappage EDI. Spécifie les caractères de contrôle qui terminent un champ de longueur variable. Vous pouvez utiliser tous les caractères spéciaux.

Default Length

Vous pouvez utiliser cette propriété pour spécifier une longueur par défaut pour les zones à longueur fixe. Vous pouvez remplacer cette valeur pour chaque zone individuelle.

Alternative Delimiter

Vous pouvez spécifier un délimiteur alternatif pour les zones de longueur variable. Chacun des champs du mappage accepte aussi bien le délimiteur alternatif que le délimiteur normal. Ceci est principalement destiné à être utilisé avec les formats, où il manque les caractères de contrôle dans la dernière zone d’un fichier ou pour les formats, où un saut de ligne peut être utilisé au lieu des caractères de contrôle à la fin d’une zone.

Vous pouvez utiliser tous les caractères spéciaux.

Table Check All Children

Cette propriété est nouvelle dans Anveo EDI Connect 4.00.
Dans les versions antérieures à la version 4.00, cette propriété n’était disponible qu’en interne et n’était pas toujours correctement définie.

Vous pouvez définir si le module acceptera une boucle, quand le premier filtre a été vérifié avec succès ou si d’autres filtres doivent également être vérifiés. Comme le convertisseur de texte n’exécute pas la structure complète des lignes de mappage des enfants, la vérification de plus d’un filtre doit être utilisée avec prudence.

Propriétés de la ligne d’importation

Après avoir créé une ligne de mappage EDI, vous pouvez configurer les propriétés. Nous n’afficherons les propriétés des lignes de mappage EDI qu’avec la propriété Type définie sur Data comme les autres propriétés se comportent comme dans tout autre mappage.

Field Name

Le nom apparaît dans la première colonne de la ligne de mappage EDI. D’un point de vue technique, cela n’a aucun effet sur le mappage, mais nous vous recommandons de le paramétrer sur le nom du champ en fonction de toute documentation disponible, ou d’utiliser un nom significatif pour le champ d’une autre manière.

Field Type

Vous pouvez spécifier si la zone a une longueur fixe ou si elle est séparée par un caractère de contrôle.

Variable

La zone est terminée par un ou plusieurs caractères de contrôle.

Fixed Length

Le champ a une longueur fixe.

Delimiter

Ce champ n’est disponible que si la propriété Field Type est définie sur Variable. Spécifie les caractères de contrôle qui terminent un champ de longueur variable. Vous pouvez utiliser tous les caractères spéciaux.

Alternative Delimiter

Ce champ n’est disponible que si la propriété Field Type est définie sur Variable. Spécifie un caractère de contrôle alternatif qui termine une zone de longueur variable. Vous pouvez utiliser tous les caractères spéciaux.

Start Escape

Ce champ n’est disponible que si la propriété Field Type est définie sur Variable. Indique un caractère d’échappement de début. Les caractères de contrôle qui devraient normalement terminer le champ de longueur variable sont autorisés entre les caractères d’Start Escape et de End Escape.

End Escape

Ce champ n’est disponible que si la propriété Field Type est définie sur Variable. Spécifie un caractère d’échappement de fin. Les caractères de contrôle qui devraient normalement terminer le champ de longueur variable sont autorisés entre les caractères d’Start Escape et de End Escape.

Length

Ce champ n’est disponible que si la propriété Field Type est définie sur Fixed Length. Indique le nombre de caractères à lire.

DestExpr

Vous pouvez spécifier où la valeur de la zone doit être enregistrée. Vous pouvez trouver plus d’informations dans la section utilisant l’expression de destination. Nous avons discuté de la signification des filtres sur les importations de texte au début de la section sur l’importation dans ce chapitre.

Not Empty

si la zone est acceptée, si elle n’a pas de valeur. Vous pouvez l’utiliser en combinaison ou comme alternative à un filtre pour importer uniquement les données, si une valeur est présente.

Format Type

Vous pouvez sélectionner le type de données des données que vous voulez importer.

Les valeurs suivantes sont disponibles :

Auto

La zone est automatiquement interprétée en fonction du type de données cible.

Date

Les données sont interprétées comme une date. Vous pouvez spécifier le format avec la propriété Format String.

Time

Les données sont interprétées comme des informations de temps. Vous pouvez spécifier le format avec la propriété Format String.

Date/Time

Les données sont interprétées comme des informations de date/heure. Vous pouvez spécifier le format avec la propriété Format String.

Value Translation

Supporté par Anveo EDI Connect 4.01 (ajouté en 4.00.12, mais nécessite une réinstallation des options du module)

Nous vous recommandons fortement de stocker la valeur originale sans la traduire dans une table tampon.

Parfois, vous voulez traduire directement une valeur importée en une autre. À l’aide de ce type de format, les données sont interprétées à l’aide d’une conversion de valeur. Vous pouvez spécifier la conversion à utiliser à l’aide de la propriété Value Translation.

Format String

Disponible uniquement si la propriété Format Type est définie. Spécifie la chaîne de format date/heure, comme décrit dans la section Utilisation des chaînes de format date/heure.

Value Translation

Disponible uniquement si la propriété Format Type est définie sur la valeur Value Translation. Spécifie la conversion de valeur qui doit être utilisée pour interpréter les données entrantes. La vérification de la longueur est faite avant, vous pouvez donc tronquer la valeur avant de la traduire.

A utiliser avec précaution. Nous recommandons de stocker la valeur originale dans une table tampon, chaque fois que cela est possible, et de la traduire en utilisant un post-traitement.

Exportation de données de texte

Pour exporter des données, assurez-vous que la propriété Direction la propriété d’en-tête de mappage est définie sur Export et configurez d’abord les propriétés d’en-tête. Ensuite, vous pouvez soit créer les lignes à l’aide de l’assistant, comme décrit ci-dessus, soit ajouter chaque ligne à la main.

Propriétés de l’en-tête d’exportation

Direction

Si vous voulez importer ou exporter des données. Pour exporter les données de la Microsoft Dynamics 365 Business Central dans un fichier texte, définissez ce paramètre sur Export.

Encoding

L’encodage à utiliser. Veuillez noter que l’encodage est limité

Default

L’encodage interne utilisé par Microsoft Dynamics 365 Business Central.

Windows-1252

Utilisez l’encodage Windows. Selon l’installation Microsoft Dynamics 365 Business Central, il peut s’agir d’une page de code différente de celle de Windows-1252. Dans la mesure du possible, nous utilisons l’encodage interne de la Microsoft Dynamics 365 Business Central sous le nom « Windows ».

MS Dos

Utilisez un codepage DOS.

IBM-500

Non pris en charge dans les nouvelles versions de Microsoft Dynamics 365 Business Central utilisant le ServiceTier. Un vieil encodage mainframe. Ne plus utiliser.

Default Field Type

Vous pouvez mélanger des zones de longueur fixe et des zones séparées par un ou plusieurs caractères de contrôle dans le même mappage. Cette propriété spécifie le type par défaut, afin que vous n’ayez pas à le sélectionner sur chaque ligne de mappage.

Fixed Length

La longueur du champ doit être spécifiée et est un nombre fixe de caractères.

Variable

La zone est terminée par un ou plusieurs caractères de contrôle.

Default Limiter

Vous pouvez utiliser cette propriété pour spécifier des valeurs globales par défaut pour l’ensemble du mappage. Vous pouvez remplacer cette propriété sur chaque ligne de mappage EDI. Spécifie les caractères de contrôle qui terminent un champ de longueur variable. Vous pouvez utiliser tous les caractères spéciaux.

Default Length

Vous pouvez utiliser cette propriété pour spécifier une longueur par défaut pour les zones à longueur fixe. Vous pouvez remplacer cette valeur pour chaque zone individuelle.

Fallback Communication Channel

Cette propriété a été renommée Anveo EDI Connect 4.00 et la valeur est maintenant facultative. Avant, vous deviez définir une valeur, même si elle n’a jamais été utilisée. Le nom précédent était Communication Channel. La logique générale n’a pas changé.

Spécifie un EDI Communication Channel qui est utilisé pour envoyer les données sortantes, s’il n’est pas spécifié auparavant. Vous pouvez remplacer ceci à partir des codes C/AL et AL, des mappages précédents et le spécifier à l’aide de Business Transactions. Cette propriété n’est utilisée que comme une solution de secours, sinon le canal de communication est défini au préalable.

Send Channel After Convert

si les données doivent être envoyées automatiquement après la conversion de ce mappage. Habituellement, c’est une bonne idée d’envoyer les données automatiquement.

Fallback Receiver Partner

Cette propriété a été renommée Anveo EDI Connect 4.00.11 pour mieux décrire la fonctionnalité. Le nom précédent était Receiver Party. La logique n’a pas changé.


Spécifie un EDI Communication Partner qui est utilisé comme destinataire des données sortantes, s’il n’est pas spécifié auparavant. Vous pouvez remplacer ceci à partir des codes C/AL et AL, des mappages précédents et le spécifier à l’aide de Business Transactions. Cette propriété n’est utilisée qu’à titre de solution de rechange, si aucun partenaire n’a été défini au préalable.

Exporter les propriétés de ligne

Après avoir créé une ligne de mappage EDI, vous pouvez configurer les propriétés. Nous n’afficherons les propriétés des lignes de mappage EDI qu’avec la propriété Type définie sur Data comme les autres propriétés se comportent comme dans tout autre mappage.

Field Name

Le nom apparaît dans la première colonne de la ligne de mappage EDI. D’un point de vue technique, cela n’a aucun effet sur le mappage, mais nous vous recommandons de le paramétrer sur le nom du champ en fonction de toute documentation disponible, ou d’utiliser un nom significatif pour le champ d’une autre manière.

Field Type

Vous pouvez spécifier si la zone a une longueur fixe ou si elle est séparée par un caractère de contrôle.

Variable

La zone est terminée par un ou plusieurs caractères de contrôle.

Fixed Length

Le champ a une longueur fixe.

Delimiter

Ce champ n’est disponible que si la propriété Field Type est définie sur Variable. Spécifie les caractères de contrôle qui terminent un champ de longueur variable. Vous pouvez utiliser tous les caractères spéciaux.

Start Escape

Ce champ n’est disponible que si la propriété Field Type est définie sur Variable. Spécifie un caractère d’échappement de début, qui sera écrit avant les données.

End Escape

Ce champ n’est disponible que si la propriété Field Type est définie sur Variable. Spécifie un caractère d’échappement de fin. Ce caractère est écrit après les données, avant le Delimiter.

Length

Ce champ n’est disponible que si la propriété Field Type est définie sur Fixed Length ou si la propriété Length Validation est définie sur un champ variable. Indique le nombre de caractères qui doivent être écrits. Vous pouvez spécifier le caractère de remplissage avec la propriété Pad Char.

SourceExpr

Vous pouvez spécifier d’où vient la valeur. Vous pouvez trouver plus d’informations dans la section utilisant l’expression source.

Format Type

Vous pouvez sélectionner le type de données des données que vous voulez importer.

Les valeurs suivantes sont disponibles :

Auto

La zone est automatiquement formatée en fonction du type de données source.

NAV Format String

Vous pouvez utiliser une chaîne de format, comme vous pouvez l’utiliser pour la fonction AL / C/AL FORMAT la Microsoft Dynamics 365 Business Central intégrée.

Date

Les données sont formatées comme une date. Vous pouvez spécifier le format avec la propriété Format String.

Time

Les données sont formatées en tant qu’informations de temps. Vous pouvez spécifier le format avec la propriété Format String.

Date/Time

Les données sont formatées en tant qu’informations de date/heure. Vous pouvez spécifier le format avec la propriété Format String.

Number

Les données sont formatées sous la forme d’une valeur numérique.

Format String

Disponible uniquement si la propriété Format Type est se to date/time ou chaîne de format NAV.

Si la propriété Format Type est définie sur NAV Format String, vous pouvez saisir la chaîne de format, comme décrit dans l’aide AL / C/AL.

Si le paramètre est défini sur date/heure, vous pouvez saisir une chaîne de format, comme décrit dans la section Utilisation des chaînes de format date/heure.

Blank Zeros

Si disponible, spécifie que les valeurs vides doivent être éditées comme un champ vide au lieu de la représentation vide par défaut.

Decimal Character

Disponible uniquement si la propriété Format Type est définie sur Number. Indique quel caractère doit être utilisé comme séparateur décimal.

Thousands Separator Character

Disponible uniquement si la propriété Format Type est définie sur Number. Si les milliers doivent être séparés et si, quel caractère doit être utilisé.

Max. Decimal Places

Disponible uniquement si la propriété Format Type est définie sur Number. Le nombre maximal de décimales qui doivent être éditées.

Min. Decimal Places

Disponible uniquement si la propriété Format Type est définie sur Number. Le nombre minimal de décimales qui doivent se trouver dans la sortie. Ceci remplira automatiquement les places manquantes avec des zéros.

Sign

Disponible uniquement si la propriété Format Type est définie sur Number. S’il faut sortir le signe positif/négatif.

Negative Only

Ne sortir que le signe « -« .

Always

Sortez les signes « + » et « -« .

Sign after Value

Disponible uniquement si la propriété Format Type est définie sur Number. S’il faut mettre le signe après les chiffres.

Length Validation

Ce champ n’est disponible que si la propriété Field Type est définie sur Variable. Les actions possibles sont partagées entre les convertisseurs, dans ce convertisseur vous pouvez utiliser un type
de champ différent pour les champs de longueur fixe. Les valeurs suivantes sont autorisées :

Ignore

Ne vérifiez pas la longueur de la sortie.

Max (Error)

Créez une erreur si la valeur est plus longue que celle autorisée.

Max (Truncate with Warning)

Créez un avertissement si la valeur est supérieure à la longueur autorisée et tronquez la sortie à la longueur autorisée.

Max (Truncate)

Tronquer la valeur, si elle est plus longue que permise.

Max (Truncate…)

Tronquez la valeur, si elle est plus longue que permise et ajoutez « …  » à la fin pour montrer que la valeur n’est pas complète.

Exact (Error)

Créez une erreur si la sortie n’a pas la longueur spécifiée.

Exact (Truncate/Pad with Warning)

Tronquer ou rembourrer la valeur, si elle n’a pas la longueur spécifiée et créer un avertissement.

Exact (Pad)

Créez une erreur si la valeur est plus longue que celle autorisée. Tapoter la valeur si elle est trop courte.

Exact (Truncate/Pad)

Tronquer ou tamponner la valeur jusqu’au nombre de caractères indiqué.

Alignment

Ce champ n’est disponible que si la propriété Field Type est définie sur Fixed Length ou si
la propriété Length Validation est définie pour remplir la sortie. Où la sortie doit être alignée, si la valeur est plus courte que le nombre de caractères à sortir.

Auto

Alignement en fonction du type de données de l’expression source.

Left

Aligner la valeur à gauche. Cela signifie que la valeur est d’abord éditée et ensuite le caractère de remplissage est utilisé pour remplir le champ.

Right

Commencez par le rembourrage et sortez la valeur alignée à droite.

Pad Character

Ce champ n’est disponible que si la propriété Field Type est définie sur Fixed Length ou si la propriété Length Validation est définie pour remplir la sortie. Quel caractère doit être utilisé pour le remplissage, si la valeur n’est pas assez longue.