Invocar API Tasks instantaneamente com um endpoint. Inicia e executa dinamicamente API Tasks sob demanda usando a API de implantação em conjunto com a solicitação sob demanda. Essa abordagem simplifica os fluxos de trabalho e melhora a eficiência dos recursos em comparação com implantações estáticas tradicionais.

Nota: As API Tasks não são compatíveis com formulários interativos.

Principais benefícios

  • Implantação programática: Implante uma API Task de qualquer lugar, sob demanda, usando a API cliente de sua preferência.
  • Processamento:
    • As automações são ativadas somente quando necessário, o que garante a utilização ideal dos recursos. Isso significa que elas não são constantemente implantadas na nuvem, o que causa a reserva de recursos. Em vez disso, elas são carregadas e executadas a cada solicitação.
    • Em períodos de alto volume, as automações são colocadas em fila e executadas assim que os dispositivos ficam disponíveis, garantindo operações tranquilas mesmo sob carga pesada. É possível visualizar o progresso das automações na página Atividade.
    • A licença Premium ajuda a dimensionar as automações, além de fornece acesso a um conjunto maior de recursos de nuvem capazes de executar várias instâncias da API Task, o que não só aumenta a simultaneidade mas também permite que você processe mais API Task solicitações de maneira concomitante.
  • Casos de uso ideais:
    • Trabalhos de processamento em lote (como análise de dados de vendas, geração de relatórios)
    • Tarefas agendadas
    • Situações onde a resposta imediata não é crucial
Nota: Para habilitar a implantação da API Task sob demanda em um processo, gere uma chave de registro em Administração > Configurações > Instalação em massa do agente de bot > Gerar uma nova chave e clique em Salvar alterações.

Autenticação

Adquira as credenciais de autenticação necessárias para interagir com a API de implantação. Isso geralmente envolve tokens de acesso ou chaves de API. No exemplo a seguir, uma API Task sob demanda é implantada para um dispositivo em nuvem. Você também pode passar variáveis para bots quando eles forem implantados.

POST https://{{ControlRoomURL}}/v4/automations/deploy

Header: X-Authorization: <<authentication token>> or Authorization: Bearer <<b
earer token>>

Todas as chamadas API devem conter um token de API de autenticação (gera um token da Web JSON) ou um token portador dos serviços OAuth. Não é possível utilizar os dois juntos em uma API.

Criar a solicitação sob demanda

Solicitação: 
{
  "botId": 121,
  "automationName": "SAMPLE_APITASK",
  "description": "My first API Task deploy using api",
  "botLabel": "string",
  "executionType": "RUN_NOW",
  "automationPriority": "PRIORITY_MEDIUM",
  "headlessRequest": {
    "numberOfExecutions": 1,
    "queueOnSlotsExhaustion": false,
    "sharedRunAsUserId": 12
  },
  "botInput": {
    "inputVar": {
      "type": "STRING",
      "string": "PassingString"
    }
  }
}
Nota:

As solicitações de implantação de automação podem ser feitas sem campos de entrada. Se você especificar entradas, certifique-se de que para a API Task receber esses valores mapeados com sucesso, a variável para essa automação precisará ser marcada como entrada. Além disso, o nome da variável na API Task precisa corresponder ao valor que está sendo mapeado no corpo da solicitação.

Parâmetros da solicitação
Parâmetro Tipo Obrigatório Descrição
botId Inteiro Sim Digite o ID da automação a ser implantada. A ID fica visível na barra de endereços quando você abre a automação em um editor.
automationName String Não Digite o nome que você usou quando criou a automação.
descrição String Não Insira a descrição que você usou quando criou a automação.
botLabel String Não Insira o rótulo que você aplicou quando fez checkin na automação. Você pode inserir Produção ou N/A.
executionType String Não Insira o tipo de execução associado ao bot. Você pode inserir um dos seguintes tipos de execução:
  • RUN_NOW
  • RUN_WITH_QUEUE
  • RUN_WITH_EVENT_TRIGGERS
automationPriority String Não Insira a prioridade para a execução de automação. Você pode inserir uma das seguintes prioridades:
  • PRIORITY_MEDIUM
  • PRIORITY_HIGH
  • PRIORITY_LOW
A prioridade padrão é definida como PRIORITY_MEDIUM.
Objeto headlessRequest.
numberOfExecutions Inteiro Não Insira o número de execuções a serem executadas para uma determinada solicitação sob demanda (headless).
queueOnSlotsExhaustion boolean Não Digite Verdadeiro ou Falso para especificar se a implantação deve ser enfileirada.
sharedRunAsUserId Inteiro Não Digite o ID do usuário apitaskrunner para estabelecer o contexto RunAsUser para API Tasks.

O ID do usuário é visível na barra de endereços quando você edita os detalhes do usuário na página Editar usuário.

Para mais informações sobre o apitaskrunner, consulte Executar como usuário para API Task (apitaskrunner).
Nota: O RunAsUser não requer uma licença de Bot Runner.
Objeto botInput
tipo Qualquer um Não Digite o tipo da variável de entrada.

Você pode inserir um dos seguintes tipos de variáveis: STRING, NUMBER, BOOLEAN, FILE, ITERATOR, LIST, DICTIONARY, TABLE, VARIABLE, CONDITIONAL, WINDOW, TASKBOT, DATETIME, UIOBJECT, RECORD, EXCEPTION, CREDENTIAL, COORDINATE, IMAGE, REGION, PROPERTIES, TRIGGER, CONDITIONALGROUP, FORM, FORMELEMENT, HOTKEY e WORKITEM.
string String Não Digite a string que deve ser usada como entrada para a variável STRING.
Resposta 
{
  "deploymentId": "320a2149-aa44-41ab-af9b-f9343ae2581b",
  "automationName": "SAMPLE_APITASK"
}
Parâmetros de resposta
Parâmetro Tipo Descrição
deploymentId String O ID de implantação que é gerado durante a implantação de bot.
automationName String O nome da automação implantada. Se você não incluir o nome da automação na solicitação, um nome aleatório será atribuído à automação implantada.
Você pode testar esse endpoint na interface do Swagger, que está incluída em todas as suas instâncias da Control Room.
Dica: Acesse o Swagger navegando até a instância da Control Room e adicionando /swagger/ no final do URL.https://{{ControlRoomURL}}/swagger/

Exiba a página de atividades na Control Room para rastrear o progresso da execução sob demanda (headless) em Na fila >> Em progresso >> Concluída.

API-Task-Activity-page

Para obter mais detalhes sobre a API de implantação, consulte API de implantação de bot (V4).