Lea y revise la documentación de Automation Anywhere

Automation Anywhere Automation 360

Cerrar contenidos

Contenidos

Abrir contenidos

REST Web Service package

  • Actualizado: 2022/02/20
    • Automation 360 v.x
    • Crear
    • Espacio de trabajo de RPA

REST Web Service package

Utilice las actions en el package REST Web Service como métodos (ELIMINAR, OBTENER, EMPARCHAR, PUBLICAR, PONER) para enviar solicitudes y recibir respuestas de una API.

Trabajar con actions REST Web Service

Proporcione la siguiente información para enviar una solicitud EN PAUSA y recibir una respuesta. No se requieren todos los parámetros para todos los métodos.
  • URI: Una dirección única para un recurso API.
  • Modo de autenticación: Existen tres modos de autenticación compatibles:
    • Básico: Se pueden utilizar cadenas de texto para la autenticación básica.
    • Usuario de AD con sesión abierta: Los usuarios de Active Directory (AD) autorizados para acceder a la API relacionada se autentican a través de AD. No se necesitan credenciales en la solicitud.
    • Autenticación de Windows NT LAN Manager (NTLM) (Usuario AD): Un método de autenticación de desafío/respuesta que les permite a los clientes proporcionar su nombre de usuario y contraseña como credenciales cifradas o texto sin formato. Le recomendamos que utilice credenciales almacenadas en el Automation Anywhere Credential Vault.
  • Encabezado: No todos los métodos requieren un encabezado. Los encabezados representan los metadatos asociados con la solicitud.
    Nota: Para usar una clave de API en su solicitud, introduzca api_key en el campo Nombre del encabezado e ingrese el valor de la clave en el campo Valor.
  • Capturar respuesta ante fallas: Seleccione la casilla de verificación para capturar la respuesta antes fallas, excepto para la respuesta Éxito/Aceptar. Los detalles de la respuesta ante fallas se capturan en el cuerpo de la respuesta.
  • Permitir una conexión insegura cuando se utiliza https: Seleccione la casilla de verificación para permitir una conexión insegura cuando se utiliza https.
  • Tipo de contenido: Cuando un encabezado contiene un tipo de contenido, define la negociación de contenido entre el cliente y el servidor. Las actions REST Web Service admiten los siguientes tipos de archivos:
    • application/json
    • aplicación/xml
    • texto/sin formato
    • texto/html
    • texto/xml
    • multipart/form-data
  • Espere a que se complete la acción: Se puede establecer un valor de tiempo de espera cuando se envía una solicitud REST y se recibe una respuesta. Cuando realiza actions como POST, PUT, DELETE, PATCH y GET, en el campo Esperar a que se complete la acción, puede especificar el tiempo de espera (en milisegundos). De manera predeterminada, el tiempo de espera es de 60 000 milisegundos.
  • Variable de salida: La salida de respuesta se captura en una variable de diccionario. Una variable de diccionario es un par de valores clave. Utilice el nombre del encabezado de la respuesta como clave para devolver el valor del encabezado o “Cuerpo” como la clave para devolver el cuerpo de la respuesta.
    Nota: La clave de respuesta con su valor está disponible en la variable de diccionario para mostrar el estado de respuesta de la API REST.
    Para obtener una lista de los nombres de encabezado para el recurso API, realice estos pasos:
    1. Inserte una action Loop después de la action REST Web Service.
    2. Seleccione el iterador Para cada clave en el diccionario.
    3. En el campo Variable de diccionario, seleccione la variable que contiene la salida de la action REST Web Service.
    4. Asigne el valor de cada clave a $prompt-assignment$.
    5. Inserte una Log To File action.
    6. Proporcione la ruta del archivo a un archivo de texto para contener la lista de nombres de encabezado.
    7. Inserte $prompt-assignment$ en el campo Introducir texto a registrar.
    8. Seleccione la opción Sobrescribir archivo existente.
    9. Haga clic en Save (Guardar).

      Cuando usted ejecuta el bot, este imprime los nombres de encabezado del recurso API al archivo seleccionado.

Pasar valores de manera segura

Usted puede pasar valores de forma segura desde la Credential Vault al servicio web especificando el locker, la credencial y el atributo en los siguientes campos de action compatibles:
  • URI
  • Encabezados personalizados
  • Cuerpo: Para el tipo de contenido application/x-www-form-urlencoded, haga clic en Agregar parámetro para seleccionar el valor desde la Credential Vault.

    Para todos los demás tipos de contenido, seleccione la opción Seleccionar una credencial como parámetros y haga clic en Elegir.

Actions en el package de REST Web Service

Action Descripción
Método DELETE Elimina el recurso que es identificado por la URI.
Método Get Recupera la información identificada por los parámetros incluidos en la URI. No hay Tipo de contenido para el método GET porque todos los parámetros se pasan como parte de la URI.

Las limitaciones y características del método GET incluyen lo siguiente:

  • La extensión de la URI se limita a 2 048 caracteres.
  • Todos los parámetros se pasan en la URI.
  • El método GET expone los datos que se encuentran en la URI, lo que hace que sea menos seguro que el método POST.
  • GET no cambia ningún dato, lo que hace que sea seguro para todos los usuarios, independientemente de la autorización.
Método PATCH Modifica el recurso que es identificado por la URI.
Método Post Crea un nuevo recurso en la URI.
  • Los parámetros son pasados al cuerpo de la solicitud.
  • No hay límite de extensión para el cuerpo de una solicitud.
Método PUT Actualiza o reemplaza un registro basado en los parámetros pasados en la URI o el cuerpo.

Compatibilidad de proxies

Si su dispositivo está configurado con un proxy, todas las solicitudes salientes de este package se enrutan a través del servidor proxy. Consulte Conectar Bot agent a un dispositivo con un proxy.

Enviar comentarios