Altova RaptorXML+XBRL Server 2026

L’exemple suivant affiche comment valider un fichier XBRL. Un problème pouvant survenir est l'absence d'une ou plusieurs taxonomies. Dans ce cas, RaptorXML+XBRL Server signalera le problème et proposera probablement une solution pour y remédier.

Valider XBRL depuis la ligne de commande

La validation peut échouer en raison de taxonomies manquantes. Par exemple, lors de l'exécution d'une commande de validation via PowerShell, le message suivant peut s'afficher :

PS C:\temp\Nanonull> raptorxmlxbrl valxbrl nanonull.xbrl

 
file:///C:/temp/Nanonull/nanonull.xbrl: runtime="141ms" result="Failed"
Erreur : file:///C:/temp/Nanonull/nanonull.xsd:52:

  Ne peut pas charger un schéma avec un espace de nom cible [...] from [...].

  from 'http://xbrl.fasb.org/us-gaap/2013/elts/us-types-2013-01-31.xsd'.
FatalError: I/O operation on file'http://xbrl.fasb.org/us-gaap/2013/elts/us-types-2013-01-31.xsd' failed.
Détails : I/O Error 1001: File 'us-types-2013-01-31.xsd' is part of missing taxonomy 'US GAAP 2013.01'.

  Call 'C:\ProgramData\Altova\SharedBetweenVersions\taxonomymanager.exe install us-gaap-2013.0'.

Dans ce cas, exécutez la commande Altova Taxonomy Manager suggérée :

PS C:\temp\Nanonull> C:\ProgramData\Altova\SharedBetweenVersions\taxonomymanager.exe install us-gaap-2013.0
Install ratings-2015.0.0, us-gaap-2013.0.0.
Create folder C:\ProgramData\Altova\pkgs\xbrl\ratings\.
Download from Altova taxonomy store: ratings-2015-03-31_0.zip.
Create folder C:\ProgramData\Altova\pkgs\xbrl\us-gaap\.
Download from Altova taxonomy store: country-2012-01-31_0.zip.
Download from Altova taxonomy store: country-2013-01-31_0.zip.
Download from Altova taxonomy store: edgartaxonomies-2013_0.xml.
Download from Altova taxonomy store: dei-2012-01-31_0.zip.
Download from Altova taxonomy store: currency-2011-01-31_0.zip.
Download from Altova taxonomy store: dei-2013-01-31_0.zip.
Download from Altova taxonomy store: currency-2012-01-31_0.zip.
Download from Altova taxonomy store: invest-2012-01-31_0.zip.
Download from Altova taxonomy store: rr-2010-02-28_0.zip.
Download from Altova taxonomy store: exch-2013-01-31_0.zip.
Download from Altova taxonomy store: invest-2013-01-31_0.zip.
Download from Altova taxonomy store: naics-2011-01-31_0.zip.
Download from Altova taxonomy store: rr-2012-01-31_0.zip.
Download from Altova taxonomy store: sic-2011-01-31_0.zip.
Download from Altova taxonomy store: stpr-2011-01-31_0.zip.
Download from Altova taxonomy store: us-gaap-2013-01-31_0.zip.
OK.

Confirmez les taxonomies installées utilisant le Gestionnaire de taxonomie :

PS C:\temp\Nanonull> taxonomymanager list -i
PKGID             NAME VERSION      STATUS
ratings-2015.0    "Ratings 2015"    installed: ratings-2015.0.0 "2015.03"
us-gaap-2013.0    "US GAAP 2013"    installed: us-gaap-2013.0.0 "2013.01"
2 packages, 0 upgradeable
OK.

Maintenant que les taxonomies ont été correctement installées par le Gestionnaire de taxonomie, la validation devrait être réussie :

PS C:\temp\Nanonull> raptorxmlxbrl valxbrl nanonull.xbrl
file:///C:/temp/Nanonull/nanonull.xbrl: runtime="787ms" result="OK"

Tester les requêtes POST avec CURL

Une requête POST peut être testée avec CURL :

PS C:\temp\Nanonull> curl.exe -F 'msg={\"command\": \"xbrl\", \"args\":[\"file:///C:/temp/Nanonull/nanonull.xbrl\"], \"options\":{}};type=application/json' http://localhost:8087/v1/queue

Le résultat est :

"state": "OK"

Utilisez POST pour télécharger le fichier d’instance utilisant le schéma additional-files :

PS C:\temp\Nanonull> curl.exe -F 'msg={\"command\": \"xbrl\", \"args\":[\"additional-files:///nanonull.xbrl\"], \"options\":{}};type=application/json'

-F "additional-files=@nanonull.xbrl;type=application/xml" http://localhost:8087/v1/queue

Supposons que la taxonomie nanonull.xsd soit introuvable. Nous obtenons :

Erreur : additional-files:///nanonull.xbrl:3: La valeur 'nanonull.xsd' de l’attribut 'xlink:href' sur l’élément <link:schemaRef> doit pointer vers un schéma de taxonomie valide.

Erreur : L’opération I/O sur le fichier 'additional-files:///nanonull.xsd' a échoué.

Détails : Erreur de système 2 : Le système ne peut pas trouver de fichier spécifié.

  I/O Error 400: Ne sait pas comment gérer l’URI relatif (nom de schéma manque).

FatalError: additional-files:///nanonull.xbrl:2: Le DTS découvert commençant par l’instance XBRL <xbrli:xbrl> n’est pas valide.

Donc nous incluons la taxonomie et les fichiers associés dans la requête POST tel que recensé ci-dessous :

PS C:\temp\Nanonull> curl.exe -F 'msg={\"command\": \"xbrl\", \"args\":[\"additional-files:///nanonull.xbrl\"], \"options\":{}};type=application/json' -F "additional-files=@nanonull.xbrl;type=application/xml" -F "additional-files=@nanonull.xsd;type=application/xml" -F "additional-files=@nanonull_cal.xml;type=application/xml" -F "additional-files=@nanonull_def.xml;type=application/xml" -F "additional-files=@nanonull_for.xml;type=application/xml" -F "additional-files=@nanonull_lab.xml;type=application/xml" -F "additional-files=@nanonull_pre.xml;type=application/xml" -F "additional-files=@nanonull_tab.xml;type=application/xml" http://localhost:8087/v1/queue

Finalement, nous pouvons soumettre l’archive Nanonull.zip entier :

PS C:\temp\Nanonull> curl.exe -F 'msg={\"command\": \"xbrl\", \"args\":[\"additional-files:///Nanonull.zip%7Czip/nanonull.xbrl\"], \"options\":{}};type=application/json' -F "additional-files=@Nanonull.zip;type=application/octet-stream" http://localhost:8087/v1/queue