Orchestrator

Configurar un flujo de trabajo

El contenido se traduce automáticamente del inglés por Phrase Language AI.

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 Configurar, o haciendo clic con el botón derecho en el bloque y seleccionando Editar parámetros para abrir la ventana Editar parámetros. Una vez que un bloque tiene parámetros, el botón Añadir parámetros cambia a Editar parámetros.

Para configurar los bloques del ejemplo, sigue estos pasos:

  1. Abre la ventana Editar parámetros de la acción language-blue.svgListar configuraciones regionales.

  2. Los campos Token de acceso y Proyecto requerirán valores dinámicos que se resuelven en tiempo de ejecución.

    1. Haz clic en el icono de enlace Icono de enlace del campo Token de acceso y selecciona la acción circle-blue.svgObtener tokens de acceso.

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

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

      {{$.path.to.value}}

      La salida de circle-blue.svgObtener tokens de acceso es:

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

      por lo que la expresión requerida para el campo Token de acceso es {{$.tokens.strings_token}}.

    3. Haz clic en el icono de enlace Icono de enlace del campo Proyecto y selecciona el activador history-orange.svguploads:create.

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

    4. La salida del activador history-orange.svguploads:create se parece a:

      {
        "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 Proyecto es {{$.project.id}}.

    5. Haz clic en Guardar.

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

  3. La configuración regional predeterminada del proyecto es necesaria para crear un trabajo pasando el ID a la acción work-blue.svgCrear trabajo. La acción circle-blue.svgTransformar JSON con jq toma una entrada JSON, aplica el filtro especificado y luego genera JSON de nuevo

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

      Arrastra y suelta el bloque de acción circle-blue.svgTransformar JSON con jq debajo de la acción language-blue.svgListar configuraciones regionales para conectarlos.

    2. Abre la ventana Editar parámetros de la acción Transformar JSON con jq.

    3. Selecciona JSON en el campo desplegable Tipo de entrada.

    4. Haz clic en el icono de enlace Icono de enlace del campo Entrada y selecciona la acción language-blue.svgListar configuraciones regionales.

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

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

    6. Haz clic en el icono de enlace Icono de enlace del campo Jq y selecciona la acción language-blue.svgListar configuraciones regionales.

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

    7. 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 default sea true.

      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 Jq.

    8. Haz clic en Guardar.

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

  4. La acción work-blue.svgCrear un trabajo ahora se puede configurar y utilizará patrones de bloques anteriores.

    1. Haz clic en el icono de enlace Icono de enlace del campo Token de acceso y selecciona la acción circle-blue.svgObtener tokens de acceso.

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

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

    2. Haz clic en el icono de enlace Icono de enlace del campo Proyecto y selecciona el activador language-orange.svguploads:create.

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

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

    3. Haz clic en el icono de enlace Icono de enlace del campo Configuración regional de origen 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}}.

    4. 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 Fecha de vencimiento, introduce 2023-12-31T12:00:00Z.

    5. Haz clic en Guardar.

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

  5. Cada acción puede tener una o más condiciones combinadas con AND y OR ló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 work-blue.svgCrear un trabajo seleccionada, haz clic en Editar condiciones en la pestaña Condiciones o haz clic con el botón derecho en el bloque y selecciona Editar condiciones.

    Se abre la ventana Editar condicionales.

    1. Siguiendo los patrones de los bloques anteriores, vincula el campo variable al activador language-orange.svguploads:create e introduce la expresión {{$.upload.tag}}.

    2. Selecciona NOT en la primera lista desplegable para invertir la condición.

    3. Selecciona IsNull en la lista desplegable Comparar.

    4. Haz clic en Guardar.

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

    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).

  6. 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 circle-blue.svgTransformar JSON con jq en la ventana Editar parámetros como en el paso 3.

    1. En el campo Entrada de ambas acciones, introduce la expresión {{@.outputs.result}}, vincúlala a la acción language-blue.svgListar configuraciones regionales y guarda el parámetro.

    2. En el campo Jg de una acción, introduce la expresión map(select(.name == "es-ES"))|.[0] y vincúlala a la acción language-blue.svgListar configuraciones regionales.

      Guarda el parámetro.

    3. En la segunda acción, introduce la expresión map(select(.name == "de-DE"))|.[0] y vincúlala a la acción language-blue.svgListar configuraciones regionales.

      Guarda el parámetro.

  7. Las configuraciones regionales ahora se aplicarán a la creación del trabajo.

    Configura las dos acciones work-blue.svgAgregar una configuración regional de destino a un trabajo con los mismos patrones definidos anteriormente.

  8. El trabajo ya se puede iniciar.

    Configura la acción work-blue.svgIniciar un trabajo con los mismos patrones definidos anteriormente.

Ejecución de un flujo de trabajo bajo demanda

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 Ejecutar.

  • Envía una solicitud POST a /orchestrator/api/v1/workflows/{workflow_id}/executions en 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 Ejecuciones 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.

¿Fue útil este artículo?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.