Lea y revise la documentación de Automation Anywhere

Automation Anywhere Automation 360

Cerrar contenidos

Contenidos

Abrir contenidos

Ejemplo de uso de la acción servicio web de SOAP

  • Actualizado: 11/23/2021
    • Automation 360 v.x
    • Crear
    • Espacio de trabajo de RPA
    • Ejemplos

Ejemplo de uso de la acción servicio web de SOAP

Utilice la action SOAP web service (Servicio web SOAP) para pasar dos valores numéricos y devolver la suma de una aplicación de calculadora en línea.

Procedimiento

Para realizar una llamada de servicios web SOAP, realice los pasos que se muestran a continuación:

  1. Haga doble clic o arrastre la acción SOAP web service (Servicio web SOAP).
  2. Seleccione un método de conexión:
    • Para conectarse utilizando un URI, ingrese el URI, por ejemplo http://www.dneonline.com/calculator.asmx?WSDL.
    • Para conectarse con un archivo, seleccione un archivo desde la sala de control o el escritorio, o inserte una variable.
  3. Opcional: Ingrese el punto final SOAP en el campo Address location (Ubicación de la dirección).
    Si se especifica la ubicación de la dirección, el bot la utiliza durante la ejecución; en caso contrario, el bot utiliza la ubicación de la dirección del archivo WSDL.
    Nota: Si está creando el URI de SOAP manualmente y no utiliza la función Build SOAP request (Crear solicitud SOAP), vaya al paso 6.
  4. Haga clic en Build SOAP request (Crear solicitud SOAP).
    Aparece la ventana SOAP request (Solicitud SOAP), que muestra los servicios y puertos con detalles sobre sus operaciones y parámetros.
  5. En la ventana SOAP request (Solicitud SOAP), expanda el servicio para el que desea ver la lista de puertos. Haga clic en el puerto obligatorio para mostrar la lista de operaciones disponibles. Seleccione la operación obligatoria y haga clic en Apply (Aplicar) para recuperar los detalles de la operación desde la solicitud SOAP.
    Si utiliza la opción Build SOAP request (Crear solicitud SOAP), los campos Services (Servicios), Port (Puerto), Operation (Operación) y Operation parameters (Parámetros de operación) se completan automáticamente con detalles basados en la operación seleccionada. Continúe en el paso 10.
  6. En el campo Service (Servicio), escriba el nombre del servicio.
    Este campo identifica la colección de puertos admitidos por el servicio web. Mantiene el valor de @nombre del servicio para una llamada de servicio web SOAP, por ejemplo, Calculator (Calculadora).
  7. Opcional: En el campo Port (Puerto), ingrese el punto final con el que se conectará.
    Si no se especifica un puerto, el bot utilizará el primer puerto mencionado en el archivo WSDL basado en el servicio seleccionado. Sin embargo, si ese puerto no es compatible con el servicio web SOAP, la ejecución de bot fallará.
    Este campo mantiene el valor del @nombre vinculante para una llamada de servicio web SOAP, por ejemplo, CalculatorSoap (CalculadoraSoap).
  8. Seleccione la Versión SOAP del punto final que especificó en el campo Port (Puerto).
    Elija entre 1.1 o 1.2.
  9. En el campo Operation (Operación), ingrese el nombre de la función de servicio para el punto final que especificó en el campo Port (Puerto).
    La ejecución de bot falla si cualquiera de las siguientes situaciones es verdadera:
    • El puerto mencionado en el campo de puerto no tiene ninguna operación.
    • La operación mencionada en la solicitud SOAP para el puerto no está disponible.
    Este campo contiene el valor del @nombre de la operación para una llamada de servicio web SOAP, por ejemplo, Add (Agregar).
  10. Seleccione Operation parameters (Parámetros de operación) o Raw data parameters (Parámetros de datos sin procesar) para proporcionar los detalles del parámetro.
    Nota: Si ha seleccionado Build SOAP request (Crear solicitud SOAP), la tabla de detalles de los parámetros en la pestaña Operation (Operación) se rellena automáticamente con los parámetros de la operación seleccionada. Indique los valores de estos parámetros. También puede agregar, editar o eliminar los parámetros de una operación en particular.
    • Si selecciona Operation parameters (Parámetros de operación), ingrese el nombre y el valor de cada parámetro. Por ejemplo, ingrese los siguientes valores:
      1. intA en el primer campo Name (Nombre)
      2. 10 en el primer campo Value (Valor)
      3. intB en el segundo campo Name (Nombre)
      4. 20 en el segundo campo Value (Valor)
    • Si selecciona Raw data parameters (Parámetros de datos sin procesar), ingrese el valor XML.
    • Si elige Raw data parameters (Parámetros de datos sin procesar), seleccione Parameters (Parámetros) o Credential parameters (Parámetros de credenciales).
  11. Parámetros: Puede utilizar los valores de las credenciales del casillero de credenciales sin exponer las credenciales en texto plano (nombre de usuario o contraseña) en los datos sin procesar. Para ello, primero debe asignar la credencial en el asignador de credenciales y utilizar el nombre de referencia en los datos sin procesar dentro de 2 llaves.

    Por ejemplo, en los datos sin procesar, usted proporcionó la contraseña en texto plano para autenticarse en el servidor.

    <aut:AuthHeader>
    <aut:Password> abc@123</aut:Password>
    </aut:AuthHeader>
    
    Para utilizar la contraseña del casillero de credenciales, realice los siguientes pasos:
    1. Haga clic en Add substitution (Agregar sustitución).
      Ingrese el nombre de referencia, por ejemplo pwd en el campo Name in XML (Nombre en XML). Seleccione Credential (Credencial) para usar un valor disponible en la bóveda de credenciales o seleccione Variable para usar una variable de credencial o Insecure string (Cadena insegura) a fin de especificar manualmente el valor que desea usar.
      Para obtener más información sobre las bóvedas de credenciales y cómo utilizarlas, consulte Credenciales y lockers en el Credential Vault.
    2. Haga clic en Add (Agregar)
    3. Especifique la referencia en los datos sin procesar entre llaves dobles, como se indica a continuación:
      <aut:AuthHeader>
      <aut:Password>{{pwd}}</aut:Password>
      </aut:AuthHeader>
      
      El nombre de referencia pwd especificado en los datos sin procesar se sustituirá por el valor correspondiente almacenado en la bóveda de credenciales.
      Asegúrese de ingresar el nombre de la referencia en el mismo formato que el especificado en la opción Add substitution (Agregar sustitución). Por ejemplo, si ingresó la contraseña como pwd en el menú Add substitution (Agregar sustitución) e ingresa password (contraseña) como nombre de referencia en los datos sin procesar, se producirá un error en la ejecución de bot.
  12. Parámetros de credenciales: Si desea ingresar los parámetros de datos sin procesar como credencial. Puede elegir Credential (Credencial) para usar un valor disponible en la bóveda de credenciales o seleccione Variable para usar una variable de credencial o Insecure string (Cadena insegura) a fin de especificar manualmente el valor que desea usar.
  13. Seleccione No Authentication (Sin autenticación) o Basic (Básica) en la lista Authentication Mode (Modo de autenticación).
    • Si selecciona No authentication (Sin autenticación), continúe con el siguiente paso.
    • Si selecciona Basic (Básico), ingrese sus credenciales.
  14. Opcional: Proporcione un certificado de cliente seleccionando un archivo de la sala de control o de su escritorio, o inserte una variable.
  15. Opcional: Proporcione encabezados personalizados.
  16. Opcional: Proporcione un archivo para guardar la salida XML.
  17. Seleccione Complete response (Respuesta completa) o Selected response (Respuesta seleccionada) para limitar el alcance de la respuesta.
    • Si selecciona Complete response (Respuesta completa), continúe con el siguiente paso.
    • Si selecciona Selected response (Respuesta seleccionada), complete los siguientes pasos:

      Realice los siguientes pasos, si está creando la expresión Xpath manualmente y no utiliza la opción Build Xpath (Construir Xpath).

      1. Proporcione la expresión XPath. Por ejemplo:
        /*[local-name()='Envelope' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='Body' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='AddResponse' and namespace-uri()='http://tempuri.org/']/*[local-name()='AddResult' and namespace-uri()='http://tempuri.org/']
      2. Seleccione una sección de la salida XML: Values (Valores), Innex XML (XML interno) u Outer XML (XML externo).
      3. Si selecciona Values (Valores), elija una opción de delimitador: Pipe (Barra vertical) o Semicolon (Punto y coma).
  18. Haga clic en Build Xpath (Crear Xpath).
    Se abre la ventana de vista previa de salida.
  19. Seleccione el nodo apropiado del cuerpo de la respuesta. La ruta XML se crea automáticamente. Haga clic en Apply (Aplicar).
    Si utiliza la opción Build Xpath (Crear Xpath) y los campos XPath expression (Expresión XPath) y Value (Valor) se rellenan automáticamente con detalles basados en la operación seleccionada.
  20. Seleccione una variable para almacenar la salida XML,
    por ejemplo, prompt-assignment (asignación rápida).
  21. Verifique la salida de la action SOAP web service (Servicio web SOAP) insertando una action de Message box (Cuadro de mensajes) con la variable de prompt-assignment (asignación rápida) en el cuerpo del mensaje.
    Cuando ejecuta el bot, el cuadro de mensajes debe mostrar 30.
Enviar comentarios