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

Utilice la acción 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 con un URI, ingrese el URI, por ejemplo http://www.dneonline.com/calculator.asmx?WSDL.
    • Para conectarse con un archivo, seleccione un archivo desde la Control Room 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 Ejemplo de uso de la acción servicio web de SOAP.
  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 Ejemplo de uso de la acción servicio web de SOAP.
  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 serviciopara una llamada de servicio web SOAP, por ejemplo, Calculator.
  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 contiene el valor de@nombre vinculantepara una llamada de servicio web SOAP, por ejemplo, CalculatorSoap.
  8. Seleccione la Versión SOAP del punto final que especificó en el campo Port (Puerto).
    Elija entre 1.1 o 1.2.
    Nota: La Versión de SOAP se puede determinar utilizando uno de los siguientes espacios de nombres especificados en el archivo WSDL:
    • Espacio de nombres SOAP 1.1: http://schemas.xmlsoap.org/soap/envelope
    • Espacio de nombres SOAP 1.2: http://www.w3.org/2003/05/soap-envelope
  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 de@nombre de la operaciónpara una llamada de servicio web SOAP, por ejemplo, Add.
  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 Nombre
      2. 10 en el primer campo Valor
      3. intB en el segundo campo Nombre
      4. 20 en el segundo campo Valor
    • 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 (nombre de usuario o contraseña) en texto sin formato en los datos sin procesar. Para ello, primero debe asignar la credencial en el mapeador de credenciales y utilizar el nombre de referencia en los datos sin procesar entre llaves.

    Por ejemplo, en los datos sin procesar, usted proporcionó la contraseña en texto sin formato para autenticarse con 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 Nombre en XML. Seleccione Credencial para usar un valor disponible en la Credential Vault o seleccione Variable para usar una variable de credencial o Cadena insegura a fin de especificar manualmente el valor que desea usar.
      Para obtener más información sobre las Credential Vault y cómo utilizarlas, consulte Credenciales y casilleros en Credential Vault.
    2. Haga clic en Add (Agregar)
    3. Especifique la referencia en los datos sin procesar entre llaves, 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 Credential Vault.
      Asegúrese de ingresar el nombre de la referencia en el mismo formato que el especificado en la opción Agregar sustitución. Por ejemplo, si ingresó la contraseña como pwd en Agregar sustitución e ingresa password como nombre de referencia en los datos sin procesar, cuando ejecuta el bot, el bot encontrará un error.
  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 Credential Vault 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 Control Room 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 Respuesta seleccionada, realice los siguientes pasos si está creando manualmente la expresión Xpath y no utiliza la opción Crear 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 la opción Valores, elija devolver el contenido como: Cadena delimitada por o Lista de cadenas.
        • Si selecciona Cadena delimitada por, elija una opción de delimitador: Barra vertical, Punto y comao Personalizado.
          Si selecciona Personalizado, ingrese variables o caracteres en el Delimitador personalizado (opcional).
          Nota: No se admite el carácter especial del signo de dólar ($) como delimitador.
        • Seleccione Lista de cadenas para devolver la salida de la respuesta de SOAP como lista de cadenas.
          Nota: Solo se puede especificar un tipo de lista de variables con tipo de datos como cadenas.
  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 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. Opcional: Para establecer un valor de tiempo de espera cuando se envía una solicitud SOAP y se recibe una respuesta, en el campo Esperar a que se complete la acción, especifique el tiempo de espera (en milisegundos).
    De manera predeterminada, el tiempo de espera es de 60 000 milisegundos.
  21. Configurar el certificado P12:
    • Para obtener el archivo de certificación SSL, seleccione una de las siguientes opciones: Archivo de Control Room, Archivo de escritorio o Variable.
    • Configure las propiedades del almacén de claves:
      • Archivo de almacén de claves (opcional): Para proporcionar el archivo de almacén de claves en formato .p12, seleccione una de las siguientes opciones: Archivo de Control Room, Archivo de escritorio o Variable. El archivo de almacén de claves incluye la clave privada y el certificado del cliente.
      • Contraseña del almacén de claves (opcional): Para proporcionar la contraseña del archivo de almacén de claves, seleccione una de las siguientes opciones: Credencial, Variable o Cadena insegura. La contraseña se utiliza para acceder al archivo de almacén de claves.
  22. Seleccione una variable para almacenar la salida XML.
    Por ejemplo, prompt-assignment
  23. Verifique la salida de la acción Servicio Web SOAP mediante inserción una acción Cuadro de mensaje con la variable de prompt-assignment en el cuerpo del mensaje.
    Cuando ejecuta el bot, el cuadro de mensajes debe mostrar 30.