Ir al contenido
↑↓ moverse↵ abriresc cerrar

Referencia

Expresiones de runtime

Todas las expresiones que Luvin entiende en parámetros, bodies, outputs, criterios y el YAML, qué devuelve cada una y en qué se diferencian de una {{variable}}.

4 min de lectura

Una expresión de runtime es un texto corto que empieza con $ y apunta a un valor que solo existe mientras corre un workflow, como un input, un dato de una respuesta o el output de un paso anterior. Luvin la reemplaza por el valor real cuando está por enviar el paso o cuando revisa un criterio.

Escribes expresiones en la pestaña YAML y en Editar como JSON del body de un request. En la pestaña Diseño casi nunca las escribes: cuando conectas datos, Luvin las escribe por ti. Lee esta página cuando abras el YAML y quieras saber qué significa un $....

Expresión Qué devuelve Ejemplo
$inputs.<nombre> El valor de un input del workflow, o del caso que se ejecuta. $inputs.pokemon
$steps.<paso>.outputs.<nombre> Un output que capturó un paso anterior. $steps.getPokemon.outputs.mainType
$workflows.<id>.outputs.<nombre> Un output de otro workflow del que este depende (dependsOn). $workflows.typeExplorer.outputs.strongAgainst
$response.body El body completo de la respuesta del paso actual. $response.body
$response.body#/puntero Un dato del body. Lo que va después de # es un JSON Pointer: / entre nombres y la posición de un elemento de lista como número. $response.body#/types/0/type/name
$response.header.<nombre> Un header de la respuesta. El nombre no distingue mayúsculas. $response.header.Content-Type
$statusCode El status HTTP de la respuesta, como número. $statusCode == 200
$url La URL a la que se llamó. $url
$method El método HTTP, en mayúsculas. $method
$request.header.<nombre> Un header que se envió. $request.header.Accept
$request.query.<nombre> Un parámetro query que se envió. $request.query.limit
$request.path.<nombre> Un parámetro de ruta que se envió. $request.path.id
$request.body o $request.body#/puntero El body que se envió, o un dato de él. $request.body#/customer/id
$message.payload o $message.payload#/puntero El payload del mensaje de un paso de mensajería. $message.body funciona igual. $message.payload#/status
$message.header.<nombre> Un header de ese mensaje. $message.header.correlationId
$sourceDescriptions.<nombre>.url La URL de un contrato del archivo Arazzo. $sourceDescriptions.pokedexEvents.url
$components.<tipo>.<nombre> Un reutilizable declarado en components. $components.parameters.requestId
$outputs.<nombre> Un output de un workflow llamado como paso, dentro del paso que lo llama. $outputs.orderId
$self La identidad del documento Arazzo, si el archivo declara una. $self
Dónde la escribes Expresiones que verás normalmente
Un parámetro o un dato del body del request $inputs, $steps, $workflows, $components.
Un output de un paso $response.body, $response.header, $statusCode, $message.
Un criterio de éxito $statusCode, $response, $message, $inputs, $steps. Mira Criterios de éxito.
Los outputs de un workflow $steps.<paso>.outputs.<nombre>, $workflows.<id>.outputs.<nombre>.
El canal de un paso de mensajería $sourceDescriptions.<nombre>.url entre llaves.

Las expresiones sobre la respuesta ($response, $statusCode) solo tienen valor después de que el paso recibió su respuesta. Usadas antes, no devuelven nada.

Una expresión que es el valor completo conserva su tipo: un número sigue siendo número. Cuando quieres una expresión dentro de un texto más largo, ponla entre llaves: {$expresión}. Luvin la reemplaza por su valor. Un valor que es un objeto o una lista se escribe como JSON.

El ejemplo del Pokédex lo hace para apuntar a un canal de un contrato:

channelPath: '{$sourceDescriptions.pokedexEvents.url}#/channels/sightingConfirmed'

Si una expresión no se puede resolver, la parte dentro del texto queda vacía. Un valor completo que no se puede resolver queda vacío, y el paso informa qué faltaba. Mira Dato no disponible.

Dos tipos de marcadores se parecen. Se resuelven en momentos distintos y desde lugares distintos.

Expresión de runtime Plantilla
Se escribe $inputs.name, {$steps...} {{variable}}, {{$randomUUID}}, {{email}}
Viene de La ejecución: inputs, respuestas, outputs. El ambiente activo (variables y secretos), o un generador de datos.
Ejemplo $steps.getPokemon.outputs.id {{baseUrl}}, {{$randomFirstName}}
Cuándo Mientras corre el workflow, paso a paso. Primero, cuando se prepara el valor.

Las plantillas se reemplazan primero. Un {{nombre}} que no es una variable del ambiente ni un generador se deja tal cual, y Luvin te avisa antes de enviarlo. Los generadores son {{email}}, {{cpf}}, {{rut}}, {{uuid}}, {{numero:8}}, {{fecha}} y {{timestamp}}, además de las variables dinámicas como {{$randomUUID}}. Mira Variables dinámicas y URLs base, variables y secretos.

Arazzo 1.1 también permite escribir un valor como un objeto con tres campos: dónde buscar (context), qué buscar (selector) y cómo (type). El ejemplo del Pokédex lo usa en un output:

context: $response.body
selector: $.effect_entries[?(@.language.name == 'en')].short_effect
type: jsonpath

El type puede ser jsonpath, jsonpointer o xpath. Luvin soporta XPath 1.0.