Llamada a un servicio web SOAP desde un flujo de trabajo
- Conozca los requisitos para comunicarse con el servicio web SOAP para la aplicación:
- Los valores para autenticarse con la aplicación
- Los valores para solicitar datos del servicio web SOAP
- El formato de los datos proporcionados en la respuesta
Consulte la documentación de la aplicación o consulte a la empresa que aloja la aplicación.
- Para preparar RICOH ProcessDirector para que se comunique con la aplicación, realice las tareas siguientes:
- Si la aplicación requiere un certificado de seguridad, instale el certificado en el equipo primario de RICOH ProcessDirector.
- Si su entorno requiere un servidor proxy para comunicarse con servicios web, configure el sistema para utilizarlo.
- Importe archivos WSDL para todos los servicios web a los que va a llamar.
RICOH ProcessDirector crea objetos de solicitud SOAP a partir de operaciones SOAP en el archivo WSDL. Especifica un prefijo que RICOH ProcessDirector añade a los nombres de las operaciones SOAP cuando crea los objetos. Un objeto de solicitud SOAP permite a RICOH ProcessDirector determinar la versión de SOAP y otra información necesaria para hacer una llamada correcta al servicio web.
Para obtener más información, consulte las tareas relacionadas.
- Ejecute una prueba manual que se autentique en la aplicación y solicite una respuesta
del servicio web SOAP. Compruebe que el servicio web devuelve la respuesta que desea.Muchos navegadores cuentan con plug-ins, como Boomerang de Google Chrome, que realizan pruebas con llamadas de servicio web a clientes SOAP.
- Decida cómo desea especificar la solicitud:
- Puede introducir la carga como el valor de la propiedad Carga de solicitud.
- Puede almacenar la carga en un archivo de texto al que el paso CallSOAPService pueda acceder durante el procesamiento del trabajo.
- Pulse la pestaña Flujo de trabajo.
- Pulse el nombre del flujo de trabajo que desea modificar.
- Opcional: Inhabilite el flujo de trabajo pulsando el conmutador que hay a la izquierda del nombre
de flujo de trabajo. Si no inhabilita el flujo de trabajo mientras lo edita, los trabajosa que utilicen este flujo de trabajo seguirán avanzando por los pasos. Al guardar, el flujo de trabajo se inhabilita temporalmente y se vuelve a habilitar. Los trabajos que se están procesando en el flujo de trabajo pueden experimentar un error.
- Revise los pasos incluidos en el flujo de trabajo, junto con los valores por omisión que establecen estos pasos.
- Añada un paso basado en la plantilla de pasos CallSOAPService al flujo de trabajo en el lugar adecuado.
- Establezca valores para las propiedades de trabajo.
- Establezca la propiedad URL de la solicitud en la URL del servicio web al que el paso llama.La URL puede utilizar el protocolo HTTP o HTTPS.
- Establezca la propiedad Contraseña en la contraseña que el paso proporciona al servicio web SOAP para autenticarse con
la aplicación.Introduce la contraseña como el valor de esta propiedad. Para proporcionar la contraseña al servicio web SOAP, especifique la propiedad Job.WebService.Password como un símbolo en la propiedad Carga de solicitud o URL de la solicitud: ${Job.WebService.Password}. Para determinar la propiedad que desea utilizar, consulte la documentación del servicio web.
- Establezca la propiedad Tipo de carga de solicitud:
- Para especificar el cuerpo de la solicitud de servicios web como el valor de la propiedad Carga de solicitud, seleccione TEXTO.
- Para especificar el cuerpo de la solicitud de servicios web en un archivo de texto al que el paso CallSOAPService pueda acceder durante el procesamiento del trabajo, seleccione ARCHIVO.
- Establezca la propiedad Carga de solicitud:
- Si establece la propiedad Tipo de carga de solicitud en TEXTO, introduzca la carga como el valor de esta propiedad.
- Si establece la propiedad Tipo de carga de solicitud en ARCHIVO, introduzca la ruta completa al directorio, el nombre y la extensión del archivo
de texto como el valor de esta propiedad.
Introduzca la carga en el archivo de texto.
Para enviar la contraseña en la carga, especifique la propiedad Job.WebService.Password como un símbolo.
En este ejemplo, el ID del pedido se almacena como el valor de la propiedad de trabajo Personalizado 3 ( Job.Info.Attr3). La carga incluye la contraseña como el valor del elemento <Token> y el ID del pedido como el valor del elemento <OrderID>:
<Token>${Job.WebService.Password}</Token><OrderID>${Job.Info.Attr3}</OrderID>
El paso resuelve los símbolos cuando llama al servicio web SOAP.
- Si su entorno requiere un servidor proxy para comunicarse con servicios web, establezca la propiedad Utilizar proxy en el servidor proxy adecuado.
- Establezca la propiedad Archivo de respuesta en la ruta completa al directorio y el nombre de archivo que RICOH ProcessDirector utiliza para almacenar la respuesta de la aplicación.Normalmente este valor es ${getFileName(print,xml,write)}.Una vez almacenada la respuesta en el archivo, el resto de pasos del flujo de trabajo puede procesar la respuesta.
- Establezca la propiedad Solicitud SOAP en la solicitud SOAP que RICOH ProcessDirector creó al importar el archivo WSDL.
Por ejemplo, si desea utilizar la solicitud SOAP GetOrdersByDate. Ha antepuesto PrintShop a los nombres de las solicitudes SOAP durante su importación. Seleccione PrintShop-GetOrdersByDate.
- Establezca la propiedad URL de la solicitud en la URL del servicio web al que el paso llama.
- Cuando haya terminado, pulse Aceptar.
- Guarde y habilite el flujo de trabajo.
Cuando haya terminado de configurar los flujos de trabajo, pruebe el intercambio de datos entre RICOH ProcessDirector y la aplicación.
Ejemplo
La característica MarcomCentral Connect incluye dos flujos de trabajo proporcionados con pasos CallSOAPService.