Configurar una fuente de datos SOAP
Prerrequisito
- Acceso al menú Gestión de fuentes de datos > Fuente de datos > SOAP (DI002).
Introducción
El sistema proporciona un menú para que los usuarios registren todas las fuentes de datos que conectarán SoftExpert Suite a otros sistemas vía SOAP.
Vea cómo configurar las fuentes de datos SOAP dentro del sistema:
Configurar una fuente de datos SOAP
Vea más detalles sobre cada una de las etapas:
Datos del web service
• El botón Habilitado permite habilitar o deshabilitar el web service sin la necesidad de eliminarlo.
• Marque la opción Web service interno de SE Suite para seleccionar un web service interno proporcionado por SoftExpert Suite. De esta forma, no será necesario crear una nueva fuente si se modifican las configuraciones de dominio del entorno. Los campos Versión del WSDL y URL de conexión no estarán disponibles, ya que estas informaciones serán definidas internamente.
• Ejemplos de formatos de fecha que se pueden utilizar:
| Formato | Descripción | Ejemplo |
| MM/dd/yyyy | Estándar americano de fecha | 06/22/2024 |
| dd/MM/yyyy | Estándar europeo de fecha | 15/03/2024 |
| HH:mm:ss | Horas, minutos y segundos | 18:37:05 |
| KK:mm:ss a | Horas, minutos y segundos (AM/PM) | 07:44:23 PM |
| dd/MM/yyyy HH:mm:ss | Fecha, horas, minutos y segundos | 26/12/2024 12:30:55 |
| dd/MM/yyyy KK:mm:ss a | Fecha, horas, minutos y segundos (AM/PM) | 12/07/2024 11:50:02 AM |
| EE MMM dd hh:mm:ss Z yyyy | Fecha descriptiva, día, horario (AM/PM), huso horario y año | Mar ago 16 12:00:00 BRT 2024 |
• Tipos de autenticación disponibles para selección:
| Anónimo | No habrá necesidad de autenticación. |
| Autenticación básica | La autenticación se realizará por usuario y contraseña en el encabezado de la petición HTTP. En los respectivos campos que se habilitarán, ingrese el usuario y la contraseña que se utilizarán para la autenticación del servicio. Si lo desea, informe también el dominio que se utilizará. |
| WS-Security (Password Text) | El usuario y la contraseña se envían con el mensaje SOAP para validar la comunicación entre el servicio y su consumidor. En los respectivos campos que se habilitarán, ingrese el usuario y la contraseña que se utilizarán para la autenticación del servicio. |
| API key |
La autenticación se realizará por un token en el encabezado de la petición HTTP. Este tipo de autenticación debe utilizarse solo cuando la fuente de datos registrada sea un WSDL de SoftExpert Suite. En el campo API key que aparecerá, informe el token del usuario que se utilizará para la operación. El token utilizado puede generarse a través de la sección API Gateway de la pantalla de datos del usuario, cuando se la accede desde el panel de usuario. Para más información sobre este tipo de autenticación, consulte la Guía de integración. |
• El campo URL de conexión no estará disponible si se ha marcado la opción Web service interno de SE Suite.
• Utilice el campo URL de conexión, de la sección Avanzado, para especificar el camino del binding del web service. Si el WSDL importado tiene múltiples bindings con el mismo método, SoftExpert Suite eligirá el primer binding encontrado si ninguna URL de conexión está definida.
Método
• En la jerarquía de parámetros, es posible identificar el tipo de dato de cada parámetro. Vea los tipos de datos que son admitidos:
 |
TEXT |
 |
NUMERIC |
 |
DECIMAL |
 |
TIME |
 |
DATE |
 |
BOOLEAN |
 |
ESNUM |
 |
BINARY |
• Especificaciones de web service no admitidas:
| Tipo de datos Array | Elementos que utilizan el tipo Array (por ejemplo: soap-enc:Array) o array a través de corchetes (por ejemplo: "element[]"). Se recomienda utilizar el atributo maxOccurs="unbounded" para representar arreglos. |
| Retornos con estructuras dinámicas | Métodos que tienen retornos con estructuras dinámicas, ya que no sería posible mapear los tipos definidos en el retorno. |
| Tipos complejos anidados con tag any | La tag <any> dentro de tags ComplexType anidadas. Se recomienda que cada ComplexType sea declarada de manera independiente, y que todos los elementos contengan el atributo type definido sin la tag <any>. |
| Herencia de elementos con la tag Extension | El uso de la tag <extension> para realizar la herencia entre ComplexTypes. En esta situación, los elementos del ComplexType padre deben replicarse en los hijos para obtener el mismo comportamiento. |
Seguridad
En la etapa Seguridad, es posible definir una lista de seguridad para la fuente de datos web service, restringiendo el acceso únicamente a quienes sea necesario.
Consulte las opciones disponibles en la pestaña:
Privado
Solo los usuarios definidos en esta pestaña podrán editar o visualizar la fuente de datos web service. Para eso, utilice las siguientes columnas:
- Editar: defina los usuarios, los grupos, las áreas y/o las funciones que tendrán permiso para editar la fuente de datos.
- Visualizar: defina los usuarios, los grupos, las áreas y/o las funciones que tendrán permiso para visualizar la fuente de datos.
Público
Todos los usuarios del sistema podrán visualizar la fuente de datos web service, sin embargo, solo aquellos definidos en la respectiva columna podrán editarla. Por lo tanto, la columna Visualizar estará deshabilitada (ya que la fuente de datos puede ser visualizada por cualquier usuario).
En la columna Editar, defina los usuarios, los grupos, las áreas y/o las funciones que podrán modificar los datos de la fuente de datos.
Resumen
En esta etapa, es posible consumir los métodos que se han habilitado. Tras hacer clic en el botón Prueba de consumo, introduzca los valores de los parámetros necesarios para consumir el método y, a continuación, haga clic en el botón Ejecutar.
Se pueden presentar dos tipos de respuesta:
- Éxito: el consumo se ha realizado correctamente. En este caso, será posible visualizar un JSON que contiene la devolución del servicio a través de SoftExpert Suite.
- Algo salió mal: se ha producido un problema al consumir el servicio. Verifique si este está disponible y si los datos han sido llenados correctamente en las etapas descritas anteriormente.
Conclusión
¡Eso es todo! Ahora usted ya sabe cómo configurar una fuente de datos SOAP dentro del sistema.