Onglets de configuration de la commande Importer un budget

Important : Un clic sur Cancel dans l’un de ces onglets ferme la boîte de dialogue de configuration des commandes. Toutes les modifications que vous avez apportées depuis la dernière fois que vous avez cliqué sur Save seront supprimées et ne pourront pas être récupérées.

Onglet Modifier la commande

L’onglet Modifier la commande permet de définir les champs à prendre en compte ou à exclure lors de l’exécution de cette commande.

Pour modifier cette commande :

Sélectionnez l’onglet Modifier la commande.
(Facultatif) Dans Name, modifiez le nom par défaut fourni.
(Facultatif) Dans Description, entrez une description utile de ce que la commande est configurée pour faire.
Sous Command Properties, sélectionnez la Workday Connection appropriée pour cette commande et le type de connexion (CloudRunner ou GroundRunner).

Remarque : CloudRunner est la sélection par défaut, mais cette connexion fonctionnera également avec un GroundRunner. Pour plus d’informations sur l’installation et l’utilisation d’un GroundRunner, reportez-vous à la page Workiva Support Install and manage GroundRunners.
Sélectionnez le fichier d’entrée à utiliser.
Il s’agit d’un fichier .csv contenant les données sources. Un modèle de ce fichier peut être obtenu dans la documentation de Workiva.

Remarque : Si vous utilisez un modèle BEI (voir ci-dessous), les en-têtes du CSV doivent correspondre aux champs définis dans le fichier modèle.
Sous Configuration du budget, entrez le Budget Structure ID associé à la structure du plan et le Custom_Budget_ID associé au nom du plan financier.

Sélectionnez le mode d’importation à utiliser.

Mode d'importation	Comportement
Ajout incrémentiel uniquement	Ajoute de nouvelles lignes et met à jour les lignes existantes. Ne supprime rien.
Remplacer tout	Supprime l’ensemble du plan budgétaire existant et le remplace strictement par les données de votre fichier.
Ajout incrémentiel avec suppression	Synchronise le système avec le fichier téléchargé. Ajoute de nouvelles lignes, met à jour les lignes existantes et supprime toutes les lignes du système qui manquent dans le fichier téléchargé.
Remplacer tout par période	Efface et remplace les données uniquement pour les périodes indiquées dans le fichier téléchargé. Préserve les données pour d’autres mois/périodes.

(Facultatif) Saisissez une note Memo décrivant l’objectif de la commande.

Sélectionnez les actions à déclencher lorsque ce nœud est terminé.

Commandement	Description
Clôture automatique	Lorsque la case est cochée, le processus de gestion est automatiquement traité. Cela signifie que toutes les approbations seront automatiquement approuvées dans le système, que toutes les révisions et les tâches seront automatiquement ignorées et que toutes les notifications seront automatiquement supprimées.
Soumettre	Lorsque la case est cochée, la chaîne soumet automatiquement l’action.

Le dernier champ et la dernière case à cocher ne concernent que les modèles EIB. Si vous n’utilisez pas de fichier modèle EIB, vous pouvez ignorer ces deux points.

Note :Le modèle EIB doit être un fichier XML qui définit les champs nécessaires à la réalisation d’une action d’importation de budget. Si vous le précisez, ce fichier aura la priorité sur les données de la « Configuration du budget ».

Si vous utilisez un fichier modèle EIB pour importer les données budgétaires, saisissez le nom du fichier dans le champ EIB template file.
(Facultatif) Cochez la case Ignore warnings pour ignorer tous les avertissements concernant les champs facultatifs manquants.
Le fichier modèle contiendra des champs facultatifs, de sorte que la commande génèrera une erreur si les champs ne sont pas présents, à moins que cette option n’ait été sélectionnée.
Cette option ne s’applique qu’aux opérations d’importation de budget utilisant un modèle EIB.

Onglet Notifications

L’onglet Notifications vous permet de configurer l’envoi d’un courriel de notification lorsqu’une condition est remplie.

Pour établir une notification :

Sélectionnez l’onglet Notifications.
Cliquez sur Nouvelle notification.
Cliquez sur Email.

Complétez les champs du panneau de notification.

Champs du panneau de notification

Nom du champ	Valeurs et actions prises en charge
Condition	Les conditions prises en charge sont les suivantes : Success : la commande s’est déroulée correctement. Erreur : la commande a échoué d’une manière ou d’une autre. Avertissement : ceci indique qu’un résultat escompté a été affecté, mais qu’il peut y avoir des circonstances exceptionnelles sur la façon dont cela s’est produit. Consultez les journaux de sortie de la commande pour obtenir des informations plus précises sur les raisons de ce déclenchement. Pause est un état de la commande. Si la commande est « en pause », la notification sera envoyée. Cela n’a rien à voir avec la mise en pause des notifications. Toujours envoyer : Le message est toujours envoyé.
Destinataires	Adresses électroniques (l’adresse électronique doit être complète) auxquelles le message doit être envoyé. En cliquant dans ce champ, vous ouvrez une liste déroulante de toutes les adresses électroniques valables pour l’espace de travail. Aucun autre courriel ne peut être fourni.
Objet	L’objet de l’e-mail. La valeur par défaut utilise les variables Chain.Environment, Chain.Name, et Command Name, suivies de la condition sélectionnée, mais vous pouvez saisir votre propre texte si vous le souhaitez.
Pièce jointe	Cela vous permet de joindre un fichier à l’e-mail. Sélectionnez le fichier parmi ceux répertoriés dans le volet Select a variable situé à gauche de la boîte de dialogue de configuration.
Nom de la pièce jointe	Il s’agit du nom (y compris l’extension, telle que .txt ou .csv) à attribuer au fichier.
Corps du message	Le texte qui apparaîtra dans le message électronique. Le formatage HTML de base est pris en charge.

Cliquez sur Enregistrer.

Pour envoyer d’autres notifications par courriel, cliquez sur Nouvelle notification en dessous de la notification actuelle, et répétez ces étapes.

Pour plus d’informations sur les notifications, reportez-vous à la page Workiva Support Manage chain and command notifications.

Sauter l’onglet des conditions

L’onglet Skip conditions vous permet de spécifier une condition qui fera sauter la commande et ce qui se passera si la commande est sautée.

Pour définir une condition de saut pour cette commande :

Sélectionnez l’onglet Skip conditions.
Cliquez dans le champ Skip conditions et sélectionnez la condition de déclenchement.
Les options sont les suivantes : succès (la commande s’est déroulée correctement) :
- Succès (la commande s’est déroulée correctement).
- Erreur (la commande a échoué d’une manière ou d’une autre).
- Avertissement (ceci indique qu’un résultat escompté a été affecté, mais qu’il peut y avoir des circonstances exceptionnelles quant à la manière dont cela s’est produit. Vérifiez les journaux de sortie de la commande pour des raisons plus spécifiques sur la raison de ce déclenchement)

Créez la règle qui détermine ce qui se passe lorsque la commande est ignorée.

Sélectionnez ET ou OU. Par défaut, la première instruction commence par ET.
Cliquez sur +RULE, et sélectionnez le type de données à tester.
Les options sont String (par défaut), Integer, Date, Float, et JSON.
Saisissez les critères à utiliser pour le test.

Sélectionnez la valeur du test. Les options sont les suivantes :

Option	Résultat
Est vide	Le résultat est vide (un ensemble vide).
N’est pas vide	Le résultat n’est pas un ensemble vide.
Contient	Le résultat contient une valeur spécifique. La sélection de cette option ouvre un champ secondaire dans lequel vous pouvez saisir la chaîne de caractères à faire correspondre.
Correspond à RegExp	Le résultat correspond à l’expression régulière spécifique. La sélection de cette option ouvre un champ secondaire dans lequel vous pouvez saisir l’expression régulière.
Commence par	Le résultat commence par une chaîne de caractères spécifique. La sélection de cette option ouvre un champ secondaire dans lequel vous pouvez saisir la chaîne de caractères.
Se termine par	Le résultat se termine par une chaîne de caractères spécifique. La sélection de cette option ouvre un champ secondaire dans lequel vous pouvez saisir la chaîne de caractères.
= (equals)	Le résultat correspond à une valeur spécifique. La sélection de cette option ouvre un champ secondaire dans lequel vous pouvez saisir la valeur.
!= (ne correspond pas)	Le résultat ne correspond pas à une valeur spécifique. La sélection de cette option ouvre un champ secondaire dans lequel vous pouvez saisir la valeur.
&lt ; (inférieur à)	Le résultat est inférieur à une valeur spécifique. La sélection de cette option ouvre un champ secondaire dans lequel vous pouvez saisir la valeur.
&gt ; (supérieur à)	Le résultat est supérieur à une valeur spécifique. La sélection de cette option ouvre un champ secondaire dans lequel vous pouvez saisir la valeur.
&lt ;= (inférieur ou égal à)	Le résultat est inférieur ou égal à une valeur spécifique. La sélection de cette option ouvre un champ secondaire dans lequel vous pouvez saisir la valeur.
&gt ;= (supérieur ou égal)	Le résultat est supérieur ou égal à une valeur spécifique. En sélectionnant cette option, vous ouvrez un champ secondaire dans lequel vous pouvez saisir la valeur à prendre en considération.

Si vous n’avez qu’une seule condition, cliquez sur Save.
Si vous avez plus d’une condition, cliquez à nouveau sur +RULE pour ajouter une seule condition, ou sur +GROUP pour que les conditions soient évaluées en tant que groupe.

Notes

Les conditions sont évaluées dans l’ordre de la liste (de haut en bas). Les conditions groupées sont évaluées en tant qu’unité, puis le résultat est évalué dans l’ordre dans lequel le groupe apparaît dans la liste.
Il n’existe aucun moyen de réorganiser les conditions ; si vous souhaitez modifier l’ordre des conditions, vous devrez recréer la liste dans l’ordre dans lequel vous souhaitez qu’elles soient évaluées.
Pour plus d’informations sur les conditions de saut, reportez-vous à la page de la communauté Workiva Conditions de saut : A ne pas sauter, mais à prendre en considération ! et la page Workiva Support Gérer les commandes en chaîne.

Onglet Sorties dynamiques

L’onglet Sorties dynamiques vous permet de spécifier des règles pour extraire une valeur ou une liste de valeurs de la sortie d’une commande, qui peuvent ensuite être utilisées plus loin dans la chaîne. Vous pouvez ajouter plusieurs sorties dynamiques à une commande en utilisant soit : une correspondance exacte - un texte spécifique au début ou à la fin des valeurs à extraire :

Une correspondance exacte - avec un texte spécifique au début ou à la fin des valeurs à extraire.
Une expression régulière - pour faire correspondre les valeurs en fonction d’un modèle ou d’une séquence spécifique.

Pour définir les règles de sortie dynamique, procédez comme suit.

Sélectionnez l’onglet Sorties dynamiques.
Cliquez sur +ADD DYNAMIC OUTPUT. Le panneau de configuration de la sortie dynamique s’affiche.
Saisissez un nom pour cette sortie.
Dans Original output, sélectionnez la sortie qui doit être transformée.
Configurez la manière dont la sortie doit être dérivée et stockée. Les champs suivants sont tous facultatifs.
- Le champ Match text peut contenir le texte à faire correspondre ou une expression régulière.
- Pour obtenir une correspondance exacte avec le texte fourni, sélectionnez « Exact » dans Type de correspondance.
- Pour utiliser une expression régulière, sélectionnez « Expression régulière (regex) » dans Type de correspondance.
- Dans Match result, indiquez comment le texte résultant doit être affiché.
  Par exemple, si le résultat est constitué de chiffres entre parenthèses, vous devez saisir 0 $ pour afficher la totalité de la valeur correspondante, y compris les parenthèses, ou 1 $ pour afficher uniquement les chiffres correspondants sans les parenthèses.
- Pour faire correspondre le texte à des lignes spécifiques de la sortie, entrez le(s) numéro(s) de ligne ou la (les) plage(s) de numéros séparés par des virgules dans Lignes à vérifier. Pour inclure une série de lignes, utilisez un tiret (-), de sorte que 1-10 ne renvoie que le contenu des lignes 1 à 10. Pour séparer les lignes ou les plages, utilisez une virgule (,), de sorte que 1-10, 13 renvoie uniquement le contenu des lignes 1 à 10 et de la ligne 13.
Dans Output type, indiquez si vous souhaitez obtenir un seul résultat ou une liste de résultats.
Cochez ou décochez les cases Case sensitive et Trim Matches pour obtenir les résultats souhaités.
Cliquez sur Enregistrer.
(Facultatif) Cliquez sur Testez pour voir si vous obtenez les résultats escomptés.

Si vous souhaitez créer une sortie dynamique supplémentaire, cliquez sur +ADD DYNAMIC OUTPUT. Ceci affiche le panneau de configuration des sorties dynamiques pour une sortie dynamique supplémentaire.

Pour plus d’informations sur l’utilisation des opérateurs dynamiques, reportez-vous à la page Workiva Support Gérer les sorties dynamiques d’une commande.

Onglet Actions d’erreur

L’onglet Error actions vous permet de spécifier ce qui doit se passer si une erreur se produit lors du traitement de la commande.

Pour définir les actions à entreprendre si cette commande génère une erreur :

Sélectionnez l’onglet Error Actions.
Sous Error actions, sélectionnez l’action que vous voulez que la chaîne prenne si la commande échoue.
- Pour suivre la logique de ramification de la chaîne, sélectionnez Continuer avec la chaîne.
- Pour arrêter temporairement la chaîne, par exemple pour remédier au problème, sélectionnez Pause de la chaîne.
  Pour redémarrer la chaîne une fois le problème résolu, sélectionnez la commande dans la chaîne et cliquez sur Resume.
- Pour arrêter complètement la chaîne, sélectionnez Quitter la chaîne.
Pour arrêter la commande si elle s’exécute plus longtemps que prévu, sous Timeout conditions, entrez la durée maximale d’exécution de la tâche (en secondes).
Pour réessayer une commande si sa source de données est intermittente ou indisponible, entrez le nombre de tentatives à effectuer et le nombre de secondes à attendre entre les tentatives.

Sous Error conditions, sélectionnez les erreurs à ignorer.

Condition	Description
Arguments non valables	En cochant cette case, la commande ignore les arguments non valides.
Échec général	Si vous cochez cette case, la chaîne se poursuivra même si la commande a échoué.

Pour définir l’état de la commande en fonction de sa sortie, cliquez sur le signe plus entouré en vert à gauche de Output interpretation.
Cliquez sur +Règle et définissez la règle -ou le groupe de règles- pour interpréter l’état de sortie.

Si vous souhaitez spécifier des conditions supplémentaires, cliquez sur le signe plus entouré en bleu pour ajouter des champs de définition de conditions supplémentaires.
Les conditions sont évaluées dans l’ordre de la liste (de haut en bas). Les conditions groupées sont évaluées en tant qu’unité, puis le résultat est évalué dans l’ordre dans lequel le groupe apparaît dans la liste.

Remarque : Il n’est pas possible de réorganiser les conditions ; si vous souhaitez modifier l’ordre des conditions, vous devrez recréer la liste dans l’ordre dans lequel vous souhaitez qu’elles soient évaluées.

Sous Log interpretation, choisissez d’ignorer ou non la commande sur la base de sorties spécifiques.
- Pour ne pas faire échouer la commande en fonction de sorties spécifiques, sélectionnez Ne pas interpréter.
- Pour faire échouer la commande lorsque des sorties spécifiques sont trouvées, sélectionnez Fail if output(s) found, et entrez les sorties à rechercher.
- Pour faire échouer la commande lorsque des sorties spécifiques ne sont pas trouvées, sélectionnez Fail if output(s) not found, et entrez la sortie à rechercher.
- Séparez plusieurs lignes de texte par \n.
Cliquez sur Enregistrer.

Onglet Itérateurs

L’onglet Iterators vous permet de définir des règles pour l’itération (cycle ou répétition) de la commande Get Workers.

Remarque : Cet onglet est désactivé par défaut.

Pour définir les règles d’itération, procédez comme suit.

Sélectionnez l’onglet Iterators.
Activez les itérateurs en basculant l’interrupteur en haut de l’onglet.

L’icône située à côté de l’en-tête de l’onglet (Iterators) passe du gris foncé au bleu et affiche le panneau de configuration des itérateurs. Le marqueur à côté du titre de l’onglet devient également vert.
Sélectionnez le type de modificateur à utiliser.
Les options sont List (par défaut) et Repeat until.
- En sélectionnant List, vous répétez la commande :
  - Une liste statique de valeurs, telles que des régions ou des entités. Il peut également s’agir d’un nombre, tel que « 3 ».
  - Une liste dynamique ou variable de valeurs, provenant par exemple d’un fichier téléchargé en tant que ressource de l’espace de travail ou d’une commande exécutée plus tôt dans la chaîne.
- En sélectionnant Repeat until, vous répétez la commande jusqu’à ce que la condition spécifiée soit remplie.
Remarque : Les commandes sont limitées à un maximum de 1000 itérations.
Saisissez la (les) règle(s) pour contrôler les itérations.
Pour plus d’informations sur l’utilisation des itérateurs, y compris sur la manière de les spécifier, consultez la page de support Workiva Use iterators with commands and command groups.
Cliquez sur Enregistrer.

Support

Communauté

Portail de support Workiva