Obtener los documentos de salida/errores

www.altova.com Imprimir este apartado Página anterior Subir un nivel Página siguiente

Inicio >  APIs de servidor: HTTP REST, COM/.NET, Java > Interfaz cliente HTTP REST > Solicitudes cliente >

Obtener los documentos de salida/errores

Un documento de resultados puede contener los URI de archivo o los URI relativos de los documentos de errores, documentos de mensajes (como los registros) y documentos de salida. (En algunos casos el documento de resultados no contiene ningún URI). Los diferentes tipos de URI se describen más abajo.

 

Para acceder a estos documentos por HTTP:

 

1.Amplíe el URI relativo del archivo del documento de resultados hasta su URI absoluto.
2.Use el URI ampliado en una solicitud HTTP GET para acceder al archivo.

 

URI (en el documento de resultados) de los documentos de errores, de mensajes y de salida

El documento de resultados contiene los URI de los documentos de errores, de mensajes y de salida. Los documentos de errores y de mensajes están relacionados con el trabajo y los genera el servidor. Siempre se guardan en el servidor, en el directorio del trabajo. Los documentos de salida (como los resultantes de transformaciones XSLT) se pueden guardar en una de estas dos ubicaciones:

 

En cualquier ubicación de archivo a la que pueda acceder el servidor. Para guardar los archivos en cualquier ubicación, debe configurar el servidor para permitir acceso no restringido al cliente (configuración predeterminada).
En el directorio de trabajo del servidor. El servidor se configura para restringir el acceso al cliente.

 

Si un cliente especifica que se debe crear un archivo de salida, la ubicación en la que se guarda el archivo depende de la opción server.unrestricted-filesystem-access del archivo de configuración del servidor.

 

Si el acceso no está restringido, el archivo se guardará en la ubicación especificada por el ciente y el URI devuelto para el documento será un URI de archivo.
Si el acceso está restringido, el archivo se guardará en el directorio del trabajo y su URI será un URI relativo. Además, se creará una asignación entre este URI relativo y la URL de archivo especificada por el cliente (ver el ejemplo del apartado Documento de resultados con los URI de los documentos de salida)

 

Para resumir, hay 3 tipos de URI:

 

URI de archivo de los documentos de errores / mensajes

Estos documentos se guardan en el servidor en el directorio del trabajo. Los URI de archivo tienen este formato:

file:///<dir-raíz-de-salida>/JOBID/mensaje.doc

 

URI de archivo de los documentos de salida

Estos documentos se guardan en cualquier ubicación. Los URI de archivo tienen este formato:

file:///<ruta-del-archivo>/salida.doc

 

URI HTTP de los documentos de errores/mensajes/salida

Estos documentos se guardan en el servidor en el directorio del trabajo. Los URI son relativos a la dirección del servidor y deben ampliarse a un URI HTTP. Este es su formato:

 

/vN/results/JOBID/error/error.txt     para documentos de errores

/vN/results/JOBID/output/verbose.log para documentos de mensajes

/vN/results/JOBID/output/1           para documentos de salida

 

En el caso de los documentos de salida, se dan las asignaciones de salida (ver fragmento de ejemplo). Estas asignaciones unen cada URI de documento de salida del documento de resultados con el documento correspondiente de la solicitud cliente.

 

Ampliar el URI relativo

Amplíe el URI relativo del documento de resultados a un URI HTTP absoluto añadiendo la dirección del servidor como prefijo al URI relativo. Por ejemplo, si la dirección del servidor es:

 

http://localhost:8087/ (la configuración inicial)

 

y el URI relativo de un archivo de errores del documento de resultados es:

 
/v1/results/20008201-219F-4790-BB59-C091C276FED2/error/error.txt 

 

entonces la dirección absoluta ampliada será

 
http://localhost:8087/v1/results/20008201-219F-4790-BB59-C091C276FED2/error/error.txt 

 

Para más información consulte los apartados Configurar el servidor y Obtener el documento de resultados.

 

Utilice una solicitud HTTP GET para acceder a los archivos

Utilice el URI ampliado en una solicitud HTTP GET para obtener el archivo que necesita. RaptorXML+XBRL Server devuelve el documento solicitado.

 


© 2019 Altova GmbH