Hinzufügen von Datenfluss-Laufzeitoptionen

Über Datenfluss-Laufzeitoptionen können Sie das Verhalten von Schritten steuern, wenn Sie den Datenfluss ausführen. Dies ist nützlich, wenn Sie die Möglichkeit haben möchten, das Verhalten des Datenflusses zu ändern, während er ausgeführt wird. Sie können beispielsweise während der Ausführung des Datenflusses eine Quelldatenbank für einen „Read from DB“-Schritt angeben, die anstelle der im „Read from DB“-Schritt im Datenfluss angegebenen Datenbank verwendet werden soll.

Diese Prozedur beschreibt, wie Sie Optionen verfügbar machen können, die zur Laufzeit festgelegt werden können. Nach Durchführen dieser Prozedur können Sie mithilfe folgender Techniken Datenflussoptionen zur Laufzeit festlegen:

Bei Aufträgen können Sie Laufzeitoptionen angeben, indem Sie eine Eigenschaftsdatei für Datenflussoptionen und das Argument -o vom Job Executor verwenden.
Bei Diensten können Sie Laufzeitoptionen als API-Optionen angeben.
Bei Diensten, die als Webservice verfügbar gemacht sind, können Sie Laufzeitoptionen als Parameter in der Anforderung angeben.
Bei Unterflüssen werden die Laufzeitoptionen vom übergeordneten Datenfluss übernommen und mit einem der oben genannten Mittel verfügbar gemacht, je nach Typ des übergeordneten Datenflusses (Auftrag, Dienst oder als Webservice verfügbar gemachter Dienst).

Sie können Laufzeitoptionen wie folgt zu einem Datenfluss hinzufügen:

Öffnen Sie den Datenfluss im Enterprise Designer.
Wenn Sie Laufzeitoptionen für einen Schritt in einem eingebetteten Datenfluss konfigurieren möchten, öffnen Sie den eingebetteten Datenfluss.
Klicken Sie in der Symbolleiste auf das Symbol „Datenflussoptionen“ oder klicken Sie auf Bearbeiten > Datenflussoptionen. Das Dialogfeld Datenflussoptionen wird angezeigt.
Klicken Sie auf Add (Hinzufügen). Das Dialogfeld Datenflussoptionen definieren wird angezeigt.
Geben Sie im Feld Optionsname den Namen ein, den Sie für diese Option verwenden möchten. Dies ist der Optionsname, der zur Laufzeit angegeben werden muss, um diese Option festzulegen.
Im Feld Beschriftung können Sie eine andere Beschriftung angeben oder den Optionsnamen als Beschriftung beibehalten.
Geben Sie eine Beschreibung der Option in das Feld Beschreibung ein.
Wählen Sie im Feld Ziel, ob diese Option auf alle Schritte im Datenfluss oder nur auf bestimmte Schritte angewendet werden soll.
Ausgewählte(r) Schritt/e

Wählen Sie diese Option aus, wenn die Option nur auf die angegebenen Schritte angewendet werden soll.

Alle Schritte

Wählen Sie diese Option aus, wenn die Option auf alle Schritte im Datenfluss angewendet werden soll.
Enthält Transformationen
Wählen Sie diese Option aus, wenn die Laufzeitoption allen benutzerdefinierten Transformationen in Transformer-Schritten im Datenfluss zur Verfügung gestellt werden soll. Wenn Sie diese Option wählen, können Sie mit folgender Syntax auf den zur Laufzeit im Groovy-Skript einer benutzerdefinierten Transformation angegebenen Wert zugreifen:
```
options.get("optionName")
```
Wenn Sie etwa auf eine Option namens casing zugreifen wollten, würden Sie im benutzerdefinierten Transformationsskript Folgendes angeben:
```
options.get("casing")
```
Wenn Sie im Feld Ziel die Option Ausgewählte(r) Schritt/e auswählen, zeigt die Tabelle Datenflussoptionen zu Schritten zuordnen eine Liste der Schritte im Datenfluss. Wählen Sie die Option aus, die Sie als Datenflussoption verfügbar machen möchten. Sie sehen, wie die Felder Standardwert und Zulässige Werte mit Daten ausgefüllt werden, wenn Sie das erste Element auswählen.

Anmerkung: Sie können mehrere Optionen auswählen, sodass die Datenflussoption mehrere Schrittoptionen steuern kann. Wenn Sie das tun, muss jede der ausgewählten Schrittoptionen zulässige Werte gemeinsam haben. Beispiel: Eine Option hat die Werte Y und N. Jede der zusätzlichen Optionen muss entweder Y oder N in ihrer Wertegruppe enthalten, und Sie können nur den gemeinsamen Wert zur Laufzeit zur Verfügung stellen. Wenn Sie also eine Option mit den Werten Y und N auswählen, können Sie keine Option mit den Werten E, T, M und L auswählen, eine Option mit den Werten P, S und N hingegen schon, weil beide Optionen „N“ als Wert gemeinsam haben. Allerdings wäre dann nur N ein verfügbarer Wert für diese Option, nicht aber Y, P oder S.
Wenn Sie die Werte beschränken möchten, die sich zur Laufzeit angeben lassen, bearbeiten Sie die Optionen im Feld Zulässige Werte. Klicken Sie dazu auf das Symbol rechts neben dem Feld.
Wenn Sie den Standardwert ändern möchten, geben Sie im Feld Standardwert einen anderen Wert an.

Anmerkung: Für einen Dienst können Sie die Standardwerte nur ändern, bevor der Dienst erstmals verfügbar gemacht wird. Nachdem der Dienst verfügbar gemacht wurde, können Sie die Standardwerte nicht mehr im Enterprise Designer ändern. Stattdessen müssen Sie die Management Console verwenden. Weitere Informationen finden Sie unter Angeben von Standarddienstoptionen.
Klicken Sie auf OK.
Fügen Sie auf Wunsch weitere Optionen hinzu.
Klicken Sie im Dialogfeld Datenflussoptionen auf OK, sobald Sie damit fertig sind.
Wenn Sie eine Laufzeitoption zu einem eingebetteten Datenfluss hinzugefügt haben, müssen Sie die Laufzeitoption im übergeordneten Datenfluss sowie in allen vorherigen Datenflüssen definieren, um die Optionen zur Laufzeit zur Verfügung zu stellen. Öffnen Sie dazu den Datenfluss, der den eingebetteten Datenfluss enthält, und machen Sie die gerade erstellte Option verfügbar. Öffnen Sie ggf. den diesem Datenfluss übergeordneten Datenfluss und definieren Sie die Option auch dort usw., bis die Datenflussoption in allen vorherigen Datenflüssen definiert ist.

Angenommen, Datenfluss A enthält einen eingebetteten Datenfluss B. Dieser wiederum enthält einen eingebetteten Datenfluss C. Daraus ergäbe sich folgende eingebettete Datenflusshierarchie: A > B > C. Wenn Sie eine Option namens „Groß-/Kleinschreibung“ in einem Schritt im eingebetteten Datenfluss „C“ verfügbar machen wollten, würden Sie den eingebetteten Datenfluss „C“ öffnen und sie dort definieren. Dann würden Sie den eingebetteten Datenfluss B öffnen und die Option dort definieren. Schließlich würden Sie Datenfluss A öffnen und die Option dort definieren und sie so zur Laufzeit verfügbar machen.

Der Datenfluss ist jetzt so konfiguriert, dass Optionen zur Laufzeit angegeben werden dürfen.