Datos del servicio

• El Identificador debe contener letras y puede contener números, pero no puede empezar por números.

• En el campo URL del servicio, se debe introducir la URL de la API REST que se utilizará para realizar la integración. Si el servicio va a utilizar parámetros del tipo PATH, estos deben introducirse en la propia URL (basta con añadir un endpoint, por ejemplo: https://exampleservice.com/user/{path}). Tenga en cuenta que el parámetro PATH que es introducido en la URL será añadido por el sistema en la etapa Parámetro de entrada, que debe tener un valor durante el consumo para que la operación sea realizada con éxito.

• Si se habilita la opción Web Service interno de SoftExpert Suite, será posible seleccionar una API REST interna proporcionada por SoftExpert Suite. Con esto, no será necesario crear una fuente, si se cambia la configuración del dominio del entorno.

• Al configurar una interfaz REST proporcionada por SoftExpert Suite, es posible obtener la URL del servicio en la sección Reference.

Métodos HTTP disponibles para selección:

Tipos de parámetros disponibles para selección:

Tipos de datos disponibles para selección:

Si el método previamente seleccionado es POST o PUT, se mostrará el campo Cuerpo de la petición, en el que se debe añadir un ejemplo para el cuerpo de la petición en formato JSON. El cuerpo de ejemplo será utilizado por SoftExpert Suite para mapear los atributos que serán enviados por la petición. 

Vea un ejemplo del cuerpo de la petición que se podrá ingresar en el campo presentado:

{  
 "id": 1,  
 "name": "New example name"  
}

También es posible enviar ejemplos con tipo de fecha:

{  
 "id": 10,  
 "name": "example",  
 "admission Date": "MM/dd/yyyy"  
}

El parámetro de fecha debe estar utilizando el valor de formato correctamente. Vea a continuación algunos ejemplos de formatos de fechas:

• Al configurar una interfaz REST proporcionada por SoftExpert Suite, se debe seleccionar el método POST. Se puede obtener el cuerpo de la petición en la sección Reference.

• Los ejemplos que se deben indicar en el Cuerpo de la respuesta son similares a los explicados para el Cuerpo de la petición de la etapa Parámetros de entrada.

• Al introducir el cuerpo de la petición/respuesta en las secciones Parámetros de entrada y Parámetros de salida, pueden surgir problemas que impidan pasar a la próxima etapa. Consulte la sección Troubleshooting para ver los posibles problemas y sus soluciones.

• Al configurar una interfaz REST proporcionada por SoftExpert Suite, puede obtener el cuerpo de la respuesta en el documento Guía de integración.

En la etapa Seguridad, es posible definir una lista de seguridad para la fuente de datos REST, restringiendo el acceso solo 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 ver la fuente de datos REST. Para eso, utilice las siguientes columnas:

• Editar: defina los usuarios, grupos, áreas y/o funciones que podrán editar la fuente de datos.
• Visualizar: defina los usuarios, grupos, áreas y/o funciones que podrán visualizar la fuente de datos.

Público

Todos los usuarios del sistema podrán visualizar la fuente de datos REST, sin embargo, solo los usuarios 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, grupos, áreas y/o funciones que podrán modificar los datos de la fuente de datos.

Tras hacer clic en el botón Prueba de consumo, en la pantalla que se abrirá se deberá rellenar la información según las especificaciones del servicio que se está consumiendo. 

Entre los parámetros disponibles en la prueba de consumo, se puede completar las siguientes informaciones:

Para consumir el servicio, haga clic en el botón Ejecutar en la parte inferior de la pantalla. Se pueden presentar dos tipos de respuesta:

• Éxito: el consumo se ha realizado correctamente. En este caso, será posible visualizar un JSON que contenga la devolución del servicio a través de SoftExpert Suite.
• Algo salió mal: se ha producido un problema al consumir el servicio. Consulte la sección Troubleshooting para ver las posibles respuestas y sus significados.