Créer des variables d’entrée

Créez les variables à transmettre à 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 nouveau nom de la 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 apparaît.
4. Configurez votre variable à l’aide des champs suivants :

   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 après 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 étant obligatoire. Les variables marquées comme obligatoires sont des champs obligatoires dans le formulaire de propriétés pour l’activité du 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 de 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 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 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 Accéder au prétraitement (avancé) pour créer un script qui s’exécute avant que l’activité ne s’exécute.

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 les valeurs requises par l’hôte ou le point de terminaison cible pour s’authentifier et demander des données. Cet exemple comprend des champs pour une commande à exécuter sur la cible et le MID Server à 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 MID Server et l’ordinateur cible sans avoir à exécuter l’activité dans un contexte de workflow. Pour plus d’informations, consultez Sorties du 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 variable 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 MID Server
   Fichier de script de MID Server	Fichier de script du MID Server à exécuter. Ce champ est disponible lorsque le type de script sélectionné est un fichier de script de MID Server.
   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 Value (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 transférée à 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 du MID Server 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 MID Server essaie toutes les informations d’identification disponibles jusqu’à ce qu’il en trouve une valide, se terminant par le compte de service du MID Server. Si un alias d’informations d’identification est défini, le MID Server essaie uniquement les informations d’identification pour cet alias et n’essaie pas le compte de service du MID Server. Ce champ n’est pas disponible lorsque la case Utiliser le compte de service MID est cochée.
   Options requises de Serveur MID	Serveur MID à utiliser pour interroger PowerShell, par options. Par défaut, le système sélectionne un MID Server 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 au cours de 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 par rapport à 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 du 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 où 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 source 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 remplacement . 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 des variables avec les 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 qui n’ont pas de valeurs par défaut affectées.
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 s’il existe des valeurs par défaut.
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 des entrées

   

5. Pour mapper automatiquement les valeurs de paramètres appropriées dans 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 les valeurs des 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.