Créer une activité de sonde JavaScript

Créez une activité de sonde JavaScript pour demander à un MID Server d’exécuter JavaScript côté serveur.

Avant de commencer

Rôle requis : activity_creator ou workflow_admin

Pourquoi et quand exécuter cette tâche

L’activité JavascriptProbe a les mêmes fonctionnalités que les appels de 'packages' dans des bibliothèques Java standard. Cela vous permet d’avoir plus de contrôle sur les bibliothèques Java sur le MID Server. Vous pouvez charger vos propres fichiers JAR sur le MID Server et demander à JavascriptProbe d’effectuer des appels de package dans ces fichiers Java.

Procédure

1. Créez une activité personnalisée.
   Cette action crée une activité personnalisée à l’aide d’un modèle.
2. Après avoir configuré les propriétés générales et créé des variables d’entrée, configurez la commande d’exécution de l’activité de sonde JavaScript.

   Option	Description
   Mappez les variables d’entrée	Utilisez les variables que vous avez créées pour configurer la commande qu’Orchestration exécute sur le MID Server.
   Type de script	Sélectionnez le type de script à inclure. Options disponibles : JavaScript personnalisé Script include MID Server
   Script	JavaScript personnalisé à exécuter avec cette sonde. Remarque : Ce champ est disponible lorsque le type de script sélectionné est JavaScript personnalisé.
   Script include MID Server	Script pour que le MID Server s’exécute avec cette sonde. Remarque : Ce champ est disponible lorsque le type de script sélectionné est Script include de MID Server.
   Sélectionner un MID Server par hôte	Serveur MID sur lequel la sonde s’exécute.
   Options requises de Serveur MID	Serveur MID à utiliser, par options.
   Paramètres	Paires nom-valeur à transmettre à l’hôte avec cette sonde. Vous pouvez créer ces paramètres manuellement ou faire glisser les variables d’entrée dans les champs Paramètres et affecter une valeur.

   Remarque :

   Vous pouvez mapper automatiquement les valeurs des paramètres d’une charge utile de test aux variables de l’onglet Sorties . Reportez-vous à la section Variables de sortie de mappage automatique.

Que faire ensuite

Terminez la création de votre activité de sonde JavaScript en créant des variables de sortie, une règle d’analyse ou desconditions. Reportez-vous à la rubrique Créer des activités personnalisées pour connaître les options de votre modèle.

Paramètres d’exécution du modèle de sonde JavaScript

Vous utilisez des paramètres d’exécution pour créer le script de processus d’entrée dans le formulaire de prétraitement du concepteur d’activité.

Pour obtenir des descriptions des champs de commande de sonde JavaScript, consultez la table de la section Configurer la commande d’exécution de sonde JavaScript.

Remarque :

Vous devez utiliser le préfixe executionParam. avec toutes les variables de cette table.

Tableau 1. Paramètres d’exécution du modèle JavaScript

Nom	Variable	Type	Utilisation
Type de script	script_type	Énumérés	Type de script à exécuter. Les types possibles sont les suivants : custom_javascript_typ mid_script_include_type
Script	script	Chaîne	Script qui exécute JavaScript personnalisé lorsque la script_type est custom_javascript_type.
Script Include du MID	mid_script_include	Référence	Référence sys_id associée au script include du MID Server à appeler, lorsque le script_type est mid_script_include_type.
Source	source	Chaîne	Hôte cible sur lequel exécuter le script.
Capacités MID	Fonctionnalités MID	Chaîne (séparée par des virgules)	Liste des options de MID Server requises.
Paramètres	paramètres	Tableau d’objets JavaScript	Tableau d’objets JavaScript, exprimé avec le préfixe executionParam. Pour ajouter d’autres paires nom-valeur au tableau de paramètres , ajoutez-les au tableau existant. Créez un objet JavaScript avec la syntaxe suivante et ajoutez-le au tableau executionParam.parameter . Cela affecte des paramètres supplémentaires au message : var newParameter = {"name":"parameterName","value":"parameterValue"}; executionParam.parameters.push(newParameter);
Options de valeur	valueCapabilities (en anglais seulement)	Tableau de la carte de hachage	Valeurs d’aptitude utilisées pour sélectionner le MID Server. Pour plus d’informations, consultez Options du MID Server. Si des options supplémentaires sont affectées par valeur, utilisez cet exemple pour personnaliser la sélection du MID Server : var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability);

Paramètres de post-traitement du modèle de sonde JavaScript

Utilisez ces paramètres pour créer un script de post-traitement.

Tableau 2. Paramètres de post-traitement de sonde JavaScript

Nom	Variable	Type	Utilisation
Charge utile	payload	Chaîne	Contient la charge utile brute renvoyée par la sonde JavaScript.
Sortie	output	Chaîne	Contient les données de sortie renvoyées par la sonde JavaScript.
EccSysId (en anglais seulement)	eccSysId (en anglais seulement)	Chaîne	Contient l’ID de référence associé au message d’entrée de file d’attente ECC.
Messages d'erreur	messages d’erreur	Chaîne	Contient les messages d’erreur renvoyés par la sonde JavaScript. Si aucun message d’erreur n’est renvoyé, cette valeur est nulle.

Configurer la commande d’exécution de sonde JavaScript

Utilisez les variables d’entrée que vous avez créées pour configurer la commande exécutée par Orchestration sur l’hôte cible de la sonde JavaScript.

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 de sonde JavaScript entre le MID Server et la 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 de sonde JavaScript

   

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

   Tableau 3. Champs de commande d’exécution de sonde JavaScript

   Champ	Description
   Entrée	Générateur de variable d’entrée. Créer des variables d’entrée pour mapper aux champs disponibles.
   Type de script	Sélectionnez le type de script à inclure. Options disponibles : JavaScript personnalisé Script include MID Server
   Script	JavaScript personnalisé à exécuter avec cette sonde. Ce champ est disponible lorsque le type de script sélectionné est JavaScript personnalisé.
   Script include MID Server	Script pour que le MID Server s’exécute avec cette sonde. Ce champ est disponible lorsque le type de script sélectionné est Script include de MID Server.
   Sélectionner un MID Server par hôte	Serveur MID sur lequel la sonde s’exécute.
   Options requises de Serveur MID	Serveur MID à utiliser, par options.
   Paramètres	Paires nom-valeur à transmettre à l’hôte avec cette sonde. Vous pouvez créer ces paramètres manuellement ou faire glisser les variables d’entrée dans les champs Paramètres et affecter une valeur.

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