Cómo configurar un contenedor de bucles Foreach

Este procedimiento describe cómo configurar un contenedor de bucles Foreach, incluyendo expresiones de propiedad en los niveles de enumerador y contenedor.

Para configurar el contenedor de bucles Foreach

  1. En Business Intelligence Development Studio, abra el proyecto de Integration Services que contiene el paquete que desea.

  2. Haga clic en la ficha Flujo de control y haga doble clic en el bucle Foreach.

  3. En el cuadro de diálogo Editor de bucles Foreach, haga clic en General y, opcionalmente, modifique el nombre y descripción del bucle Foreach.

  4. Haga clic en Colección y seleccione un tipo de enumerador de la lista Enumerador.

  5. Especifique un enumerador y establezca las opciones del enumerador de la manera siguiente:

    • Para usar el enumerador de archivos Foreach, proporcione la carpeta que contiene los archivos que se deben enumerar, especifique un filtro para el nombre y tipo de archivo, y especifique si se debe devolver el nombre de archivo completo. Además, indique si se deben recorrer las subcarpetas para obtener más archivos.

    • Para usar el enumerador de elementos para Foreach, haga clic en Columnas y, en el cuadro de diálogo Columnas For Each Item, haga clic en Agregar para agregar columnas. Seleccione un tipo de datos de la lista Tipo de datos para cada columna y haga clic en Aceptar.
      Escriba valores en las columnas o seleccione valores de las listas.

      [!NOTA] Para agregar una nueva fila, haga clic en cualquier punto fuera de la celda en la que escribió.

      [!NOTA] Si un valor no es compatible con el tipo de datos de la columna, el texto aparece en rojo.

    • Para usar el enumerador Foreach ADO, seleccione una variable existente o haga clic en Nueva variable en la lista Variable de origen de objeto ADO para especificar la variable que contiene el nombre del objeto ADO que se debe enumerar, y seleccione una opción de modo de enumeración.
      Si se crea una nueva variable, establezca las propiedades de la variable en el cuadro de diálogo Agregar variable.

    • Para usar el Enumerador de conjunto de filas del esquema para Foreach de ADO.NET, seleccione una conexión ADO.NET existente o haga clic en Nueva conexión en la lista Conexión y luego seleccione un esquema.
      Opcionalmente, haga clic en Restricciones y seleccione las restricciones de esquemas, seleccione la variable que contenga el valor de restricción o escriba el valor de restricción y haga clic en Aceptar.

    • Para usar el Enumerador de variable para Foreach, seleccione una variable en la lista Variable.

    • Para usar el Enumerador de lista de nodos para Foreach, haga clic en DocumentSourceType y seleccione el tipo de origen de la lista y luego haga clic en DocumentSource.. Según el valor seleccionado para DocumentSourceType, seleccione una variable o conexión de archivo de la lista, cree una nueva variable o conexión de archivo, o escriba el origen XML en el Editor de origen del documento.
      A continuación, haga clic en EnumerationType y seleccione un tipo de enumeración de la lista. Si EnumerationType es Explorador, Nodo o Texto de nodo, haga clic en OuterXPathStringSourceType y seleccione el tipo de origen, y luego haga clic en OuterXPathString.. Según el valor seleccionado para OuterXPathStringSourceType, seleccione una variable o conexión de archivo de la lista, cree una nueva variable o conexión de archivo, o escriba la cadena para la expresión del Lenguaje de rutas XML (XPath).
      Si EnumerationType es ElementCollection, establezca OuterXPathStringSourceType y OuterXPathString como se describió anteriormente. A continuación, haga clic en InnerElementType, y seleccione un tipo de enumeración para los elementos internos y luego haga clic en InnerXPathStringSourceType. Según el valor establecido para InnerXPathStringSourceType, seleccione una variable o conexión de archivo, cree una nueva variable o conexión de archivo, o escriba la cadena para la expresión interna de XPath.

    • Para usar el Enumerador de SMO para Foreach, seleccione una conexión ADO.NET existente o haga clic en Nueva conexión en la lista Conexión y luego escriba la cadena que se debe usar o haga clic en Examinar. Si hace clic en Examinar, en el cuadro de diálogo Seleccionar enumeración de SMO, seleccione el tipo de objeto que se debe enumerar y el tipo de enumeración, y haga clic en Aceptar.

  6. Opcionalmente, haga clic en el botón Examinar (…) en el cuadro de texto Expresiones en la página Colección para crear expresiones que actualizan valores de propiedad. Para obtener más información, vea Cómo crear una expresión de propiedad.

    [!NOTA] Las propiedades enumeradas en la lista Propiedad varían según el enumerador.

  7. Opcionalmente, haga clic en Asignaciones de variables para asignar propiedades de objetos al valor de la colección y luego haga lo siguiente:

    1. En la lista Variables, seleccione una variable o haga clic en <Nueva variable> para crear una nueva variable.

    2. Si agrega una nueva variable, establezca las propiedades de la variable en el cuadro de diálogo Agregar variable y haga clic en Aceptar.

    3. Si usa el enumerador Foreach Item, puede actualizar el valor de índice en la lista Índice.

      [!NOTA] El valor de índice indica cuál es la columna en el elemento que se debe asignar a la variable. Sólo el enumerador Foreach Item puede usar un valor de índice que no sea 0.

  8. Opcionalmente, haga clic en Expresiones y, en la página Expresiones, cree expresiones de propiedades para las propiedades del contenedor de bucles Foreach. Para obtener más información, vea Cómo crear una expresión de propiedad.

  9. Haga clic en Aceptar.

Vea también

Conceptos

Contenedor Foreach Loop
Temas de procedimientos de flujo de control (SSIS)

Ayuda e información

Obtener ayuda sobre SQL Server 2005