Para continuar con el flujo de trabajo de ejemplo, será necesario configurarlo.
Se puede acceder a la configuración del bloque haciendo clic en Editar parámetros en la pestaña , o haciendo clic con el botón derecho en el bloque y seleccionando Editar parámetros para abrir la ventana . Una vez que un bloque tiene parámetros, el botón cambia a .
Para configurar los bloques del ejemplo, sigue estos pasos:
-
Abre la ventana de la acción
.Listar configuraciones regionales
-
Los campos y requerirán valores dinámicos que se resuelven en tiempo de ejecución.
-
Haz clic en el icono de enlace
del campo y selecciona la acción
.Obtener tokens de acceso
El enlace se vuelve verde y el campo se puede editar.
-
La sintaxis para acceder a las propiedades de un activador o acción referenciados es:
{{$.path.to.value}}La salida de
es:Obtener tokens de acceso
{ "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }por lo que la expresión requerida para el campo es
{{$.tokens.strings_token}}. -
Haz clic en el icono de enlace
del campo y selecciona el activador
.uploads:create
El enlace se vuelve verde y el campo se puede editar.
-
La salida del activador
se parece a:uploads:create
{ "branch": { "name": "my_branch" }, "event": "uploads:create", "message": "user-1 initialized file upload file.yml in project name_1672734591_11 within branch my_branch\n", "project": { "created_at": "2023-01-03 08:29:51 UTC", "id": "abcdabcdabcdabcd-11", "main_format": "yml", "name": "name_1672734591_10", "point_of_contact": null, "project_image_url": null, "slug": "name_1672734591_10", "updated_at": "2023-01-03 08:29:51 UTC" }, "upload": { "created_at": "2023-01-03 08:29:48 UTC", "filename": "file.yml", "format": "yml", "id": "upload-1", "state": "initialized", "summary": {}, "tag": null, "updated_at": "2023-01-03 08:29:48 UTC" }, "user": { "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94", "id": "9c365b9a6f77c247c3de959f6152b231", "name": "Joe Sixpack", "username": "user-1" } }por lo que la expresión necesaria para el campo es
{{$.project.id}}. -
Haz clic en Guardar.
La ventana se cierra y los parámetros de la acción se guardan
-
-
La configuración regional predeterminada del proyecto es necesaria para crear un trabajo pasando el ID a la acción
. La acciónCrear trabajo
toma una entrada JSON, aplica el filtro especificado y luego genera JSON de nuevoTransformar JSON con jq
-
En la pestaña de la ventana , busca phrase-jq.
Arrastra y suelta el bloque de acción
debajo de la acciónTransformar JSON con jq
para conectarlos.Listar configuraciones regionales
-
Abre la ventana de la acción
Transformar JSON con jq. -
Selecciona en el campo desplegable .
-
Haz clic en el icono de enlace
del campo y selecciona la acción
.Listar configuraciones regionales
El enlace se vuelve verde y el campo se puede editar.
-
El campo recibe la entrada JSON. Una expresión fija especial (
@en lugar de$) asegura que toda la salida de la acción referenciada se pase al campo.Introduce la expresión
{{@.outputs.result}}en el campo . -
Haz clic en el icono de enlace
del campo y selecciona la acción
.Listar configuraciones regionales
El enlace se vuelve verde y el campo se puede editar.
-
Se requiere un filtro de la lista de configuraciones regionales que devuelva una nueva lista que contenga todos los elementos en los que la propiedad
defaultseatrue.Solo puede haber una configuración regional predeterminada por proyecto y la lista tiene un elemento identificable y obligatorio. A ese elemento se accede directamente con la sintaxis de matriz
.[0].Introduce la expresión
map(select(.default))|.[0]en el campo . -
Haz clic en Guardar.
La ventana se cierra y los parámetros de la acción se guardan
-
-
La acción
ahora se puede configurar y utilizará patrones de bloques anteriores.Crear un trabajo
-
Haz clic en el icono de enlace
del campo y selecciona la acción
.Obtener tokens de acceso
El enlace se vuelve verde y el campo se puede editar.
Introduce la expresión
{{$.tokens.strings_token}}. -
Haz clic en el icono de enlace
del campo y selecciona el activador
.uploads:create
El enlace se vuelve verde y el campo se puede editar.
Introduce la expresión
{{$.project.id}}. -
Haz clic en el icono de enlace
del campo y selecciona la acción
Transformar JSON con jq.El enlace se vuelve verde y el campo se puede editar.
Introduce la expresión
{{@.outputs.result}}. -
La fecha de vencimiento puede calcularse con funciones de sprig o Expr (), pero en este ejemplo se usará una fecha fija que la API pueda interpretar.
En el campo , introduce 2023-12-31T12:00:00Z.
-
Haz clic en Guardar.
La configuración se guarda y los detalles se pueden ver en la pestaña .
-
-
Cada acción puede tener una o más condiciones combinadas con
ANDyORlógicos. Estas condiciones se evalúan en tiempo de ejecución y la acción y sus elementos secundarios solo se ejecutarán si la condición se evalúa como verdadera.Para reflejarlo en el ejemplo, con la acción
seleccionada, haz clic en Editar condiciones en la pestaña o haz clic con el botón derecho en el bloque y selecciona Editar condiciones.Crear un trabajo
Se abre la ventana .
-
Siguiendo los patrones de los bloques anteriores, vincula el campo al activador
e introduce la expresiónuploads:create
{{$.upload.tag}}. -
Selecciona NOT en la primera lista desplegable para invertir la condición.
-
Selecciona IsNull en la lista desplegable .
-
Haz clic en Guardar.
La condición se presenta en la pestaña .
El flujo de trabajo se detendrá en este punto si la carga no contiene una etiqueta (lo que significa que no hubo claves/traducciones nuevas o actualizadas).
-
-
Ahora se requieren configuraciones regionales de destino para el trabajo. Para los fines del ejemplo, se crearán dos configuraciones regionales; una para español (es-ES) y otra para alemán (de-DE). Las configuraciones regionales se agregarán a las dos acciones
en la ventana como en el paso 3.Transformar JSON con jq
-
En el campo de ambas acciones, introduce la expresión
{{@.outputs.result}}, vincúlala a la accióny guarda el parámetro.Listar configuraciones regionales
-
En el campo de una acción, introduce la expresión
map(select(.name == "es-ES"))|.[0]y vincúlala a la acción.Listar configuraciones regionales
Guarda el parámetro.
-
En la segunda acción, introduce la expresión
map(select(.name == "de-DE"))|.[0]y vincúlala a la acción.Listar configuraciones regionales
Guarda el parámetro.
-
-
Las configuraciones regionales ahora se aplicarán a la creación del trabajo.
Configura las dos acciones
con los mismos patrones definidos anteriormente.Agregar una configuración regional de destino a un trabajo
-
El trabajo ya se puede iniciar.
Configura la acción
con los mismos patrones definidos anteriormente.Iniciar un trabajo
Una vez configurados los bloques, el flujo de trabajo se puede ejecutar bajo demanda para probarlo sin esperar a su activador, como una programación o un webhook.
Inicia una ejecución de cualquiera de estas formas:
-
En el editor de flujos de trabajo, usa el botón Ejecución de prueba para abrir el cuadro de diálogo .
-
Envía una solicitud
POSTa/orchestrator/api/v1/workflows/{workflow_id}/executionsen la API pública.
Una ejecución siempre utiliza la última revisión del flujo de trabajo. La revisión no necesita ser publicada, pero debe pasar la validación de publicación. Cada ejecución bajo demanda crea una nueva ejecución, que aparece en la página con la etiqueta Manual.
Nota
Las ejecuciones bajo demanda solo están disponibles para flujos de trabajo en el motor de flujos de trabajo de próxima generación. Para los flujos de trabajo heredados, el botón Ejecución de prueba no se muestra en el editor y la API devuelve un error 422.
Los paquetes de acciones y las plantillas no se pueden ejecutar, y el flujo de trabajo debe tener un propietario.