I report aziendali elettronici strutturati sono costituiti da documenti XBRL e documenti Inline XBRL (iXBRL). In XBRL, i report aziendali sono raccolte di fatti. In alternativa, un rapporto iXBRL è leggibile e contiene dati con tag. A livello di programmazione, possiamo leggere documenti di istanza XBRL o iXBRL e recuperare riferimenti a schemi, contesti, elementi, ecc. In questo articolo impareremo come leggere i file XBRL in Python.
In questo articolo saranno trattati i seguenti argomenti:
Python XBRL Reader per leggere XBRL
Per leggere file XBRL o documenti di istanza, utilizzeremo l’API Aspose.Finance per Python. Consente di creare documenti di istanza XBRL, analizzare e convalidare i file XBRL o iXBRL.
L’API fornisce la classe XbrlDocument che rappresenta un documento XBRL contenente una o più istanze XBRL. La classe XbrlInstance fornisce vari metodi e proprietà per lavorare con le istanze XBRL. Abbiamo la classe InlineXbrlDocument che rappresenta un documento XBRL inline.
Si prega di scaricare il pacchetto o installare l’API da PyPI utilizzando il seguente comando pip nella console:
pip install aspose-finance
Leggi i file XBRL usando Python
Possiamo facilmente caricare e leggere un documento di istanza XBRL seguendo i passaggi indicati di seguito:
- Innanzitutto, carica un file XBRL utilizzando la classe XbrlDocument.
- Successivamente, ottieni tutte le istanze utilizzando xbrlinstances.
- Quindi, accedi all’istanza XBRL desiderata accedendo utilizzando il relativo indice dalla raccolta.
- Successivamente, leggi il contenuto dell’istanza XBRL.
- Infine, mostra i dati/informazioni richiesti.
L’esempio di codice seguente mostra come leggere un file XBRL in Python.
# Questo esempio di codice mostra come leggere un file XBRL.
from aspose.finance.xbrl import XbrlDocument
# Carica documento XBRL
document = XbrlDocument("C:\\Files\\sample.xbrl")
# Ottieni istanze
xbrlInstances = document.xbrl_instances
# Seleziona un'istanza specifica
xbrlInstance = xbrlInstances[0]
# Estrai e leggi
facts = xbrlInstance.facts
schemaRefs = xbrlInstance.schema_refs
contexts = xbrlInstance.contexts
units = xbrlInstance.units
# Mostra dati
if contexts.length > 0:
for x in contexts:
print("id: " + x.id)
print("Entity Identifier : " + x.entity.identifier)
Leggi i file iXBRL in Python
Possiamo anche leggere un documento iXBRL seguendo i passaggi indicati di seguito:
- Innanzitutto, carica un file iXBRL utilizzando la classe InlineXbrlDocument.
- Leggi il contenuto del documento iXBRL.
L’esempio di codice seguente mostra come leggere un file iXBRL in Python.
# Questo esempio di codice mostra come analizzare il documento iXBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument
# Il percorso della directory dei documenti.
inputFile = "C:\\Files\\Output.html"
# Carica il file di input
document = InlineXbrlDocument(inputFile)
# Analizza
inlineFacts = document.facts
contexts = document.contexts
units = document.units
Ottieni una licenza gratuita
Puoi ottenere una licenza temporanea gratuita per provare la libreria senza limiti di valutazione.
Conclusione
In questo articolo abbiamo imparato a leggere i file XBRL in Python. Abbiamo anche visto come estrarre dati da oggetti istanza XBRL a livello di codice. Inoltre, puoi saperne di più su Aspose.Finance per l’API Python usando documentazione. In caso di ambiguità, non esitate a contattarci sul nostro forum di supporto gratuito.