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 Entrées .

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 le nom de votre nouvelle 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 à ECC Queue (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é dans le workflow. La fonctionnalité de test d’entrée vous permet de filtrer les variables obligatoires.
   Valeur 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é dans le 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 glisser la ligne 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 haut/bas ( ).

6. Pour supprimer une variable, cliquez sur l’icône de suppression ( ) 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 cible ou le point de terminaison 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 vers 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èle de test.

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 affiché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 un fichier de script Serveur MID.
   Commande	Commande sur laquelle cette activité s’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époser 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 passe dans 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 d’Orchestration que cette activité doit utiliser pour exécuter des 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 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 du 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 .

Tester les entrées de modèles d’activités

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 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 d’extraire l’activité pour la tester, et vous pouvez tester les variables d’entrée à n’importe quelle étape du 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 à 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 de la bourse.

   

2. Filtrez la liste de variables à l’aide des contrôles suivants :
   • 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’a été affectée.
3. Réinitialisez les valeurs si nécessaire.
   • 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 Réponse affichent différentes vues de la charge utile. La charge utile complète apparaît dans la fenêtre Sortie brute .

   Figure 2. Charge utile de 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 toute 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.