Anveo EDI Connect / Config / Mappings / Lecture et écriture des données du tableau
This is an automatic translation. The original post is available in 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 de mappage qui sont les enfants de l’instance de table. L’indentation des lignes de la table doit donc être faite de telle sorte que toutes les lignes qui veulent accéder aux données soient des enfants de la table. Pour cela, plusieurs tables sont souvent imbriquées l’une sous l’autre pour avoir accès à tous les champs.

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

Ensuite, vous pouvez 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 de la table.

Mode

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

Read

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

Write

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

Update

Mettre à jour un enregistrement existant ou en créer un nouveau, s’il n’existe pas. Le module ne peut mettre à jour qu’un seul enregistrement à la fois, assurez-vous donc d’appliquer des filtres pour qu’au maximum un enregistrement soit trouvé. Pour mettre à jour plusieurs enregistrements, vous devez créer une boucle de table lisant les données et une deuxième instance de cette table en mode mise à jour filtrée sur la clé primaire de l’enregistrement actuellement lu.

Table

Sélectionne la table source/cible dans la 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 mappage. Le nom est utilisé pour différencier les différentes instances d’une même table. Pensez-y, comme à un nom de variable.

Data View

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

All Records

Ne pas appliquer de filtres spéciaux. Vous pouvez toujours filtrer les données avec les propriétés ci-dessous.

Post Process Record

Uniquement utilisable, si ce mappage fonctionne en post-traitement. Filtrez l’instance de la table sur l’enregistrement sur lequel le post-traitement a été défini.

Business Transaction Data

Uniquement utilisable, si ce mappage s’exécute dans une transaction commerciale. Filtre les données sur les données de l’opération commerciale (par ex. les données de job).

Named Table View

Filtre les données en fonction d’une vue de table nommée. Il peut s’agir soit d’un des noms de vue de table intégrés, soit 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’Data View est défini sur Named Table View. Vous pouvez utiliser n’importe quelle vue tableau définie par code ou l’une des vues spéciales suivantes :

TRANSMISSION

S’il y a une transmission entrante, vous pouvez y accéder avec cette vue tableau.

PROCESSINGQUEUE

Si le mappage 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 défaillante.

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 devez définir la valeur de la Data View sur Post Process Record à la place. Mais si vous mettez à jour les mappings des anciennes versions du module, vous pouvez toujours 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 d’utiliser 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.

Disponible uniquement en mode lecture. Indique si vous voulez limiter le nombre d’enregistrements qui peuvent ê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

Limiter les enregistrements au nombre spécifié.

False

Ne limitez pas le nombre d’enregistrements retournés.

Select Top

Disponible uniquement si le Limit Count est réglé sur True. Le nombre maximum d’enregistrements à utiliser.

Table View

Lecture seule. Regroupe d’autres propriétés. Le nom Table View est utilisé dans la programmation de la Microsoft Dynamics 365 Business Central pour décrire la combinaison des filtres de tri et de constantes sur une table. Nous avons utilisé ce nom pour faciliter l’utilisation du module par les programmeurs C/AL, le considérant comme un filtre constant et une valeur initiale.

Key

La 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 ne dépendent pas des données d’une autre table. Vous pouvez filtrer toutes les colonnes du tableau.

Si le Mode la table est Write, les filtres sont appliqués comme valeurs initiales à la table. Vous pouvez donc également utiliser le filtre pour spécifier certaines valeurs de colonne pour les nouveaux enregistrements.

Data Item Link

Cette propriété permet de définir la relation à une autre table. Il s’agit d’une liste de valeurs. Vous sélectionnez d’abord la colonne dans l’instance de la table actuelle, puis une autre table et des zones. Cette propriété est utilisée pour définir la relation clé étrangère.

Supposons que vous ayez une instance de table de la table EDI Document dans le mappage et qu’en tant qu’enfant vous ayez 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 :

Les colonnes spécifiées seront filtré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 la table est Write, le Data Item Link est appliqué comme valeurs initiales aux colonnes de la table. Ainsi, vous pouvez également utiliser le Data Item Link pour spécifier certaines des valeurs de colonne pour les nouveaux enregistrements.

Temporary

C’est une propriété avancée et normalement cachée.

Indique que vous souhaitez utiliser une table temporaire. Une table temporaire est plus récente et écrite dans la base de données.

Init Function

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

La propriété de la fonction d’initialisation 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 du type Codeunit ANVEDI Data Structure pointant vers un RecordRef qui contient les données initiales.

Company

C’est une propriété avancée et normalement cachée.

L’entreprise à laquelle l’enregistrement est lu / écrit. Ceci peut être utilisé pour accéder aux données d’une autre société.

Ne changez pas la compagnie sur les instances de la 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 la société S/L actuelle, de sorte que vous ne devez jamais écrire directement dans une table standard d’une société S/L différente.

TotalFields

Vous pouvez spécifier des colonnes pour lesquelles le module calculera automatiquement une somme. Vous pouvez lire les valeurs additionnées du tableau en accédant aux colonnes après la boucle du tableau et non comme une ligne enfant de la boucle du tableau.

Register Errors On Instance

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

C’est une propriété avancée et 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. C’est logique pour les tables tampons.

False

Ne pas enregistrer d’erreurs sur cette instance de table. Ceci a du sens si l’instance accède, par exemple, aux informations de la table secondaire.

Linked Documents

Il s’agit d’une propriété en lecture seule pour regrouper les propriétés enfant.

Create Linked Documents

si vous voulez créer des entrées dans la table des documents liés pour cette instance de table. Si cette valeur est True, vous pourrez naviguer de la EDI Processing Queue, de la EDI Transmission (si présente) et de la EDI Business Transaction (si présente) à cette table.

Linked Tables

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

Internal No. Display Field

Vous pouvez sélectionner la colonne qui doit être utilisée pour le numéro interne, chaque fois qu’une entrée de pièce liée est créée pour cette instance de table.

External No. Display Field

Vous pouvez sélectionner la colonne qui doit être utilisée pour le numéro externe, chaque fois qu’une entrée de pièce liée 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 le mappage terminé avec succès. Les post-traitements ne sont pas exécutés, s’il y a eu des erreurs. Vous pouvez en apprendre plus dans la section post-traitement.

Min. Repeat

Si vous entrez un numéro, le mappage affichera une erreur si la répétition minimale spécifiée n’est pas atteinte.

Min. Repeat Error Message

Le message d’erreur qui devrait être augmenté si le nombre minimal d’enregistrements n’est pas trouvé.

Max. Repeat

Si vous entrez un numéro, le mappage affichera une erreur si la répétition maximale spécifiée n’est pas atteinte.

Max. Repeat Error Message

Le message d’erreur qui devrait être augmenté si le nombre maximal d’enregistrements est dépassé.