Correspondances de données
Principe
Dans un modèle d’échange de données, il est possible d’appliquer des correspondances de données.
Une correspondance de données permet d’effectuer un transcodage de valeur, en requêtant une ou plusieurs tables à partir d’un ou plusieurs arguments et en définissant le champs dont la valeur doit être appliquée.
Par exemple, une correspondance de données permettra :
- de rechercher le compte général de vente ou d’achat correspondant à un groupe de comptabilisation marché et un groupe de comptabilisation produit,
- de rechercher un code article sur la base de son code EAN,
- …
Paramétrer les correspondances de données
Ces correspondances peuvent être paramétrées dans le menu suivant :
- Choisissez l'icône
, saisissez Correspondances données , puis sélectionnez le lien associé. - Renseignez les champs selon vos besoins.
Pour une correspondance de données, les champs suivants doivent être définis :
En-tête
| Nom du champs | Description |
|---|---|
| Code | Code identifiant la correspondance de données. |
| Désignation | Descriptif succinct de la correspondance de données. |
| Si valeur non trouvée | Permet de définir le comportement du système si, lors de son exécution, la correspondance ne permet pas de trouver une valeur : * Erreur : le système émet une erreur bloquante. * Appliquer valeur vide : le système retourne une valeur vide. * Appliquer valeur origine : le système retourne la même valeur que la valeur d’origine. |
Lignes
Les lignes permettent de définir la ou les tables dans lesquelles la recherche va être effectuée.
Les informations suivantes doivent être renseignées :
| Champs | Description |
|---|---|
| N° table | N° de la table dans laquelle la requête est effectuée. |
| N° champ cible | N° du champ dont la valeur sera retournée lors de l’utilisation de la correspondance. |
| N° index clé | Identifiant de la clé qui sera utilisée lors de la requête. Il est important de sélectionner une clé adéquate en prenant en compte les champs sur lesquels des filtres sont appliqués. |
| Méthode recherche | Permet de définir le comportement du système si plusieurs enregistrements cible sont identifiés. * Premier : applique les valeurs du premier enregistrement. * Dernier : applique les valeurs du dernier enregistrement. |
| N° ligne liée | Permet de sélectionner une ligne de la correspondance de référence, afin d’effectuer une recherche sur plusieurs tables. |
Les informations suivantes sont affichées à titre informatif :
| Champs | Description |
|---|---|
| Nom table | Nom de la table sélectionnée dans le champ N° table. |
| Nom champ cible | Nom du champ sélectionné dans le champ N° champ cible. |
| Clé | Contenu de la clé sélectionnée dans le champ N° index clé. |
| Filtre ligne | Affiche Oui ou Non selon l’existence de lignes de filtres pour la ligne en cours. |
| N° ligne | Numéro affecté automatiquement aux lignes qui sont créées. |
Si on souhaite effectuer une recherche sur plusieurs tables, il est possible de créer autant de ligne que nécessaire dans la fiche. Ces lignes « filles » devront faire référence à leur ligne « mère », en utilisant le champ N° ligne liée. Les champs à utiliser pour lier les enregistrements entre eux sont définis dans la table des filtres.
Filtres
Pour que la correspondance puisse donner un résultat, il est nécessaire d’appliquer des filtres sur les données. Ces filtres peuvent être définis pour une ligne de correspondance, à partir de l'action Gérer / Filtres disponible à partir des lignes.
Dans la page qui s'ouvre, les champs suivants doivent être renseignés :
| Champs | Description |
|---|---|
| N° champ | Numéro du champ de la table d’origine sur lequel le filtre sera positionné. |
| Type liaison | Permet de définir le filtre devant être appliqué au champ sélectionné : * Filtre : indique que le filtre appliqué sera une valeur fixe, construite à partir du champ Valeur filtre. * Champ : indique que le filtre appliqué sera la valeur d’un champ situé dans la table liée. Le champ dont la valeur sera appliquée doit être défini dans le champ N° champ lié. |
| Valeur filtre | Permet de définir la valeur du filtre à appliquer. Pour cela, le système passe par des codes particuliers afin de définir cette valeur : * %SRCVL%[X] : correspond aux valeurs d’argument qui sont passées à la correspondance. Le « X » correspond au numéro de l’argument. * %CMPNM% : permet d’appliquer le nom de la société comme valeur de filtre. * %USRID% : permet d’appliquer l’identifiant de l’utilisateur comme valeur de filtre. * %DMPCD% : permet d’appliquer le code de la correspondance de données comme valeur de filtre. Ce champ doit être paramétré si le champ Type liaison est paramétré à la valeur Filtre. |
| N° champ lié | Permet de définir le numéro du champ de la table liée dont la valeur doit être appliquée comme filtre. Ce champ doit être paramétré si le champ Type liaison est paramétré à la valeur Champ. |
Les informations suivantes sont affichées à titre informatif :
| Champs | Description |
|---|---|
| N° table | Numéro de la table sur laquelle le filtre sera positionné. Il ne peut être modifié. |
| N° table liée | Numéro de la table liée à la ligne d’origine. |
| Nom champ | Affiche le nom du champ sélectionné dans le champ N° champ. |
| Nom champ lié | Affiche le nom du champ sélectionné dans le champ N° champ lié. |
Correspondance générique
Il est possible de mettre en œuvre dans le module une correspondance générique, c'est à dire une correspondance de données qui ne se base par sur les données de Business Central, mais sur une table de correspondance générique.
Le module prévoit une table de correspondance avec une cardinalité de données simple (1 valeur d'origine pour 1 valeur de destination).
Pour créer une correspondance de données générique, il faut effectuer les paramétrages suivants :
- Utiliser comme table de recherche la table 8062738.
- Appliquer sur le champ Code correspondance donnée un filtre en utilisant le code %DMPCD%.
- Appliquer sur le champ Valeur d'origine un filtre en appliquant l'argument passé en paramètre.
Le contenu de la table de correspondance peut être mis à jour depuis la fiche de correspondance. Pour cela :
- Depuis la fiche de la correspondance, sélectionnez l'action Données dans le bandeau d'action.
- La page Valeur correspondance données s'ouvre.
- Renseignez les valeurs d'origine et leur valeur de destination.
Tester une correspondance de données
Il est possible de tester une correspondance de données. Pour cela, depuis la fiche :
- Depuis la fiche de la correspondance à tester, sélectionnez l'action Tester dans le bandeau d'action.
- La page Test correspondance données s'ouvre.
- Renseignez dans la partie Données origine la valeur des arguments à passer.
- Sélectionnez l'action Lancer le test.
- Le champ Donnée destination dans la partie Données destination doit retourner la valeur attendue.
Exploiter une correspondance de données
Les correspondances de données peuvent être exploitées exclusivement dans la modèles d'échange de données.
Voir aussi
Aperçu du module d'échange de document
Gestion des flux inter-sociétés
Gestion des interfaces
Correspondances de données
Modèles d'échange de documents
Documents échangés
Exécution des échanges de documents
Utilisation de Business Central