Procédure : configurer un conteneur de boucles Foreach

Cette procédure décrit comment configurer un conteneur de boucles Foreach, notamment les expressions de la propriété au niveau de l'énumérateur et du conteneur.

Pour configurer le conteneur de boucles Foreach

1. Dans Business Intelligence Development Studio, ouvrez le projet Integration Services contenant le package qui vous intéresse.

2. Cliquez sur l'onglet Flux de contrôle, puis double-cliquez sur la boucle Foreach.

3. Dans la boîte de dialogue Éditeur de boucle Foreach, cliquez sur Général, puis si vous le souhaitez, modifiez le nom et la description de la boucle Foreach.

4. Cliquez sur Collection, puis sélectionnez un type d'énumérateur dans la liste Énumérateur.

5. Indiquez un énumérateur et définissez ses options de la manière suivante :

   • Pour utiliser l'énumérateur de fichier Foreach, indiquez le dossier contenant les fichiers à énumérer, spécifiez un filtre pour le nom et le type de fichier et indiquez si le nom de fichier complet doit être renvoyé. Indiquez enfin si les fichiers des sous-dossiers doivent également être énumérés.
   • Pour utiliser l'énumérateur Foreach Item, cliquez sur Colonnes, puis dans la boîte de dialogue Colonnes For Each Item, cliquez sur Ajouter pour ajouter des colonnes. Sélectionnez un type de données dans la liste Type de données de chaque colonne, puis cliquez sur OK.
     Tapez des valeurs dans les colonnes ou sélectionnez des valeurs dans les listes.

     Remarque :
     Pour ajouter une nouvelle ligne, cliquez n'importe où en dehors de la cellule dans laquelle vous avez tapé une valeur.

     Remarque :
     Si une valeur n'est pas compatible avec le type de données de la colonne, le texte apparaît en rouge.

   • Pour utiliser l'énumérateur Foreach ADO, sélectionnez une variable existante ou cliquez sur Nouvelle variable dans la liste Variable source de l'objet ADO pour spécifier la variable contenant le nom de l'objet ADO à énumérer et sélectionnez une option de mode d'énumération.
     Si vous créez une variable, définissez ses propriétés dans la boîte de dialogue Ajouter une variable.
   • Pour utiliser l'énumérateur Foreach ADO.NET Schema Rowset, sélectionnez une connexion ADO.NET existante ou cliquez sur Nouvelle connexion dans la liste Connexion, puis sélectionnez un schéma.
     Si vous le souhaitez, cliquez sur Restrictions et sélectionnez des restrictions de schéma, sélectionnez la variable contenant la valeur de restriction ou tapez cette valeur, puis cliquez sur OK.
   • Pour utiliser l'énumérateur Foreach From Variable, sélectionnez une variable dans la liste Variable.
   • Pour utiliser l'énumérateur Foreach NodeList, cliquez sur DocumentSourceType, puis sélectionnez le type de source dans la liste et cliquez sur DocumentSource.. En fonction de la valeur sélectionnée pour DocumentSourceType, sélectionnez une variable ou une connexion de fichier dans la liste, créez une variable ou une connexion de fichier ou tapez la source XML dans l'Éditeur de source de document.
     Cliquez ensuite sur EnumerationType, puis sélectionnez un type d'énumération dans la liste. Si la valeur de EnumerationType est définie sur Navigator, Node ou NodeText, cliquez sur OuterXPathStringSourceType et sélectionnez le type de source, puis cliquez sur OuterXPathString.. En fonction de la valeur définie pour OuterXPathStringSourceType, sélectionnez une variable ou une connexion de fichier dans la liste, créez une variable ou une connexion de fichier ou tapez la chaîne de l'expression XPath (XML Path Language) externe.
     Si EnumerationType a pour valeur ElementCollection, définissez OuterXPathStringSourceType et OuterXPathString comme décrit plus haut. Cliquez ensuite sur InnerElementType, sélectionnez un type d'énumération pour les éléments internes, puis cliquez sur InnerXPathStringSourceType. En fonction de la valeur définie pour InnerXPathStringSourceType, sélectionnez une variable ou une connexion de fichier, créez une variable ou une connexion de fichier ou tapez la chaîne de l'expression XPath interne.
   • Pour utiliser l'énumérateur Foreach SMO, sélectionnez une connexion ADO.NET existante ou cliquez sur Nouvelle connexion dans la liste Gestionnaire de connexions, puis tapez la chaîne à utiliser ou cliquez sur Parcourir. Si vous cliquez sur Parcourir, dans la boîte de dialogue Sélectionner l'énumération SMO, sélectionnez le type d'objet à énumérer et le type d'énumération, puis cliquez sur OK.

6. Si vous le souhaitez, cliquez sur le bouton (…) dans la zone de texte Expressions de la page Collection pour créer des expressions qui mettent à jour les valeurs des propriétés. Pour plus d'informations, consultez Procédure : créer une expression de propriété.

   Remarque :
   Les propriétés énumérées dans la liste Propriété varient en fonction de l'énumérateur.

7. Si vous le souhaitez, cliquez sur Mappage de variables pour mapper des propriétés d'objets à la valeur de la collection, puis procédez comme suit :

   1. Dans la liste Variables, sélectionnez une variable ou cliquez sur <Nouvelle variable> pour créer une variable.
   2. Si vous ajoutez une nouvelle variable, définissez les propriétés de la variable dans la boîte de dialogue Ajouter une variable, puis cliquez sur OK.
   3. Si vous utilisez l'énumérateur For Each Item, vous pouvez mettre à jour la valeur de l'index dans la liste Index.

      Remarque :
      La valeur de l'index indique quelle colonne de l'élément mapper à la variable. Seul l'énumérateur For Each Item peut utiliser une valeur d'index autre que 0.

8. Si vous le souhaitez, cliquez sur Expressions, puis dans la page Expressions, créez des expressions de propriété pour les propriétés du conteneur de boucles Foreach. Pour plus d'informations, consultez Procédure : créer une expression de propriété.

9. Cliquez sur OK.

Voir aussi

Concepts

Conteneur de boucles Foreach
Rubriques d'aide relatives au flux de contrôle (SSIS)

Aide et Informations

Assistance sur SQL Server 2005