Strukturerade elektroniska affärsrapporter består av XBRL dokument och inline XBRL (iXBRL) dokument. I XBRL är affärsrapporter samlingar av fakta. Alternativt är en iXBRL-rapport läsbar för människor och innehåller taggade data. Programmatiskt kan vi läsa XBRL- eller iXBRL-instansdokument och hämta schemareferenser, sammanhang, objekt etc. I den här artikeln kommer vi att lära oss hur man läser XBRL-filer i Python.
Följande ämnen ska behandlas i den här artikeln:
Python XBRL Reader för att läsa XBRL
För att läsa XBRL-filer eller instansdokument kommer vi att använda Aspose.Finance for Python API. Det gör det möjligt att skapa XBRL-instansdokument, analysera och validera XBRL- eller iXBRL-filerna.
API tillhandahåller klassen XbrlDocument som representerar ett XBRL-dokument som innehåller en eller flera XBRL-instanser. Klassen XbrlInstance tillhandahåller olika metoder och egenskaper för att arbeta med XBRL-instanser. Vi har klassen InlineXbrlDocument som representerar ett inline XBRL-dokument.
Vänligen antingen ladda ner paketet eller installera API:t från PyPI med följande pip-kommando i konsolen:
pip install aspose-finance
Läs XBRL-filer med Python
Vi kan enkelt ladda och läsa ett XBRL-instansdokument genom att följa stegen nedan:
- Först laddar du en XBRL-fil med XbrlDocument-klassen.
- Hämta sedan alla instanser med hjälp av xbrlinstances.
- Gå sedan till önskad XBRL-instans genom att använda dess index från samlingen.
- Efter det, läs innehållet i XBRL-instansen.
- Till sist, visa nödvändig data/information.
Följande kodexempel visar hur man läser en XBRL-fil i Python.
# Detta kodexempel visar hur man läser en XBRL-fil.
from aspose.finance.xbrl import XbrlDocument
# Ladda XBRL-dokument
document = XbrlDocument("C:\\Files\\sample.xbrl")
# Hämta instanser
xbrlInstances = document.xbrl_instances
# Välj en specifik instans
xbrlInstance = xbrlInstances[0]
# Extrahera och läs
facts = xbrlInstance.facts
schemaRefs = xbrlInstance.schema_refs
contexts = xbrlInstance.contexts
units = xbrlInstance.units
# Visa data
if contexts.length > 0:
for x in contexts:
print("id: " + x.id)
print("Entity Identifier : " + x.entity.identifier)
Läs iXBRL-filer i Python
Vi kan också läsa ett iXBRL-dokument genom att följa stegen nedan:
- Först laddar du en iXBRL-fil med klassen InlineXbrlDocument.
- Läs innehållet i iXBRL-dokumentet.
Följande kodexempel visar hur man läser en iXBRL-fil i Python.
# Detta kodexempel visar hur man tolkar iXBRL-dokument.
from aspose.finance.xbrl.inline import InlineXbrlDocument
# Sökvägen till dokumentkatalogen.
inputFile = "C:\\Files\\Output.html"
# Ladda indatafil
document = InlineXbrlDocument(inputFile)
# Analysera
inlineFacts = document.facts
contexts = document.contexts
units = document.units
Skaffa en gratis licens
Du kan få en gratis tillfällig licens för att prova biblioteket utan utvärderingsbegränsningar.
Slutsats
I den här artikeln har vi lärt oss hur man läser XBRL-filer i Python. Vi har också sett hur man extraherar data från XBRL-instansobjekt programmatiskt. Dessutom kan du lära dig mer om Aspose.Finance för Python API med hjälp av dokumentation. I händelse av oklarheter är du välkommen att kontakta oss på vårt gratis supportforum.