Condividi tramite

  • Articolo

Procedura: Configurazione di un contenitore Ciclo Foreach

Questa procedura descrive la configurazione di un contenitore Ciclo Foreach, incluse le espressioni di proprietà a livello di enumeratore e contenitore.

Per configurare il contenitore Ciclo Foreach

  1. In Business Intelligence Development Studio aprire il progetto di Integration Services che contiene il pacchetto desiderato.

  2. Fare clic sulla scheda Flusso di dati e quindi fare doppio clic su Ciclo Foreach.

  3. Nella finestra di dialogo Editor ciclo Foreach fare clic su Generale e, facoltativamente, modificare il nome e la descrizione del ciclo Foreach.

  4. Fare clic su Raccolta e selezionare un tipo di enumeratore nell'elenco Enumerator.

  5. Specificare un enumeratore e impostarne le opzioni nel modo seguente:

    • Per utilizzareForeach File Enumerator, specificare la cartella che contiene i file da enumerare, specificare un filtro per il nome e il tipo di file e specificare se deve essere restituito il nome completo del file. Indicare inoltre se ricercare ulteriori file nelle sottocartelle.

    • Per utilizzare Foreach Item Enumerator, fare clic su Colonne e, nella finestra di dialogo Colonne For Each Item, fare clic su Aggiungi per aggiungere le colonne. Selezionare un tipo di dati nell'elenco Tipo di dati per ogni colonna e quindi scegliere OK.

      Digitare i valori nelle colonne oppure selezionarli dagli elenchi.

      Nota

      Per aggiungere una nuova riga, fare clic in un punto qualsiasi al di fuori della cella in cui si è digitato.

      Nota

      Se un valore non è compatibile con il tipo di dati della colonna, il testo verrà visualizzato in rosso.

    • Per utilizzare Foreach ADO Enumerator, selezionare una variabile esistente oppure fare clic su Nuova variabile nell'elenco Variabile di origine oggetto ADO per specificare la variabile che contiene il nome dell'oggetto ADO da enumerare, quindi selezionare l'opzione corrispondente alla modalità di enumerazione desiderata.

      Se si crea una nuova variabile, impostarne le proprietà nella finestra di dialogo Aggiungi variabile.

    • Per utilizzare Foreach ADO.NET Schema Rowset Enumerator, selezionare un connettore ADO.NET esistente oppure fare clic su Nuova connessione nell'elenco Connessione e quindi selezionare uno schema.

      Facoltativamente, fare clic su Imposta restrizioni e selezionare le restrizioni dello schema, selezionare la variabile che contiene il valore della restrizione oppure digitare il valore della restrizione e scegliere OK.

    • Per utilizzare Foreach From Variable Enumerator, selezionare una variabile nell'elenco Variabile.

    • Per utilizzare Foreach NodeList Enumerator, fare clic su DocumentSourceType e selezionare il tipo di origine dall'elenco, quindi fare clic su DocumentSource. A seconda del valore selezionato per DocumentSourceType, selezionare una variabile o una connessione file dall'elenco, creare una nuova variabile o connessione file oppure specificare l'origine XML in Editor origine documento.

      Successivamente fare clic su EnumerationType e selezionare un tipo di enumerazione dall'elenco. Se EnumerationType è Navigator, Node o NodeText, fare clic su OuterXPathStringSourceType, selezionare il tipo di origine e quindi fare clic su OuterXPathString. A seconda del valore impostato per OuterXPathStringSourceType, selezionare una variabile o una connessione file dall'elenco, creare una nuova variabile o connessione file oppure digitare la stringa per l'espressione XPath (XML Path Language) esterna.

      Se EnumerationType è ElementCollection,impostare OuterXPathStringSourceType e OuterXPathString come descritto in precedenza. Fare quindi clic su InnerElementType, selezionare un tipo di enumerazione per gli elementi interni e quindi fare clic su InnerXPathStringSourceType. A seconda del valore impostato per InnerXPathStringSourceType, selezionare una variabile o una connessione file, creare una nuova variabile o connessione file oppure digitare la stringa per l'espressione XPath interna.

    • Per utilizzare Foreach SMO Enumerator, selezionare una connessione ADO.NET esistente oppure fare clic su Nuova connessione nell'elenco Connessione e quindi digitare la stringa da utilizzare oppure fare clic su Sfoglia. Se si fa clic su Sfoglia, nella finestra di dialogo Seleziona enumerazione SMO selezionare il tipo di oggetto da enumerare e il tipo di enumerazione e quindi scegliere OK.

  6. Facoltativamente, fare clic sul pulsante di ricerca (…) nella casella di testo Espressioni della pagina Raccolta per creare le espressioni che aggiornano i valori delle proprietà. Per ulteriori informazioni, vedere Procedura: Aggiungere o modificare un'espressione di proprietà.

    Nota

    Le proprietà incluse nell'elenco Proprietà variano a seconda dell'enumeratore.

  7. Facoltativamente, fare clic su Mapping variabili per associare le proprietà degli oggetti ai valori della raccolta e quindi eseguire le operazioni seguenti:

    1. Nell'elenco Variabili selezionare una variabile oppure fare clic su <Nuova variabile> per creare una nuova variabile.

    2. Se si aggiunge una nuova variabile, impostarne le proprietà nella finestra di dialogo Aggiungi variabile e scegliere OK.

    3. Se si utilizza l'enumeratore For Each Item, sarà possibile aggiornare il valore dell'indice nell'elenco Indice.

      Nota

      Il valore dell'indice indica la colonna dell'elemento da associare alla variabile. Solo l'enumeratore For Each Item può utilizzare un valore di indice diverso da 0.

  8. Facoltativamente, fare clic su Espressioni e, nella pagina Espressioni, creare espressioni di proprietà per le proprietà del contenitore Ciclo Foreach. Per ulteriori informazioni, vedere Procedura: Aggiungere o modificare un'espressione di proprietà.

  9. Fare clic su OK.