Obtenir les documents Erreur/Message/Sortie
Un document de résultat peut contenir des URI de fichier ou des URI relatifs des documents d'erreur, des documents de message (comme des journaux), et/ou des documents de sortie. (Il existe certaines situations dans laquelle un document de résultat peut ne pas contenir d'URI.) Les différents types d'URI sont décrits ci-dessous.
Pour accéder ces documents via HTTP, procéder comme suit :
1.Agrandir l'URI relatif du fichier dans le document de résultat à son URI absolu
2.Utiliser l'URI agrandi dans une requête GET HTTP pour accéder au fichier
Les URI (dans le document de résultat) de documents d'erreur/de message/ de sortie
Le document de résultat contient des URI d'erreur, de message et/ou des documents de sortie. Les documents d'erreur et de message sont des documents liés aux tâches qui sont générés par le serveur ; ils sont toujours enregistrés dans le répertoire de la tâche sur le serveur. Les documents de sortie (comme la sortie des transformations XSLT) peuvent être enregistrés dans un des emplacements suivants :
•Dans n'importe quel emplacement de fichier accessible au serveur. Pour que les fichiers de sortie soient enregistrés dans un emplacement quelconque, le serveur doit être configuré pour permettre au client un accès non limité (le paramètre par défaut).
•Dans le répertoire de tâche sur le serveur. Le serveur est configuré pour limiter l'accès au client.
Si un client spécifie qu'un fichier de sortie soit créé, l'emplacement dans lequel le fichier de sortie est enregistré sera déterminé par l'option server.unrestricted-filesystem-access du fichier de configuration du serveur.
•Si l'accès n'est pas limité, le fichier sera enregistré sur l'emplacement spécifié par le client et l'URI retourné pour le document sera un URI de fichier.
•Si l'accès est limité, le fichier sera enregistré sur le répertoire de tâche et son URI sera un URI relatif. De plus, il y aura un mappage de cet URI relatif ver l'URL de fichier spécifiée par le client. (Voir la liste du Document de résultat contenant les URI de documents de sortie.)
En résumé, vous rencontrerez donc les types d'URI suivants :
URI de fichier des documents d'erreur/message
Ces documents sont enregistrés dans le répertoire de tâche du serveur. Les URI de fichier ont la forme suivante :
file:///<output-root-dir>/JOBID/message.doc
URI de fichier des documents de sortie
Ces documents sont enregistrés dans n'importe quel endroit. Les URI de fichier ont la forme suivante :
file:///<path-to-file>/output.doc
URI HTTP des documents d'erreur/message/sortie
Ces documents sont enregistrés dans le répertoire de tâche du serveur. Les URI sont relatifs à l'adresse de serveur et doivent être agrandis à l'URI HTTP complet. Le chemin relatif aura cette forme :
/vN/results/JOBID/error/error.txt pour les documents d'erreur
/vN/results/JOBID/output/verbose.log pour les documents de message
/vN/results/JOBID/output/1 pour les documents de sortie
Dans le cas des documents de sortie, des mappages de sortie sont donnés (voir liste d'exemple). Ces mappages mappent chaque URI de document de sortie dans le document de résultat dans la requête client.
Agrandir l'URI relatif
Agrandir l'URI relatif dans le document de résultat sur un URI HTTP absolu en préfixant l'URI relatif avec l'adresse de serveur. Par exemple, si l'adresse de serveur est :
http://localhost:8087/ (l'adresse de configuration initiale )
et que l'URI relatif d'un fichier d'erreur d'un fichier d'erreur dans le document de résultat est :
/2023.2/results/20008201-219F-4790-BB59-C091C276FED2/error/error.txt
alors l'adresse absolue agrandie sera
http://localhost:8087/2023.2/results/20008201-219F-4790-BB59-C091C276FED2/error/error.txt
Pour plus d'informations liées à ce sujet, voir les sections : Configurer le serveur et Obtenir le document de résultat.
Utiliser une requête GET HTTP pour accéder au fichier
Utiliser l'URI agrandie dans une requête GET HTTP pour obtenir le fichier requis. RaptorXML+XBRL Server retourne le document requis.