Consumo servicio Web
Este objeto nos permite consumir un servicio Web vía XMLHttpRequest.
Para crear un objeto de este tipo seleccionar la opción nuevo objeto/consumo servicio web del menú objetos de Velneo vDevelop o a través de la galería de objetos.
Propiedades
Identificador
Etiqueta alfanumérica que identifica al objeto. Este identificador será el que se usa para referenciarlo en los inspectores y en las propiedades de otros objetos.
Nombre
Etiqueta alfanumérica que servirá como descriptor del objeto. Es el texto que se presentará al usuario final de la aplicación para referenciar al objeto. Podemos definir una etiqueta por cada idioma presente en el proyecto.
Estilos
Privado
Limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Comentarios
Esta propiedad nos permite documentar el uso del objeto.
Url
Permite establecer la URL del servicio con el que queremos conectar. Este se establecerá mediante una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad.
Método
Permite establecer el método HTTP a usar para conectar con el servicio Web, tal como GET, POST, etc. Este se establecerá mediante una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad.
Asíncrono
En este parámetro estableceremos, mediante una fórmula, un valor booleano -opcional- para indicar si realizar o no la operación de forma asíncrona. Si este valor es falso, la función de envío no retorna hasta que la respuesta es recibida.
Si este valor es verdadero, el proceso de respuesta se ejecutará también de forma asíncrona.
Body
Si el objeto no tiene definidos parámetros, en esta propiedad podremos especificar, mediante una expresión fórmula, el cuerpo de la petición.
Es body binario
Si el objeto no tiene definidos parámetros, en esta propiedad podremos especificar, mediante una expresión fórmula, si el cuerpo de la petición es un binario o no. Si se deja vacío no se enviará un binario.
Senda body binario
Si el objeto no tiene definidos parámetros, y lo que vamos a enviar en el cuerpo de la petición es un binario, en esta propiedad podremos especificar, mediante una expresión fórmula, la senda de dicho binario.
Es respuesta binaria
En esta propiedad podremos especificar, mediante una expresión fórmula, si el cuerpo de la petición es un binario o no. Si se deja vacío no se esperará un binario.
Senda para guardar respuesta binaria
Si lo que vamos a recibir es un binario, en esta propiedad podremos especificar, mediante una expresión fórmula, la senda donde guardar el binario recibido.
Timeout
Representa el número de milisegundos que una petición puede tomar antes de ser automáticamente terminada.
Si no se especifica ningún valor, se define como valor por defecto 30 minutos.
Proceso respuesta parcial (asíncrono)
Proceso de código nativo Velneo que recogerá la respuesta del servicio Web en modo streaming.
Proceso respuesta completa (asíncrono)
Proceso de código nativo Velneo que recogerá la respuesta completa del servicio Web.
Usaremos uno u otro proceso sgún el modo en el que queramos obtener la respuesta.
Certificado cliente
Si el servicio Web a consumir requiere certificados, en este parámetro podemos poner el contenido del certificado requerido mediante una expresión fórmula.
Senda certificado cliente
Si el servicio Web a consumir requiere certificados, en este parámetro podemos poner la senda donde tengamos guardado el certificado requerido.
El certificado debe establecerse únicamente por uno de los dos métodos.
El certificado que se utilice debe estar en formato p12.
Esta opción solamente es funcional en Windows y en Linux pero no en macOS, dado que, al contrario que en Windows y Linux que usan Open SSL, macOS usa un sistema propio llamado Secure Transport SSL, que no es funcional con este sistema. En el caso de macOS debemos especificar directamente el certificado cliente.
Clave certificado cliente
En este parámetro podemos especificar la clave del certificado mediante una expresión fórmula. Debemos especificar la clave propiamente dicha, no una senda de un fichero externo.
Senda clave certificado cliente
Si el servicio Web a consumir requiere certificados, en este parámetro podemos poner la senda donde tengamos guardado la clave del certificado requerido.
El certificado que se utilice debe estar en formato p12.
Contraseña certificado cliente
Si el certificado require passphrase, lo estableceremos en este parámetro mediante una expresión fórmula.
Ignorar errores TLS/SSL
Mediante una expresión fórmula podemos configurar permitirá configurar si se ignoran o no los errores de TLS/SSL.
En caso de ser positivo el resultado de la fórmula, el webservice será ejecutado ignorando los errores.
Por defecto se asume que no se ignoran los errores.
Este parámetro en Velneo Web no tiene efecto. No es posible ignorar los errores de TLS/SSL en el navegador ya que no lo permite.
Parámetros de consumo servicio Web
En este sub-objeto podemos definir los parámetros que se necesitan para consumir el servicio Web.
Usando los parámetros se desactiva el body y se usarán del modo siguiente:
Si el método del servcicio Web es Get, estos parámetros se añadirán a la URL.
Si el método del servcicio Web es Post, estos parámetros se enviarán como internos en el post de la URL. En este paso se aplica automáticamente: Content-Type": "application/x-www-form-urlencoded.
Si en la URL ya teníamos declarado algún parámetro, los que definamos como sub-objetos se añadirán a éstos.
Si queremos hacer uso del body, no debemos usar parámteros y entonces tendremos que definir el body y el Content-type de forma manual por medio de las cabeceras.
Las propiedades de un parámetro son:
Identificador
Etiqueta alfanumérica que identifica al parámetro. Este identificador será el que se usa para referenciarlo en los inspectores y en las propiedades de otros objetos.
Nombre
Etiqueta alfanumérica con el nombre del parámetro.
Estilos
Privado
Limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Comentarios
Esta propiedad nos permite documentar el uso del parámetro.
Clave
En esta propiedad especificaremos, mediante una expresión fórmula, el identificador del parámetro a enviar en la petición.
Valor
Esta propiedad estará activa si lo que vamos a enviar en la petición no es un binario y nos permitirá establecer el valor del parámetro a enviar mediante una expresión fórmula.
Senda valor binario
Si el parámetro a enviar es un binario, mediante una expresión fórmula, estableceremos la senda donde lo tenemos alojado.
Condición de activo
Esta propiedad nos permite establecer una condición para el envío de un parámetro. Para ello hemos de establecer la fórmula que debe cumplirse para que el parámetro sea enviado. Si no se especifica ninguna fórmula, el parámetro se enviará siempre.
Cabeceras de consumo servicio Web
En este sub-objeto podemos definir las cabeceras que se necesitan para consumir el servicio Web.
Las propiedades de una cabecera son:
Identificador
Etiqueta alfanumérica que identifica al parámetro. Este identificador será el que se usa para referenciarlo en los inspectores y en las propiedades de otros objetos.
Nombre
Etiqueta alfanumérica con el nombre de la cabecera.
Si en un objeto consumo servicio Web creamos una cabecera CONTENT-LENGTH, tomará ésta, si no la creamos, la enviará automáticamente como cabecera calculada.
Estilos
Privado
Limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Comentarios
Esta propiedad nos permite documentar el uso de la cabecera.
Clave
En esta propiedad especificaremos, mediante una expresión fórmula, el nombre de la cabecera de la petición.
Valor
En esta propiedad especificaremos, mediante una expresión fórmula, el valor de la cabecera a enviar en la petición.
Condición de activo
Esta propiedad nos permite establecer una condición para el envío de una cabecera. Para ello hemos de establecer la fórmula que debe cumplirse para que el parámetro sea enviado. Si no se especifica ninguna fórmula, el parámetro se enviará siempre.
Variables locales del objeto
Cuando creamos un objeto de este tipo, Velneo le añade automáticamente algunas variables locales especiales que nos permiten almacenar los datos de la respuesta del servicio. Otras deberemos crearlas nosotros en el caso de necesitarlas. Son las siguientes:
Recogerá el texto del mensaje de error. Se recibe el numero de error interno de QNetworkReply del XMLHttpRequest ( XMLHttpRequest.errorCode ). Ver códigos de error.
Recogerá toda la información de la respuesta en formato JSON.
Recogerá el texto de la respuesta a la llamada al servicio Web.
Recogerá la respuesta cuando se trate de un binario. Esta variable no se crea automáticamente, debemos declararla si queremos usarla. Si no se declara, se recogerá en la varaible RESPONSE_TEXT.
Recogerá el status de la llamada. Lo que se recibe es el código de error http (XMLHttpRequest.status). Ver códigos de estados HTTP.
Recogerá el texto del status de la llamada. Se recibe el estado http en texto (XMLHttpRequest.statusText). Ver códigos de estados HTTP.
Recogerá el cuerpo de la petición. Esta variable no se crea automáticamente, debemos declararla si queremos usarla.
Recogerá el cuerpo de la petición cuando se trate de un binario. Esta variable no se crea automáticamente, debemos declararla si queremos usarla.
Funcionamiento
Para realizar la petición al servicio Web dispararemos este objeto desde un proceso con comandos de objeto y la respuesta la obtendremos en el proceso configurado en la propiedad proceso para ejecutar la respuesta.
En las propiedades de tipo fórmula de este objeto podemos hacer uso de variables locales para poder asignarles contenido de forma dinámica con el comando de instrucción de proceso set variable local del objeto antes de dispararlo.
Para enviar un objeto binario estableceremos un 1 en la propiedad Tipo de body y estableceremos en la propiedad Senda body binario la senda del fichero donde se leerá el body. Otra posibilidad sería dejar la senda vacía y poner en base64 el body.
Para recibir un objeto binario debemos establecer un 1 en la propiedad Tipo de respuesta, establecer Senda para guardar respuesta en binario con la senda del fichero donde se escribirá la respuesta. Otra posiblidad sería dejar la senda vacía y entonces rellenará en el proceso de respuesta la variable RESPONSE_TEXT con el base64 de la respuesta.
El objeto, si bien es funcional en Velneo Web, en determinadas circunstancias pueden no ser funcional cuando el elemento al que se hace referencia no tener una configuración CORS adecuada. Ver el siguiente capítulo de la documentación.
Aviso de Seguridad: Problema en la gestión de HTTP2 (implementación 35.3)
Se ha identificado una vulnerabilidad relacionada con el manejo de conexiones HTTP2, asignada como CVE-2024-39936. Esta falla permite enviar datos a un servidor con un certificado TLS no coincidente que puede ser explotado mediante técnicas Man-in-the-middle en casos como redirección y otros.
Para evitar el problema con servidores web no conocidos en aplicaciones que utilicen xmlhttprequest y consumo de servicios web, se recomienda desactivar HTTP2.
En Velneo podremos hacerlo mediante la configuración de una clave beta:
http2NotSupported = C5A39F2332858154F02E045F64F7FFF8985F4F41
Las claves beta son entradas en la rama beta de Velneo del registro del sistema operativo. Se recomienda generarlas desde un proceso con el comando de instrucción de proceso Configuración del sistema: escribir cadena texto para establecerlos, ejecutándolo en 1er plano (si vamos a usar esos objetos en el cliente) o en 3er plano (si los vamos a usar en el servidor). Los parámetros se resolverán como indicamos a continuación:
Configuración de sistema: Escribir cadena de texto ( "Velneo", "beta", "http2NotSupported", "C5A39F2332858154F02E045F64F7FFF8985F4F41")
Última actualización
¿Te fue útil?
