Freigeben über

  • Artikel

Vorgehensweise: Konfigurieren eines Foreach-Schleifencontainers

In diesem Verfahren wird das Konfigurieren eines Foreach-Schleifencontainers beschrieben, einschließlich der Eigenschaftsausdrücke auf Enumerator- und Containerebene.

So konfigurieren Sie den Foreach-Schleifencontainer

  1. Öffnen Sie in Business Intelligence Development Studio das Integration Services-Projekt mit dem gewünschten Paket.

  2. Klicken Sie auf die Registerkarte Ablaufsteuerung, und doppelklicken Sie auf die Foreach-Schleife.

  3. Klicken Sie im Dialogfeld Foreach-Schleifen-Editor auf Allgemein, und ändern Sie optional den Namen und die Beschreibung der Foreach-Schleife.

  4. Klicken Sie auf Auflistung, und wählen Sie aus der Liste Enumerator einen Enumeratortyp aus.

  5. Geben Sie einen Enumerator an, und legen Sie wie folgt Enumeratoroptionen fest:

    • Wenn Sie denForeach-Dateienumerator verwenden möchten, stellen Sie den Ordner bereit, der die aufzuzählenden Dateien enthält. Geben Sie einen Filter für den Dateinamen und den Typ an, und geben Sie an, ob der vollqualifizierte Dateiname zurückgegeben werden soll. Zeigen Sie außerdem an, ob Unterordner nach weiteren Dateien durchsucht werden sollen.

    • Wenn Sie den Foreach Item-Enumerator verwenden möchten, klicken Sie auf Spalten, und klicken Sie im Dialogfeld For Each Item-Spalten auf Hinzufügen, um Spalten hinzuzufügen. Wählen Sie aus der Liste Datentyp einen Datentyp für jede Spalte aus, und klicken Sie auf OK.

      Geben Sie Werte in die Spalten ein, oder wählen Sie in Listen Werte aus.

      HinweisHinweis

      Klicken Sie an einer beliebigen Stelle außerhalb der Zelle, in die Sie Werte eingegeben haben, um eine neue Zeile hinzuzufügen.
      HinweisHinweis

      Falls ein Wert nicht mit dem Spaltendatentyp kompatibel ist, wird der Text rot angezeigt.

    • Wenn Sie den Foreach-ADO-Enumerator verwenden möchten, wählen Sie eine vorhandene Variable aus, oder klicken Sie in der Liste ADO-Objektquellvariable auf Neue Variable, um die Variable anzugeben, die den Namen des aufzuzählenden ADO-Objekts enthält, und wählen Sie eine Enumerationsmodusoption aus.

      Wenn Sie eine neue Variable erstellen, legen Sie die Variableneigenschaften im Dialogfeld Variable hinzufügen fest.

    • Wenn Sie den Enumerator für Foreach-ADO.NET-Schemarowset verwenden möchten, wählen Sie eine vorhandene ADO.NET-Verbindung aus, oder klicken Sie in der Liste Verbindung auf Neue Verbindung, und wählen Sie ein Schema aus.

      Klicken Sie optional auf Einschränkungen festlegen, und wählen Sie Schemaeinschränkungen aus, wählen Sie die Variable aus, die den Einschränkungswert enthält, oder geben Sie den Einschränkungswert ein, und klicken Sie auf OK.

    • Wenn Sie einen Foreach-Enumerator für Daten aus Variable verwenden möchten, wählen Sie aus der Liste Variable eine Variable aus.

    • Wenn Sie den Foreach-NodeList-Enumerator verwenden möchten, klicken Sie auf DocumentSourceType, wählen Sie den Quelltyp aus der Liste aus, und klicken Sie dann auf DocumentSource. Je nach dem für DocumentSourceType ausgewählten Wert wählen Sie eine Variable bzw. eine Dateiverbindung aus der Liste aus, erstellen Sie eine neue Variable bzw. Dateiverbindung oder geben Sie die XML-Quelle in den Dokumentquellen-Editor ein.

      Klicken Sie anschließend auf EnumerationType, und wählen Sie einen Enumerationstyp aus der Liste aus. Wenn EnumerationTypeNavigator, Node oder NodeText ist, klicken Sie auf OuterXPathStringSourceType, wählen Sie den Quelltyp aus, und klicken Sie dann auf OuterXPathString. Je nach dem für OuterXPathStringSourceType ausgewählten Wert wählen Sie eine Variable bzw. eine Dateiverbindung aus der Liste aus, erstellen Sie eine neue Variable bzw. Dateiverbindung oder geben Sie die Zeichenfolge für den äußeren XPath-Ausdruck (XML Path Language) ein.

      Falls EnumerationType gleich ElementCollection ist, legen Sie OuterXPathStringSourceType und OuterXPathString wie oben beschrieben fest. Klicken Sie anschließend auf InnerElementType, und wählen Sie einen Enumerationstyp für die inneren Elemente aus. Klicken Sie dann auf InnerXPathStringSourceType. Je nachdem, welchen Wert Sie für InnerXPathStringSourceType festgelegt haben, wählen Sie eine Variable bzw. eine Dateiverbindung aus, erstellen Sie eine neue Variable bzw. Dateiverbindung, oder geben Sie die Zeichenfolge für den inneren XPath-Ausdruck ein.

    • Wenn Sie den Foreach-SMO-Enumerator verwenden möchten, wählen Sie eine vorhandene ADO.NET-Verbindung aus, oder klicken Sie in der Liste Verbindung auf Neue Verbindung, und geben Sie die zu verwendende Zeichenfolge ein, oder klicken Sie auf Durchsuchen. Wenn Sie auf Durchsuchen klicken, wählen Sie im Dialogfeld SMO-Enumeration auswählen den aufzuzählenden Objekttyp und den Enumerationstyp aus, und klicken Sie auf OK.

  6. Klicken Sie optional im Textfeld Ausdrücke auf der Seite Auflistung auf die Schaltfläche mit den drei Punkten (…), um Ausdrücke zu erstellen, mit denen Eigenschaftswerte aktualisiert werden. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen oder Ändern eines Eigenschaftsausdrucks.

    HinweisHinweis

    Die in der Liste Eigenschaft aufgeführten Eigenschaften hängen vom Enumerator ab.

  7. Klicken Sie optional auf Variablenzuordnungen, um Objekteigenschaften dem Auflistungswert zuzuordnen, und führen Sie dann folgende Aktionen aus:

    1. Wählen Sie in der Liste Variablen eine Variable aus, oder klicken Sie auf <Neue Variable>, um eine neue Variable zu erstellen.

    2. Wenn Sie eine neue Variable hinzufügen, legen Sie die Variableneigenschaften im Dialogfeld Variable hinzufügen fest, und klicken Sie auf OK.

    3. Wenn Sie den Foreach Item-Enumerator verwenden, können Sie den Indexwert in der Liste Index aktualisieren.

      HinweisHinweis

      Der Indexwert zeigt an, welche Spalte im Element der Variablen zugeordnet werden soll. Nur der Foreach Item-Enumerator kann einen anderen Indexwert als 0 verwenden.

  8. Klicken Sie optional auf Ausdrücke, und erstellen Sie auf der Seite Ausdrücke Eigenschaftsausdrücke für die Eigenschaften des Foreach-Schleifencontainers. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen oder Ändern eines Eigenschaftsausdrucks.

  9. Klicken Sie auf OK.