Altova MapForce 2023 Enterprise Edition

Cuando necesite llamar a un servicio web con parámetros de URL, estos parámetros deben estar definidos en el cuadro de diálogo "Configuración de la llamada a servicio web". Este cuadro de diálogo también sirve para configurar la solicitud del servicio web con encabezados personales. Como se describe más abajo, puede configurar los valores de los parámetros para que sean asignables (es decir, para que los provea la asignación) o fijos (definidos en el cuadro de diálogo).

 

Para definir los parámetros del servicio web:

 

1.Haga doble clic en la barra del título del componente del servicio web en la asignación o haga clic en él con el botón derecho y seleccione Propiedades para abrir el cuadro de diálogo "Configurar llamadas a servicios web".

mf_ws_03

2.En la sección Definición del servicio seleccione Manual. Como se ve en la imagen anterior, los parámetros se pueden introducir manualmente o, como alternativa, los puede importar desde una URL o un archivo WADL. Los parámetros importados pasan a estar disponibles en la tabla Parámetros, desde donde puede modificarlos si lo necesita.

3.Utilice los botones Agregar parámetro ( ic_paramadd ) y Eliminar parámetro ( ic_paramdel ) según corresponda.

 

 

Parámetros

A continuación describimos las columnas que componen la tabla Parámetros:

 

 

Ejemplo 1: parámetros de encabezados y plantillas

El servicio web de este ejemplo recupera un producto en base a su identificador (id) por medio de un método HTTP GET. La URL del servicio web especifica el parámetro id entre llaves. Observe que el parámetro id existe en la tabla Parámetros y que tiene el estilo Plantilla. Además, está configurado como parámetro asignable, es decir, que el parámetro aparecerá en la asignación como nodo de estructura que se puede conectar al valor real de id (que se podría tomar de una base de datos, de un archivo o de una constante, por ejemplo). Cuando se ejecute la asignación, este parámetro se reemplazará con el valor real. Por tanto, si el valor es "1", la URL será http://example.org/api/products/1.

 

Para suministrar una constante como valor id en lugar de darle un valor desde la asignación, desmarque la casilla "Asignable" e introduzca el valor en la columna "Valor fijo".

mf_ws_03

Los parámetros Accept y Accept-Charset tienen el estilo Encabezado. Estos parámetros se usan para llamar al servicio web con encabezados de solicitud personales. Hay dos maneras de aportar un valor al encabezado:

 

dejando marcada la opción Asignable y dando el valor de encabezado personal desde la asignación o

desactivando la asilla Asignable e introduciendo el valor en la columna Valor fijo directamente.

 

Ejemplo 2: parámetros de matriz

El servicio web de este ejemplo recupera una lista de productos que coinciden con el color y el tamaño dados como argumentos. El estilo de los parámetros es Matriz, es decir, se pueden definir como marcadores de posición tanto dentro de la URL como en la tabla de asignación. Observe que los parámetros están marcados como asignables y que la opción Repetido está marcada. Esto significa que su valor se leerá desde una secuencia de valores de la asignación (por ejemplo, una lista de filas dentro de un archivo de texto, un nodo XML o una columna de base de datos) y se enviará al servicio web en tiempo de ejecución. Por tanto, una dirección URL como esta podrá convertirse en la URL http://example.org/api/products/;color=red;color=blue;size=big;size=small siempre y cuando la asignación aporte los valores red y blue para el color y big y small para el tamaño.

mf_ws_04

Si necesita una URL como http://example.org/api/products;color=red,blue;size=big,small, entonces deberá:

 

1.Introducir la URL como http://example.org/api/products;color={color};size={size}.

2.En la tabla Parámetros cambiar el estilo del parámetro por Plantilla.

 

Si necesita una URL como http://example.org/api/products?color=red,blue&size=big,small, entonces deberá:

 

1.Introducir la URL como http://example.org/api/products?color={color}&size={size}.

2.En la tabla Parámetros cambiar el estilo del parámetro por Plantilla.

 

Ejemplo 3: parámetros de consulta

El servicio web de este ejemplo también recupera una lista de productos que coincidan con el color y el tamaño dados como argumentos, pero esta vez usando el estilo Consulta. Para este estilo no es necesario definir los parámetros como marcadores de posición en la URL. Solamente se definen en la tabla Parámetros. En este ejemplo, imaginemos que los valores de parámetro están fijos y no hay necesidad de proporcionarlos desde la asignación. Para conseguir esto, los valores del parámetro se introdujeron en el campo Valor fijo (así que deberá desactivar la casilla Asignable). Por tanto, cuando se ejecute la asignación, la URL pasará a ser http://example.org/api/products?color=red&size=big.

mf_ws_05

© 2017-2023 Altova GmbH