Créer des variables d’entrée

Créez les variables à transmettre dans l’activité dans le formulaire Entrées du concepteur d’activité.

Avant de commencer

Vous devez nommer votre activité dans le formulaire Général avant de pouvoir passer à l’étape des intrants .

Rôles requis : workflow_admin ou activity_creator

Remarque :

Les chaînes de variables dans le formulaire Entrées ont une limite de 255 caractères.

Procédure

1. Cliquez sur l’icône + pour créer une variable d’entrée.

   Le concepteur crée une variable par défaut appelée Input1.

   

2. Saisissez votre nouveau nom de variable dans le champ.
3. Pour modifier le nom d’une variable ou de l’un de ses attributs, double-cliquez sur la valeur, puis sélectionnez ou saisissez une nouvelle valeur dans le champ qui s’affiche.
4. Configurez votre variable à l’aide de ces champs :

   Tableau 1. Configuration des variables

   Champ	Description
   Type	Type de données pour cette variable. Double-cliquez sur le champ pour afficher la liste de choix. En plus des types de données habituels, vous pouvez créer des tableaux d’entrée et chiffrer des variables individuelles contenant des données sensibles. Les variables chiffrées sont transmises à la file d’attente ECC, puis déchiffrées par le Serveur MID lorsqu’elles s’exécutent sur l’hôte cible. Les données sensibles renvoyées par l’exécution de ces variables sur l’hôte peuvent ensuite être transmises à une autre activité via des variables de sortie chiffrées.
   Obligatoire	Marque une variable d’entrée comme obligatoire. Les variables marquées comme obligatoires sont des champs obligatoires dans le formulaire des propriétés pour l’activité du workflow. La fonctionnalité de test d’entrée vous permet de filtrer sur les variables obligatoires.
   Par défaut	Valeur par défaut pour cette variable d’entrée. Les valeurs par défaut sont préremplies pour les variables dans le formulaire des propriétés de l’activité du workflow. Vous pouvez remplacer cette valeur lorsque vous testez les variables.

5. Pour réorganiser la liste de variables, sélectionnez une ligne, puis faites-la glisser vers son nouvel emplacement.

   Lorsque vous sélectionnez une ligne pour la déplacer, l’icône du pointeur se transforme en icône de flèche vers le haut/vers le bas ( ).

6. Pour supprimer une variable, cliquez sur l’icône de suppression (icône de ) dans la ligne.
7. Cliquez sur Continuer pour passer à l’étape de commande d’exécution ou cliquez sur Aller au prétraitement (avancé) pour créer un script qui s’exécute avant l’exécution de l’activité.

Mapper une variable d’entrée

Après avoir créé les variables d’entrée, mappez-les aux champs du formulaire Commande d’exécution.

Avant de commencer

Rôle requis : activity_admin, activity_creator

Pourquoi et quand exécuter cette tâche

Ces champs contiennent des valeurs requises par l’hôte ou le point de terminaison cible pour s’authentifier et interroger les données. Cet exemple comprend les champs d’une commande à exécuter sur la cible et le serveur MID à utiliser, le cas échéant.

Procédure

Pour mapper une variable, faites-la glisser dans le champ approprié.

Le concepteur exprime automatiquement la variable dans la syntaxe requise par le système.

Configurer la commande d’exécution PowerShell

Utilisez les variables d’entrée que vous avez créées pour configurer la commande qu’Orchestration exécute sur l’ordinateur cible Windows.

Avant de commencer

Créez les variables d’entrée dont vous avez besoin dans le formulaire Entrées avant de pouvoir passer à l’étape de commande d’exécution .

Rôle requis : activity_creator, admin

Remarque :

Vous pouvez tester la connexion PowerShell entre le serveur MID et l’ordinateur cible sans avoir à exécuter l’activité dans un contexte de workflow. Pour plus d’informations, consultez Sorties de modèles de tests.

Procédure

1. Faites glisser les variables de la liste des entrées et déposez-les dans les champs de commande.
   Le système formate la variable dans la syntaxe appropriée pour la commande.

   Figure 1. Commande d’exécution PowerShell

   

2. Renseignez les champs indiqués dans la table.

   Tableau 2. Champs de commandes Powershell

   Champ	Description
   Entrée	Générateur de variables d’entrée. Créez des variables à mapper aux champs disponibles.
   Hôte cible	Nom d’hôte ou adresse IP du serveur cible pour cette activité PowerShell.
   Type de script	Type de script à exécuter sur l’hôte PowerShell. Options disponibles : Commande Powershell personnalisée Fichier de script de Serveur MID
   Fichier de script de Serveur MID	Fichier de script de Serveur MID à exécuter. Ce champ est disponible lorsque le type de script sélectionné est Fichier de script Serveur MID.
   Commande	Commande que cette activité exécute sur l’hôte cible. Ce champ est disponible lorsque le type de script sélectionné est une commande Powershell personnalisée. Vous pouvez glisser-déplacer les variables d’entrée du générateur de variables dans ce champ pour créer votre commande.
   Variables Powershell	Paires nom-valeur à transmettre à l’hôte avec PowerShell. Vous pouvez créer ces variables manuellement ou faire glisser les variables d’entrée dans le champ Valeur . Les variables d’entrée chiffrées conservent leur chiffrement, quels que soient les paramètres de type de données dans ce champ. Si vous saisissez une valeur et sélectionnez le type de données chiffrées , votre valeur apparaît en texte brut dans ce champ et n’est chiffrée que lorsqu’elle est transmise à la file d’attente ECC.
   Utiliser un compte de service MID	Force cette activité à s’authentifier sur l’hôte cible à l’aide des informations d’identification du compte de service de Serveur MID uniquement, sans essayer d’autres informations d’identification. Lorsque cette case est cochée, le champ Balise d’informations d’identification n’est pas disponible.
   Balise d’informations d’identification	Alias d’informations d’identification spécifiques pour les activités Orchestration que cette activité doit utiliser pour exécuter les commandes Powershell sur l’hôte. Si ce champ est laissé vide, le Serveur MID essaie toutes les informations d’identification disponibles jusqu’à ce qu’il en trouve une valide, en terminant par le compte de service du Serveur MID. Si un alias d’informations d’identification est défini, le Serveur MID teste uniquement les informations d’identification pour cet alias et ne teste pas le compte de service du Serveur MID. Ce champ n’est pas disponible lorsque la case Utiliser le compte de service MID est cochée.
   Capacités de Serveur MID requises	Serveur MID à utiliser pour interroger PowerShell, par options. Par défaut, le système sélectionne un Serveur MID PowerShell.

3. Cliquez sur Enregistrer.
4. Cliquez sur Continuer pour passer à l’étape Sorties .

Entrées de modèles d’activités de test

Vous pouvez tester les paramètres d’entrée d’une activité personnalisée pendant son développement sans avoir à exécuter l’activité dans un contexte de workflow.

Avant de commencer

Créez des variables d’entrée et mappez-les aux champs du formulaire Commande d’exécution ou fournissez des valeurs réelles pour ces champs.

Rôle requis : web_service_admin, activity_admin activity_creator

Pourquoi et quand exécuter cette tâche

Un test d’entrée exécute uniquement les paramètres d’entrée sur un point de terminaison et non sur les scripts de prétraitement ou de post-traitement Vous devez utiliser un workflow pour tester un script de prétraitement ou de post-traitement. Vous n’avez pas besoin de consulter l’activité pour la tester, et vous pouvez tester les variables d’entrée à n’importe quelle étape dans le concepteur d’activité, si votre activité est correctement configurée. En règle générale, l’étape de commande d’exécution est le point auquel vos entrées sont prêtes pour le test.

Remarque :

Si vous avez l’intention d’utiliser le mappage automatique, vous devez tester vos variables d’entrée.

Procédure

1. Cliquez sur Tester les entrées.
   La liste des variables sources d’entrée s’affiche. Si vous avez ajouté des valeurs par défaut pour ces variables, celles-ci s’affichent dans la colonne Valeur de substitution . Les variables obligatoires sont marquées d’une étoile rouge. Dans cet exemple, un point de terminaison SOAP renvoie une valeur pour une variable de cotation boursière.

   

2. Filtrez la liste de variables avec ces contrôles :
   • Toutes les entrées : affiche toutes les variables d’entrée. Il s’agit de la vue par défaut.
   • Entrées obligatoires : affiche uniquement les variables d’entrée obligatoires.
   • Entrées sans valeur par défaut : affiche les variables d’entrée auxquelles aucune valeur par défaut n’est affectée.
3. Réinitialisez les valeurs selon vos besoins.
   • Réinitialiser les valeurs par défaut : remplace toutes les valeurs de test définies dans ce formulaire par les valeurs par défaut, le cas échéant.
   • Effacer les valeurs : efface toutes les valeurs de la liste des variables d’entrée, même si des valeurs par défaut existent.
4. Lorsque vos valeurs de test sont configurées correctement, cliquez sur OK.
   Le système exécute les valeurs de toutes les entrées configurées par rapport à la cible spécifiée et renvoie la charge utile résultante. Les boutons du formulaire de réponse affichent différentes vues de la charge utile. L’ensemble de la charge utile apparaît dans la fenêtre Sortie brute .

   Figure 2. Charge utile de la réponse à partir du test d’entrées

   

5. Pour mapper automatiquement les valeurs de paramètres appropriées de la charge utile aux variables de l’étape Sorties , sélectionnez une option de mappage automatique.
6. Vous pouvez également cliquer sur Enregistrer pour les règles d’analyse afin de copier l’intégralité de la charge utile dans les règles d’analyse.
   Cela vous permet de sélectionner manuellement des valeurs pour les variables de sortie directement à partir de la charge utile. Cette action remplace complètement toute charge utile précédente qui existait dans les règles d’analyse.
7. Cliquez sur le X dans le coin supérieur droit de la fenêtre pour la fermer.