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 défini 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
   Mapper 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 Include de script de Serveur MID.
   Sélectionner un serveur MID par hôte	Serveur MID sur lequel la sonde s’exécute.
   Options de Serveur MID requises	Serveur MID à utiliser, par aptitudes.
   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, en créant 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 les 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, reportez-vous à la table de Configurer la commande d’exécution de la 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 un JavaScript personnalisé lorsque le script_type est custom_javascript_type.
Script Include du MID	mid_script_include	Référence	Référence sys_id associée à l’include de script du Serveur MID à 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	Capacités MID	Chaîne (séparée par des virgules)	Liste des options de Serveur MID 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 . Des paramètres supplémentaires sont alors affectés 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 serveur MID. Pour plus d’informations, consultez Options de Serveur MID. Si des options supplémentaires sont affectées par valeur, utilisez cet exemple pour personnaliser la sélection du Serveur MID : 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 la sonde JavaScript

Nom	Variable	Type	Utilisation
Charge utile	charge utile	Chaîne	Contient la charge utile brute renvoyée par la sonde JavaScript.
Sortie	sortie	Chaîne	Contient les données de sortie renvoyées par la sonde JavaScript.
EccSysId (en anglais seulement)	eccSysId	Chaîne	Contient l’ID de référence associé au message d’entrée 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 la sonde JavaScript

Utilisez les variables d’entrée que vous avez créées pour configurer la commande qu’Orchestration exécute 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 la sonde JavaScript entre le serveur MID et la cible sans avoir à exécuter l’action 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 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 variables 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 Include de script de Serveur MID.
   Sélectionner un serveur MID par hôte	Serveur MID sur lequel la sonde s’exécute.
   Options de Serveur MID requises	Serveur MID à utiliser, par aptitudes.
   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 .