Les rapports commerciaux électroniques structurés sont constitués de documents XBRL et de documents Inline XBRL (iXBRL). En XBRL, les rapports d’activité sont des ensembles de faits. Alternativement, un rapport iXBRL est lisible par l’homme et contient des données balisées. Par programmation, nous pouvons lire des documents d’instance XBRL ou iXBRL et récupérer des références de schéma, des contextes, des éléments, etc. Dans cet article, nous allons apprendre à lire des fichiers XBRL en Python.
Les sujets suivants seront traités dans cet article :
Lecteur Python XBRL pour lire XBRL
Pour lire des fichiers XBRL ou des documents d’instance, nous utiliserons l’API Aspose.Finance for Python. Il permet de créer des documents d’instance XBRL, d’analyser et de valider les fichiers XBRL ou iXBRL.
L’API fournit la classe XbrlDocument qui représente un document XBRL contenant une ou plusieurs instances XBRL. La classe XbrlInstance fournit diverses méthodes et propriétés pour travailler avec les instances XBRL. Nous avons la classe InlineXbrlDocument qui représente un document XBRL en ligne.
Veuillez soit télécharger le package ou installer l’API à partir de PyPI en utilisant la commande pip suivante dans la console :
pip install aspose-finance
Lire des fichiers XBRL à l’aide de Python
Nous pouvons facilement charger et lire un document d’instance XBRL en suivant les étapes ci-dessous :
- Tout d’abord, chargez un fichier XBRL à l’aide de la classe XbrlDocument.
- Ensuite, récupérez toutes les instances à l’aide de xbrlinstances.
- Ensuite, accédez à l’instance XBRL souhaitée en accédant à l’aide de son index à partir de la collection.
- Après cela, lisez le contenu de l’instance XBRL.
- Enfin, indiquez les données/informations requises.
L’exemple de code suivant montre comment lire un fichier XBRL en Python.
# Cet exemple de code montre comment lire un fichier XBRL.
from aspose.finance.xbrl import XbrlDocument
# Charger le document XBRL
document = XbrlDocument("C:\\Files\\sample.xbrl")
# Obtenir des instances
xbrlInstances = document.xbrl_instances
# Sélectionnez une instance spécifique
xbrlInstance = xbrlInstances[0]
# Extraire et lire
facts = xbrlInstance.facts
schemaRefs = xbrlInstance.schema_refs
contexts = xbrlInstance.contexts
units = xbrlInstance.units
# Afficher les données
if contexts.length > 0:
for x in contexts:
print("id: " + x.id)
print("Entity Identifier : " + x.entity.identifier)
Lire des fichiers iXBRL en Python
Nous pouvons également lire un document iXBRL en suivant les étapes ci-dessous :
- Tout d’abord, chargez un fichier iXBRL à l’aide de la classe InlineXbrlDocument.
- Lisez le contenu du document iXBRL.
L’exemple de code suivant montre comment lire un fichier iXBRL en Python.
# Cet exemple de code montre comment analyser un document iXBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument
# Chemin d'accès au répertoire des documents.
inputFile = "C:\\Files\\Output.html"
# Charger le fichier d'entrée
document = InlineXbrlDocument(inputFile)
# Analyser
inlineFacts = document.facts
contexts = document.contexts
units = document.units
Obtenez une licence gratuite
Vous pouvez obtenir une licence temporaire gratuite pour essayer la bibliothèque sans limitation d’évaluation.
Conclusion
Dans cet article, nous avons appris à lire des fichiers XBRL en Python. Nous avons également vu comment extraire des données d’objets d’instance XBRL par programmation. En outre, vous pouvez en savoir plus sur l’API Aspose.Finance pour Python en utilisant documentation. En cas d’ambiguïté, n’hésitez pas à nous contacter sur notre forum d’assistance gratuit.