EDI Business Transaction Type
Le type de transaction commerciale définit un cas général possible. Il peut s’agir, par exemple, d’une facture sortante ou de commandes entrantes.
Cette structure de données est également utilisée pour définir la collecte automatique de données, par exemple pour trouver toutes les nouvelles factures dans le système et déclencher des actions EDI. Le type de transaction commerciale définit également la manière dont le partenaire EDI est déterminé à partir des données commerciales.
Chaque flux de transaction est composé d’un ou de plusieurs types de transactions commerciales, utilisant différents points d’entrée du processus, qui déterminent la manière dont les données sont traitées à chaque étape. Il est essentiel de comprendre ces différents types de structure de EDI Business Transaction Type pour mettre en place des processus EDI efficaces et fiables.
Type
Incoming Transmission
Ce type est utilisé pour recevoir et importer des données de systèmes externes dans Dynamics 365 Business Central. Il constitue généralement la première étape d’une transaction et est chargé d’analyser le fichier d’entrée (par exemple, EDIFACT, XML, CSV) et d’importer les données dans une structure tampon interne.
- Exemple de cas d’utilisation: Réception de bons de commande ou de factures de partenaires commerciaux.
Data Collection
Ce type est utilisé pour extraire des données de Dynamics 365 Business Central. Il collecte les enregistrements nécessaires à partir de tables telles que les commandes de vente, les factures ou les expéditions, et les prépare pour l’exportation.
- Exemple de cas d’utilisation: Rassembler les commandes en cours pour les exporter en tant que réponses ou confirmations de commandes.
Sub-Process
Le type de sous-processus est principalement utilisé pour travailler avec des structures tampons, telles que le document EDI ou les tables tampons associées. Contrairement aux autres types d’activités qui opèrent directement sur un fichier unique (données entrantes) ou sur un enregistrement source dans Business Central (collecte de données), les activités de sous-processus opèrent généralement sur les données tampons intermédiaires.
Ce type est essentiel pour structurer et contrôler le flux de la logique de traitement dans les scénarios d’importation et d’exportation.
Principaux cas d’utilisation
- Transformation des données de la mémoire tampon: Dans les scénarios d’importation, un fichier entrant est d’abord mis en correspondance avec une structure tampon. Un sous-processus prend alors le relais pour poursuivre le traitement de la mémoire tampon. Il peut s’agir d’un traitement 1:1 de la mémoire tampon ou d’un scénario 1:n dans lequel un enregistrement entrant génère plusieurs entrées dans la mémoire tampon.
- Traitement par lots avec tolérance aux pannes: Lorsqu’un fichier unique contient plusieurs documents commerciaux (par exemple, plusieurs commandes), chaque enregistrement tampon peut être traité dans son propre sous-processus. Cela garantit qu’une défaillance dans un document ne bloque pas le traitement des autres.
- Préparation du Mapping d’exportation: Dans les flux d’exportation, le type de collecte de données rassemble des enregistrements tels que des factures de vente ou des expéditions et les prépare dans des structures tampons. Un sous-processus est ensuite utilisé pour traiter cette mémoire tampon, en transformant ou en mapping données, avant qu’elles ne soient émises au format XML, EDIFACT ou dans un autre format requis.
Depuis le mapping, l’enregistrement associé à la transaction commerciale (par exemple, un document EDI) est toujours accessible, de sorte que lorsque nous voulons modifier l’enregistrement principal en vue d’un traitement ultérieur, nous pouvons utiliser un sous-processus à cet effet.
Conventions d’appellation
Bien que vous soyez libre d’utiliser n’importe quel code, nous vous recommandons d’utiliser des conventions de dénomination cohérentes. Vous trouverez ci-dessous nos conventions, qui permettent d’identifier immédiatement l’objet de la transaction et son rôle dans la chaîne de traitement.
Le nom de chaque type de transaction commerciale suit généralement ce format :
[DOCUMENT_TYPE]_[ROLE]
Où ?
- [DOCUMENT_TYPE] décrit le document commercial traité (par exemple, ORDERS, INVOIC, DESADV).
- [ROLE] indique la fonction du sous-type dans la transaction.
Suffixes de rôle recommandés
| Suffixe | Sous-type | Description |
|---|---|---|
| _INCOMING | Incoming Transmission | Traite les fichiers entrants (par exemple, XML, EDIFACT) pour l’importation. |
| _COLLECT | Data Collection | Rassemble les données de Business Central (par exemple, les factures). |
| _PROCESSING | Sub-Process | Traite les données de la mémoire tampon (par exemple, transformation de l’importation). |
| _OUTGOING | Sub-Process | Transformation finale du tampon et mapping avant l’exportation. |
Exemples de modèles de dénomination :
- ORDERS_INCOMING
Utilisé pour importer des fichiers de bons de commande entrants dans les tables tampons. - ORDERS_PROCESSING
Préparer les données et créer des commandes clients à partir de l’enregistrement tampon créé par la transaction ORDERS_INCOMING. - INVOIC_COLLECT
Collecte les factures de vente comptabilisées et les enregistrements tampons créés. - INVOIC_OUTGOING
Met en correspondance et transforme la mémoire tampon des factures collectées dans un format EDI sortant.
Domaines
Ce champ fait partie de la clé primaire. Vous pouvez utiliser n’importe quel code. Nous recommandons un code descriptif, comme INVOICE_OUT, ORDERS_IN, etc. Voir les conventions d’appellation ci-dessus pour plus d’informations.
Ce champ définit le type de transaction commerciale. Il détermine un grand nombre des autres options disponibles.
Le processus a pour point d’entrée les données existantes dans le Microsoft Dynamics 365 Business Central Cette option vous permet de définir des tâches de collecte automatique.
(La valeur entière de cette option dans la base de données est 0)
Le processus commence par une transmission à partir d’un canal de communication.
(La valeur entière de cette option dans la base de données est 1)
Le processus est une sous-partie d’un autre processus. La Transaction Data Table ne doit pas nécessairement être la même. Cette option définit que ce type d’opération ne peut être appelé qu’en tant que sous-processus d’un autre type d’opération.
(La valeur entière de cette option dans la base de données est 2)
Indique comment traiter les entrées pour lesquelles le partenaire de communication est introuvable.
Créez des entrées dans la table des transactions commerciales et marquez-les.
(La valeur entière de cette option dans la base de données est 0)
Ne créez pas d’entrées dans la table des transactions commerciales.
(La valeur entière de cette option dans la base de données est 1)
La description du type de transaction commerciale est affichée dans la liste des types. Il peut être paramétré en plusieurs langues.
En fonction du Type, ce champ définit la table utilisée pour les enregistrements des transactions commerciales.
Ce champ enregistre l’ID de la Transaction Data Table Il ne figure pas sur la carte de transaction commerciale.
Ce champ définit le champ utilisé comme numéro de référence dans la table des transactions commerciales. Ce champ n’a aucune influence sur la logique de traitement, mais il est enregistré dans la liste des transactions commerciales et peut être utilisé pour trouver le document du point de vue de l’utilisateur final.
Il s’agit du numéro technique du champ Reference No. Field Il ne figure pas sur la carte de transaction commerciale.
L’utilisation de ce champ dépend du Process Entry Point.
Définit que le partenaire de communication pour ce EDI Business Transaction Type est trouvé par une valeur du Transaction Data Table Voir ci-dessous« Relations avec les partenaires de la communication » pour plus de détails.
Le partenaire de communication est unique pour ce EDI Business Transaction Type
Si le code du partenaire de communication est enregistré dans un champ de la Transaction Data Table, vous pouvez spécifier ce champ par le biais de cette option.
Si aucun partenaire de communication ne peut être trouvé par d’autres moyens, le partenaire défini dans ce champ sera utilisé.
Définit le champ utilisé pour trouver le partenaire de communication.
Domaine technique no. pour le champ Relation Field Name Il ne figure pas sur la carte de transaction commerciale.
Définit si vous souhaitez activer la collecte automatique des données. Sachez que vous devrez également définir une tâche qui lancera la collecte automatique. Cette option permet de définir le type de champ utilisé pour détecter les nouveaux enregistrements.
Vous ne souhaitez pas activer la collecte automatique de données.
(La valeur entière de cette option dans la base de données est 0)
Vous suivez les modifications en vous basant sur l’horodatage SQL. Cela n’est possible qu’avec Microsoft Dynamics 2013R2 et les versions plus récentes. Le BC 17 a introduit un nouveau champ système qui contient la date et l’heure de la dernière modification. Nous vous recommandons vivement d’utiliser l’option Date Field la place.
(La valeur entière de cette option dans la base de données est 1)
Vous souhaitez utiliser un champ de date.
(La valeur entière de cette option dans la base de données est 2)
Vous souhaitez utiliser un champ de code.
(La valeur entière de cette option dans la base de données est 3)
Vous souhaitez utiliser un indicateur booléen, false signifiant que les données ne sont pas encore exportées. Le champ est modifié automatiquement. Cette option ne fonctionne pas sur les tables système protégées, comme les en-têtes de factures de vente enregistrées.
(La valeur entière de cette option dans la base de données est 4)
Exportez toujours tous les enregistrements. Cela peut être utile pour exporter, par exemple, toutes les commandes en cours. Les filtres de la vue Tableau de données sont toujours appliqués, ce qui vous donne la possibilité d’utiliser des champs ou des critères personnalisés.
(La valeur entière de cette option dans la base de données est 5)
Cette option vous permet d’exporter toutes les entrées qui se situent dans un intervalle de temps spécifié, calculé par rapport à la dernière exécution du travail (et non par rapport à la date du jour). Par exemple, si vous spécifiez « 30 jours » et que vous utilisez « Date de comptabilisation » comme champ de filtrage, le module prendra en compte les entrées comptabilisées dans les 30 jours précédant le dernier cycle, telles qu’elles sont enregistrées dans le champ « Dernière valeur date/heure ».
L’exportation est filtrée pour n’inclure que les entrées pour lesquelles le champ de date sélectionné est supérieur à la « Dernière valeur date/heure » moins la période spécifiée. Il n’y a pas de filtre pour empêcher l’exportation d’entrées dont la date est supérieure à aujourd’hui.
Si l’option « Ignorer les doublons » est activée dans le groupe d’actions, le module vérifie la présence d’entrées sur l’ensemble de la période et n’exporte que celles qui n’ont pas été exportées précédemment.
(La valeur entière de cette option dans la base de données est 6)
Définit le champ utilisé pour la recherche de nouvelles entrées.
Numéro du champ technique pour le champ Change Detection Field Name. Il ne figure pas sur la carte de transaction commerciale.
Enregistre le dernier horodatage. Si la Automatic Data Collection est définie sur
SQL Timestamp, un filtre est appliqué à la table de données, recherchant uniquement les entrées dont la valeur est supérieure à celle-ci. Après l’exécution de la tâche de collecte des données, la dernière valeur est enregistrée dans ce champ.
Enregistre le dernier horodatage. Si la Automatic Data Collection est réglée sur Code Field, un filtre est appliqué au tableau de données, ne recherchant que les entrées dont la valeur est supérieure à celle-ci. Après l’exécution de la tâche de collecte des données, la dernière valeur est enregistrée dans ce champ.
Enregistre le dernier horodatage. Si la Automatic Data Collection est réglée sur Date Field, un filtre est appliqué au tableau de données, ne recherchant que les entrées dont la valeur est supérieure à celle-ci. Après l’exécution de la tâche de collecte des données, la dernière valeur est enregistrée dans ce champ.
Définit une vue de tableau qui est appliquée en plus des critères pour la collecte automatique de données.
Enregistre la date et l’heure de création de cet enregistrement.
Enregistre la date et l’heure de modification de cet enregistrement.
Communication Partner Relations
Si vous associez la recherche du partenaire de communication à un champ, vous devez configurer la relation entre les valeurs du champ et le partenaire de communication pour permettre le traitement des enregistrements de la Transaction Data Table Voici un exemple de configuration :
