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 NAV 2015, 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 :
Le type de la boucle. Sélectionnez la valeur Table pour accéder aux données du tableau.
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.
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é.
Créer un nouvel enregistrement dans la table. Selon le type de format, un ou plusieurs enregistrements peuvent être créés.
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.
Sélectionne la table source/cible à partir de Microsoft Dynamics NAV 2015. Vous pouvez saisir le nom de la table ou son ID.
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.
Cette propriété est nouvelle dans la version 4.00 du module.
N’appliquez pas de filtres spéciaux. Vous pouvez toujours filtrer les données à l’aide des propriétés ci-dessous.
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.
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).
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.
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 :
S’il y a une transmission entrante, vous pouvez y accéder à l’aide de cette vue en tableau.
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é.
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.
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.
Limite les enregistrements au nombre spécifié.
Ne pas limiter les enregistrements renvoyés.
Uniquement disponible si le Limit Count est fixé à True. Le nombre maximum d’enregistrements à utiliser.
En lecture seule. Regroupe d’autres propriétés. Le nom Table View est utilisé dans la programmation Microsoft Dynamics NAV 2015 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.
Clé à utiliser pour le tri. Peut être vide.
L’ordre dans lequel la clé est appliquée. La valeur par défaut est Ascending.
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.
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 :
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.
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.
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.
Le nom de l’objet sur lequel la fonction est définie.
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.
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.
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 :
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.
Pour les champs numériques uniquement. Le plus petit nombre.
Pour les champs numériques uniquement. Le plus grand nombre.
La valeur du premier enregistrement trouvé.
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.
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.
Enregistrer les erreurs sur cette instance de table. Cela est utile pour les tables tampons.
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.
Il s’agit d’une propriété en lecture seule permettant de regrouper les propriétés enfants.
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.
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éé.
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.
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.
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.
Si vous entrez un nombre, le mapping émettra une erreur si la répétition minimale spécifiée n’est pas atteinte.
Le message d’erreur à afficher si le nombre minimal d’enregistrements n’est pas trouvé.
Si vous saisissez un nombre, le mapping émettra une erreur si la répétition maximale spécifiée n’est pas atteinte.
Le message d’erreur à afficher si le nombre maximal d’enregistrements est dépassé.