Ajout de fonctoids Bouclage de table et Extracteur de table à un mappage
Les fonctoids Bouclage detable et Extracteur de table sont utilisés ensemble. Le fonctoid Bouclage de table a une table interne que vous configurez. Pour chaque enregistrement ou champ d’entrée, le fonctoid Bouclage de table génère les lignes de la table, une par une. Le fonctoid Extracteur de table extrait l’élément souhaité d’une ligne et le transmet au message de sortie instance.
Pour plus d’informations conceptuelles sur les fonctoids Bouclage de table et Extracteur de table , consultez Fonctoids Bouclage de table et Extracteur de table.
Pour ajouter les fonctoids Bouclage de table et Extracteur de table à un mappage et les configurer
Une fois la boîte à outils Visual Studio active, cliquez sur l’onglet Fonctoids avancés pour sélectionner cette catégorie de fonctoids.
La liste de fonctoids de la catégorie choisie s'affiche.
Faites glisser le fonctoid Bouclage de table (
) de la boîte à outils à l’emplacement approprié sur une page de grille.Notes
Le fonctoid sera placé sur la page de grille affichée. Si vous souhaitez placer le fonctoid sur une autre page de grille, vous devez d’abord afficher cette page de grille.
Notes
Étant donné que la sortie du fonctoid Bouclage de table sert d’entrée à un ou plusieurs fonctoids Extracteur de table associés, veillez à laisser de l’espace à droite du fonctoid Table Looping pour les fonctoids Extractor de table.
Faites glisser un enregistrement ou un champ du schéma source vers le fonctoid Bouclage de table nouvellement ajouté. En tant que premier paramètre d’entrée du fonctoid Bouclage de table, le nombre d’occurrences de cet enregistrement ou champ dans un message instance contrôle le nombre de fois où ce fonctoid produit une sortie. Par exemple, si un enregistrement de bouclage est déplacé vers le fonctoid et qu’un message instance contenant 10 occurrences de cet enregistrement est traité et que la grille de table a été configurée avec une ligne de sources de données de colonne, le fonctoid Boucle de table itérera 10 fois, produisant 10 lignes de sortie à extraire par un fonctoid Extractor de table, et permettant à 10 enregistrements de destination d’être facilement construits.
Notes
Si vous configurez plusieurs lignes dans la grille de table, chacune de ces lignes sera générée pour chaque itération du fonctoid Bouclage de table. Par conséquent, le nombre d’occurrences d’un enregistrement d’entrée multiplié par le nombre de lignes configurées dans la grille de table donne le nombre de lignes de table de sortie disponibles pour l'extraction de données.
Faites glisser un enregistrement ou un champ du schéma de destination vers le fonctoid Bouclage de table. Ce lien permet de s’assurer que le nœud est créé dans le schéma de destination.
Sélectionnez le fonctoid Bouclage de table nouvellement ajouté et, dans la fenêtre Propriétés , cliquez sur le bouton de sélection (...) associé à sa propriété Paramètres d’entrée .
Notes
Vous pouvez également sélectionner le fonctoid, puis appuyer sur les touches CTRL+M, CTRL+T. Pour obtenir la liste des raccourcis clavier du mappeur , consultez Raccourcis clavier du mappeur BizTalk.
Dans la boîte de dialogue Configurer le fonctoid bouclage de table, cliquez sur le bouton
pour créer le deuxième paramètre d’entrée. Tapez un nombre qui représente le nombre de colonnes disponibles dans la table que vous créez pour ce fonctoid Bouclage de table .Notes
Le nombre maximal de colonnes dans la table est de 228.
Dans la boîte de dialogue Configurer le fonctoid bouclage de table, cliquez sur le bouton
pour entrer les valeurs constantes qui apparaissent dans la grille de votre table configurée. L’ordre dans lequel vous créez ces constantes n’est pas important dans cette boîte de dialogue, tant que les premier et second paramètres, le nombre de lignes et de colonnes, respectivement, gardent leur position au début de la liste des paramètres d’entrée. Lorsque vous avez terminé, cliquez sur OK.La boîte de dialogue Configurer le fonctoid bouclage de table se ferme.
Faites glisser zéro ou plusieurs nœuds d’enregistrement ou de champ du schéma source vers le fonctoid Bouclage de table que vous avez récemment ajouté. Chacun de ces nœuds d’enregistrement et de champ est ajouté à la fin de la liste des paramètres d’entrée et sera par conséquent disponible lorsque la grille de table sera configurée dans une prochaine étape. À l’instar des constantes de données de table ajoutées précédemment (pas les constantes de nombre de colonne et de ligne), l’ordre dans lequel ces nœuds d’enregistrement et de champ sont ajoutés n’est pas important.
Pour attribuer une étiquette à un lien, effectuez la procédure ci-dessous :
Sélectionnez un lien dans la page de grille affichée.
Dans le Fenêtre Propriétés Visual Studio, fournissez un nom descriptif pour la propriété Label. Par exemple, vous pouvez donner le nom « link2ndAuthor » à un lien issu d'un champ appelé « Second Author ».
Sélectionnez le fonctoid Table Looping nouvellement ajouté et, dans la fenêtre Propriétés , cliquez sur le bouton de sélection (...) associé à la propriété Table Looping Grid associée à ce fonctoid.
La boîte de dialogue Configurer le fonctoid Bouclage de table s’affiche avec l’onglet Grille de boucle de table sélectionné.
Notes
Vous pouvez également cliquer avec le bouton droit sur le fonctoid, puis cliquer sur Configurer la grille de bouclage de table dans le menu contextuel. La boîte de dialogue Configurer le fonctoid Bouclage de table s’affiche avec l’onglet Grille de boucle de table sélectionné.
Utilisez les listes déroulantes associées à chaque cellule de table pour configurer au moins une ligne de la grille, éventuellement plus. Les choix disponibles dans les listes déroulantes sont les constantes et les liens que vous avez configurés aux étapes 6 à 8 en tant que paramètres d’entrée 3 et jusqu’au fonctoid Bouclage de table . (Les paramètres d’entrée 1 et 2 n’apparaissent pas dans ces listes déroulantes.) Lorsque vous avez terminé, cliquez sur OK.
La boîte de dialogue Configurer le fonctoid bouclage de table se ferme.
Notes
Chaque ligne constitue une itération de la structure de sortie, en combinaison avec le nombre d’occurrences de l’enregistrement ou du champ spécifié comme premier paramètre d’entrée du fonctoid Table Looping . Pour plus d’informations, consultez l’étape 3.
Notes
Vous devez sélectionner une valeur pour chaque colonne à laquelle vous avez l’intention d’accéder à l’aide d’un fonctoid Extracteur de table . Si une colonne n’est pas utilisée par un fonctoid Extracteur de table , vous devez envisager de supprimer cette colonne, plutôt que de la conserver.
Notes
L’ordre de remplissage de la grille de table est sans importance.
Faites glisser autant de fonctoids Extractor de table (
) à partir de la boîte à outils vers la page de grille affichée si nécessaire.Notes
Étant donné que l’entrée de ces fonctoids Extractor de table provient du fonctoid Bouclage de table ajouté à l’étape précédente, veillez à placer les fonctoids Extractor de table à droite du fonctoid Bouclage de table dans la page de grille affichée.
Pour créer le premier paramètre d’entrée pour l’un des fonctoids Extractor de table ajoutés à l’étape 9, faites-le glisser vers le fonctoid Bouclage de table approprié vers sa gauche.
Pour créer le deuxième paramètre d’entrée pour le même fonctoid Extracteur de table , sélectionnez le fonctoid et, dans la fenêtre Propriétés , cliquez sur le bouton de sélection (...) associé à sa propriété Paramètres d’entrée .
La boîte de dialogue Configurer le fonctoid extracteur de table s’affiche .
Cliquez sur le bouton
pour créer le deuxième paramètre d’entrée. Tapez le numéro de la colonne dans la grille de table du fonctoid Bouclage de table correspondant à partir duquel vous souhaitez extraire les données. Cliquez sur OK.La boîte de dialogue Configurer le fonctoid extracteur de table se ferme.
Notes
Les numéros de colonne commencent à 1.
Pour utiliser la sortie du fonctoid Extractor de table, faites glisser le fonctoid Extractor de table vers un nœud d’enregistrement ou de champ dans le schéma de destination, ou faites glisser un nœud d’enregistrement ou de champ dans le schéma de destination vers le fonctoid Extracteur de table . La valeur d’élément ou d’attribut du message d’instance de destination correspondant à ce nœud d’enregistrement ou de champ dans le schéma de destination est renseignée par la valeur issue de (dans le cas de constantes), ou indiquée par (dans le cas de liens), la cellule spécifiée dans la grille de table.
Répétez les étapes 12, 13, 14 et 15 pour chacun des fonctoids Extractor de table ajoutés à l’étape 11.