Altova MapForce 2023 Enterprise Edition

Cuando llame a servicios web que devuelvan contenido en la parte del cuerpo del mensaje de respuesta, puede definir la estructura de respuesta como:

 

sin estructura

XML

JSON

archivos Protocol Buffers (véase Protocol Buffers)

 

Nota:en llamadas a servicios web creados en MapForce puede usar JSON estándar como estructura de solicitud o de respuesta; no se admiten estructuras en JSON 5 o líneas JSON.

 

La estructura que seleccione aquí determina los elementos asignables que aparecen en la asignación como secundarios del elemento Body mf_ic_body.

Para definir la estructura de respuesta:

1.Abra el cuadro de diálogo de configuración de los servicios web (véase Configurar llamadas a servicios web).

2.En la sección Definición del servicio, seleccione Manual.

3.En la sección Estructuras, seleccione Editar, a la derecha de Respuesta

mf_ws_response_structure_dialog

Consejo:un atajo para mostrar este cuadro de diálogo es hacer clic en el botón excel1-compicon en la parte de solicitud del componente del servicio web de la asignación.

 

4.Seleccione una de estas opciones:

 

a) Si el servicio web no espera contenido en el cuerpo o si quiere suministrar el cuerpo base (entidad MIME) directamente desde la asignación, seleccione Sin estructura.

 

b) En el caso de XML, obtenga el esquema XML o DTD de la solicitud del proveedor del servicio web. Si selecciona un archivo de instancia XML, este debe tener una referencia de esquema válida. Algunos esquemas XML definen a los elementos con declaración global (es decir, los elementos con schema como elemento primario). Para este tipo de esquemas puede escoger qué elemento del esquema debe ser el elemento raíz de la estructura de la asignación en MapForce. Para ello haga clic en Elegir y después, en el cuadro de diálogo que aparece, seleccione el elemento raíz que prefiera.

 

c) Para JSON debe obtener el esquema JSON de la solicitud del proveedor del servicio web o generarlo a partir de un elemento JSON de muestra con una herramienta como XMLSpy.

 

Consejo:si tiene un archivo de solicitud XML o JSON de muestra pero no tiene un archivo de esquema puede usar XMLSpy para generar el archivo de esquema. Si es necesario, XMLSpy también puede convertir el archivo de instancia de XML a JSON y viceversa.
 

b) Para archivos Protocol Buffers debe obtener del proveedor del servicio web el archivo .proto que describe el archivo binario y después hacer clic en Examinar para seleccionar el archivo. El campo Tipo de mensaje raíz se puede aplicar si el archivo de Protocol Buffers contiene varios tipos de mensaje. Haga clic en Elegir y seleccione el tipo de mensaje que debe ir en la raíz de la estructura.

 

También puede rellenar los campos Tipo de contenido y Estado HTTP si necesita filtrar una respuesta de entidad MIME por tipo de soporte del contenido y código de estado HTTP. Esto es útil si necesita una gestión condicional en función del código de estado HTTP y el tipo de contenido devueltos por la llamada al servicio web. Para ver un ejemplo consulte el apartado Gestionar condicionalmente la respuesta HTTP.

 

Por defecto, el filtro Tipo de contenido está definido como */*, que admite todos los tipos de soporte. Los códigos de estado HTTP predeterminados son 200 a 299. Si la llamada al servicio web devuelve otro código de estado que no se trata de forma explícita, la ejecución de la asignación fallará y emitirá un error.

 

Al guardar la asignación cualquier ruta de acceso absoluta de este cuadro de diálogo se convierte en relativa al archivo del diseño de asignación (.mfd) si la casilla Guardar todas las rutas de acceso de archivos como relativas al archivo MFD está marcada en la configuración del componente (véase el apartado Configurar llamadas a servicios web).

© 2017-2023 Altova GmbH