Crear y gestionar cadenas

Para automatizar los flujos de trabajo en la plataforma de Workiva y en otros orígenes de datos, los propietarios de espacios de trabajo pueden crear y gestionar secuencias lineales de tareas en forma de cadenas. Por ejemplo, puedes crear una cadena para actualizar automáticamente la información financiera de una fuente de datos en una tabla y, a continuación, enviar esos datos a otra fuente de datos para generar un informe.

Formación adicional disponible

¡Desbloquea el poder de las cadenas con nuestro curso a tu ritmo en el Workiva Learning Hub! Este completo curso te guiará a través del proceso de creación de una cadena de principio a fin, proporcionándote experiencia práctica y un profundo conocimiento de la plataforma del Generador de cadenas.

Visita el Centro de Formación Workiva

Requisitos

Los siguientes roles de usuario de Wdata pueden crear y administrar cadenas:

Propietario del espacio de trabajo con el rol Editor, Profesional o Estándar.
Propietario de la cadena con el rol Editor, Profesional o Estándar.
Generador de cadenas con los permisos correspondientes.

Acceder a las cadenas

Haz clic en Cadenas => Generador de cadenas en Wdata para ver y administrar tus cadenas. Desde Administrador => Seguridad, puedes realizar un seguimiento de los eventos de auditoría sobre la creación y la administración de cadenas.

Crear una cadena

Para definir la secuencia de comandos y eventos que se producirán con una cadena, puedes:

Generar la cadena desde cero
Crear la cadena a partir de una plantilla
Comenzar con una copia de una cadena similar

Para facilitar la reutilización, te recomendamos que crees también variables para utilizarlas dentro de tus cadenas o en tiempo de ejecución.

Desde el Generador de cadenas, puedes arrastrar y vincular los pasos (o nodos) dentro de una cadena.

Paso 1: Añadir la cadena y configurar los detalles

Desde: Cadenas, haz clic en Crear => Crear Cadena.

Nota: También puedes crear una cadena directamente desde la pestaña Cadenas pasando el ratón por encima del icono Construir device_hub de la parte superior derecha.
En Configuración, introduce un nombre único y una descripción para ayudar a identificar la cadena y su propósito.
Para permitir que la cadena se ejecute varias veces simultáneamente, por ejemplo, con diferentes entradas en tiempo de ejecución para cada instancia, selecciona Permitir ejecuciones simultáneas.
Para evitar que se ejecute la cadena, por ejemplo, para posponer su uso, selecciona Deshabilitar ejecución.
Define los valores compartidos o dinámicos utilizados en la cadena:
- En Variables código, define valores que aparecen en múltiples comandos y muchos cambian con frecuencia.
- En Variables Dinámicas código, define los valores a establecer cuando la cadena comience a ejecutarse o durante su ejecución, por ejemplo, basándose en las salidas de comandos anteriores.
Nota: Para pedir a los colaboradores que introduzcan valores para variables dinámicas, incluye un evento de activación Entradas en tiempo de ejecución o Establecer Variables de Cadena Dinámica evento.
Para ejecutar automáticamente la cadena a intervalos regulares o durante un intervalo de fechas específico, en Programas Alarma, especifica cuándo y con qué frecuencia debe iniciarse.
Haz clic en Guardar.

Paso 2: Definir los nodos de la cadena

Cuando construyes una cadena, incluyes y vinculas sus múltiples nodos:

Comandos, o las tareas ejecutadas por la cadena para interactuar con la plataforma de Workiva u otro origen de datos.
Eventos de cadena, que se producen dentro de la cadena, por ejemplo, para activar un flujo de trabajo de aprobación o la subida manual de archivos.
Eventos desencadenantes, como entradas en tiempo de ejecución para establecer variables (como a cuentas, regiones o períodos de tiempo específicos) cuando ejecutas la cadena, o para iniciar automáticamente la cadena en función de cambios en los orígenes conectados.

Agregando nodos

Cuando agregues un nodo, muévelo al lugar de la cadena en el que se produce y enlázalo a sus pasos siguiente y anterior.

Para agregar el primer nodo de la cadena, muévelo al Inicio.
Para agregar un nodo como inicio de una nueva rama de un árbol lógico, vincula el paso anterior de la cadena con el primer nodo de las múltiples ramas.
Para ejecutar comandos en paralelo entre sí o juntos como parte de un proceso en serie, muévelos uno encima del otro para crear un grupo de comandos como el paso.

Nota: Por defecto, un nodo se ejecuta cuando el nodo anterior vinculado tiene éxito. Para activar la lógica condicional, como ejecutar un nodo sólo cuando falla el nodo anterior, haz doble clic en el vínculo y selecciona su condición: éxito círculo_de_verificación, fallo error, advertencia advertencia, o cualquiera círculo_de_verificación.

Una vez definidos los nodos de la cadena, haz clic en Publicar para permitir su ejecución.

Nota: Aunque puedes publicar una cadena con nodos no vinculados, solo los vinculados entre sí -empezando por el nodo Inicio - se ejecutan cuando ejecutas la cadena.

Para facilitar la creación de una cadena, puedes comenzar con una plantilla que proporcione el marco de sus comandos, eventos y variables.

Paso 1. Crear la cadena

En Generador de cadenas, desde la pestaña Plantillasdynamic_feed o Cadenas device_hub, crea la cadena a partir de la plantilla:
- Desde Plantillas, haz clic en el nombre de la plantilla y, a continuación, haz clic en Nueva cadena en la parte superior derecha.
- En Cadenas, haz clic en el icono Generar device_hub y, a continuación, Crear cadena desde plantilla. A continuación, puedes seleccionar la plantilla que quieres utilizar.
Introduce un nombre único para ayudar a identificar la cadena.
Selecciona el espacio de trabajo y el entorno para utilizar la cadena y haz clic en Siguiente.

Paso 2. Asignar las variables y conexiones de la plantilla

Para cada variable de plantilla, selecciona el valor que debe sustituirla en la cadena:
- Para un valor de variable establecido dentro de la cadena , selecciona un Tipo de Variable de Cadena, e introduce un nombre para la nueva variable de cadena.
- Para un valor de variable establecido dentro del espacio de trabajo, selecciona un Tipo de variable de Espacio de trabajo, y selecciona la variable del espacio de trabajo a utilizar.
- Para un archivo subido como recurso dentro del espacio de trabajo, selecciona un Tipo de variable de Recurso del espacio de trabajo, y selecciona el recurso a utilizar.
- Para establecer el valor de una variable dinámica cuando se ejecuta la cadena, selecciona Tipo de variable de Cadena dinámica e introduce un nombre para la nueva variable dinámica de la cadena.
- Para un valor generado cuando la cadena se ejecuta, selecciona un Tipo de variable de Tiempo de ejecución, y selecciona la variable de tiempo de ejecución a utilizar.
Nota: Si seleccionas Dinámica o Recurso cuando añades la variable a la plantilla, no puedes seleccionar un tipo de variable diferente.
Después de asignar las variables de la plantilla a tus nuevas variables o recursos, haz clic en Siguiente.
Para cada conexión utilizada en la plantilla, selecciona el conector y el ejecutor para que realicen sus comandos, y haz clic en Enviar.

Paso 3. Finalizar la cadena

Haz clic en Ver tu nueva cadena.
Personaliza la nueva cadena según sea necesario:
- Actualiza cualquier variable de cadena utilizada mediante las variables de la plantilla.
- Añade cualquier comando o evento adicional para iniciar o completar la cadena.
Haz clic en Publicar.

Para crear una cadena similar a otra cadena del espacio de trabajo, puedes utilizar una copia como punto de partida.

Consejo: Si utilizas con frecuencia una cadena como punto de partida para otras cadenas, crea una plantilla basada en su secuencia de nodos.

En Generador de cadenas, desde la pestaña Cadenas device_hub, selecciona Copiar file_copy del menú de la cadena existente.
Para la nueva copia, haz clic en Editar crear, y actualiza sus nodos o propiedades según sea necesario.

Promover una cadena a un entorno diferente

Como parte de tu ciclo de vida de desarrollo, puedes generar cadenas en un entorno separado de donde los colaboradores las ejecutan. Por ejemplo, puedes crear cadenas en un entorno DEV hasta que estén listas para su uso en un entorno PROD. Para trasladar una cadena de un entorno a otro, puedes promoverla.

En Generador de cadenas, desde la pestaña Cadenas device_hub, selecciona Promovertrending_up en el menú de la cadena.
En Nombre, edita el nombre de la cadena para su nuevo entorno según sea necesario.
En Promover a, selecciona el nuevo entorno de la cadena.
Selecciona si quieres activar los calendarios en la cadena promovida y haz clic en Siguiente.
Para cada conexión de la cadena, elige la conexión que quieras utilizar en el nuevo entorno y haz clic en Siguiente.
Revisa la asignación de conexiones y haz clic en Promover.

Editar una cadena

Para actualizar los pasos o propiedades de una cadena:

En Generador de cadenas, desde la pestaña Cadenas device_hub, haz clic en Editarcrear para la cadena, y actualiza sus comandos y eventos según sea necesario.
Para actualizar las propiedades de la cadena, haz clic en Ajustes de la cadena y ajusta sus programaciones, variables y notificaciones según sea necesario.
Para actualizar en bloque las conexiones de comandos de la cadena, haz clic en el menú de tres puntos y ajusta su Comandos.

Consejo: Puedes organizar fácilmente tus cadenas seleccionando varios nodos a la vez. Sólo tienes que pulsar `Mayúsculas` y arrastrar el cursor del ratón por el lienzo. Obtén más información.

Revertir una cadena a una versión anterior

Para devolver una cadena a una versión publicada anteriormente, por ejemplo, para deshacer cambios o crear una nueva cadena a partir de una versión anterior de otra:

En Generador de cadenas, desde la pestaña Cadenas device_hub, selecciona Versionesassignment_return en el menú de la cadena.
Debajo de Versiones pasadas, selecciona la versión a la que quieres volver y haz clic en Revertir cadenahistorial.
Selecciona el conector y el ejecutor para cada conexión, y establece las variables.
Haz clic en Enviar, Ver cadena revertida yPublicar.

Etiquetas de cadena

Las etiquetas de cadena permiten agrupar cadenas relacionadas y proporcionan información sobre el contenido de la cadena. Una vez creada una etiqueta, se puede utilizar como filtro para las Cadenas dentro de la vista Lista de Cadenas y el Programador.

Añadir una etiqueta de cadena

Selecciona la Cadena para ampliar la vista.
Haz clic en el icono más (+) para introducir un nuevo nombre de etiqueta o seleccionar una etiqueta existente.
Si quieres, puedes definir el color de la etiqueta haciendo clic en ella y eligiendo un color.

Quitar una etiqueta de cadena

Selecciona la Cadena para ampliar la vista.
Pasa el ratón por encima de la etiqueta y haz clic en la (x) gris.

Nota: Actualiza la vista del explorador después de eliminar una etiqueta. Las etiquetas desaparecerán si todas las Cadenas de un inquilino se han disociado de esa etiqueta.

Soporte

Comunidad

Centro de soporte de Workiva