Para establecer valores para entradas que aparecen repetidamente en varias cadenas o comandos dentro de una misma cadena, puedes utilizar las variables. En lugar de introducir el mismo valor en varias cadenas o comandos, puedes definirlo como variable y gestionar su valor en una sola ubicación.
- Las variables de los Espacios de trabajo definen valores que aparecen en varias cadenas.
- Las variables de cadena definen valores que aparecen en varios comandos de una cadena y que pueden cambiar con frecuencia.
- Variables dinámicas definen los valores a establecer cuando una cadena se ejecuta o durante la ejecución de una cadena, por ejemplo, basándose en el resultado de un comando anterior.
Formación adicional disponible
Puedes aprender el poder de las Cadenas con nuestro curso autodidacta 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 Aprendizaje Workiva
Gestiona las variables de tu espacio de trabajo.
Desde tu espacio de trabajo, puedes definir las variables utilizadas por varias cadenas:
- En Generador de cadenas, selecciona Configuraciones en la parte superior izquierda.
- A la derecha de Variables, haz clic en Añadir a.
- Para ayudar a identificar la variable, introduce su nombre y, si es necesario, su valor predeterminado y su descripción. Estos Valores predeterminados pueden personalizarse posteriormente para cadenas individuales.
- Para mayor seguridad, selecciona Cifrar: de este modo se ocultarán los valores sensibles, como las contraseñas.
- Haz clic en Guardar.
Después de añadir una variable a tu espacio de trabajo, puedes editar su nombre, valor o cifrado según sea necesario. Para eliminar una variable del Espacio de trabajo, haz clic en Eliminar.
Gestionar las variables de una cadena
Para los valores que aparecen en varios comandos de una cadena y cambian con frecuencia, añádelos como variables de la cadena. No existe un límite estricto para el número de variables de una cadena, pero se ha observado una disminución de la capacidad de respuesta cuando las cadenas se acercan a las 1000 variables.
- En la cadena, haz clic en Configuración de la cadena.
- En Variables, haz clic en Añadir.
- Introduce un nombre que sea único y una descripción que ayude a identificar la variable y su intención.
- Introduce el valor predeterminado de la variable.
- Para que solo los administradores puedan ver el valor de la variable, como en el caso de las contraseñas, selecciona Cifrado.
- Haz clic en Guardar.
Para actualizar una variable, haz clic en Editar para la cadena, y ajusta el valor en Variables.
Para eliminar una variable que ya no necesitas, haz clic en Eliminar.
Gestionar las variables dinámicas de una cadena
Para establecer valores cuando la cadena se ejecuta, o para basar los valores en la salida de otro comando, añádelos 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, haz clic en Configuración de la cadena.
- En Variables dinámicas, haz clic en Añadir.
- Introduce un nombre que sea único para ayudar a identificar la variable y su intención.
Nota: El Campo de 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 empieza a ejecutarse una cadena, iníciala con a Entradas en tiempo de ejecución desencadenar evento. Para pausar una cadena y definir el valor de una variable dinámica antes de pasar a la siguiente etapa, añade a Establecer variables de cadena dinámica evento.
Para eliminar una variable que ya no necesitas, haz clic en Eliminar.
Utilizar variables como entradas de comando
Para utilizar variables como entradas basadas en texto para un comando:
- Desde la cadena, selecciona el comando para utilizar las variables.
- En la entrada basada en texto para utilizar una variable, haz clic en Variable y selecciona la variable.
Nota: Para concatenar múltiples variables dentro de una Entrada, selecciona las variables a utilizar y, a continuación, introduce cualquier texto que aparezca antes o después de cada una.
- Haz clic en Guardar.
Nota: Para modificar o dar formato a una variable para utilizarla como entrada de un comando, aplica una transformación de variables.
Variables de tiempo de ejecución
Para incluir datos relacionados con el momento en que se ejecuta una cadena, puedes utilizar varias variables de tiempo de ejecución.
| Variable | Descripción |
|---|---|
| Chain.Environment | El entorno de la cadena que se está ejecutando actualmente |
| Chain.ExecutionDateTime | Fecha y hora de inicio de la cadena. |
| Chain.ExecutorId | El identificador numérico de la cadena que está Ejecutando actualmente. |
| Chain.Id | El ID numérico de una cadena en el estado no Ejecutando. |
| Chain.Name | El nombre de la cadena que se está ejecutando actualmente. |
| Chain.PreviousExecutionDateTime | Fecha y hora de la última vez que se ejecutó la cadena. |
| Chain.URL | La URL única de la cadena que se está ejecutando actualmente. |
| Chain.Workspace | El espacio de trabajo de la cadena que se está ejecutando actualmente. |
| Command.ExecutorId | ID numérico del comando que se está ejecutando en ese momento. |
| Comando.Id | El ID numérico de un comando en el estado no Ejecutando. |
| Comando.Nombre | El nombre del comando que se está ejecutando actualmente. |
| Comando.URL | La URL única del comando que se está ejecutando actualmente. |
| Runner.InstallationDirectory | El directorio de instalación del GroundRunner de la cadena; valor nulo si se usa CloudRunner |
| System.Date | La fecha actual del sistema. |
| System.DateTime | Fecha y hora actuales del sistema. |
| Correo electrónico del usuario | Correo electrónico del colaborador que ejecutó la cadena. |
| User.Id | El ID del colaborador que ejecutó la cadena. |
| Usuario.Nombre | El nombre del colaborador que ejecutó la cadena |