Crear un Tarea API

Puede crear un Tarea API con varios paquetes compatibles con Automation Anywhere Control Room.

Antes de empezar

Debe tener una licencia Bot Creator.
En este tema, se describe cómo crear una Tarea API usando una API que toma un código postal de los EE. UU. como entrada y devuelve el nombre del lugar y el estado como salida. Puede crear un Tarea API con las acciones específicas de su caso de uso.

Procedimiento

  1. Inicie sesión en su instancia de Automation Anywhere Control Room como Bot Creator.
  2. Crear un nuevo Tarea API:
    1. En el panel izquierdo, haga clic en Automatización.
    2. Haga clic en Crear nueva > Tarea API.
    3. En la ventana Crear Tarea API, ingrese el nombre del Tarea API.
    4. Acepte la ubicación predeterminada de la carpeta: \Bots\.
      Si desea cambiar la ruta de almacenamiento de su Tarea API, haga clic en Elegir y siga las indicaciones.
    5. Haga clic en Crear y editar.
  3. Cree una variable de ZipCode como una entrada que se utilizará en la URL del código postal.
  4. Use la acción Método Get para recuperar el lugar y el estado de un código postal.
    Nota: Hay paquetes prediseñados para la mayoría de las aplicaciones empresariales habituales. Para revisar una lista de paquetes compatibles, consulte Preguntas frecuentes sobre tareas de API (contenido en la v.30).
    1. Haga doble clic o arrastre la acción Servicios web REST > Método Get.
      Servicios web Rest - Método Get
    2. Escriba el siguiente URI: $ZipCode$ del URI es la variable de entrada creada en el Paso 3. 
      https://api.zippopotam.us/us/$ZipCode$
      Nota:

      Puede configurar varias API dentro de una sola Tarea API. Esto puede simplificar la automatización y reducir la necesidad de realizar múltiples tareas por separado. Por ejemplo, puede configurar API 1 para que obtenga datos del producto, API 2 para que obtenga datos de precios, y luego, API 3 para que cree una cotización dentro de la misma Tarea API.

    3. En el menú desplegable Modo de autenticación, seleccione Sin autenticación porque este punto final no requiere autenticación.
      Nota: Normalmente, los puntos finales requieren autenticación para garantizar que solo las aplicaciones autorizadas puedan acceder a los datos. Seleccione un mecanismo de autenticación apropiado para permitir el acceso al extremo al que desea acceder.
    4. Cree la variable pDictZipCodeApiResponse en el campo Asignar la salida a una variable. Para obtener más información sobre la creación de variables, consulte Crear una variable.
      Nota:
      • La respuesta JSON completa de la API se asigna a esta variable de diccionario: pDictZipCodeApiResponse.
      • Los siguientes tipos de variables no son compatibles con las Tareas API: Archivo, ventana y formulario.
  5. En el panel Acciones, arrastre la acción JSON > Iniciar sesión hacia el lienzo debajo de la acción Servicios web REST.
    1. En el campo Origen de datos, seleccione Texto e introduzca $pDictZipCodeApiResponse{Body}$.
    2. En el campo sesión del objeto JSON, haga clic en Sesión local e ingrese Default.

      Diccionario de tareas API
      Ya tienes el Body completo. La siguiente tarea consiste en extraer los campos obligatorios del cuerpo. A continuación, se muestra un ejemplo Body de JSON:
      {
    "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. Extraiga place name del JSON.
    1. En el panel Acciones, arrastre la acción Json > Obtener valor de nodo y suéltela en el lienzo debajo de la acción Json > Establecer sesión.
    2. Especifique qué nodos se extraerán. Por ejemplo, para extraer el lugar, puede usar places[0].["place name"]
    3. Cree una variable Colocar y asigne la salida a esta variable.
  7. Extraiga state del JSON.
    1. En el panel Acciones, arrastre la acción Json > Obtener valor de nodo y suéltela en el lienzo debajo de la acción Json > Establecer sesión.
    2. Especifique qué nodos se extraerán. Por ejemplo, para extraer el lugar, puede usar places[0].["state"]
    3. Cree una variable Estado y asigne la salida a esta variable.
  8. Haga clic en Guardar.
    Para probar el Tarea API, haga clic en Depurador. Durante la depuración, se usa el dispositivo local para ejecutar el Tarea API. El Tarea API creado en este ejemplo recupera el Lugar y Estado para cualquier entrada de código postal.