Czytaj pliki XBRL w Python

Ustrukturyzowane elektroniczne raporty biznesowe składają się z dokumentów XBRL oraz dokumentów Inline XBRL (iXBRL). W XBRL raporty biznesowe są zbiorami faktów. Alternatywnie raport iXBRL jest czytelny dla człowieka i zawiera oznakowane dane. Programowo możemy czytać dokumenty instancji XBRL lub iXBRL i pobierać odniesienia do schematu, konteksty, elementy itp. W tym artykule nauczymy się czytać pliki XBRL w Python.

W tym artykule zostaną omówione następujące tematy:

  1. Czytnik Python XBRL do odczytu XBRL
  2. Odczyt pliku XBRL
  3. Odczyt pliku iXBRL

Python XBRL Reader do odczytu XBRL

Do odczytu plików XBRL lub dokumentów instancji będziemy używać API Aspose.Finance for Python. Umożliwia tworzenie dokumentów instancji XBRL, parsowanie i sprawdzanie poprawności plików XBRL lub iXBRL.

Interfejs API udostępnia klasę XbrlDocument, która reprezentuje dokument XBRL zawierający co najmniej jedną instancję XBRL. Klasa XbrlInstance udostępnia różne metody i właściwości do pracy z instancjami XBRL. Mamy klasę InlineXbrlDocument, która reprezentuje wbudowany dokument XBRL.

Proszę pobierz pakiet lub zainstaluj API z PyPI za pomocą następującego polecenia pip w konsoli:

pip install aspose-finance

Czytaj pliki XBRL za pomocą Python

Możemy łatwo załadować i odczytać dokument instancji XBRL, wykonując czynności podane poniżej:

  1. Najpierw załaduj plik XBRL przy użyciu klasy XbrlDocument.
  2. Następnie pobierz wszystkie instancje za pomocą xbrlinstances.
  3. Następnie uzyskaj dostęp do żądanej instancji XBRL, uzyskując dostęp za pomocą jej indeksu z kolekcji.
  4. Następnie przeczytaj zawartość instancji XBRL.
  5. Na koniec pokaż wymagane dane/informacje.

Poniższy przykładowy kod pokazuje, jak odczytać plik XBRL w języku Python.

# Ten przykład kodu pokazuje, jak odczytać plik XBRL.
from aspose.finance.xbrl import XbrlDocument

# Załaduj dokument XBRL
document = XbrlDocument("C:\\Files\\sample.xbrl")

# Uzyskaj instancje
xbrlInstances = document.xbrl_instances

# Wybierz konkretną instancję
xbrlInstance = xbrlInstances[0]

# Wypakuj i przeczytaj
facts = xbrlInstance.facts
schemaRefs = xbrlInstance.schema_refs
contexts = xbrlInstance.contexts
units = xbrlInstance.units

# Pokaż dane
if contexts.length > 0:
   for x in contexts:
        print("id: " + x.id)
        print("Entity Identifier : " + x.entity.identifier)

Czytaj pliki iXBRL w Python

Możemy również odczytać dokument iXBRL, wykonując poniższe czynności:

  1. Najpierw załaduj plik iXBRL przy użyciu klasy InlineXbrlDocument.
  2. Zapoznaj się z treścią dokumentu iXBRL.

Poniższy przykładowy kod pokazuje, jak odczytać plik iXBRL w języku Python.

# Ten przykład kodu pokazuje, jak analizować dokument iXBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument

# Ścieżka do katalogu dokumentów.
inputFile = "C:\\Files\\Output.html"

# Załaduj plik wejściowy
document = InlineXbrlDocument(inputFile)

# Analizować
inlineFacts = document.facts
contexts = document.contexts
units = document.units

Uzyskaj bezpłatną licencję

Możesz uzyskać bezpłatną tymczasową licencję, aby wypróbować bibliotekę bez ograniczeń ewaluacyjnych.

Wniosek

W tym artykule nauczyliśmy się czytać pliki XBRL w Python. Widzieliśmy również, jak programowo wyodrębnić dane z obiektów instancji XBRL. Poza tym możesz dowiedzieć się więcej o Aspose.Finance for Python API korzystając z dokumentacji. W przypadku jakichkolwiek niejasności prosimy o kontakt na naszym darmowym forum pomocy.

Zobacz też