Anveo EDI Connect / Config / Mappings / Lecture et écriture des données des tableaux
This is an automatic translation. The original post is available in Anglais.

Lecture et écriture des données des tableaux

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 tableaux sont souvent imbriqués les uns sous les autres pour accéder à tous les champs.

Pour lire ou écrire dans des tables à l’intérieur de la Microsoft Dynamics NAV 2013, vous devez d’abord déclarer une instance de cette table dans la mapping. Choisissez la valeur Loop dans la ligne mapping Type de propriété. Cela modifiera les propriétés disponibles et ajoutera une nouvelle propriété appelée  » Loop Type« . Sélectionnez le Table de valeurs comme Loop Type.

Ensuite, vous pouvez configurer les autres propriétés. Les propriétés suivantes sont disponibles :

Loop Type

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

Mode

Qu’il s’agisse de lire les données d’une table, d’écrire des données dans une table (créer un nouvel enregistrement) ou de 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éez un nouveau record dans le tableau. Selon le type de format, un ou plusieurs enregistrements peuvent être créés.

Update

Mettre à jour un enregistrement existant ou, éventuellement, en créer un nouveau, s’il n’existe pas. Le module ne peut mettre à jour qu’un seul enregistrement à la fois, il faut donc veiller à 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 seconde instance de cette table en mode de mise à jour filtrée sur la clé primaire de l’enregistrement actuellement lu.

Table

Sélectionne le tableau source/cible de la Microsoft Dynamics NAV 2013. Vous pouvez soit saisir le nom de la table, soit son identifiant.

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 avec les propriétés ci-dessous.

Post Process Record

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

Business Transaction Data

Uniquement utilisable, si ce mapping s’inscrit dans le cadre d’une transaction commerciale. Filtre les données sur les données relatives aux transactions commerciales (par exemple les données relatives à l’emploi).

Named Table View

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

PROCESSINGQUEUE

Si le mapping fonctionne comme un 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 de post-traitement. Vous devez plutôt régler la valeur de la Data View sur Post Process Record-processus. Mais si vous mettez à jour les cartographies des anciennes versions du module, vous pourriez 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 d’utiliser ces noms en haut de la page. Veuillez utiliser un nom de filtre parlant ou la DOUANE à la place.

Limit Count

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

Disponible uniquement en mode lecture. Précise si vous souhaitez 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

Limitez les enregistrements au nombre spécifié.

False

Ne limitez pas les dossiers retournés.

Select Top

Uniquement disponible si la valeur du Limit Count est fixée à True. Le nombre maximum de dossiers à utiliser.

Table View

En lecture seule. Regroupe d’autres propriétés. Le nom  » Table View  » est utilisé dans la programmation de Microsoft Dynamics NAV 2013 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, en le considérant comme un filtre constant et une valeur initiale.

Key

La clé qui doit être utilisée 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’un autre tableau. Vous pouvez filtrer toutes les colonnes du tableau.

Si le Mode de 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 des 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 de l’instance de table actuelle et ensuite une autre table et des champs. Cette propriété est utilisée pour définir la relation clé-écran.

Supposons que vous ayez une instance de la table EDI Document dans la 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 :

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

Cela permettra de filtrer les colonnes spécifiées à 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 appartient à l’en-tête.

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

Temporary

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

Précise que vous souhaitez utiliser une table temporaire. Une table temporaire est plus récente et inscrite 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 init n’est disponible que si la propriété Temporary est réglée 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 sur un RecordRef qui contient les données initiales.

Company

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

L’entreprise de laquelle le document est lu / écrit. Cela peut être utilisé pour accéder aux données d’une autre entreprise.

Ne changez pas les instances de l’entreprise sur 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 l’entreprise actuelle, de sorte que vous ne devez jamais écrire directement dans une table standard d’une autre entreprise.

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.

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

True

Enregistrez les erreurs sur cette table. C’est logique pour les tables tampons.

False

N’enregistrez pas d’erreurs sur cette table instance. Cela 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 de l’enfant.

Create Linked Documents

Si vous souhaitez créer des entrées dans la table des documents liés pour cette instance de table. Si vous réglez cette option sur  » True « , vous pourrez naviguer dans ce tableau à partir de la EDI Processing Queue, de la EDI Transmission DI (si elle existe) et de la EDI Business Transaction (si elle existe).

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 table à partir 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 qui doit être utilisée pour le numéro interne, chaque fois qu’une entrée de document liée est créée pour cette instance de tableau.

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 document liée est créée pour cette instance de table.

Post-Processing

Vous permet de spécifier une ou plusieurs actions qui doivent être exécutées sur chaque enregistrement de cette instance de table, après que la mapping ait été terminée avec succès. Les post-traitements ne sont pas exécutés, s’il y a eu des erreurs. Vous pouvez en savoir plus dans la section  » Post-traitements « .

Min. Repeat

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

Min. Repeat Error Message

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

Max. Repeat

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

Max. Repeat Error Message

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