Modification des variables d'exécution

Explique comment sélectionner un ensemble de variables pouvant être utilisées en tant que paramètre d'exécution pour les jobs de pipeline.

Sur la page Variables, vous pouvez sélectionner un ensemble de variables pouvant être utilisées en tant que paramètre d'exécution pour les jobs de pipeline. Lorsque vous exécutez un pipeline, une valeur d'entrée est fournie pour ces variables (un ensemble de valeurs d'exécution ou prêtes à l'emploi que vous pouvez utiliser comme valeurs de paramètre dans les jobs individuels). Les variables peuvent être de type prédéfini, comme "Période", "Mode d'import" ou "Mode d'export".

Vous pouvez également ajouter un paramètre de variable personnalisée en tant que paramètre de job. Par exemple, si vous voulez transmettre des valeurs statiques à l'aide d'une variable de substitution pour la période de début, définissez le type de variable sur Texte et indiquez ensuite une variable de substitution en tant que paramètre (accepté par l'API REST d'intégration), comme &ThisMonth#&ThisYear. (Une variable de substitution est un nom de variable utilisateur précédé d'une ou de deux esperluettes (&)).

Les variables d'exécution par défaut sont les suivantes :

Période de début
Période de fin
Mode d'import
Mode d'export
Envoyer un message
Destinataire
Joindre un journal
Exécution d'étape

Pour modifier les variables d'exécution de pipeline, procédez comme suit :

Sur la page d'accueil de l'intégration des données, cliquez sur à droite du pipeline, puis sélectionnez Détails du pipeline.
Sur la page Pipeline, sélectionnez l'onglet Variables.
Sélectionnez la variable à modifier.
Pour ajouter ou modifier un nom de variable prédéfini, indiquez le nom dans Nom de la variable.

Le nom de la variable peut être référencé en tant que paramètre de job. Le nom ne doit pas dépasser 20 caractères et ne doit pas contenir d'espaces.
Dans Nom d'affichage, indiquez le nom d'invite d'affichage de la variable.
Dans Ordre d'affichage, indiquez l'ordre d'affichage de la variable.
Cochez la case Requis si une valeur de variable est requise pour exécuter le pipeline.
Dans la liste déroulante Type de validation, sélectionnez le type de valeur utilisé pour valider la variable.

Les types de validation sont les suivants :
- Liste : utilise une requête de liste de valeurs. Valeurs de liaison requises.
- Texte : champ de texte libre.
- Fichier : nom de fichier. Une fenêtre de navigateur de fichiers permet de sélectionner un fichier.
- Liste personnalisée : liste de valeurs définie par l'utilisateur.
  
  Pour utiliser ce type de validation, fournissez une liste de valeurs dans la fenêtre Paramètre de validation. Les valeurs doivent être indiquées au format Value,Label et chaque ligne doit terminer par un caractère de retour à la ligne. Exemple :
```
M,Month
Q,Quarter
Y,Year
```
- Consultation : utilisez les valeurs de consultation disponibles.
Dans la liste déroulante Paramètres de validation, sélectionnez les paramètres prédéfinis de la variable en fonction du type de validation.

Ainsi, vous pouvez sélectionner un paramètre de variable Période de début en fonction d'un type de validation Liste, par exemple :
- Statut de pipeline
- Requête de liste de valeurs de mode d'export de pipeline
- Requête de liste de valeurs de nom de période globale
- Requête de liste de valeurs d'emplacement sans sécurité
- Requête de balance des comptes convertie par compte/entité cible
- Requête de surveillance de processus

Dans Valeur par défaut, sélectionnez la valeur par défaut de la variable.

La valeur par défaut peut être une valeur statique ou une variable de substitution Planning.

Les variables d'exécution par défaut et leur description sont présentées dans le tableau suivant.

Table 12-40 Variables d'exécution par défaut et descriptions

Nom de la variable	Valeurs disponibles
Période de début	Permet d'indiquer la première période incluse dans la portée du traitement d'import/export du pipeline. Elle définit le début de la plage de périodes utilisée par l'étape d'échange de données (souvent conjointement avec Période de fin) pour déterminer les données des périodes à traiter.
Période de fin	Permet d'indiquer la dernière période incluse dans la portée du traitement d'import/export du pipeline. Elle définit la fin de la plage de périodes (utilisée avec Période de début) pour définir les données des périodes que l'étape d'échange de données traitera.
Mode d'import	Permet d'indiquer comment le pipeline d'échange de données doit gérer le chargement des données entrantes lors d'une étape d'import, c'est-à-dire si l'import remplace les données existantes ou ajoute/met à jour les données existantes dans la cible. Remplacer : (valeur par défaut) remplace les données cible existantes pour la portée d'import, puis charge les nouvelles données. Ajouter : conserve les données cible existantes et ajoute de nouveaux enregistrements et/ou met à jour les enregistrements correspondants en fonction des règles d'import. Aucun import : ne charge pas les données. Mapper et valider : exécute l'import à l'aide des mappings et des règles de validation définis pour transformer et valider les données source, mais n'écrit pas les données dans la cible. Permet de vérifier le fichier/format, la couverture de mapping et les validations de règle, ainsi que de passer en revue les erreurs ou les avertissements avant d'exécuter un mode de chargement/validation.
Mode d'export	Permet d'indiquer comment le pipeline d'échange de données doit exporter les données : Fusionner : (valeur par défaut) exporte uniquement les données de la portée d'exécution en cours et les combine avec toute sortie d'export existante pour le fichier/l'emplacement cible. Les enregistrements existants peuvent être mis à jour lorsque les clés correspondent. De nouveaux enregistrements sont ajoutés. Cumuler : ajoute la sortie d'export de l'exécution en cours à la sortie existante en tant qu'ensemble d'enregistrements supplémentaire (ajout uniquement), en conservant le contenu exporté précédent. Remplacer : génère une nouvelle sortie d'export pour la portée d'exécution en cours et remplace le contenu/fichier d'export existant dans l'emplacement cible. Exécution à blanc : exécute le processus d'export (sélection de portée, formatage, validations) sans produire ni écrire la sortie finale de l'export, ce qui vous permet de vérifier les résultats et de détecter les problèmes avant de générer les fichiers. Aucun export : n'exporte pas les données.
Envoyer un message	Permet de déterminer si le pipeline envoie une notification par courriel concernant son exécution : Toujours : envoie une notification par courriel pour chaque exécution de pipeline, quel que soit le résultat (succès, avertissement ou échec). Non : (valeur par défaut) n'envoie aucune notification par courriel pour l'exécution de pipeline. En cas d'échec : envoie une notification par courriel uniquement lorsque l'exécution de pipeline échoue (ou se termine avec un statut d'erreur). En cas de succès : envoie une notification par courriel uniquement lorsque l'exécution de pipeline est terminée.
Destinataire	Permet d'indiquer la liste des destinataires de courriel pour les notifications d'exécution de pipeline lorsque l'option Envoyer un message est activée.
Joindre des journaux	Permet de déterminer si les journaux d'exécution de l'exécution de pipeline sont inclus en tant que pièces jointes avec les résultats/notifications de pipeline (par exemple, dans la sortie de job ou toute charge utile de courriel/notification configurée). Non : (valeur par défaut) ne joint pas les journaux. Oui : joint les journaux.
Exécution d'étape	Démarrer à partir du début : (valeur par défaut) en cas d'échec du pipeline, permet de redémarrer le processus depuis le début. Démarrer à partir de l'échec : en cas d'échec du pipeline, au lieu de redémarrer le processus, permet de démarrer le job à partir de la dernière étape qui a échoué. Lorsqu'un pipeline est redémarré à partir d'une étape en échec, le statut des jobs de la phase précédente est transféré vers la nouvelle exécution de pipeline. Note: Si vous sélectionnez Démarrer à partir de l'échec mais que le pipeline a réussi, le pipeline ne sera pas exécuté.

Cliquez sur Enregistrer.