Configurer les définitions d'échange de données
Vous pouvez configurer Business Central pour échanger des données dans des tables spécifiques avec des données sur des fichiers externes. Par exemple, pour envoyer et recevoir des documents électroniques, importer et exporter des données bancaires ou d'autres données, telles que la paie et les catalogues d'articles. En savoir plus sur Échange de données électronique.
Pour créer une définition d'échange de données pour un fichier de données ou un flux, vous pouvez utiliser le schéma XML associé pour définir quels éléments de données inclure dans la Définitions des colonnes Raccourci. Reportez-vous à l'étape 6 dans Pour décrire la mise en forme des lignes et des colonnes dans le fichier. En savoir plus sur Utiliser des schémas XML pour préparer les définitions d'échange de données.
Normalement, vous configurez les définitions d'échange de données sur la Définition d'échange de données page. Toutefois, pour la mise à jour des taux de change des devises, il est plus rapide d'utiliser un service de taux de change des devises. En savoir plus sur Mettre à jour les taux de change.
Remarque
Remarque:
Si le fichier en cours de conversion est au format XML, le terme "colonne" dans cet article doit être interprété comme un "élément XML contenant des données".
Cet article inclut les procédures suivantes :
- Créer une définition d'échange de données.
- Exporter une définition d'échange de données sous forme de fichier XML à des fins d'utilisation par d'autres.
- Importer un fichier XML pour une définition d'échange de données existante.
Créer une définition d'échange de données
La création d'une définition d'échange de données implique deux tâches :
- Sur l' Définition d'échange de données page, décrivez la mise en forme des lignes et des colonnes dans le fichier. En savoir plus dans la Pour décrire la mise en forme des lignes et des colonnes dans le fichier section.
- Sur l' Correspondance d'échange de données page, mettez en correspondance les colonnes du fichier de données avec les champs de Business Central. En savoir plus dans la Pour mettre en correspondance les colonnes du fichier de données avec les champs de Business Central section.
Pour décrire la mise en forme des lignes et des colonnes dans le fichier
Choisissez l'onglet
icône, entrez Définitions échange de données, puis choisissez le lien associé.Choisissez l'onglet Nouveau action.
Sur l' Général Raccourci, décrivez la définition d'échange de données et le type de fichier de données en remplissant les champs comme décrit dans le tableau suivant.
Champ Définition Code Entrez un code pour identifier la définition d'échange de données. Nom Entrez un nom pour la définition d'échange de données. Type de fichier Spécifiez le type de fichier pour lequel la définition d'échange de données est utilisée. Vous pouvez choisir parmi quatre types de fichiers :
- XML: Chaînes de contenu et de balisage superposées entourées de balises indiquant la fonction.
- Texte variable: Les enregistrements ont une longueur variable et sont séparés par un caractère, comme une virgule ou un point-virgule, également connu sous le nom de fichier délimité.
- Texte fixe: Les enregistrements ont la même longueur, en utilisant des caractères de remplissage, et chaque enregistrement est sur une ligne séparée, également connu sous le nom de fichier à largeur fixe.
- Json: Chaînes de contenu superposées en JavaScript.Type Spécifiez le type d'activité commerciale pour lequel la définition d'échange de données est utilisée, par exemple Exportation de paiement. Codeunit de traitement des données Spécifiez le codeunit qui transfère les données vers et depuis les tables de Business Central. Codeunit de validation Spécifiez le codeunit utilisé pour valider les données par rapport aux règles d'affaires prédéfinies. Codeunit de lecture/écriture Spécifiez le codeunit qui traite les données importées avant la correspondance et les données exportées ensuite. XMLport de lecture/écriture Spécifiez le XMLport par lequel un fichier de données ou un service importé entre avant la correspondance, et par lequel les données exportées sont écrites dans un fichier de données ou un service ensuite. Codeunit de traitement des données externes Spécifiez le codeunit qui transfère les données externes vers et depuis l'infrastructure d'échange de données. Codeunit de retour d'information utilisateur Spécifiez le codeunit qui effectue diverses opérations de nettoyage après la correspondance, comme marquer les lignes comme exportées et supprimer les enregistrements temporaires. Encodage du fichier Spécifiez l'encodage du fichier. Remarque : Ce champ est uniquement pertinent pour l'importation. Séparateur de colonnes Spécifiez la façon dont les colonnes du fichier de données sont séparées, si le fichier est de type Texte variable. Lignes d'en-tête Spécifiez le nombre de lignes d'en-tête qui existent dans le fichier.
Ce paramètre permet de s'assurer que les données d'en-tête ne sont pas importées. Remarque : Ce champ est uniquement pertinent pour l'importation.Balise d'en-tête Si une ligne d'en-tête existe à plusieurs positions dans le fichier, entrez le texte de la première colonne de la ligne d'en-tête.
Cette option permet de s'assurer que les données d'en-tête ne sont pas importées. Remarque : Ce champ est uniquement pertinent pour l'importation.Balise de pied de page Si une ligne de pied de page existe à plusieurs positions dans le fichier, entrez le texte de la première colonne de la ligne de pied de page.
Cette option permet de s'assurer que les données de pied de page ne sont pas importées. Remarque : Ce champ est uniquement pertinent pour l'importation.Conseil
Conseil:
Pour vérifier quels codeunits Microsoft utilise dans les définitions existantes du produit standard, explorez les trois Codeunit champs sur les Correspondance de champs page pour chaque définition.Sur l' Définitions de lignes Raccourci, décrivez la mise en forme des lignes dans le fichier de données en remplissant les champs comme décrit dans le tableau suivant.
Remarque
Remarque:
Pour l'importation de relevés bancaires, vous ne créez qu'une seule ligne pour le format unique du fichier de relevé bancaire que vous souhaitez importer.Pour l'exportation des paiements, vous pouvez créer une ligne pour chaque type de paiement que vous souhaitez exporter. Dans ce cas, la Définitions des colonnes Raccourci affiche des colonnes différentes pour chaque type de paiement.
Champ Description Type de ligne Spécifie le type de la ligne dans le fichier. Code Entrez un code pour identifier la ligne dans le fichier. Nom Entrez un nom qui décrit la ligne dans le fichier. Nombre de colonnes Spécifiez le nombre de colonnes que contient la ligne dans le fichier de données. Remarque : Ce champ est uniquement pertinent pour l'importation. Balise de ligne de données Spécifiez la position dans le schéma XML associé de l'élément qui représente l'entrée principale du fichier de données. Remarque : Ce champ est uniquement pertinent pour l'importation. Espace de noms Spécifiez l'espace de noms attendu dans le fichier pour activer la validation de l'espace de noms. Vous pouvez laisser ce champ vide si vous ne souhaitez pas activer la validation de l'espace de noms. Code parent Spécifiez le parent de la ligne, tel qu'il apparaît dans le Code champ dans les cas où la configuration de l'échange de données est destinée aux fichiers comportant des entrées parents et enfants, comme un en-tête de document et des lignes. Répétez l'étape 4 pour créer une ligne pour chaque type de données de fichier que vous souhaitez exporter.
Procédez à la description de la mise en forme des colonnes dans le fichier de données en remplissant les champs de la Définitions des colonnes Raccourci comme décrit dans le tableau à l'étape 8. Vous pouvez utiliser un fichier de structure, comme un fichier .xsd, pour le fichier de données afin de préremplir le Raccourci avec les éléments pertinents. En savoir plus sur Utiliser des schémas XML pour préparer les définitions d'échange de données.
Sur l' Définitions des colonnes Raccourci, choisissez le Obtenir la structure du fichier action.
Sur l' Obtenir la structure du fichier page, sélectionnez le fichier de structure associé, puis choisissez OK. Les lignes de la Définitions des colonnes Raccourci sont remplies selon la structure du fichier de données.
Sur l' Définitions des colonnes Raccourci, modifiez ou remplissez les champs comme décrit dans le tableau suivant.
Champ Description N° colonne Spécifiez le numéro qui reflète la position de la colonne sur la ligne dans le fichier.
Pour les fichiers XML, spécifiez le numéro qui reflète le type d'élément dans le fichier contenant les données.Nom Spécifiez le nom de la colonne.
Pour les fichiers XML, spécifiez le balisage qui marque les données à échanger.Type de données Spécifiez si les données à échanger sont de type Texte, Date, ou Décimal. Format des données Spécifiez le format des données, le cas échéant. Par exemple, MM-dd-yyyy si le type de données est Date. Remarque : Pour l'exportation, spécifiez le format des données selon Business Central. Pour l'importation, spécifiez le format des données selon le .NET Framework. En savoir plus sur Chaînes de format de date et d'heure standard. Culture de mise en forme des données Spécifiez le format des données régional, le cas échéant. Par exemple, en-US si le type de données est Décimal pour s'assurer que la virgule est utilisée comme séparateur 0.000, selon le format américain. En savoir plus sur Chaînes de format de date et d'heure standard. Remarque : Ce champ est uniquement pertinent pour l'importation. Longueur Spécifiez la longueur de la ligne à largeur fixe qui contient la colonne si le fichier de données est de type Texte fixe. Description Spécifie une description de la colonne, à des fins d'information. Chemin Spécifiez la position de l'élément dans le schéma XML associé. Identifiant de signe négatif Entrez la valeur utilisée dans le fichier de données pour identifier les montants négatifs, dans les fichiers de données qui ne peuvent pas contenir de signes négatifs. Cet identificateur est ensuite utilisé pour inverser les montants identifiés en signes négatifs lors de l'importation. Remarque : Ce champ est uniquement pertinent pour l'importation. Constante Spécifiez les données que vous souhaitez exporter dans cette colonne, comme des informations supplémentaires sur le type de paiement. Remarque : Ce champ est uniquement pertinent pour l'exportation. Remplissage de texte requis Spécifiez que les données doivent inclure un remplissage de texte. Caractère de remplissage Spécifiez le caractère de remplissage de texte. Justification Spécifiez si la justification de la colonne est à gauche ou à droite. Répétez l'étape 8 pour chaque colonne ou élément XML du fichier de données dont vous souhaitez échanger les données avec Business Central.
L'étape suivante dans la création d'une définition d'échange de données consiste à décider quelles colonnes ou quels éléments XML du fichier de données correspondent à quels champs de Business Central.
Remarque
Remarque:
La correspondance spécifique dépend de l'objectif commercial du fichier de données à échanger et des variantes locales. Même la norme bancaire SEPA comporte des variantes locales. Business Central prend en charge l'importation de fichiers de relevés bancaires SEPA CAMT prêt à l'emploi. Cela est représenté par le SEPA CAMT code d'enregistrement de définition d'échange de données sur la Définitions échange de données page. Pour en savoir plus sur la correspondance de champs spécifique de cette prise en charge SEPA CAMT, accédez à Mappage des champs lors de l'importation de fichiers SEPA CAMT.
Pour mettre en correspondance les colonnes du fichier de données avec les champs de Business Central
Conseil
Conseil:
Parfois, les valeurs dans les champs que vous souhaitez mettre en correspondance sont différentes. Par exemple, dans une application d'affaires, le code de langue pour les États-Unis est "É.-U.", mais dans une autre, c'est "US". Cela signifie que vous devez transformer la valeur lors de l'échange de données. Cela se fait via des règles de transformation que vous définissez pour les champs. En savoir plus sur Règles de transformation.
Vous pouvez également grouper par n'importe quel champ, utiliser l'index de clé pour trier les résultats, et les nouveaux types de transformation Arrondi et Recherche de champ.
Sur l' Définitions de lignes Raccourci, sélectionnez la ligne pour laquelle vous souhaitez mettre en correspondance les colonnes avec les champs, puis choisissez Correspondance de champs. Le Correspondance d'échange de données page s'ouvre.
Sur l' Général Raccourci, spécifiez la configuration de la correspondance en remplissant les champs comme décrit dans le tableau suivant.
Champ Description ID table Spécifiez la table qui contient les champs vers ou depuis lesquels les données sont échangées selon la correspondance. Utiliser comme table intermédiaire Spécifiez si la table que vous sélectionnez dans le ID table champ est une table intermédiaire où les données importées sont stockées avant d'être associées à la table cible.
En général, vous utilisez une table intermédiaire lorsque la définition d'échange de données importe et convertit des documents électroniques dans Business Central. Par exemple, des documents tels que des factures fournisseur en factures achat. En savoir plus sur Échange de données électronique.Nom Entrez un nom pour la configuration de la correspondance. Index de clé Spécifiez l'index de clé pour trier les enregistrements source avant l'exportation. Codeunit de pré-correspondance Spécifiez le codeunit qui prépare la correspondance entre les champs de Business Central et les données externes. Codeunit de correspondance Spécifiez le codeunit utilisé pour mettre en correspondance les colonnes ou éléments de données XML spécifiés avec les champs de Business Central. Codeunit de post-correspondance Spécifiez le codeunit qui finalise la correspondance entre les champs de Business Central et les données externes. Remarque : Lorsque vous utilisez l'extension AMC Banking 365 Fundamentals, le codeunit convertit les données exportées de Business Central dans un format générique prêt pour l'exportation. Pour l'importation, le codeunit convertit les données externes dans un format prêt pour l'importation dans Business Central. Sur l' Correspondance de champs Raccourci, spécifiez quelles colonnes correspondent à quels champs de Business Central en remplissant les champs comme décrit dans les tableaux suivants, selon que la Utiliser comme table intermédiaire champ est activé.
Avec le Utiliser comme table intermédiaire bouton bascule désactivé :
Champ Description N° colonne Spécifiez quelle colonne du fichier de données vous souhaitez définir une correspondance pour.
Vous ne pouvez sélectionner que les colonnes représentées par des lignes dans la Définitions des colonnes Raccourci de la Définition d'échange de données .Légende de colonne Spécifiez la légende de la colonne dans le fichier externe qui est associée au champ dans la ID table cible champ lorsque vous utilisez une table intermédiaire pour l'importation de données. ID de champ Spécifiez quel champ la colonne dans la N° colonne champ est associé.
Vous ne pouvez sélectionner que des champs qui existent dans la table que vous avez spécifiée dans la ID table champ sur la Général Raccourci.Légende de champ Spécifiez la légende du champ dans le fichier externe qui est associée au champ dans la ID table cible champ, lorsque vous utilisez une table intermédiaire pour l'importation de données. Facultatif Spécifiez si la correspondance doit être ignorée si le champ est vide. Si vous ne sélectionnez pas cette option, une erreur d'exportation se produit si le champ est vide. Règle de transformation Spécifiez la règle qui transforme le texte importé en une valeur prise en charge avant qu'il puisse être associé à un champ spécifié. Lorsque vous choisissez une valeur dans ce champ, la même valeur est saisie dans le Règle de transformation champ dans la Tampon de correspondance de champ d'échange de données table et vice versa. Pour en savoir plus sur l'application des règles de transformation, accédez à Règles de transformation. Remplacer la valeur Spécifiez que la nouvelle valeur peut remplacer la valeur actuelle. Priorité Spécifiez l'ordre dans lequel les correspondances de champs doivent être traitées. La correspondance de champ avec le numéro de priorité le plus élevé est traitée en premier. Multiplicateur Spécifiez un multiplicateur à appliquer aux données numériques, y compris les valeurs négatives. Avec le Utiliser comme table intermédiaire bouton bascule activé :
Champ Description N° colonne Spécifiez quelle colonne du fichier de données vous souhaitez définir une correspondance pour.
Vous ne pouvez sélectionner que les colonnes représentées par des lignes dans la Définitions des colonnes Raccourci de la Définition d'échange de données .Légende de colonne Spécifiez la légende de la colonne dans le fichier externe qui est associée au champ dans la ID table cible champ lorsque vous utilisez une table intermédiaire pour l'importation de données. ID table cible Spécifiez la table vers laquelle la valeur dans le Légende de colonne champ est associée, lorsque vous utilisez une table intermédiaire pour l'importation de données. Légende de table Spécifiez le nom de la table dans le ID table cible champ, qui est la table vers laquelle la valeur dans le Légende de colonne champ est associée, lorsque vous utilisez une table intermédiaire pour l'importation de données. ID champ cible Spécifiez le champ dans la table cible vers lequel la valeur dans le Légende de colonne champ est associée, lorsque vous utilisez une table intermédiaire pour l'importation de données. Légende de champ Spécifiez le nom du champ dans la table cible vers lequel la valeur dans le Légende de colonne champ est associée, lorsque vous utilisez une table intermédiaire pour l'importation de données. Validation uniquement Spécifiez que la correspondance élément-champ n'est pas utilisée pour convertir les données, mais uniquement pour les valider. Règle de transformation Spécifiez la règle qui transforme le texte importé en une valeur prise en charge avant qu'il puisse être associé à un champ spécifié. Lorsque vous choisissez une valeur dans ce champ, la même valeur est saisie dans le Règle de transformation champ dans la Tampon de correspondance de champ d'échange de données table et vice versa. Pour en savoir plus sur les règles de transformation, accédez à Règles de transformation. Priorité Spécifiez l'ordre dans lequel les correspondances de champs doivent être traitées. La correspondance de champ avec le numéro de priorité le plus élevé est traitée en premier.
Sur l' Regroupement de champs Raccourci, spécifiez les règles que vous souhaitez utiliser pour grouper vos champs lors de la création du fichier en remplissant les champs comme décrit dans le tableau suivant.
Champ Description ID de champ Spécifiez le numéro du champ dans le fichier externe qui est utilisé pour le regroupement, et que l'utilisateur doit définir ce champ. Légende de champ Spécifiez la légende du champ dans le fichier externe qui est utilisé pour le regroupement.
Règles de transformation
Si les valeurs des champs que vous souhaitez mettre en correspondance diffèrent, vous devez utiliser des règles de transformation pour les définitions d'échange de données afin de les harmoniser. Vous définissez des règles de transformation pour les définitions d'échange de données en ouvrant une définition existante ou en créant une nouvelle définition, puis dans la Définitions de lignes Raccourci, en choisissant Gérer, puis Correspondance de champs. Des règles prédéfinies sont fournies, mais vous pouvez également créer les vôtres. Le tableau suivant décrit les types de transformations que vous pouvez effectuer.
| Option | Description |
|---|---|
| Majuscules | Mettre toutes les lettres en majuscules. |
| Minuscules | Mettre toutes les lettres en minuscules. |
| Casse du titre | Mettre en majuscule la première lettre de chaque mot. |
| Supprimer les espaces | Supprimer les espaces vides avant et après la valeur. |
| Sous-chaîne | Transformer une partie spécifique d'une valeur. Pour spécifier où commencer la transformation, choisissez soit une Position de départ ou de Texte de départ. La position de départ est un nombre qui représente le premier caractère à transformer. Le texte de départ est la lettre immédiatement avant la lettre à remplacer. Si vous souhaitez commencer avec la première lettre de la valeur, utilisez plutôt une position de départ. Pour spécifier où arrêter la transformation, vous choisissez soit Longueur, qui est le nombre de caractères à remplacer, soit le Texte de fin, qui est le caractère immédiatement après le dernier caractère à transformer. |
| Remplacer | Rechercher une valeur et la remplacer par une autre. Cette transformation est utile pour remplacer des valeurs simples, comme un mot particulier. |
| Expression régulière - Remplacer | Utiliser une expression régulière dans le cadre d'une opération de recherche et remplacement. Cette transformation est utile pour remplacer plusieurs valeurs ou des valeurs plus complexes. |
| Supprimer les caractères non alphanumériques | Supprimer les caractères qui ne sont pas des lettres ou des chiffres, comme les symboles ou les caractères spéciaux. |
| Mise en forme des dates | Spécifiez comment afficher les dates. Par exemple, vous pouvez transformer JJ-MM-AAAA en AAAA-MM-JJ. |
| Mise en forme des décimales | Définissez des règles pour le placement des décimales et la précision d'arrondi. |
| Expression régulière - Correspondance | Utiliser une expression régulière pour trouver une ou plusieurs valeurs. Cette règle est similaire aux Sous-chaîne et Expression régulière - Remplacer options. |
| Personnalisé | Cette règle de transformation est une option avancée qui nécessite l'assistance d'un développeur. Elle active un événement d'intégration auquel vous pouvez vous abonner si vous souhaitez utiliser votre propre code de transformation. Si vous êtes développeur et souhaitez utiliser cette option, accédez à Conseil pour les développeurs : Exemple de l'option personnalisée. |
| Mise en forme de la date et de l'heure | Définissez comment afficher la date actuelle et l'heure de la journée. |
| Recherche de champ | Utiliser des champs provenant de différentes tables. Pour l'utiliser, vous devez respecter certaines règles. Tout d'abord, utilisez ID table pour spécifier l'ID de la table qui contient l'enregistrement pour la recherche de champ. Ensuite, dans le ID du champ source champ, spécifiez l'ID du champ qui contient l'enregistrement pour la recherche de champ. Enfin, dans le ID champ cible champ, spécifiez l'ID du champ pour trouver l'enregistrement pour la recherche de champ. Vous pouvez également utiliser le Règle de recherche de champ champ pour spécifier le type de la recherche de champ. Pour la Cible champ, la valeur du ID champ cible est utilisée, même si elle est vide. Pour la Valeur d'origine si la cible est vide champ, la valeur d'origine est utilisée si la cible est vide. |
| Arrondir | Arrondissez la valeur dans ce champ en utilisant des règles supplémentaires. Tout d'abord, dans le Précision champ, spécifiez une précision d'arrondi. Ensuite, dans le Direction champ, spécifiez la direction de l'arrondi. |
Remarque
Remarque:
Pour en savoir plus sur la mise en forme de la date et de l'heure, accédez à Chaînes de format de date et d'heure standard.
Conseil pour les développeurs : Exemple de l'option personnalisée
L'exemple suivant montre comment implémenter votre propre code de transformation.
codeunit 60100 "Hello World"
{
[EventSubscriber(ObjectType::Table, Database::"Transformation Rule", 'OnTransformation', '', false, false)]
procedure OnTransformation(TransformationCode: Code[20]; InputText: Text; var OutputText: Text)
begin
if TransformationCode = 'CUST' then
OutputText := InputText + ' testing';
end;
}
Après avoir défini vos règles, vous pouvez les tester. Dans la Test Raccourci, entrez un exemple de valeur que vous souhaitez transformer, puis vérifiez les résultats en choisissant Mettre à jour.
Exporter une définition d'échange de données sous forme de fichier XML à des fins d'utilisation par d'autres
Après avoir créé la définition d'échange de données pour un fichier de données spécifique, vous pouvez exporter la définition d'échange de données sous forme de fichier XML que vous pouvez importer. Cette tâche est décrite dans la procédure suivante.
Choisissez l'onglet
icône, entrez Définitions échange de données, puis choisissez le lien associé.Sélectionnez la définition d'échange de données que vous souhaitez exporter.
Choisissez l'onglet Exporter une définition d'échange de données action.
Enregistrez le fichier XML qui représente la définition d'échange de données à un emplacement approprié.
Si une définition d'échange de données a déjà été créée, vous n'avez qu'à importer le fichier XML dans l'infrastructure d'échange de données. Cette tâche est décrite dans la procédure suivante.
Importer une définition d'échange de données existante
- Enregistrez le fichier XML qui représente la définition d'échange de données à un emplacement approprié.
- Choisissez l'onglet icône, entrez Définitions échange de données, puis choisissez le lien associé.
- Choisissez l'onglet Importer une définition d'échange de données action.
- Choisissez le fichier que vous avez enregistré à l'étape 1.
Informations connexes
Configurer l'échange de données
Configurer l'envoi et la réception de documents électroniques
Collecter des paiements par prélèvement automatique SEPA
Effectuer des paiements avec l'extension AMC Banking 365 Fundamentals ou virement crédit SEPA
Documents entrants
Fonctionnalité commerciale générale
Trouvez des modules d'apprentissage en ligne gratuits pour Business Central ici