Para automatizar los flujos de trabajo en la plataforma Workiva y en otras fuentes de datos, los propietarios del espacio de trabajo pueden crear y gestionar secuencias lineales de tareas como cadenas. Por ejemplo, puede crear una cadena para actualizar automáticamente la información financiera de una fuente de datos en una tabla y luego enviar esos datos a otra fuente de datos para generar un informe.
Capacitación adicional disponible
¡ Desbloquee el poder de las cadenas con nuestro curso a su propio ritmo en Workiva Learning Hub! Este curso integral lo guía a través del proceso de creación de una cadena de principio a fin, brindándole experiencia práctica y una comprensión profunda de la plataforma Chain Builder.
Visite el centro de aprendizaje de Workiva
Requisitos
Los siguientes roles de usuario de Wdata pueden crear y administrar cadenas:
- Propietario del espacio de trabajocon el rol Editor, Profesionalo Estándar
- Propietario de la cadenacon el rol Editor, Profesionalo Estándar ]
- Chain Builder con permisos apropiados
Cadenas de acceso
Haga clic en Cadenas =>Generador de cadenas en Wdata para ver y administrar sus cadenas. Desde Admin =>Seguridad, puede realizar un seguimiento de los eventos de auditoría sobre la creación y gestión de cadenas.
crear una cadena
Para definir la secuencia de comandos y eventos que ocurrirán con una cadena, puede:
- Construye la cadena desde cero
- Crear la cadena a partir de una plantilla.
- Comience con una copia de una cadena similar
Desde Chain Builder, puede arrastrar y vincular los pasos (o nodos) dentro de una cadena.
Paso 1: agrega la cadena y configura sus detalles
- Desde Cadenas, haga clic en Crear => Crear cadena.
Nota: También puede crear una cadena directamente desde la pestaña Cadenas colocando el cursor sobre el icono Construir en la parte superior derecha.
- En Configuración, ingrese un nombre y una descripción únicos para ayudar a identificar la cadena y su intención.
- Para permitir que la cadena se ejecute varias veces simultáneamente, por ejemplo con diferentes entradas de tiempo de ejecución para cada instancia, seleccione Permitir ejecuciones simultáneas.
- Para evitar que se ejecute la cadena, como posponer su uso, seleccione Deshabilitar ejecución.
- Defina cualquier valor compartido o dinámico utilizado en la cadena:
- En Variables , defina valores que aparecen en múltiples comandos y muchos cambian con frecuencia.
- En Variables dinámicas , defina los valores que se establecerán cuando la cadena comience a ejecutarse o durante su ejecución, como, por ejemplo, en función de las salidas de comandos anteriores.
Nota: Para solicitar a los colaboradores que ingresen valores para variables dinámicas, incluya un evento desencadenanteEntradas de tiempo de ejecución o Establecer variables de cadena dinámica evento.
- Para ejecutar automáticamente la cadena en intervalos regulares o durante un rango de fechas específico, en Programaciones, especifique 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 Workiva u otra fuente de datos.
- Eventos en cadena que ocurren dentro de la cadena, como para habilitar un flujo de trabajo de aprobación o la carga manual de archivos.
- Activar eventos, como entradas de tiempo de ejecución para establecer variables, como cuentas, regiones o períodos de tiempo específicos, cuando ejecuta la cadena, o para iniciar automáticamente la cadena en función de los cambios en fuentes conectadas.
Cuando agregue un nodo, muévalo al lugar donde ocurre en la cadena y vincúlelo a sus pasos anteriores y siguientes.
- Para agregar el primer nodo de la cadena, muévalo a Inicio.
- Para agregar un nodo como inicio de una nueva rama de un árbol lógico, vincule el paso anterior de la cadena al primer nodo de las múltiples ramas.
- Para ejecutar comandos en paralelo entre sí o juntos como parte de un proceso en serie, muévalos uno encima del otro para crear un grupo de comandos como paso.
Nota: De forma predeterminada, un nodo se ejecuta cuando el nodo anterior vinculado tiene éxito. Para habilitar la lógica condicional, como ejecutar un nodo solo cuando falla el nodo anterior, haga doble clic en el enlace y seleccione su condición: éxito, falla, advertenciao cualquier.
Después de definir los nodos de la cadena, haga clic en Publicar para permitir que se ejecute.
Nota: Si bien puede publicar una cadena con nodos no vinculados, solo aquellos vinculados entre sí, comenzando con el nodo Iniciar, se ejecutan cuando ejecuta la cadena.
Para facilitar la creación de una cadena, puede comenzar con una plantilla que proporcione el marco de sus comandos, eventos y variables.
Paso 1. Crea la cadena
- En Chain Builder, desde la pestaña Plantillas o Cadenas , cree la cadena a partir de la plantilla:
- Desde Plantillas, haga clic en el nombre de la plantilla y luego haga clic en Nueva cadena.
- Desde Cadenas, haga clic en el icono Construir [ y luego en Crear cadena a partir de plantilla. Luego puede seleccionar la plantilla a utilizar.
- Desde Plantillas, haga clic en el nombre de la plantilla y luego haga clic en Nueva cadena.
- Ingrese un nombre único para ayudar a identificar la cadena.
- Seleccione el espacio de trabajo y el entorno para usar la cadena y haga clic en Siguiente.
Paso 2. Mapee las variables y conexiones de la plantilla.
- Para cada variable de plantilla, seleccione el valor para reemplazarlo en la cadena:
- Para un valor de variable establecido dentro de la cadena, seleccione un Tipo de variable de Cadena e ingrese un nombre para la nueva variable de cadena.
- Para un valor de variable establecido dentro del espacio de trabajo, seleccione un Tipo de variable del Espacio de trabajo y seleccione la variable del espacio de trabajo que desea usar.
- Para un archivo cargado como recurso dentro del espacio de trabajo, seleccione un Tipo de variable de Recurso del espacio de trabajo y seleccione el recurso que desea utilizar.
- Para un valor de variable dinámica establecido cuando se ejecuta la cadena, seleccione un Tipo de variable de Dinámica de cadena e ingrese un nombre para la nueva variable de cadena dinámica.
- Para un valor generado cuando se ejecuta la cadena, seleccione un Tipo de variable de Tiempo de ejecución y seleccione la variable de tiempo de ejecución que se utilizará.
Nota: Si selecciona Dinámico o Recurso cuando agrega la variable a la plantilla, no puede seleccionar un tipo de variable diferente.
- Después de asignar las variables de la plantilla a sus nuevas variables o recursos, haga clic en Siguiente.
- Para cada conexión utilizada en la plantilla, seleccione el conector y el corredor para ejecutar sus comandos y haga clic en Enviar.
Paso 3. Finaliza la cadena
- Haga clic en Ver su nueva cadena.
- Personalice la nueva cadena según sea necesario:
- Actualice cualquier variable de cadena utilizada por las variables de la plantilla.
- Agregue cualquier comando o evento adicional para iniciar o completar la cadena.
- Haga clic en Publicar.
Para crear una cadena similar a otra cadena en el espacio de trabajo, puede utilizar una copia como punto de partida.
Consejo: Si utiliza con frecuencia una cadena como punto de partida para otras cadenas, cree una plantilla basada en su secuencia de nodos.
- En Chain Builder, desde la pestaña Chains, seleccione Copy en el menú de la cadena existente.
- Para la nueva copia, haga clic en Editar y actualice sus nodos o propiedades según sea necesario.
Promocionar una cadena a un entorno diferente.
Como parte de su ciclo de vida de desarrollo, puede crear cadenas en un entorno independiente de donde las ejecutan los colaboradores. Por ejemplo, puede crear cadenas en un entorno DEV hasta que estén listas para usarse en un entorno PROD. Para mover una cadena de un entorno a otro, puede promoverla.
- En Chain Builder, desde la pestaña Cadenas, seleccione Promocionar en el menú de la cadena.
- En Nombre, edite el nombre de la cadena para su nuevo entorno según sea necesario.
- En Promocionar a, seleccione el nuevo entorno de la cadena.
- Seleccione si desea habilitar programaciones en la cadena promocionada y haga clic en Siguiente.
- Para cada conexión de la cadena, elija la conexión que desea utilizar en el nuevo entorno y haga clic en Siguiente.
- Revise la asignación de conexiones y haga clic en Promocionar.
Editar una cadena
Para actualizar los pasos o propiedades de una cadena:
- En Chain Builder, desde la pestaña Cadenas, haga clic en Editar para la cadena y actualice sus comandos y eventos como necesario.
- Para actualizar las propiedades de la cadena, haga clic en Configuración de la cadenay ajuste sus programaciones, variablesy notificaciones según sea necesario.
Revertir una cadena a una versión anterior
Para devolver una cadena a una versión publicada anteriormente, como para deshacer cambios o crear una nueva cadena a partir de una versión anterior de otra:
- En Chain Builder, desde la pestaña Cadenas, seleccione Versiones en el menú de la cadena.
- En Versiones pasadas, seleccione la versión a la que desea volver y haga clic en Revertir cadena .
- Seleccione el conector y el corredor para cada conexión y establezca las variables.
- Haga clic en Enviar,Ver cadena revertidayPublicar.
Etiquetas de cadena
Las etiquetas de cadena brindan la capacidad de agrupar cadenas relacionadas y brindar información sobre el contenido de la cadena. Una vez creada una etiqueta, se puede utilizar como filtro para Cadenas dentro de la vista Lista de cadenas y el Programador.
Agregar una etiqueta de cadena
- Seleccione la cadena para expandir la vista
- Haga clic en el ícono más (+) para ingresar un nuevo nombre de etiqueta o seleccionar una etiqueta existente
- Opcionalmente, establezca el color de la etiqueta haciendo clic en la etiqueta y eligiendo un color
Quitar una etiqueta de cadena
- Seleccione la cadena para expandir la vista
- Pase el cursor sobre la etiqueta y haga clic en la (x) gris.