Crie uma Tarefa de API (Tarefa de API no formulário)

Crie um Tarefa de API com os pacotes disponíveis na Control Room, no editor de Tarefa de API. Você pode criar um Tarefa de API com ações de pacotes que são suportados no Automation 360 Nuvem.

Pré-requisitos

Você deve ter uma licença do Bot Creator.
Este tópico descreve como criar uma Tarefa de API usando uma API que recebe um CEP dos EUA como entrada e retorna o nome do local e do estado como saída. Você pode criar um Tarefa de API com as ações que são específicas para seu caso de uso.

Procedimento

  1. Faça login na instância do Automation Anywhere Control Room como o Bot Creator.
  2. Crie um novo Tarefa de API:
    1. No painel da esquerda, clique em Automação.
    2. Clique em Criar novo > Tarefa de API.
    3. Na janela Criar Tarefa de API, insira o nome do Tarefa de API.
    4. Aceite o local da pasta padrão: \Bots\.
      Para alterar o local de armazenamento do Tarefa de API, clique em Escolher e siga as instruções.
    5. Clique em Criar e editar.
  3. Crie uma variável ZipCode como uma entrada que será usada no URL do CEP.
  4. Use a ação Método GET para recuperar o local e o estado de um CEP.
    Nota: Pacotes pré-construídos estão disponíveis para os aplicativos corporativos mais comuns. Para obter uma lista dos pacotes suportados, consulte Perguntas frequentes sobre tarefas de API (conteúdo .30).
    1. Clique duas vezes ou arraste a ação REST Web Services > Método GET.
      Serviços Rest Web - Método Get
    2. Insira o seguinte URI. $ZipCode$ no URI é a variável de entrada criada na Etapa 3. 
      https://api.zippopotam.us/us/$ZipCode$
      Nota:

      Você pode configurar múltiplas APIs com uma única Tarefa de API. Isso pode simplificar sua automação e reduzir a necessidade de ter múltiplas tarefas separadas. Por exemplo, você pode chamar a API 1 para buscar dados do produto, a API 2 para buscar dados de preços e então a API 3 para criar uma cotação dentro da mesma Tarefa de API.

    3. Na lista suspensa Modo de autenticação, selecione Sem autenticação, pois este endpoint não requer autenticação.
      Nota: Em geral, os endpoints requerem autenticação para garantir que apenas aplicativos autorizados possam acessar os dados. Selecione um mecanismo de autenticação apropriado para permitir o acesso ao endpoint que você deseja acessar.
    4. Crie a variável pDictZipCodeApiResponse no campo Atribuir a saída à variável. Para mais informações sobre criar uma variável, consulte Criar uma variável.
      Nota:
      • A resposta completa da API JSON é atribuída a esta variável de dicionário: pDictZipCodeApiResponse.
      • Os seguintes tipos de variáveis não são suportados para Tarefas de API: Arquivo, Janela e Formulário.
  5. No painel Ações, clique na ação JSON > Iniciar sessão e arraste-a para a tela abaixo da ação Serviços Web REST.
    1. No campo Fonte de dados, selecione Texto e insira $pDictZipCodeApiResponse{Body}$.
    2. No campo Sessão do objeto JSON, selecione Sessão local e insira Default.

      Tarefa de API Dicionário
      Agora você tem todo o Body. A próxima tarefa é extrair os campos obrigatórios do corpo. A seguir, um exemplo de JSON Body:
      {
    "post code": "90210",
    "country": "United States",
    "country abbreviation": "US",
    "places": [
        {
            "place name": "Beverly Hills",
            "longitude": "-118.4065",
            "state": "California",
            "state abbreviation": "CA",
            "latitude": "34.0901"
        }
    ]
}
  6. Extraia o place name do JSON.
    1. No painel Ações, arraste a ação Json > Obter valor do nó para a tela abaixo da ação Json > Indicar sessão.
    2. Especifique os nós que serão extraídos. Por exemplo, para extrair o local, use places[0].["place name"]
    3. Crie uma variável Local e atribua a saída a essa variável.
  7. Extraia o state do JSON.
    1. No painel Ações, arraste a ação Json > Obter valor do nó para a tela abaixo da ação Json > Indicar sessão.
    2. Especifique os nós que serão extraídos. Por exemplo, para extrair o local, use places[0].["state"]
    3. Crie uma variável Estado e atribua a saída a essa variável.
  8. Clique em Salvar.
    Para testar o Tarefa de API, clique em Depurador. Ao fazer a depuração, o dispositivo local é usado para executar o Tarefa de API. O Tarefa de API criado nesta amostra recupera o Local e o Estado de qualquer entrada de CEP.