Portail de support Workiva

Pour permettre des pipelines et des groupes de mappage flexibles, vous pouvez utiliser des valeurs variables dans les transformations et les règles de mappage. 

Exigences

Data Prep est entièrement contrôlé au niveau de l'organisation et ne reconnaît pas les espaces de travail individuels ni leurs autorisations.

Cela signifie que :

• Les données Prep sont partagées entre tous les utilisateurs autorisés de votre organisation.
• Tout utilisateur ayant accès à Chain Builder a également accès à Data Prep.
• Tous les utilisateurs qui peuvent créer ou modifier des chaînes auront la possibilité de gérer des pipelines dans Data Prep.
• Un seul pipeline de Data Prep peut être utilisé sur plusieurs chaînes et espaces de travail au sein d'une organisation.
  
  

Types de variables

Vous pouvez utiliser différents types de variables avec un pipeline, en fonction de la valeur à renvoyer.

Introduire une valeur variable

Vous pouvez sélectionner une variable pour certaines valeurs dans une transformation ou une règle de mappage :

• Pour sélectionner une variable pour une transformation, cliquez sur Variable code dans le champ.
  
• Pour sélectionner une variable pour une règle de mappage, cliquez sur le champ From ou To.
  

Vous pouvez inclure plusieurs valeurs variables dans un champ ou combiner des variables avec des valeurs statiques.

Créer des variables d'exécution pour un pipeline ou un groupe de mappage

Vous pouvez créer des variables d'exécution qui permettent de définir des valeurs pour les transformations ou les groupes de mappage lors de l'exécution du pipeline.

Remarque : Vous ne pouvez utiliser une variable d'exécution qu'avec des colonnes du même type de données. Pour utiliser une variable avec plusieurs colonnes de types de données différents, créez une variable distincte pour chaque type.

1. Dans le pipeline ou le groupe de mappage, sélectionnez l'onglet Variables code.
2. Ajouter la variable :
   • S'il s'agit de la première variable, cliquez sur Créer des variables.
     
   • Sinon, sous Editer les variables, cliquez sur Ajouter une variable.
     
     
     
3. Sélectionnez le type de données des colonnes dans lesquelles la variable doit être utilisée, par exemple Chaîne ou Nombre.
4. Si la valeur de la variable est nécessaire à l'exécution du pipeline, vérifiez Required.

   Note : Si l'option Required est cochée et que la valeur n'est pas saisie au moment de l'exécution, le pipeline ne s'exécutera pas, même si la variable a une valeur par défaut.

5. Dans Display name, entrez un nom pour aider à identifier la variable.
6. Saisissez la valeur par défaut de la variable, le cas échéant.
7. Cliquez sur Enregistrer.

Conseil : Si vous créez une variable d'exécution pour un groupe de mappage, créez une variable correspondante pour tout pipeline qui utilise le groupe de mappage dans une transformation Mapping. Pour faciliter la mise en correspondance des variables entre le pipeline et le groupe de mappage, utilisez le même nom pour les deux. Pour distinguer la variable du groupe de mappage, ajoutez un préfixe à son nom, par exemple MG_.

Définir des valeurs de prévisualisation pour les variables d'exécution d'un pipeline

Si un pipeline utilise des variables d'exécution, définissez les valeurs à utiliser pour prévisualiser ses transformations.

Note : Si une variable d'exécution est requise, le pipeline a besoin de sa valeur pour prévisualiser les transformations. Si une variable d'exécution est non requise, null apparaît dans l'aperçu jusqu'à ce que sa valeur soit définie.

1. Dans le pipeline, sélectionnez l'onglet Variables code, et cliquez sur Editer les variables.
2. Sous Set preview variables, entrez les valeurs des variables d'exécution du pipeline.
3. Cliquez sur Définir les valeurs.

Note : Le message, Il y a eu une erreur dans le traitement de votre transformation.  Pipeline de prévisualisation des exceptions   Les variables [] sont marquées comme obligatoires mais n'ont pas de valeur non vide. s'affiche si une variable d'exécution est obligatoire mais que l'aperçu n'est pas renseigné.

Modifier les variables d'exécution

Vous pouvez modifier les variables d'exécution à tout moment.

1. Dans le pipeline ou le groupe de mappage, sélectionnez l'onglet Variables code et cliquez sur Editer les variables.
2. Mettez à jour le type de données des variables, le statut Required, le nom ou la valeur par défaut si nécessaire.
3. Cliquez sur Enregistrer.
4. Si vous modifiez le type de données, mettez également à jour toute transformation qui utilise la valeur de la variable.

Supprimer les variables d'exécution

Si vous n'avez plus besoin d'une variable d'exécution, vous pouvez la supprimer du pipeline ou du groupe de mappage.

1. Dans le pipeline ou le groupe de mappage, sélectionnez l'onglet Variables code et cliquez sur Editer les variables.
2. Pour la variable à supprimer, cliquez sur Supprimer supprimer.
3. Cliquez sur Enregistrer.
4. Mettre à jour toutes les transformations qui ont utilisé la variable avec une nouvelle valeur.