Anveo EDI Connect / Config / Mappings / Lecture et écriture des données du tableau
C'est une traduction automatique. Le message original est disponible en Anglais.

Lecture et écriture des données du tableau

Il est important de noter que vous ne pouvez accéder aux colonnes de cette instance de table qu’à partir des lignes mapping qui sont des enfants de l’instance de table. L’indentation des lignes du tableau doit donc être faite de manière à ce que toutes les lignes qui veulent accéder aux données soient des enfants du tableau. À cette fin, plusieurs tables sont souvent imbriquées les unes dans les autres pour permettre l’accès à tous les champs.

Pour lire ou écrire dans des tables à l’intérieur de Microsoft Dynamics 365 Business Central, vous devez d’abord déclarer une instance de cette table dans le mapping. Choisissez la valeur Loop dans la propriété Type ligne de mapping. Cette opération modifie les propriétés disponibles et ajoute une nouvelle propriété appelée Loop Type. Sélectionnez la valeur Table comme Loop Type.

Vous pouvez ensuite configurer les autres propriétés. Les propriétés suivantes sont disponibles :

Loop Type

Le type de la boucle. Sélectionnez la valeur Table pour accéder aux données du tableau.

Mode

Lire les données d’une table, écrire des données dans une table (créer un nouvel enregistrement) ou mettre à jour des données existantes.

Read

Lire les données existantes. Les données peuvent être filtrées. Il est possible d’appliquer des filtres, de sorte qu’aucun enregistrement ne soit trouvé.

Write

Créer un nouvel enregistrement dans la table. Selon le type de format, un ou plusieurs enregistrements peuvent être créés.

Update

Mise à jour d’un enregistrement existant ou, éventuellement, création d’un nouvel enregistrement s’il n’existe pas. Le module ne peut mettre à jour qu’un seul enregistrement à la fois. Veillez donc à appliquer des filtres de manière à ce qu’un enregistrement au maximum soit trouvé. Pour mettre à jour plusieurs enregistrements, vous devez créer une boucle de table qui lit les données et une deuxième instance de cette table en mode mise à jour, filtrée sur la clé primaire de l’enregistrement en cours de lecture.

Table

Sélectionne la table source/cible à partir de Microsoft Dynamics 365 Business Central. Vous pouvez saisir le nom de la table ou son ID.

Name

Le nom de cette instance de table dans le mapping. Le nom est utilisé pour différencier les différentes instances d’un même tableau. Pensez-y comme à un nom de variable.

Data View

Cette propriété est nouvelle dans la version 4.00 du module.

All Records

N’appliquez pas de filtres spéciaux. Vous pouvez toujours filtrer les données à l’aide des propriétés ci-dessous.

Post Process Record

Utilisable uniquement si ce mapping est exécuté en post-traitement. Filtrer l’instance de table sur l’enregistrement sur lequel le post-traitement a été défini.

Business Transaction Data

Utilisable uniquement si ce mapping est exécuté dans le cadre d’une transaction commerciale. Filtre les données vers les données de la transaction commerciale (par ex. les données relatives à l’emploi).

Named Table View

Filtre les données en fonction d’une vue de table nommée. Il peut s’agir d’un des noms de vue de table intégrés ou d’une vue de table définie par programmation. Une nouvelle propriété sera disponible pour sélectionner le nom.

Table View Name

Cette propriété n’est disponible que si l’option Data View est définie sur Named Named Table View. Vous pouvez utiliser n’importe quelle vue de table définie par le code, ou l’une des vues spéciales suivantes :

TRANSMISSION

S’il y a une transmission entrante, vous pouvez y accéder à l’aide de cette vue en tableau.

PROCESSINGQUEUE

Si le mapping est exécuté en tant que gestionnaire d’erreurs, vous pouvez utiliser ce filtre pour accéder à l’entrée de la file d’attente de traitement qui a échoué.

POST_PROCESS_REC
DEFAULT

Ces noms de filtres sont généralement utilisés par le module pour stocker des informations sur l’enregistrement post-traitement. Vous devriez plutôt définir la valeur de la Data View sur Post Process Record. Mais si vous mettez à jour des mappings à partir d’anciennes versions du module, vous pouvez encore trouver ces valeurs, qui fonctionneront toujours.

Les noms peuvent également être définis à partir d’un code personnalisé et contenir n’importe quel filtre. Nous ne recommandons plus l’utilisation de ces noms. Veuillez utiliser un nom de filtre parlant ou CUSTOM à la place.

Limit Count

Cette propriété est nouvelle dans Anveo EDI Connect 4.00.

Uniquement disponible en mode lecture. Indique si vous souhaitez limiter le nombre d’enregistrements pouvant être trouvés. Peut être utilisé pour sélectionner uniquement le premier ou le dernier enregistrement en combinaison avec la propriété de tri.

True

Limite les enregistrements au nombre spécifié.

False

Ne pas limiter les enregistrements renvoyés.

Select Top

Uniquement disponible si le Limit Count est fixé à True. Le nombre maximum d’enregistrements à utiliser.

Table View

En lecture seule. Regroupe d’autres propriétés. Le nom Table View est utilisé dans la programmation Microsoft Dynamics 365 Business Central pour décrire la combinaison du tri et des filtres constants sur un tableau. Nous avons utilisé ce nom pour faciliter l’utilisation du module par les programmeurs C/AL. Pensez aux filtres constants et à la valeur initiale.

Key

Clé à utiliser pour le tri. Peut être vide.

Order

L’ordre dans lequel la clé est appliquée. La valeur par défaut est Ascending.

Filter

Les filtres qui sont constants ou, en d’autres termes, qui ne dépendent pas des données d’une autre table. Vous pouvez filtrer toutes les colonnes du tableau.

Si le Mode du tableau est Write, les filtres sont appliqués en tant que valeurs initiales au tableau. Vous pouvez donc également utiliser le filtre pour spécifier certaines valeurs de colonne pour les nouveaux enregistrements.

Data Item Link

Cette propriété est utilisée pour définir la relation avec une autre table. Il s’agit d’une liste de valeurs. Vous sélectionnez d’abord la colonne dans l’instance de table actuelle, puis dans une autre table et dans d’autres champs. Cette propriété est utilisée pour définir la relation entre les clés étrangères.

Supposons que vous ayez une instance de la table EDI Document dans le mapping et comme enfant une instance de la table EDI Document Line. Pour spécifier que la ligne appartient au document d’en-tête, vous définissez le Data Item Link comme suit :

"Document Type"="EDI Document"."Document Type", "Document No."="EDI Document"."No.", "Document Version No."="EDI Document"."Version No."

Cela permet de filtrer les colonnes spécifiées en fonction de la valeur du document d’en-tête. En mode lecture, vous n’obtiendrez que les lignes appartenant au document. En mode écriture, les colonnes seront remplies avec les données du document, de sorte que la ligne appartienne à l’en-tête.

Si le Mode du tableau est l’Write, le Data Item Link est appliqué comme valeurs initiales aux colonnes du tableau. Vous pouvez donc également utiliser le Data Item Link pour spécifier certaines valeurs de colonne pour les nouveaux enregistrements.

Temporary

Il s’agit d’une propriété avancée qui est normalement cachée.

Indique que vous souhaitez utiliser une table temporaire. Une nouvelle table temporaire est écrite dans la base de données.

Init Function

Cette propriété est nouvelle dans Anveo EDI Connect 4.00.

La propriété « init function » n’est disponible que si la propriété  » Temporary est définie sur True« . Cette fonction est utilisée pour remplir la table temporaire lorsqu’elle est initialisée.

Object

Le nom de l’objet sur lequel la fonction est définie.

Property/Function

Le nom de la fonction. La fonction doit renvoyer un objet de type Codeunit ANVEDI Variant pointant vers un RecordRef contenant les données initiales.

Company

Il s’agit d’une propriété avancée qui est normalement cachée.

La société dans laquelle l’enregistrement est lu ou écrit. Il peut être utilisé pour accéder aux données d’une autre entreprise.

Ne modifiez pas la société sur les instances de table en mode écriture, sauf si vous savez ce que vous faites. Tous les déclencheurs sont exécutés en fonction des données de l’entreprise actuelle, de sorte que vous ne devez jamais écrire directement dans une table standard d’une autre entreprise.

TotalFields

Cette propriété n’est disponible que pour les tables en mode lecture. Vous pouvez spécifier des colonnes pour lesquelles le module calculera automatiquement un agrégat, tel qu’une somme. Vous pouvez lire la valeur agrégée du tableau en accédant à la colonne après la ligne de tableau, mais pas en tant que ligne fille de la boucle de tableau.

Les fonctions d’agrégation suivantes sont disponibles :

Sum

Pour les champs numériques uniquement. Le résultat est la somme des valeurs individuelles. Peut être utilisé pour calculer le montant du document en fonction du montant de la ligne, etc.

Min

Pour les champs numériques uniquement. Le plus petit nombre.

Max

Pour les champs numériques uniquement. Le plus grand nombre.

First

La valeur du premier enregistrement trouvé.

Last

La valeur du dernier enregistrement lu.

Conseil : vous pouvez utiliser cette fonctionnalité pour les tableaux de configuration. Placez-les en haut de la mapping et définissez des agrégats « First » pour les champs que vous souhaitez utiliser dans la mapping. Vous pouvez maintenant accéder aux propriétés n’importe où sous cette ligne dans le mapping sans avoir à tout indenter.

Register Errors On Instance

Cette propriété est nouvelle dans Anveo EDI Connect 4.00.

Il s’agit d’une propriété avancée qui est normalement cachée. Si vous voulez enregistrer automatiquement les erreurs après cette ligne dans cette instance de table.

True

Enregistrer les erreurs sur cette instance de table. Cela est utile pour les tables tampons.

False

N’enregistrez pas d’erreurs sur cette instance de table. Cela a du sens si l’instance accède, par exemple, à des informations sur les tables secondaires.

Linked Documents

Il s’agit d’une propriété en lecture seule permettant de regrouper les propriétés enfants.

Create Linked Documents

Indique si vous souhaitez créer des entrées dans la table des documents liés pour cette instance de table. La valeur True vous permettra de naviguer de la EDI Processing Queue, de la EDI Transmission (le cas échéant) et de la EDI Business Transaction (le cas échéant) vers ce tableau.

Linked Tables

Cette propriété n’est disponible que si l’option Create Linked Documents est réglée sur True. Vous pouvez spécifier d’autres instances de tables de ce mapping qui doivent être liées à l’instance de table actuelle. Cela vous permet, par exemple, sur le EDI Document, de naviguer vers d’autres documents liés, comme un en-tête de vente créé.

Internal No. Display Field

Vous pouvez sélectionner la colonne à utiliser pour le numéro interne, chaque fois qu’une entrée de document lié est créée pour cette instance de table.

External No. Display Field

Vous pouvez sélectionner la colonne à utiliser pour le numéro externe, chaque fois qu’une entrée de document lié est créée pour cette instance de table.

Post-Processing

Permet de spécifier une ou plusieurs actions qui doivent être exécutées sur chaque enregistrement de cette instance de table, une fois que le mapping a été terminé avec succès. Les post-traitements ne sont pas exécutés s’il y a eu des erreurs. Pour en savoir plus, consultez la section sur les post-traitements.

Min. Repeat

Si vous entrez un nombre, le mapping émettra une erreur si la répétition minimale spécifiée n’est pas atteinte.

Min. Repeat Error Message

Le message d’erreur à afficher si le nombre minimal d’enregistrements n’est pas trouvé.

Max. Repeat

Si vous saisissez un nombre, le mapping émettra une erreur si la répétition maximale spécifiée n’est pas atteinte.

Max. Repeat Error Message

Le message d’erreur à afficher si le nombre maximal d’enregistrements est dépassé.