This shows you the differences between two versions of the page.
es:api_webservice_adaptor [2024/01/25 12:55] 127.0.0.1 external edit |
es:api_webservice_adaptor [2024/12/10 15:39] (current) montse [Parámetros de configuración del Adaptador REST] |
||
---|---|---|---|
Line 15: | Line 15: | ||
* **EndPoint:** URL base para acceder al servicio. | * **EndPoint:** URL base para acceder al servicio. | ||
- | * **Keep_Session:** Indica si la sesión debe mantenerse entre las solicitudes al servicio. Si está marcada, el adaptador añadirá las cookies que reciba en las respuestas a las peticiones que realice. | + | * **Keep_Session:** indica si la sesión debe mantenerse entre las solicitudes al servicio. Si está marcada, el adaptador añadirá las cookies que reciba en las respuestas a las peticiones que realice. |
- | * **IsSecure:** Indica si las peticiones al servicio se enviaron a través del protocolo http o https. | + | * **IsSecure:** indica si las peticiones al servicio se enviaron a través del protocolo http o https. |
- | * **Service Charset(Opt.):** Para configurar el conjunto de caracteres que utilizará como servicio HTTP (por ejemplo, REST). Las palabras y oraciones en el texto se crean a partir de caracteres. Una codificación de caracteres proporciona una clave para desbloquear (es decir, descifrar) el código. Así, el conjunto de caracteres es la información de codificación, es decir, el conjunto de asignaciones entre los bytes del ordenador y los caracteres del conjunto de caracteres. Sin la clave, los datos parecen basura. Un ejemplo de conjunto de caracteres son UTF-8 o UTF-16. El Cp1047 es usado por defecto. | + | * **Service Charset(Opt.):** para configurar el conjunto de caracteres que utilizará como servicio HTTP (por ejemplo, REST). Las palabras y oraciones en el texto se crean a partir de caracteres. Una codificación de caracteres proporciona una clave para desbloquear (es decir, descifrar) el código. Así, el conjunto de caracteres es la información de codificación, es decir, el conjunto de asignaciones entre los bytes del ordenador y los caracteres del conjunto de caracteres. Sin la clave, los datos parecen basura. Un ejemplo de conjunto de caracteres son UTF-8 o UTF-16. El Cp1047 es usado por defecto. |
- | * **WADL_File (Opt.):**Se trata de una descripción XML legible por máquina de los servicios web basados en HTTP (por ejemplo, REST). El objetivo del fichero WADL es modelar los recursos proporcionados por un servicio y las relaciones entre ellos. | + | * **WADL_File (Opt.):** se trata de una descripción XML legible por máquina de los servicios web basados en HTTP (por ejemplo, REST). El objetivo del fichero WADL es modelar los recursos proporcionados por un servicio y las relaciones entre ellos. |
- | * **Headers:** Permite añadir cabeceras a todas las incidencias que se envien al servicio. | + | * **Headers:** permite añadir cabeceras a todas las incidencias que se envien al servicio. |
- | * **Authentication Type**: Permite seleccionar el tipo de autenticación que requiere el servicio. Una vez seleccionado nos permite introducir los datos necesarios para el tipo de autenticación seleccionado. Por defecto, no se usa autenticación.\\ \\ | + | * **Authentication Type**: permite seleccionar el tipo de autenticación que requiere el servicio. Una vez seleccionado nos permite introducir los datos necesarios para el tipo de autenticación seleccionado. Por defecto, no se usa autenticación.\\ \\ |
=====Nuevas Funciones Predefinidas para REST en el Adaptador Web===== | =====Nuevas Funciones Predefinidas para REST en el Adaptador Web===== | ||
Line 261: | Line 261: | ||
* String propertyValues = GetJSonPathPropertyValue (httpResponse, String JSonPathExp); | * String propertyValues = GetJSonPathPropertyValue (httpResponse, String JSonPathExp); | ||
* Similar a la función anterior pero utilizando el estándar JSonPath para navegar por los datos de respuesta. Sólo se aplica a las respuestas de tipo JSon. En principio desarrollaremos más funciones de este tipo que permitan recuperar los datos de la respuesta e introducirlos como variables en el flujo de ejecución del diagrama, en caso de que quieran ser utilizados como valores de entrada a otros mensajes en el diagrama.\\ \\ | * Similar a la función anterior pero utilizando el estándar JSonPath para navegar por los datos de respuesta. Sólo se aplica a las respuestas de tipo JSon. En principio desarrollaremos más funciones de este tipo que permitan recuperar los datos de la respuesta e introducirlos como variables en el flujo de ejecución del diagrama, en caso de que quieran ser utilizados como valores de entrada a otros mensajes en el diagrama.\\ \\ | ||
- | |||
- | ==== El problema de la sesión Mantenimiento ==== | ||
- | |||
- | Como usted sabe, Http es un protocolo de solicitud/respuesta sin estado, pero a veces los flujos de trabajo obligan a relacionar varias solicitudes como si fueran del mismo cliente. Es decir, mantener la sesión entre el cliente y el servidor durante todo el flujo de trabajo. Normalmente se hace con cookies, aunque también se puede hacer a través de encabezados. | ||
- | |||
- | En cualquier caso, esto es transparente para el usuario, pero el adaptador debe tenerlo en cuenta, ya que debe almacenar la cookie enviada por el servidor en la primera petición para añadirla a las siguientes peticiones Http en el diagrama. O en otros casos a través de Tokens que son proporcionados por el servidor después de autenticarse y que el cliente debe incluir en un encabezado en cada solicitud. | ||
- | |||
- | Es posible que el usuario deba indicarnos si desea mantener una sesión durante el envío de varios mensajes consecutivos, y el mecanismo que el servidor utiliza para ello. En SoapUi, a la hora de crear un caso de prueba, nos ofrece la posibilidad de marcar una casilla de verificación que indica si queremos mantener la sesión, simplemente no pedimos más datos, entiendo que tratamos de mantenerla transparente para el usuario. | ||
- | |||