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 du 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 de variable

   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 MID Server 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 Propriétés pour l’activité dans le workflow. La fonctionnalité de test d’entrée vous permet de filtrer les variables obligatoires.
   Par défaut	Valeur par défaut de 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 prend la forme d’une icône de flèche vers le haut/vers le ).

6. Pour supprimer une variable, cliquez sur l’icône de suppression ( ) de la ligne.
7. Cliquez sur Continuer pour passer à l’étape 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

Une fois les variables d’entrée créées, 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 les valeurs requises par l’hôte cible ou le point de terminaison pour s’authentifier et interroger les données. Cet exemple inclut des champs pour qu’une commande s’exécute 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 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 les sorties des modèles 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 commande 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 Serveur MID
   Fichier de script Serveur MID	Fichier de script Serveur MID à exécuter. Ce champ est disponible lorsque le type de script sélectionné est Fichier de script de 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 Commande Powershell personnalisée. Vous pouvez glisser-déposer des 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é , votre valeur apparaît en texte brut dans ce champ et n’est chiffrée que lorsqu’elle passe à 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 les commandes Powershell sur l’hôte. Si ce champ est laissé vide, le serveur MID teste 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 essaie les informations d’identification pour cet alias uniquement et n’essaie 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.
   Options 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 du modèle d’activité 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 à des champs dans le 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 à partir de n’importe quelle étape dans le concepteur d’activité, si votre activité est correctement configurée. En règle générale, l’étape 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, ces valeurs apparaissent 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’a été affectée.
3. Réinitialisez les valeurs si nécessaire.
   • Réinitialiser les valeurs par défaut : remplace 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 de variables d’entrée, même si des valeurs par défaut existent.
4. Lorsque vos valeurs de test sont correctement configurées, 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 qui en résulte. Les boutons du formulaire de réponse affichent différentes vues de la charge utile. L’ensemble de la charge utile s’affiche 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.