Criar um API Task

Você pode criar um API Task com diversos pacotes sem compatibilidade na Automation Anywhere Control Room.

Pré-requisitos

Você deve ter uma licença do Bot Creator.
Este tópico descreve como criar uma API Task usando uma amostra de 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 API Task com as ações que são específicas para seu caso de uso.

Procedimento

  1. Faça login na instância da Automation Anywhere Control Room como o Bot Creator.
  2. Crie um novo API Task:
    1. No painel da esquerda, clique em Automação.
    2. Clique em Criar novo > API Task .
    3. Na janela Criar API Task , insira o nome API Task.
    4. Aceite o local da pasta padrão: \Bots\.
      Para alterar o local de armazenamento do API Task, 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 action 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 Tabela 1.
    1. Clique duas vezes ou arraste a REST Web Services > Método GET action.
      Serviços da Web Get - Método Get
    2. Digite 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 API Task. Este 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, em seguida, API 3 para criar uma cotação dentro da mesma API Task.

    3. Na lista suspensa Modo de autenticação, selecione Sem autenticação porque este ponto final não requer autenticação.
      Nota: Normalmente, os endpoints exigem autenticação para garantir que somente aplicativos autorizados possam acessar os dados. Selecione um mecanismo de autenticação apropriado para permitir o acesso ao endpoint que você quer acessar.
    4. Crie a variável pDictZipCodeApiResponse no campo Atribuir a saída a uma variável. Para mais informações sobre como 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 API Tasks: Arquivo, Janela e Formulário.
  5. No painel Ações, arraste a ação JSON > Iniciar sessão e solte-a na tela abaixo da ação Serviços Web REST.
    1. No campo Fonte de dados, selecione Texto e digite$pDictZipCodeApiResponse{Corpo}$.
    2. No campo Sessão do objeto JSON, selecione Sessão local e insira Padrão.

      API Task Dicionário
      Agora você tem todo o Body. A próxima tarefa é extrair os campos obrigatórios do corpo. A seguir, um exemplo de Corpo:
      {
    "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ó action e solte-a na tela abaixo da ação Json > Sessão de estado.
    2. Especifique os nós que serão extraídos. Por exemplo, para extrair o local, você pode usar places[0].["nome do local"]
    3. Crie uma variável Local e atribua a saída a essa variável.
  7. Extraia o estado do JSON.
    1. No painel Ações, arraste a ação Json > Obter valor do nó action e solte-a na tela abaixo da ação Json > Sessão de estado.
    2. Especifique os nós que serão extraídos. Por exemplo, para extrair o local, você pode use places[0].["estado"]
    3. Crie uma variável Estado e atribua a saída a essa variável.
  8. Clique em Salvar.
    Para testar o API Task, clique em Depurador. Ao fazer a depuração, o dispositivo local é usado para executar o API Task. O API Task criado neste exemplo recupera o Local e Estado para qualquer entrada de código postal.