Perguntas frequentes sobre API Task

Consulte as perguntas frequentes para saber mais sobre API Tasks.

1. Quais são as diferentes etapas envolvidas na criação e uso de API Tasks em formulários (tempo real)?

API Task em um formulário

2. Quais são as diferentes etapas envolvidas na criação e utilização de API Tasks no processo (sob demanda)?

Tarefa da API em um processo

3. Como uma API Task é executada em comparação com um Task Bot?

As API Tasks são executadas no Automation 360 Cloud, ao contrário dos Task Bots, que usam os dispositivos do executor de bots na infraestrutura do cliente. As API Tasks não realizam interações de desktop como os Task Bots e podem ser iniciadas com rapidez e potencialmente serem executadas de maneira mais rápida do que os Task Bots.

Além disso, o produto está em conformidade com o Regulamento Geral de Proteção de Dados (GDPR) e a Lei de Privacidade do Consumidor da Califórnia (CCPA). A API Task também faz parte da plataforma que está em conformidade com o SOC 2. Todos os dados de API Task são criptografados, e fornecemos criptografia para dados móveis e estáticos.

4. É possível ler ou gravar em um arquivo em API Tasks?
Sim, você pode ler ou gravar em um fluxo de arquivo com API Tasks. O REST Web Services package agora é compatível com a leitura de um FileStream por meio de uma variável, permitindo que você interaja perfeitamente com arquivos em armazenamento on-line como o OneDrive. Embora atualmente tenhamos compatibilidade apenas com o OneDrive, nossos planos incluem a integração com outros serviços populares de armazenamento em nuvem.
5. A API Task oferece suporte a pacotes personalizados criados usando o Package SDK?
Não, a API Task atualmente não oferece suporte a pacotes criados usando o Package SDK.
6. Se um dos dispositivos ficar inativo em meu grupo de dispositivos de API, outro será ativado automaticamente?
Sim, tudo é gerenciado para você.
7. Os usuários podem criar um grupo de dispositivos para tarefas da API por conta própria e atribuir tarefas da API a ele?
Não, não é possível criar seu próprio pool de dispositivos para API Tasks. A plataforma Automation Anywhere Cloud provisiona e gerencia automaticamente contêineres de API Task, dimensionando-os de maneira dinâmica para acomodar cargas de trabalho flutuantes.
8. O que acontece se uma API Task executa mais do que o limite da sessão? Ela falha imediatamente ou fica na fila?
  • Modo em tempo real: Se uma API Task no modo em tempo real (assistido – chamado via formulários) exceder o limite da sessão, ela falhará imediatamente. Isso ocorre porque as tarefas do modo em tempo real são pré-implantadas e prontas para execução imediata, e não há mecanismo de enfileiramento para tarefas que não podem ser executadas devido a restrições de simultaneidade.
  • Modo sob demanda: Se uma API Task no modo sob demanda (não assistido – chamado por meio de processos) excede o limite da sessão, ela será enfileirada e processada quando uma sessão estiver disponível. Isso significa que a tarefa não falhará imediatamente, mas aguardará até que uma sessão seja liberada antes de poder ser executada.
9. Qual é a vida útil dos dispositivos que giram?
Os recursos do pool de dispositivos da API ficam disponíveis durante toda a configuração.
10. Alguma coisa precisa ser configurada no computador de implementação?
API Tasks são executadas nos dispositivos Automation 360 Cloud; portanto, nenhum dispositivo do cliente na infraestrutura precisa ser configurado.
11. É necessário realizar alguma instalação de dispositivo?
Os dispositivos de nuvem são executados em clusters gerenciados pela Automation Anywhere. O cliente não precisa instalar nenhum dispositivo.
12. Há um tempo limite para a execução de API Task?
Para API Tasks em tempo real, o tempo limite é de 1 minuto. Para API Tasks sob demanda, o tempo limite é de 15 minutos.
13. Que tipo de dados e por quanto tempo as informações permanecem nos dispositivos de nuvem?
Os dados transitórios não persistem; somente os metadados de API Task são salvos.
14. Por que a opção de execução não está disponível no editor de API Task?
As API Tasks não podem ser implantadas em seu PC local. Por isso, o editor de API Task não inclui uma opção de execução. No entanto, você pode invocar as API Tasks por meio de formulários, processos, endpoints ou usando a opção Executar agora.
15. Como faço para encontrar erros em minha API Task?
Para verificar se sua lógica de API Task está correta, é recomendável usar a ferramenta Depurador e observar as variáveis de saída. Você também pode usar as ações do pacote do gerenciador de erros para verificar se há erros na API Task.
16. O que é pré-aquecimento?
O pré-aquecimento é o processo de pré-instalação da lógica da API Task e dos comandos nos dispositivos na Cloud, preparando-os para processar as solicitações recebidas. Durante o aquecimento, todas as dependências de API Task, inclusive as bibliotecas, são instaladas com antecedência. Isso é vantajoso, pois elimina a necessidade de verificar as dependências antes de implantar a API Task. Portanto, as API Tasks são executadas com latência muito baixa. As API Tasks que são invocadas em um formulário precisam ser pré-aquecidas no dispositivo Cloud para que a execução seja concluída com êxito. Antes de executar um processo que tenha o formulário (API Task anexada), você pode verificar se a API Task está pré-aquecida nos logs de auditoria. Para mais detalhes, consulte Exibir registros de auditoria do tempo de execução da API Task.
17. Posso criar um pool de dispositivos para API Tasks e atribuir API Tasks a ele?

Não, não é possível criar seu próprio pool de dispositivos para API Tasks. A plataforma de nuvem da Automation Anywhere provisiona e gerencia automaticamente contêineres de API Task, dimensionando-os de maneira dinâmica para acomodar cargas de trabalho flutuantes.

18. O que acontece se uma API Task executa mais do que o limite da sessão? Ela falha imediatamente ou fica na fila?
O comportamento das tarefas da API que excedem o limite da sessão depende do modo de API Task que está sendo usado:
  • Modo em tempo real: Se uma API Task no modo em tempo real (assistido – chamado via formulários) exceder o limite da sessão, ela falhará imediatamente. Isso ocorre porque as tarefas do modo em tempo real são pré-implantadas e prontas para execução imediata, e não há mecanismo de enfileiramento para tarefas que não podem ser executadas devido a restrições de simultaneidade.
  • Modo sob demanda: Se uma API Task no modo sob demanda (não assistido – chamado por meio de processos) excede o limite da sessão, ela será enfileirada e processada quando uma sessão estiver disponível. Isso significa que a tarefa não falhará imediatamente, mas aguardará até que uma sessão seja liberada antes de poder ser executada.
19. Quais são os tipos de variáveis compatíveis com as API Tasks?
Os seguintes tipos de variáveis são compatíveis com as API Tasks:
  • String
  • Número
  • Data/hora
  • Booliano
  • Credencial
  • Lista
  • Dicionário
  • Gravar
  • Tabela
  • Sessão
  • Arquivo
    Nota: Para obter mais informações sobre os pacotes que oferecem suporte a variáveis de arquivo em API Tasks, consulte File streaming using file variable.
Para mais informações sobre as variáveis, consulte Visão geral das variáveis.
20. Qual é o modelo de licença para as API Tasks?
Como parte dos direitos básicos gratuitos, cada cliente de nuvem recebe 100 execuções de API Task por Control Room. Os direitos básicos também incluem duas execuções simultâneas, o que quer dizer que você pode executar duas tarefas da API simultaneamente. Para limites de execução mais altos e simultaneidade adicional, você pode adquirir a licença Enterprise Platform ou um SKU de API Task excedente. Para obter mais assistência, entre em contato com seu gerente de atendimento ao cliente.
21. Como você visualiza os detalhes de consumo das API Tasks?
Vá para a seção Automation Anywhere Cloud Service em Administração > Licenças para acompanhar o consumo de API Task. Clique em Execuções básicas (número de execuções de tarefas da API) ou Execuções excedentes (número de execuções de tarefas da API) para ver os detalhes da execução.
  • As Execuções básicas listam os detalhes de consumo do direito à base gratuita.
  • As Execuções em excesso listam os detalhes de consumo que fazem parte de uma licença Enterprise Platform ou de um SKU de API Task excedente.
22. Como o sistema calcula as execuções de API Task?
O sistema calcula as execuções de API Task por minuto. Se a duração da execução exceder 1 minuto (60 segundos), a contagem de execuções será aumentada em um.
Por exemplo:
  • Uma tarefa de API que é executada por 30 segundos conta como uma execução.
  • Uma tarefa de API que é executada por 1 minuto e 1 segundo (61 segundos) conta como 2 execuções.
  • Uma tarefa de API que é executada por 3 minutos e 40 segundos (220 segundos) conta como 4 execuções.
23. Se eu incluir 10 chamadas de API em uma única API Task, isso contará como uma ou múltiplas execuções?
Conta como uma única execução. Você pode incluir qualquer número de chamadas de API em uma única API Task.
24. Como o sistema calcula o consumo de API Task quando uma execução de API Task está travada?
Se uma execução de API Task ficar travada devido a qualquer problema de lógica ou código, como um loop infinito, falta de resposta de um sistema de terceiros ou um tempo limite de resposta, o sistema encerrará automaticamente a execução após um minuto para API Tasks em tempo real e 15 minutos para API Tasks sob demanda. Nesses casos, o sistema conta isso como uma execução (uma execução para API Tasks em tempo real e 15 execuções para API Tasks sob demanda) e atualiza os detalhes de consumo na página Licenças.
Se a solicitação de execução permanecer na fila devido à indisponibilidade do dispositivo, o sistema não contará a execução até que um dispositivo esteja disponível e a execução seja concluída.
Nota: Você poderá cancelar as API Tasks travadas se você tiver a permissão Gerenciar minha atividade . Para obter mais assistência, entre em contato com o respectivo gerente de atendimento ao cliente.
25. Ao implantar uma API Task sob demanda em um processo, você encontra o erro "DESCONHECIDO: Não foi possível encontrar o token de registro automático do agente de bot". Como você pode resolver isso?
O erro acima indica que uma chave de registro não está disponível para implantação sob demanda da API Task. Para resolver isso:
  1. Vá para Administração > Configurações > Instalação em massa do agente de bot.
  2. Clique em Editar; a opção Gerar uma nova chave é selecionada por padrão.
  3. Clique em Salvar alterações para gerar uma chave de registro.