Fonctoid Nombre d’enregistrements

Le fonctoid Nombre d’enregistrements compte des enregistrements dans le message d’entrée instance.

Le fonctoid Nombre d’enregistrements a une entrée et une sortie. L’entrée est un lien dans l’enregistrement de boucle du schéma source. La sortie du fonctoid Nombre d’enregistrements correspond au nombre d’enregistrements en boucle dans un message d’entrée instance réel.

Les enregistrements de boucle correspondent à des éléments qui se répètent un nombre imprévisible de fois dans un message d’instance d’entrée. Par exemple, dans un bon de commande, l’élément Item peut se produire plusieurs fois. De plus, l’élément Item peut inclure des produits, des descriptions, des prix et des quantités. Le code suivant est un exemple simplifié d'un bon de commande de ce type.

<ns0:PurchaseOrder xmlns:ns0="http://RecordFunctoid.PurchaseOrder">  
    <From>Kevin F. Browne</From>  
    <To>Northwind Traders</To>  
    <LineItems>  
        <Item>  
            <Product>Laptop Computer</Product>  
            <Description>Thin profile laptop</Description>  
            <Price>1999.95</Price>  
            <Quantity>1</Quantity>  
        </Item>  
        <Item>  
            <Product>Monitor Swipes</Product>  
            <Description>Disposable monitor swipes</Description>  
            <Price>3.95</Price>  
            <Quantity>10</Quantity>  
        </Item>  
    </LineItems>  
</ns0:PurchaseOrder>  

La propriété Max Occurs de l’enregistrement Item est définie comme non liée. Cela indique que l’enregistrement Item boucle et que le mappeur BizTalk compile cet enregistrement sous forme de boucle.

Supposons que vous souhaitiez rechercher le nombre total d’éléments Item dans l’entrée de bon de commande instance message et placer le résultat dans un champ dans le message instance de sortie.

La figure suivante montre un fonctoid Nombre d’enregistrements qui compte le nombre d’éléments d’un bon de commande entrant et place cette valeur dans le champ ItemCount dans le message de sortie SummedPO instance.

Mappage du fonctoid Nombre d'enregistrements

Notez que la propriété Max Occurs de l’enregistrement Item ne serait pas liée. Cela indique que l’enregistrement Item boucle et que le mappeur BizTalk compile cet enregistrement sous forme de boucle.

Pour l’exemple précédent d’instance message de bon de commande contenant deux éléments Item, la valeur du champ ItemCount est définie sur 2.

<ns0:SummedPO xmlns:ns0="http://RecordCountFunctoid.SummedPO">  
    <From>Kevin F. Browne</From>  
    <To>Northwind Traders</To>  
    <POTotal>2039.45</POTotal>  
    <ItemCount>2</ItemCount>  
</ns0:SummedPO>  

Notes

Vous pouvez également utiliser le fonctoid Nombre d’enregistrements pour compter les éléments de champ répétés. Il ne se limite pas aux enregistrements.

Voir aussi

Ajout de fonctoids Nombre d'enregistrements à un mappage
Fonctoids avancés
Fonctoid Index
Fonctoid Itération
Fonctoid Bouclage