Implementar servicios web SOAP
Con MapForce Enterprise Edition puede generar código de programa Java o C# que implemente servicios web SOAP desde archivos WSDL (lenguaje de descripción de servicios web). Puede asignar datos a operaciones WSDL como sigue:
•A partir del contenido de la operación WSDL a cualquier fuente de datos compatible con MapForce, incluyendo archivos planos, XML, XBRL, EDI, Microsoft Excel y BD.
•A partir de fuentes de datos compatibles con MapForce al resultado de la operación WSDL.
MapForce admite WSDL 1.1 y WSDL 2.0 (para más información sobre compatibilidad y limitaciones, consulte los apartados Compatibilidad con SOAP y WSDL e Información sobre servicios web SOAP Java).
| Nota: | como alternativa al desarrollo de servicios web SOAP a partir de archivos WSDL ya existentes también puede implementar asignaciones de MapForce en MapForce Server, donde las puede ejecutar con la API o una llamada de la línea de comandos. Además, con FlowForce Server puede exponer la asignación como servicio genérico (no SOAP) en el equipo en el que se esté ejecutando FlowForce Server. Cualquier asignación diseñada para el motor de transformación integrado BUILT-IN se puede implementar en MapForce Server o en FlowForce Server. FlowForce Server es una solución de servidor que no solo puede convertir asignaciones de MapForce a servicios web genéricos, sino también ejecutarlos como trabajos programados o bajo demanda. Para más información, consulte el apartado Implementar asignaciones en FlowForce Server. |
Requisitos
Para crear servicios web con MapForce es necesario un archivo WSDL del servicio web. Tenga en cuenta que puede diseñar archivos WSDL y probar solicitudes SOAP con XMLSpy. También necesitará el software específico para cada plataforma para construir, implementar y ejecutar un servicio web SOAP, por ejemplo:
Java
•Java Development Kit Java SE JDK 8 u 11 (incluido OpenJDK) o posterior
•Apache Tomcat: https://tomcat.apache.org
•Apache Axis2: https://ws.apache.org/axis2/, un marco de trabajo SOAP que se ejecuta dentro de Tomcat
•Apache Ant: https://ant.apache.org/
C#
•Microsoft Visual Studio 2013, 2015, 2017, 2019, 2022
•Microsoft Internet Information Services (IIS) versión 5.0 o posterior.
Funcionamiento
El siguiente diagrama ilustra todo el proceso, empezando por la implementación de un servicio web a partir de un archivo WSDL ya existente hasta el punto en el que se puede llamar a ese servicio desde aplicaciones SOAP clientes. Tenga en cuenta que solo los dos primeros pasos tienen lugar en MapForce. Los pasos 3 y 4 dependen de las herramientas de terceras partes que se usen en su organización.
El proceso de la imagen anterior funciona así:
Paso # | Descripción |
|---|---|
1. Diseñar el servicio web a partir de un archivo WSDL ya existente | Una vez que tiene el archivo WSDL puede empezar un nuevo proyecto de servicio web de MapForce. Estos proyectos tienen una estructura predefinida que permite acceder rápidamente a una operación WSDL o a un servicio web concretos dentro del mismo. Al empezar un proyecto de servicio web de MapForce tiene la opción de indicarle a la aplicación que genere automáticamente archivos de asignación para todas las operaciones WSDL que se encuentren en el archivo WSDL. También puede optar por seleccionar de forma individual los servicios WSDL y los puntos finales WSDL que quiere que se incluyan en el proyecto de servicio web de MapForce. En la interfaz gráfica del usuario de MapForce las operaciones WSDL corresponden a asignaciones y los parámetros de entrada y salida de la operación aparecen en la asignación como componentes. |
2. Generar el código Java o C# | Cuando su proyecto de servicio web esté listo en MapForce puede generar el código C# o Java para asignaciones individuales (para realizar pruebas) o para todo el proyecto. En este último caso, MapForce crea un servidor completo de servicio web en el lenguaje que escoja (C# o Java). |
3. Construir e implementar el servicio web en un servidor | En este paso compila el código C# o Java generado (fuera de MapForce) y lo implementa en su servidor web personalizado. Su servidor web debe ser capaz de alojar servicios SOAP y de responder a llamadas de clientes SOAP. Véase el apartado Requisitos más arriba. |
4. Alojar un servicio web | Puede alojar el servicio web compilado en el servidor que usted elija, como: •Apache Tomcat •Internet Information Services (IIS) |
5. Llamar al servicio web | El cliente del servicio web incluye cualquier aplicación capaz de generar llamadas SOAP y de procesar la respuesta, incluidos XMLSpy o MapForce. |
Para más información sobre el paso 1, consulte el apartado Crear proyectos de servicio web a partir de archivos WSDL. Para el resto de pasos, consulte los apartados Ejemplo: generar servicios web SOAP (C#) and Ejemplo: generar servicios web SOAP (Java)