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 tres 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 salida 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.