Centro de soporte de Workiva

Los comandos son las tareas realizadas dentro de la cadena, basadas en una conexión con una fuente de datos. Para cadenas más complejas, puede incluir comandos activados por diversas condiciones.

Nota: Antes de añadir una cadena, asegúrate de que tu organización establece las conexiones necesarias para habilitar los comandos con sus orígenes de datos.

Para ejecutar comandos específicos en serie-uno tras otro, esperando cada uno a que termine el comando anterior- o simultáneamente en paralelo, o para que falle una cadena si falla uno de varios comandos, agrúpalos.

Añadir un comando a una cadena

1. En la cadena, selecciona el comando a ejecutar:

   • Para Agregar un nuevo comando a la cadena, en Conectores disponibles, haz clic en su conexión y, a continuación, mueve el comando al lugar de la cadena donde debería aparecer.
   • Para duplicar un comando existente, selecciona su nodo, haz clic en Copiar file_copy y mueve el nuevo nodo a donde debería ocurrir en la cadena.

   Consejo: Para añadir un comando como primer nodo de la cadena, muévelo a Empieza en.

2. Para vincular el comando a sus nodos anterior y siguiente de la cadena, haz clic y arrastra las Líneas entre los puertos de sus nodos.

   Nota: Para cambiar la posición de un nodo en la cadena, desvincúlalo de otros nodos y, a continuación, muévelo al lugar donde debería estar. Para desplazar varios nodos a la vez, mantén pulsado MAYÚS mientras los seleccionas.

3. Selecciona el nuevo nodo y haz clic en Editar crear.
4. Introduce los parámetros del comando:
   • En Información básica, introduce un nombre que sea único y una descripción que ayude a identificar el comando y su Intención.
   • Activa el icono de ojo si quieres ocultar los resultados con datos confidenciales.
   • Para ejecutar el comando varias veces, para cada elemento de la lista, activa Iteradorrepetir, y introduce los valores de iteración.
   • Debajo de Propiedades del comando, introduce las entradas del comando, en función del conector.
5. Haz clic en Guardar.

Ejecutar solo un comando o un grupo

Para facilitar las pruebas y las iteraciones rápidas a medida que construyes cadenas, puedes ejecutar un solo comando o grupo de comandos dentro de una cadena.

1. En Chain Builder, desde la pestaña Cadenas, selecciona Ejecutar flight_takeoff desde el menú de la cadena.
2. Para que se ejecute el comando o grupo, haz clic en Ejecutar este comando play_circle_outline.
3. Haz clic en Ejecutar cadena.

Omitir un comando

Para desarrollar una lógica de bifurcación, o como parte del desarrollo de una cadena, puede que necesites omitir un comando para forzar un resultado concreto. También puedes establecer una lógica condicional para que devuelva automáticamente un resultado concreto en función de unas Reglas establecidas.

1. En la cadena, selecciona el nodo del comando, haz clic en Editar create, y selecciona Omitirskip_next.
2. Elige si se debe devolver automáticamente un resultado de información check_circle, advertencia warning o error error para el comando cuando se omita.

3. Para omitir el comando solo si se cumplen determinados criterios, especifica cuándo. Construye la lógica condicional como un grupo al que añadir reglas y otros grupos de reglas, cada uno unido con un booleano Y u O.

   • Si todas las condiciones deben ser verdaderas para omitir, selecciona Y.
   • Si solo debe cumplirse una condición para omitir, selecciona O.

   Puedes añadir reglas basadas en varios tipos de datos:

   Tipo de datos	Descripción
   Cadena	Dos o más caracteres
   Entero	Cualquier valor numérico entero no decimal
   Fecha	Cualquier cadena de fecha o variable de Fecha.
   Flotante	Cualquier valor numérico
   JSON	JavaScript Object Notation; usa Transformación de variables para analizar objetos

   Para verificar si los datos cumplen los criterios para omitir el comando, emparéjalos con un operador y un valor:

   • Está en blanco o No está en blanco
   • Contiene
   • Coincide con RegExp, para expresión regular
   • Empieza por o Finaliza con
   • = o !=
   • < o >
   • <= o >=
4. Haz clic en Guardar.

Gestionar el tratamiento de errores de un comando

Detectar o ignorar errores de un comando:

1. En la cadena, haz clic en el nodo del comando, haz clic en Editar create, y selecciona Gestión de errores warning.
2. En Acciones de error repeat, selecciona qué hacer si el comando falla.
   
   • Para seguir la lógica de ramificación en cadena, selecciona Continúa con la cadena.
   • Para detener la cadena temporalmente, por ejemplo para solucionar la incidencia, selecciona Pausa la cadena. Para reiniciar la cadena una vez resuelta la incidencia, selecciona el comando en la cadena y haz clic en Reanudar.
   • Para detener la cadena por completo, selecciona Salir de la cadena.
3. Para detener el comando si tarda más de lo esperado, en Condiciones de tiempo de espera alarm, ingresa su duración máxima en segundos.
   
4. Para reintentar un comando si su fuente de datos es intermitente o no está disponible, introduce el número de reintentos a intentar y cuántos segundos esperar entre intentos.
5. En Condiciones de error priority_high, selecciona cualquier error que se deba ignorar, como al crear una carpeta que ya existe.
6. Para establecer el estado del comando en función de su resultado, haz clic en Añadir en Interpretación del resultado y define la regla (o grupo de reglas) para interpretar su estado.  Por ejemplo, con la variable Estado de la salida Detalles del comando, puedes establecer una regla que dé lugar a una advertencia cuando el comando tenga éxito.
   
7. En Interpretación del registro, selecciona si el comando debe fallar en función de si da lugar a resultados específicos.
   • Para no fallar el comando basándote en resultados específicos, selecciona No interpretar.
   • Para hacer fallar el comando cuando se encuentran salidas específicas, selecciona Fallar si se encuentra(n) salida(s), e introduce las salidas a buscar.
   • Para hacer fallar el comando cuando no se encuentran salidas específicas, selecciona Fallar si no se encuentra(n) salida(s), e introduce las salidas a buscar.
   • Las líneas de texto múltiples deberán separarse con \n
8. Haz clic en Guardar.

Ver el resultado de un comando

Desde Monitorflight_takeoff, puedes previsualizar el resultado de un comando ejecutado a través del CloudRunner. 

1. En Generador de cadenas, desde Monitor, abre la ejecución con el Resultado a previsualizar, y selecciona el comando.
2. En la pestaña Salidas, haz clic en Vista previa de la salidavisibilidad para visualizar la salida.
   

Nota: Solo puedes previsualizar los resultados de los comandos ejecutados a través del CloudRunner, no a GroundRunner.

Quitar un comando de una cadena

Para eliminar un comando de una cadena, haz clic en su nodo, haz clic en Eliminar delete, y luego haz clic en Eliminar.

Nota: Para ayudar a garantizar la lógica de la cadena, no puedes eliminar un comando si su padre tiene varios hermanos o ramas en su mismo nivel.