DataWorks:Nœud de branchement

Notes d'utilisation

• Pour utiliser la fonctionnalité de nœud de branchement, vous devez souscrire à l'édition Standard de DataWorks ou à une édition supérieure. Pour plus d'informations, consultez la rubrique Comparaison des éditions DataWorks.

• Un nœud de branchement peut comporter au maximum 50 branches.

• Un nœud de branchement s'utilise généralement conjointement avec un nœud d'affectation. Pour plus d'informations, consultez la rubrique Nœud d'affectation.

• Si une condition de branchement n'est pas satisfaite lors de l'exécution, les nœuds en aval de cette branche passent à l'état de test à blanc (dry run). Le journal d'exécution affiche un message similaire à It's set condition-skip by task.

Créer un nœud de branchement

1. Connectez-vous à la console DataWorks. Dans la région cible, cliquez sur Data Development and O&M > Data Development dans le volet de navigation de gauche. Sélectionnez un espace de travail dans la liste déroulante et cliquez sur Go to Data Development.

2. Survolez l'icône et choisissez Create Node > General > Branch Node.

   Vous pouvez également ouvrir le workflow cible, cliquer avec le bouton droit dans une zone vide et choisir Create Node > General > Branch Node.

3. Dans la boîte de dialogue Create Node, saisissez un nom de nœud et sélectionnez un chemin.

4. Cliquez sur Commit.

5. Définissez la logique de branchement.

   1. Sur la page Definition, cliquez sur Add Branch.

   2. Dans la boîte de dialogue Branch Definition, configurez les paramètres.

      Parameter	Description
      Condition	La condition qui détermine si cette branche s'exécute. Notez les règles suivantes : Utilisez uniquement des opérateurs de comparaison Python pour définir la condition logique. Si l'expression est évaluée à true lors de l'exécution, la condition de branchement correspondante est satisfaite. Si une erreur se produit lors de l'analyse de l'expression au moment de l'exécution, l'intégralité du nœud de branchement échoue. Utilisez des variables globales et des paramètres définis dans le contexte du nœud au sein des conditions de branchement. Par exemple, ${input} peut être un paramètre d'entrée défini sur le nœud de branchement.
      Associated Node Output	La sortie que les nœuds en aval référencent pour établir les dépendances : Les nœuds en aval référencent cette sortie pour déclarer les dépendances. Lorsqu'une condition de branchement est satisfaite, les nœuds en aval qui dépendent de la sortie associée s'exécutent, à condition que leurs autres dépendances en amont soient également satisfaites. Si une condition de branchement n'est pas satisfaite, les nœuds en aval qui dépendent de la sortie correspondante ne s'exécutent pas. DataWorks définit ces nœuds à l'état Not run because the branch condition is not met.
      Description	Saisissez une brève description de la branche. Par exemple, définissez deux branches avec les conditions ${input}==1 et ${input}>2.

      L'exemple suivant illustre la configuration du paramètre Associated Node Output.

      Par exemple, un nœud de branchement possède deux nœuds en aval nommés qqqq et wwww. Lorsque la condition de branchement est 1, la logique du nœud qqqq s'exécute. Lorsque la condition de branchement est 2, la logique du nœud wwww s'exécute. Lors de la configuration du nœud de branchement, définissez les sorties des nœuds selon vos besoins. Par exemple, si la sortie de la branche 1 est 1234 et celle de la branche 2 est 2324, ces deux valeurs sont utilisées comme noms de sortie pour ce nœud de branchement. Le nœud en aval qqqq doit référencer le nom de sortie 1234, et le nœud wwww doit référencer le nom de sortie 2324.

   3. Cliquez sur OK.

      Après avoir ajouté une branche, vous pouvez la Modify ou la Delete.

      • Cliquez sur Modify pour modifier les paramètres de la branche. DataWorks met à jour les dépendances associées en conséquence.

      • Cliquez sur Delete pour supprimer la branche. DataWorks met également à jour les dépendances associées.

6. Dans le volet de droite, cliquez sur Scheduling Settings pour configurer les propriétés de planification du nœud.

   Une fois les conditions de branchement définies, DataWorks ajoute automatiquement les noms de sortie à la section Output Name of Current Node de l'onglet Scheduling Settings > Scheduling Dependency. Les nœuds en aval peuvent utiliser ces noms de sortie pour déclarer des dépendances.

   Remarque

   • Étant donné que la propriété de test à blanc (dry run) se propage aux nœuds en aval, ne placez pas de tâches auto-dépendantes sur un chemin de branchement. Pour savoir s'il faut hériter de la propriété de test à blanc d'un nœud en amont, consultez la rubrique Hériter de la propriété de test à blanc des nœuds en amont.

   • Si vous créez une dépendance en traçant une ligne pour établir un contexte de nœud et que le nom de sortie n'apparaît pas dans Scheduling Settings, saisissez manuellement le nom de sortie.

7. Validez et déployez le nœud.

   1. Cliquez sur l'icône de la barre d'outils pour enregistrer le nœud.

   2. Cliquez sur l'icône de la barre d'outils pour valider le nœud.

   3. Dans la boîte de dialogue Submission, saisissez une Change Description.

   4. Cliquez sur OK.

   Si vous utilisez un espace de travail en mode standard, vous devez déployer la tâche dans l'environnement de production après l'avoir validée. Cliquez sur Deploy Task dans le coin supérieur gauche de la barre de menu supérieure. Pour plus d'informations, consultez la rubrique Déployer des tâches.

8. Consultez les tâches planifiées.

   1. Dans le coin supérieur droit de l'éditeur, cliquez sur O&M Personnel pour ouvrir le centre d'opérations (Operation Center) de l'environnement de production.

   2. Consultez les tâches planifiées en cours d'exécution. Pour plus d'informations, consultez la rubrique Gérer les tâches planifiées.

   Pour afficher plus de détails sur les tâches planifiées, cliquez sur Operation Center dans la barre de menu supérieure. Pour plus d'informations, consultez la rubrique Présentation du centre d'opérations (Operation Center).

Exemple : Dépendance de nœud en aval

Opérateurs de comparaison Python pris en charge