Czytaj XBRL w Python

Dokumenty XBRL i Inline XBRL (iXBRL) to ustrukturyzowane elektroniczne raporty biznesowe spełniające różne wymagania biznesowe. Dokument XBRL to zbiór faktów, które razem składają się na raport biznesowy. Natomiast raport iXBRL jest raportem czytelnym dla człowieka z osadzonymi w nim oznakowanymi danymi. Możemy łatwo programowo przeanalizować dokument instancji XBRL lub iXBRL i odczytać obiekty lub elementy, takie jak odniesienie do schematu, kontekst, jednostka, elementy itp. W poprzednim wpisie widzieliśmy, jak utworzyć dokument XBRL. W tym artykule nauczymy się analizować dokument XBRL w Python.

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

  1. Biblioteka finansowa Python do analizowania XBRL
  2. Analizuj plik XBRL
  3. Analizuj plik iXBRL

Python Finance Library do parsowania XBRL

Aby przeanalizować plik XBRL lub dokument instancji, użyjemy API Aspose.Finance for Python. Umożliwia tworzenie instancji XBRL, parsowanie i sprawdzanie poprawności plików XBRL lub iXBRL.

Klasa XbrlDocument interfejsu API reprezentuje dokument XBRL zawierający co najmniej jedną instancję XBRL. Instancja XBRL to fragment XML, w którym element główny ma znacznik XBRL. Klasa XbrlInstance udostępnia różne metody i właściwości do pracy z instancjami XBRL. Klasa InlineXbrlDocument interfejsu API reprezentuje wbudowany dokument XBRL.

Pobierz pakiet lub zainstaluj interfejs API z PyPI, używając następującego polecenia pip w konsoli:

pip install aspose-finance

Parsuj plik XBRL w Python

Możemy łatwo załadować i przeanalizować 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 z kolekcji.
  4. Następnie przeanalizuj zawartość instancji XBRL.
  5. Na koniec pokaż wymagane dane/informacje.

Poniższy przykładowy kod pokazuje, jak analizować wystąpienie XBRL w języku Python.

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

# Ścieżka do katalogu dokumentów.
inputFile = "C:\\Files\\Finance\\sample.xbrl"

# Zainicjuj XbrlDocument
document = XbrlDocument(inputFile)

# Uzyskaj instancje
xbrlInstances = document.xbrl_instances

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

# Analizować
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)

Przeanalizuj plik iXBRL w Python

Możemy również przeanalizować dokument iXBRL, wykonując czynności podane poniżej:

  1. Najpierw załaduj plik iXBRL przy użyciu klasy InlineXbrlDocument.
  2. Przeanalizuj zawartość dokumentu iXBRL.

Poniższy przykładowy kod pokazuje, jak analizować 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\\Finance\\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ę analizować dokument XBRL lub iBXRL 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 forum.

Zobacz też