Ajout d'options d'exécution de flux de données

Les options d’exécution de flux de données vous permettent de contrôler le comportement des stages lorsque vous exécutez le flux de données. Ceci s’avère utile lorsque vous souhaitez avoir la possibilité de modifier le comportement du flux de données lors de son exécution. Par exemple, vous pouvez souhaiter indiquer une base de données source pour un stage Read from DB lorsque vous exécutez le flux de données, au lieu d'utiliser la base de données indiquée dans le stage Read from DB du flux de données.

Cette procédure explique comment exposer des options qui peuvent être définies lors de l’exécution. Après avoir effectué cette procédure, vous pourrez définir des options de flux de données lors de l’exécution à l’aide de ces techniques :

Pour les jobs, vous pourrez indiquer des options d'exécution à l'aide d'un fichier de propriétés d'options de flux de données et de l'argument -o de Job Executor.
Pour les services, vous pourrez indiquer des options d’exécution sous forme d’options de l’API.
Pour les services exposés sous forme de service Web, vous pourrez indiquer des options d’exécution sous forme de paramètres dans la requête.
Pour les sous-flux, les options d'exécution seront héritées du flux de données parent et exposées via l'une des méthodes ci-dessus, selon le type de flux de données parent (job, service ou service exposé sous forme de service Web).

Pour ajouter des options d’exécution à un flux de données :

Ouvrez le flux de données dans Enterprise Designer.
Pour configurer les options d'exécution d'un stage dans un flux de données intégré, ouvrez ce dernier.
Cliquez sur l'icône Options de flux de données de la barre d'outils ou sur Édition > Options de flux de données. La boîte de dialogue Options de flux de données apparaît.
Cliquez sur Ajouter. La boîte de dialogue Définir l'option de flux des données apparaît.
Dans le champ Option name, indiquez le nom à utiliser pour cette option. Il s'agit du nom de l'option qui devra être spécifié lors de l'exécution afin de définir cette option.
Dans le champ Label, vous pouvez spécifier un autre libellé ou conserver le même en tant que nom d'option.
Saisissez une description de l'option dans le champ Description.
Dans le champ Target, déterminez si cette option doit être appliquée à tous les stages dans le flux de données ou à certains stages uniquement.
Stage(s) sélectionné(s)

Sélectionnez cette option pour qu'elle ne soit appliquée qu'aux stages que vous spécifiez.

Tous les stages

Sélectionnez cette option pour qu'elle soit appliquée à tous les stages dans le flux de données.
Inclut les transformations
Sélectionnez cette option pour que l'option d'exécution soit mise à disposition pour les transformations personnalisées dans les stages Transformer dans le flux de données. Si vous choisissez cette option, vous pouvez accéder à la valeur indiquée lors de l'exécution dans le script Groovy d'une transformation personnalisée à l'aide de la syntaxe suivante :
```
options.get("optionName")
```
Par exemple, pour accéder à une option nommée casing, vous devez inclure cela dans votre script de transformation personnalisée :
```
options.get("casing")
```
Si vous choisissez Selected stage(s) dans le champ Target, la table Map dataflow options to stages affiche la liste des stages contenus dans le flux de données. Sélectionnez l'option à exposer en tant qu'option de flux de données. Vous verrez les champs Valeur par défaut et Valeurs conformes se remplir de données lorsque vous sélectionnez votre premier élément.

Remarque : Vous pouvez sélectionner plusieurs options de telle sorte que l'option de flux de données contrôle plusieurs options de stages. Si vous faites cela, chaque option que vous sélectionnez doit partager des valeurs conformes. Par exemple, une option présente des valeurs de Y et N, chacune des options supplémentaires doit disposer de Y ou de N dans son ensemble de valeurs, et vous ne pouvez autoriser la valeur en commun à être disponible qu'au moment de l'exécution. Ainsi, si vous sélectionnez une option avec les valeurs Y et N, vous ne pouvez pas sélectionner une option dotée des valeurs E, T, M et L, mais vous pouvez sélectionner une option avec les valeurs P, S et N car les deux options partagent la valeur « N ». Cependant, seule cette valeur « N » est disponible pour cette option, pas « Y », « P » ou « S ».
Si vous voulez limiter les valeurs qu'un utilisateur peut sélectionner, modifiez les options disponibles dans le champ Legal values en cliquant sur l'icône située directement à droite de ce champ.
Pour modifier la valeur par défaut, indiquez une valeur différente dans le champ Valeur par défaut.

Remarque : Pour un service, vous ne pouvez modifier que les valeurs par défaut avant d'exposer le service pour la première fois.Une fois que vous exposez le service, vous ne pouvez plus modifier les valeurs par défaut à l’aide d’Enterprise Designer.Au lieu de cela, vous devez utiliser Management Console.Pour plus d'informations, reportez-vous à la section Spécification des Options de services par défaut.
Cliquez sur OK.
Continuez d'ajouter les options souhaitées.
Cliquez sur OK dans la boîte de dialogue des Options du flux de données lorsque vous avez terminé d'ajouter vos options.
Si vous ajoutez une option d'exécution à un flux de données intégré, vous devez définir le flux de données parent de l'option d'exécution, ainsi que tous les flux de de données ancêtres, pour que les options soient disponibles lors de l'exécution. Pour ce faire, ouvrez le flux de données contenant le flux de données intégré et exposez l'option que vous venez de créer. Si nécessaire, ouvrez le parent de ce flux de données et définissez-y l'option, etc., jusqu'à ce que l'option de flux de données soit définie pour tous les ancêtres.

Par exemple, imaginons que vous disposiez d'un flux de données nommé « A » contenant un flux de données intégré nommé « B », contenant à son tour un flux de données intégré nommé « C », de sorte que votre hiérarchie de flux de données intégrés ressemble à : A > B > C. Si vous souhaitez exposer une option nommée Casing dans un stage dans le flux de données intégré « C », vous devez ouvrir le flux de données intégré « C » et y définir l'option. Ensuite, vous devez ouvrir le flux de données intégré « B » et y définir l'option. Pour finir, vous devez ouvrir le flux de données « A » et y définir l'option, pour qu'elle soit disponible lors de l'exécution.

Le flux de données est désormais configuré pour permettre la spécification des options lors de l'exécution.