Descripción de los parámetros de flujos de trabajo

Los flujos de trabajo que no funcionan con entrada de datos tienen un alcance limitado, ya que muchos flujos de trabajo necesitan parámetros ajustables para ser de utilidad. Para ello, se agrega un miembro parameters al objeto global workflow. El miembro parameters es a su vez un objeto que se espera que tenga un miembro para cada parámetro. Cada miembro parameters debe tener los siguientes miembros:

Tabla 4-2  Miembros de parámetros de flujo de trabajo requeridos

Miembro obligatorio Tipo Descripción label Cadena Etiqueta para adornar la entrada del parámetro del flujo de trabajo. type Cadena Tipo de parámetro de flujo de trabajo.

El miembro type debe ser de uno de estos tipos:

Tabla 4-3  Nombres de tipos de miembros de flujo de trabajo

Nombre del tipo Descripción Boolean Valor booleano ChooseOne Un valor de una serie de valores especificados EmailAddress Dirección de correo electrónico File Archivo que se transfiere al dispositivo Host Host válido, como nombre o decimal con punto HostName Nombre de host válido HostPort Puerto válido disponible Integer Número entero NetAddress Dirección de red NodeName Nombre de nodo de red NonNegativeInteger Número entero mayor o igual que cero Number Cualquier número, incluido el punto flotante Password Contraseña Permissions Permisos de POSIX Port Número de puerto Size Tamaño String Cadena StringList Lista de cadenas

Ejemplo 4-3  Flujo de trabajo con dos parámetros

En función de los tipos especificados, se genera una entrada apropiada al ejecutarse el flujo de trabajo. Por ejemplo, el siguiente flujo de trabajo tiene dos parámetros, el nombre de una unidad de negocio (que se usa como proyecto) y el nombre de un recurso compartido (que se usa como nombre del recurso compartido):

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 se carga y ejecuta este flujo de trabajo, aparecerá un cuadro de diálogo para que complete el nombre del recurso compartido y la unidad de negocio. Cuando se haya creado el recurso compartido, se genera un mensaje para indicar que se lo creó.