Configure a Workflow

Abre la ventana Editar parámetros para la acción Listar localizaciones.

Los campos identificador único (token) de acceso y Proyecto requerirán valores dinámicos que se resuelven en tiempo de ejecución.

1. Haz clic en el ícono de enlace para el campo identificador único (token) de acceso y selecciona la acción Obtener identificadores únicos (tokens) de acceso.

   El enlace se vuelve verde y el campo se puede editar.

2. La sintaxis para acceder a las propiedades de un desencadenador o acción referenciada es:

   {{$.path.to.value}}

   Con la salida para Obtener identificadores únicos (tokens) de acceso siendo:

   { "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }

   haciendo que la expresión sea requerida para el campo identificador único (token) de acceso {{$.tokens.strings_token}}.

3. Haz clic en el ícono de enlace para el campo Proyecto y selecciona el desencadenador uploads:create.

   El enlace se vuelve verde y el campo se puede editar.

4. La salida del trigger uploads:create se parece a:

   {
     "branch": {
       "name": "my_branch"
     },
     "event": "uploads:create",
     "message": "usuario-1 inicializó la carga del archivo file.yml en el proyecto name_1672734591_11 dentro de la rama 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"
     },
     "cargar": {
       "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"
     }
   }
   

   haciendo que la expresión sea requerida para el campo Proyecto {{$.project.id}}.

5. Haz clic en Guardar.

   La ventana de Editar parámetros se cierra y los parámetros para la acción se guardan

La localización predeterminada del proyecto es necesaria para crear un trabajo pasando el ID a la acción Crear trabajo. La acción Transform JSON with jq toma una entrada JSON, aplica el filtro especificado y luego vuelve a generar JSON

1. Desde la pestaña Acciones en la ventana Bloques de flujo de trabajo, busca phrase-jq.

   Arrastra y suelta el bloque de acción Transform JSON with jq debajo del bloque de acción Listar localizaciones para conectarlos.

2. Abre la ventana de Editar parámetros para la acción Transform JSON with jq.

3. Selecciona JSON del campo desplegable Tipo de entrada.

4. Haz clic en el ícono de enlace para el campo Entrada y selecciona la acción Listar localizaciones.

   El enlace se vuelve verde y el campo se puede editar.

5. El campo Input toma 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.

   Ingresa la expresión {{@.outputs.result}} en el campo Input.

6. Haz clic en el ícono de enlace para el campo Jq y selecciona la acción Listar localizaciones.

   El enlace se vuelve verde y el campo se puede editar.

7. Se requiere un filtro de la lista de localizaciones que devuelva una nueva lista que contenga todos los elementos donde la propiedad default sea true.

   Solo puede haber una localización predeterminada por proyecto y la lista tiene un elemento identificable y obligatorio. Ese elemento se accede directamente con la sintaxis de array .[0].

   Ingresa la expresión map(select(.default))|.[0] en el campo Jq.

8. Haz clic en Guardar.

   La ventana de Editar parámetros se cierra y los parámetros para la acción se guardan

La acción Crear un trabajo ahora se puede configurar y utilizará patrones de bloques anteriores.

1. Haz clic en el ícono de enlace para el campo identificador único (token) de acceso y selecciona la acción Obtener identificadores únicos (tokens) de acceso.

   El enlace se vuelve verde y el campo se puede editar.

   Ingresa la expresión {{$.tokens.strings_token}}.

2. Haz clic en el ícono de enlace para el campo Proyecto y selecciona el desencadenador uploads:create.

   El enlace se vuelve verde y el campo se puede editar.

   Ingresa la expresión {{$.project.id}}.

3. Haz clic en el ícono de enlace para el campo Fuente de localización y selecciona la acción Transform JSON with jq.

   El enlace se vuelve verde y el campo se puede editar.

   Ingresa la expresión {{@.outputs.result}}.

4. La fecha de vencimiento puede ser calculada con funciones sprig o Expr, pero para este ejemplo se usará una fecha codificada que entiende la API.

   En el campo Fecha de vencimiento, ingresa 2023-12-31T12:00:00Z.

5. Haz clic en Guardar.

   La configuración se guarda y puedes ver los detalles en la pestaña Configurar.

Cada acción puede tener una o más condiciones combinadas con Y lógico y O. 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 reflejar esto en el ejemplo, mientras tengas seleccionada la acción Crear un trabajo, haz clic en Editar condiciones en la pestaña Condiciones o haz clic derecho en el bloque y selecciona Editar condiciones.

Se abre la ventana Editar condiciones.

1. Siguiendo patrones de bloques anteriores, vincula el campo variable al desencadenador uploads:create e ingresa la expresión {{$.upload.tag}}.

2. Selecciona NOT de la primera lista desplegable para invertir la declaración.

3. Selecciona IsNull de la lista desplegable comparar.

4. Haz clic en Guardar.

   La condición se presenta en la pestaña Conditions.

El flujo de trabajo se detendrá en este punto si la carga no contiene una etiqueta (lo que significa que no hubo claves o traducciones nuevas o actualizadas).

Ahora se requieren las localizaciones de destino para el trabajo. Para este ejemplo, se crearán dos localizaciones: una para español (es-ES) y otra para alemán (de-DE). Las localizaciones se agregarán a las dos acciones Transform JSON with jq en la ventana de Editar parámetros, como en el paso 3.

1. En el campo Input de ambas acciones, ingresa la expresión {{@.outputs.result}}, vincula a la acción List locales y guarda el parámetro.

2. En el campo Jg de una acción, ingresa la expresión map(select(.name == "es-ES"))|.[0] y vincula a la acción List locales.

   Guarda el parámetro.

3. En la segunda acción, ingresa la expresión map(select(.name == "de-DE"))|.[0] y vincula a la acción List locales.

   Guarda el parámetro.

Las localizaciones ahora se aplicarán a la creación del trabajo.

Configura las dos Agregar una localización de destino a un trabajo acciones con los mismos patrones definidos anteriormente.

El trabajo ya se puede iniciar.

Configura la acción Start a job con los mismos patrones que se definieron anteriormente.