Para establecer valores para entradas que aparecen repetidamente en varias cadenas o comandos dentro de una misma cadena, puede utilizar variables. En lugar de introducir el mismo valor en varias cadenas o comandos, puede definirlo como variable y gestionar su valor en un solo lugar.
- Las variables del espacio de trabajo definen valores que aparecen en varias cadenas.
- Las variables de cadena definen valores que aparecen en varias órdenes de una cadena y que pueden cambiar con frecuencia.
- Variables dinámicas definen valores a establecer cuando se ejecuta una cadena o durante la ejecución de una cadena, como por ejemplo basándose en la salida de un comando anterior.
Formación adicional disponible
¡Desbloquee el poder de las cadenas con nuestro curso autodidacta en el Workiva Learning Hub! Este completo curso le guiará a través del proceso de creación de una cadena de principio a fin, proporcionándole experiencia práctica y un profundo conocimiento de la plataforma Chain Builder.
Visite el Workiva Learning Hub
Gestione las variables de su espacio de trabajo
Desde su espacio de trabajo, puede definir las variables utilizadas por varias cadenas:
- En Chain Builder, seleccione Configuración en la parte superior izquierda.
- Derecha de Variables, haga clic en Agregar
- Para ayudar a identificar la variable, introduzca su nombre y, si es necesario, su valor por defecto y su descripción. Estos valores por defecto pueden personalizarse posteriormente para cadenas individuales.
- Para mayor seguridad, seleccione Encrypt -- esto ocultará cualquier valor sensible como contraseñas.
- Haz clic en Guardar.
Después de Agregar una variable a su espacio de trabajo, puede editar su nombre, valor o codificación según sea necesario. Para Quitar una variable del área de trabajo, haga clic en Eliminar.
Gestionar las variables de una cadena
Para los valores que aparecen en varios comandos dentro de una cadena y cambian con frecuencia, agréguelos como variables para la cadena. Una cadena puede tener hasta 100 variables.
- En la cadena, haga clic en Configuración de la cadena.
- En Variables
- Introduzca un nombre único y una descripción para ayudar a identificar la variable y su intención.
- Introduzca el valor por defecto de la variable.
- Para Habilitar que sólo los administradores puedan ver el valor de la variable, como en el caso de las contraseñas, seleccione Cifrar.
- Haz clic en Guardar.
Para actualizar una variable, haga clic en Editar para la cadena, y ajuste el valor en Variables.
Para Quitar una variable que ya no necesita, haga clic en Eliminar
.Gestionar las variables dinámicas de una cadena
Para establecer valores cuando se ejecuta la cadena, o para basar los valores en la salida de otro comando, agréguelos como variables dinámicas para la cadena.
Nota: Para facilitar las ejecuciones consecutivas, las variables dinámicas conservan los valores establecidos durante la ejecución anterior de la cadena.
- En la cadena, haga clic en Configuración de la cadena.
- En Variables dinámicas , haga clic en Agregar .
- Introduzca un nombre único para ayudar a identificar la variable y su intención.
Nota: El campo Valor inicial no es aplicable aquí y debe dejarse en blanco.
- Haz clic en Guardar.
Nota: Para establecer los valores de las variables dinámicas cuando una cadena empieza a ejecutarse, iníciela con a Entradas en tiempo de ejecución evento de activación. Para pausar una cadena para definir el valor de una variable dinámica antes de proceder a la Siguiente Etapa, agregue a Set Dynamic Chain Variables event.
Para Quitar una variable que ya no necesita, haga clic en Eliminar
.Utilizar variables como entradas de comandos
Para utilizar variables como entradas basadas en texto para un comando:
- En la cadena, seleccione el comando para utilizar las variables.
- En la entrada basada en texto para utilizar una variable, haga clic en Variable
Nota: Para concatenar varias variables dentro de una entrada, seleccione las variables que desea utilizar y, a continuación, introduzca el texto que aparecerá antes o después de cada una.
, y seleccione la variable. - Haz clic en Guardar.
Nota: Para modificar o dar formato a una variable para su uso como entrada de comandos, aplique una transformación de variables .
Variables de tiempo de ejecución
Para incluir datos relacionados con el momento en que se ejecuta una cadena, puede utilizar varias variables de tiempo de ejecución.
Variable | Descripción |
---|---|
Cadena.Entorno | Entorno de la cadena que se está ejecutando actualmente |
Chain.ExecutionDateTime | Fecha y hora de inicio de la cadena |
Cadena.ExecutorId | ID numérico de la cadena que se está ejecutando actualmente. |
Cadena.Id | El ID numérico de una cadena en el estado no en ejecución |
Cadena.Nombre | El nombre de la cadena que se está ejecutando actualmente |
Cadena.PreviousExecutionDateTime | Fecha y hora de la última vez que se ejecutó la cadena. |
Cadena.URL | URL única de la cadena que se está ejecutando actualmente |
Cadena.de.trabajo | El espacio de trabajo de la cadena que se está ejecutando actualmente |
Command.ExecutorId | El ID numérico del comando que se está ejecutando actualmente. |
Comando.Id | El ID numérico de un comando en el estado no en ejecución |
Comando.Nombre | El nombre del comando que se está ejecutando actualmente |
Comando.URL | La URL única del comando que se está ejecutando en ese momento |
Runner.InstallationDirectory | El directorio de instalación para el GroundRunner de la cadena; null si se utiliza un CloudRunner. |
Sistema.Fecha | Fecha actual del sistema |
System.DateTime | Fecha y hora actuales del sistema |
Usuario.Email | La dirección de correo electrónico del colaborador que dirigió la cadena |
Usuario.Id | El ID del colaborador que ejecutó la cadena |
Nombre de usuario | El nombre del colaborador que dirigía la cadena |