Como usar a ação Atualizar item de trabalho

A ação Atualizar item de trabalho fornece a flexibilidade de atualizar um item de trabalho com base no nome da fila ou na ID do item de trabalho como parte de uma execução de automação.

Pré-requisitos

Certifique-se de ter adicionado um item de trabalho a uma fila para que o sistema gere uma id para aquele item de trabalho. Para obter mais informações, consulte Gerenciar Itens de trabalho.
Revise as seguintes considerações para usar a ação item de trabalho Atualizar:
  • Execute a automação usando uma das opções a seguir:
    • Executar agora
    • Cronograma
    • Executar com gatilhos de evento
    Nota: Um usuário Executor de bots que atualizará o item de trabalho deve estar associado a uma função que seja o proprietário ou um participante da fila.
  • Use a ação Atualizar item de trabalho para gerenciar fluxos de trabalho complexos em uma automação adicionando itens de trabalho de múltiplas filas.
  • Se os seguintes campos não forem atualizados corretamente, um erro será exibido durante o tempo de execução e a automação falhará:
    • Nome incorreto inserido no campo Nome da fila.
    • Para a guia Gravar:
      • A sequência das colunas está incorreta.

        Por exemplo, se a estrutura do item de trabalho for Coluna A, Coluna B e Coluna C. A automação falhará se você inserir a sequência de colunas na guia Gravar como Coluna A, Coluna C e Coluna B.

      • O tipo de dados das colunas está incorreto.

        Por exemplo, se a estrutura do item de trabalho contiver um tipo de dado como String, mas a estrutura da gravação de entrada for Número.

      • Se alguma das colunas na estrutura da gravação estiver faltando.

        Por exemplo, se o item de trabalho tiver 3 colunas e você remover uma delas. Entretanto, o registro de entrada está definido para 3 colunas.

      • O valor Data/hora não está definido para uma data e hora futuras.
        Por exemplo, se a data e a hora do sistema forem 10 de maio de 2024, às 14:00, certifique-se de definir a Data/hora como um valor de data e hora futuros.
        Nota: O valor Data/hora não é definido para uma data e hora futuras quando você coloca os itens de trabalho em espera
  • Para o campo Valor na opção Gravar > Adicionar, certifique-se de não usar uma variável como valor de entrada, conforme mostrado na imagem a seguir:

    Atualizar item de trabalho

Procedimento

  1. Na página Automação, clique no ícone Criar ou clique em um Task Bot para abrir a tela do editor.
  2. Na paleta Ações, clique duas vezes ou arraste a ação Atualizar item de trabalho disponível em Carga de trabalho.
  3. No campo Nome da fila, insira o nome da fila onde você deseja atualizar os itens de trabalho.
    Nota: Certifique-se de inserir o nome correto, pois um erro será exibido durante o tempo de execução da automação se a fila especificada não existir.
    Como alternativa, clique no ícone Inserir um valor para selecionar uma variável que você pode ter usado para armazenar o nome da fila.
  4. No campo ID do item de trabalho, insira a ID do item de trabalho que você deseja atualizar.
    Como alternativa, clique no ícone Inserir um valor para selecionar uma variável que você pode ter usado para armazenar o valor do ID do item de trabalho.
  5. Use o campo Valores do item de trabalho para selecionar uma das seguintes opções:
    • Gravar
      Clique no botão Adicionar para adicionar uma gravação e atualizar as seguintes entradas:
      • Índice: É um campo gerado automaticamente e não pode ser editado manualmente. Entretanto, se você adicionar mais de um registro, as setas Mover para cima e Mover para baixo serão habilitadas. O valor no campo Índice muda com base na posição para a qual você move um registro.
      • Nome: Insira um nome para a coluna que você está adicionando.
      • Tipo: Clique no menu suspenso para selecionar o tipo de coluna.
        Nota: Somente String, Número e Data/hora são compatíveis com os itens de trabalho
      • Valor Insira o valor para a coluna com base no Tipo que você selecionou.
      Nota: Certifique-se de que o registro que você está adicionando tenha o mesmo número de colunas que a estrutura do item de trabalho. Por exemplo, número, nome e tipo de colunas, além dos respectivos valores.

      Clique no botão Obter estrutura.

      Ao clicar nesse botão, toda a estrutura do item de trabalho, chave, tipo e caixa de texto para adicionar valor é exibida. O botão Obter estrutura está disponível apenas na opção Gravar e se você não tiver adicionado manualmente nenhum atributo. Entretanto, se você adicionou os atributos manualmente, clique no botão Obter estrutura para limpar a entrada manual e carregar a estrutura, como nome, tipo de dados e valor em branco. Depois de obter a estrutura do item de trabalho, você pode adicionar ou excluir painéis.
      Nota: Certifique-se de não adicionar uma variável para o nome da fila.
    • Variável

      Digite o nome da variável de gravar ou clique no ícone Inserir um valor para selecionar uma variável de gravar existente que contenha os valores atualizados do item de trabalho.

  6. Clique no menu suspenso Status para selecionar uma das seguintes opções:
    • Processar novamente (Novo): Selecione esta opção para reprocessar o item de trabalho selecionado como novo.
    • Em espera: Selecione esta opção para pausar ou colocar o item de trabalho selecionado em espera. Você pode usar ainda uma das seguintes guias para refinar o status Em espera:
      • Indefinidamente: Selecione esta opção se quiser alterar manualmente o status em um dia ou data posterior.
      • Até: Selecione esta opção para definir o status Em espera com base em:
        • Data/hora: Selecione a data, a hora e o fuso horário.
          Nota: Os fusos horários EST, HST ou MST estão obsoletos.
        • Variável: Insira uma variável ou clique no ícone Inserir um valor para selecionar uma variável.
  7. Clique em Salvar.
    O item de trabalho selecionado é atualizado com base nas configurações que você escolheu.