Configure a Workflow

Abra a janela Editar parâmetros para a ação Listar locais.

Os campos Token de acesso e Projeto precisarão de valores dinâmicos que são resolvidos em tempo de execução.

1. Clique no ícone de link para o campo Token de acesso e selecione a ação Buscar tokens de acesso.

   O link fica verde e o campo pode ser editado.

2. A sintaxe para acessar as propriedades de um gatilho ou ação referenciada é:

   {{$.path.to.value}}

   Com a saída para Buscar tokens de acesso sendo:

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

   tornando a expressão necessária para o campo Token de acesso {{$.tokens.strings_token}}.

3. Clique no ícone de link para o campo Projeto e selecione o gatilho uploads:create.

   O link fica verde e o campo pode ser editado.

4. A saída do gatilho uploads:create se assemelha a:

   {
     "branch": {
       "name": "my_branch"
     },
     "event": "uploads:create",
     "mensagem": "usuário-1 inicializou o upload do arquivo file.yml no projeto name_1672734591_11 dentro do ramo 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",
       "estado": "inicializado",
       "resumo": {},
       "tag": null,
       "updated_at": "2023-01-03 08:29:48 UTC",
     },
     "usuário": {
       "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94",
       "id": "9c365b9a6f77c247c3de959f6152b231",
       "name": "Joe Sixpack",
       "username": "user-1"
     }
   }
   

   fazendo a expressão obrigatória para o campo Projeto {{$.project.id}}.

5. Clique em Gravar.

   A janela Editar parâmetros é fechada e os parâmetros da ação são gravados.

O local padrão do projeto é necessário para criar um trabalho, passando o ID para a ação Criar trabalho. A ação Transformar JSON com jq recebe uma entrada JSON, aplica o filtro especificado e então gera a saída JSON novamente

1. Na aba Ações na janela Blocos de Fluxo de Trabalho, procure por frase-jq.

   Arraste e solte o bloco de ação Transformar JSON com jq abaixo do bloco de ação listar locais para conectá-los.

2. Abra a janela Editar parâmetros para a ação Transformar JSON com jq.

3. Selecione JSON no campo suspenso Tipo de entrada.

4. Clique no ícone de link para o campo Entrada e selecione a ação listar locais.

   O link fica verde e o campo pode ser editado.

5. O campo Input aceita a entrada JSON. Uma expressão fixa especial (@ em vez de $) garante que toda a saída da ação referenciada seja passada para o campo.

   Digite a expressão {{@.outputs.result}} no campo Input.

6. Clique no ícone de link para o campo Jq e selecione a ação listar locais.

   O link fica verde e o campo pode ser editado.

7. Um filtro da lista de locais que retorna uma nova lista contendo todos os elementos onde a propriedade default é true é necessário.

   Pode haver apenas um local padrão por projeto e a lista tem um elemento identificável e obrigatório. Esse elemento é acessado diretamente com a sintaxe de array .[0].

   Digite a expressão map(select(.default))|.[0] no campo Jq.

8. Clique em Gravar.

   A janela Editar parâmetros fecha e os parâmetros para a ação são salvos

A ação Criar um trabalho agora pode ser configurada e usará padrões de blocos anteriores.

1. Clique no ícone de link para o campo Token de acesso e selecione a ação Buscar tokens de acesso.

   O link fica verde e o campo pode ser editado.

   Digite a expressão {{$.tokens.strings_token}}.

2. Clique no ícone de link para o campo Projeto e selecione o gatilho uploads:criar.

   O link fica verde e o campo pode ser editado.

   Digite a expressão {{$.project.id}}.

3. Clique no ícone de link para o campo Local de texto original e selecione a ação Transform JSON with jq.

   O link fica verde e o campo pode ser editado.

   Digite a expressão {{@.outputs.result}}.

4. A data de vencimento pode ser calculada com funções sprig ou Expr, mas para fins deste exemplo, uma data codificada será usada, compreendida pela API.

   No campo Data de vencimento, digite 2023-12-31T12:00:00Z.

5. Clique em Gravar.

   A configuração é salva e os detalhes podem ser visualizados na aba Configurar.

Cada ação pode ter uma ou mais condições combinadas com os operadores lógicos E e OU. Essas condições são avaliadas em tempo de execução e a ação e seus secundários só serão executados se a condição for avaliada como verdadeira.

Para refletir isso no exemplo, enquanto a ação Criar um trabalho estiver selecionada, clique em Editar condições na aba Condições ou clique com o botão direito no bloco e selecione Editar condições.

A janela Editar condições é aberta.

1. Seguindo padrões de blocos anteriores, vincule o campo variável ao gatilho uploads:criar e digite a expressão {{$.upload.tag}}.

2. Selecione NÃO na primeira lista suspensa para inverter a declaração.

3. Selecione IsNull na lista suspensa comparar.

4. Clique em Gravar.

   A condição é apresentada na aba Condições.

O fluxo de trabalho será interrompido neste ponto se o upload não contiver um código (o que significa que não houve novas chaves/traduções atualizadas).

Os locais de destino agora são obrigatórios para o trabalho. Para os propósitos do exemplo, dois locais serão criados; um para espanhol (es-ES) e um para alemão (de-DE). Os locais serão adicionados às duas Transformar JSON com jq ações na janela Editar parâmetros como na etapa 3.

1. No campo Input de ambas as ações, insira a expressão {{@.outputs.result}}, vincule à ação List locales e grave o parâmetro.

2. No campo Jg de uma ação, insira a expressão map(select(.name == "es-ES"))|.[0] e vincule à ação List locales.

   Grave o parâmetro.

3. Na segunda ação, insira a expressão map(select(.name == "de-DE"))|.[0] e vincule à ação List locales.

   Grave o parâmetro.

Os locais agora serão aplicados à criação do trabalho.

Configure as duas ações Adicionar um local de destino a um trabalho com os mesmos padrões definidos anteriormente.

O trabalho agora pode ser iniciado.

Configure a ação Iniciar um trabalho com os mesmos padrões definidos anteriormente.