Présentation des paramètres de workflow

Les workflows qui n'agissent pas sur l'entrée ont une portée limitée ; un grand nombre de workflows doivent être paramétrés pour présenter une utilité. Pour ce faire, il faut ajouter un membre parameters à l'objet workflow global. Le membre parameters est lui-même un objet comportant normalement un membre pour chaque paramètre. Chaque membre parameters doit avoir les membres suivants :

Table 4-2  Membres obligatoires des paramètres des workflows

Membre obligatoire Type Description label String Etiquette associée à l'entrée du paramètre de workflow type String Type du paramètre de workflow

Le membre type doit être défini sur l'un des types suivants :

Table 4-3  Noms des types de membres du workflow

Nom du type Description Boolean Valeur booléenne ChooseOne Une valeur parmi plusieurs spécifiées EmailAddress Adresse électronique File Fichier destiné à être transféré à l'appareil Host Hôte valide, sous forme de nom ou de décimal avec points HostName Nom d'hôte valide HostPort Port valide disponible Integer Entier NetAddress Adresse réseau NodeName Nom de noeud réseau NonNegativeInteger Entier supérieur ou égal à zéro Number Nombre quelconque, notamment nombre à virgule flottante Password Mot de passe Permissions Autorisations POSIX Port Numéro de port Size Taille String Chaîne StringList Liste de chaînes

Exemple 4-3  Workflow utilisant deux paramètres

Sur la base des types spécifiés, une forme d'entrée appropriée sera générée à l'exécution du workflow. L'exemple ci-dessous présente un workflow à deux paramètres, le nom d'une division commerciale (à utiliser comme projet) et le nom d'un partage (à utiliser comme nom de partage) :

var workflow = {
       name: 'New share',
       description: 'Creates a new share in a business unit',
       parameters: {
               name: {
                       label: 'Name of new share',
                       type: 'String'
               },
               unit: {
                       label: 'Business unit',
                       type: 'String'
               }
       },
       execute: function (params) {
               run('shares select ' + params.unit);
               run('filesystem ' + params.name);
               run('commit');
               return ('Created new share "' + params.name + '"');
       }
};

Si vous téléchargez ce workflow et que vous l'exécutez, une boîte de dialogue vous invitera à renseigner le nom du partage et celui de la division commerciale. Une fois que le partage aura été créé, vous en serez informé dans un message.