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 se introduce en la URL será añadido por el sistema en la etapa Parámetro de entrada; este parámetro 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. Así, no será necesario crear una fuente, si se modifican las configuraciones de 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 deberá añadir un ejemplo para el cuerpo de la petición en el 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á introducir 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 introducir 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 producirse problemas que impidan pasar a la próxima etapa. Consulte la sección Solucionar problemas de las fuentes de datos REST para ver los posibles problemas y sus soluciones.

• Al configurar una interfaz REST proporcionada por SoftExpert Suite, se 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, 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 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, los grupos, las áreas y/o las 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á ingresar la información según las especificaciones del servicio que se está consumiendo. 

Entre los parámetros disponibles en la prueba de consumo, se pueden introducir 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 contiene 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 Solucionar problemas de las fuentes de datos REST para ver las posibles respuestas y sus significados.