Tarefa de API

Importante: A Tarefa de API é um novo recurso da v.30 e tem disponibilidade limitada nas regiões dos Estados Unidos (leste dos EUA, oeste dos EUA e Sandbox dos EUA). Entre em contato com seu gerente de suporte ao cliente (CSM) para ativar esse recurso.

A Tarefa de API é um novo tipo de automação que você pode criar no Automation 360 Nuvem. As automações de API são executadas no Nuvem para integração com qualquer aplicativo SaaS ou endpoints de API.

As Tarefas de API interagem com um aplicativo diretamente via API e proporcionam um melhor desempenho no tempo de resposta. Use as Tarefas de API para criar automações usando pacotes que sejam compatíveis com Automation 360 Nuvem. Crie uma Tarefa de API no editor de API, assim como Task Bots, e use-a em:
  • Processo como uma tarefa de API.
  • Formulários para pesquisa dinâmica de dados via chamadas de API.

As Tarefas de API também podem ser iniciadas no Process Composer e podem ser usadas em qualquer um dos processos. Uma Tarefa de API pode se conectar a uma API especificada para recuperar dados para serem consumidos pela automação de processo. Para mais detalhes, consulte Process Composer.

No entanto, as Tarefas de API são semelhantes aos Task Bots, já que não usam os dispositivos Bot Runner locais, em vez disso, funcionam inteiramente no Nuvem. As Tarefas de API funcionam com nossos conectores padrão, como Salesforce, ServiceNow, Workday, REST e SOAP para automatizar fluxos de trabalho e processos. Não é possível usar a Tarefa de API para automatizar uma operação de desktop.
Nota: Não é possível executar uma Tarefa de API a partir do API Editor como uma automação autônoma. No entanto, você pode testar a Tarefa de API no API Editor usando o recurso Depurador.

Por que usar as Tarefas de API?

Você pode obter os seguintes resultados usando as Tarefas de API para sua automação.
  • Execuções mais rápidas na velocidade nativa do Java
  • Design de caso de uso de baixa latência
  • Tempo de resposta inferior a um segundo
  • Funciona em grupo de dispositivos no Automation 360 Nuvem
  • As tarefas de API podem ser agendadas de acordo com os requisitos do negócio
  • Nenhuma infraestrutura local necessária

Invocar Tarefas de API

Você pode invocar uma Tarefa de API a partir de um formulário ou do Process Composer, onde você compõe o fluxo de trabalho para um processo de ponta a ponta. Um processo de ponta a ponta pode incluir: Task Bot, Tarefa de API e Tarefa humana. No entanto, quando as Tarefas de API em um fluxo de processo são executadas, as automações são executadas em dispositivos de nuvem na infraestrutura do Automation 360, reduzindo o tempo de processamento. Como as Tarefas de API são executadas em dispositivos de nuvem, você precisa configurar um pool de dispositivos de API. Para mais detalhes, consulte Criar um grupo de dispositivos da API e configurar o Tarefa de API.

Invocar Tarefas de API em um formulário

Você pode usar Tarefas de API em um formulário para procurar dados dinamicamente por meio da chamada de API.

  • Quando Tarefas de API são invocadas a partir de um formulário, elas são executadas em dispositivos em nuvem e fornecem resposta em tempo real.
  • O Tarefa de API é pré-aquecido em um ou mais dispositivos de nuvem. Você aloca dispositivos para pré-aquecimento para a Tarefa de API no Criar um grupo de dispositivos da API e configurar o Tarefa de API.
  • O número de dispositivos pré-aquecidos depende do nível de simultaneidade necessário.
Invocar Tarefas de API em um processo

Você pode usar as Tarefas de API em um processo para fazer chamadas para APIs assíncronas.

  • Quando as Tarefas de API são invocadas em um processo, elas fornecem uma resposta mais rápida do que um Task Bot quando chamado no mesmo processo.
  • Tarefas de API são executadas em dispositivos não atribuídos disponíveis no pool de dispositivos da API durante o tempo de execução.

Definição e configuração de Tarefa de API pelo usuário

Defina usuários para criar Tarefas de API e atribuir usuários para executar como usuário. Você também pode atribuir funções apropriadas aos usuários.

O diagrama a seguir mostra a definição e a configuração das Tarefas de API para usuários administradores e criadores de bots:
Fluxo de trabalho da tarefa da API

Funções:

A seguinte permissão deve ser atribuída a uma função (por exemplo: api_task_creator):
  • Bots: Exibir, Executar, Exportar, Importar, Categorizar, Cancelar Checkout
  • Dispositivos: Exibir e gerenciar TODOS os dispositivos
  • Exibir ações de log de auditoria de todos
  • A função AAE_API Task Runner é atribuída automaticamente ao usuário apitaskrunner com as seguintes permissões atribuídas:
    • Exibir pacotes
    • Registrar dispositivo
    • Ver informações básicas de usuários e funções
    • Exibir e gerenciar meus Bot runners, Bot creators e grupos de dispositivos: Criar grupos de dispositivos
    • BOTS: Exibir, Executar, Exportar, Importar, Categorizar, Cancelar Checkout
    • Guia Bots: Selecionar tudo na pasta Bots
    • Dispositivos: Exibir e gerenciar TODOS os dispositivos

Usuários:

Um usuário de execução padrão apitaskrunner é atribuído automaticamente a todas as Tarefas de API configuradas no grupo de dispositivos de API. O usuário apitaskrunner terá a função AAE_API Task Runner associada a ele.

Você também pode criar um usuário com uma licença de Bot Creator, com as seguintes funções:
  • AAE_Basic
  • Desenvolvedor AAE_Bot
  • Administrador AAE_Pool
  • api_task_creator (função personalizada que você criou anteriormente).

Casos de uso de Tarefa de API

Veja a seguir alguns dos casos de uso das Tarefas de API:
Chamadas de API SaaS
Usar as Tarefas de API em seus processos simplifica a integração de vários aplicativos SaaS, por meio das APIs. Você pode fazer o seguinte com as APIs SaaS:
  • Conecte-se a sistemas SaaS conhecidos, como Salesforce, Twilio ou ServiceNow, para realizar tarefas complexas com eficiência.
  • Use-o como um conector SaaS para trazer diretamente dados sob demanda de aplicativos externos para sua automação.
Pesquisa no banco de dados
Tarefas de API podem consultar bancos de dados por meio dos endpoints da API de banco de dados. Elas podem se conectar rapidamente a um aplicativo de banco de dados para procurar os dados necessários e disponibilizá-los para processamento posterior.