Ověřte XBRL v Pythonu

XBRL znamená XML Based Business Reporting Language. Je to jednoduše schéma, které pomáhá společnostem organizovat svá data tak, aby mohly sdílet informace mezi různými odděleními v rámci své společnosti. Dokumenty XBRL a Inline XBRL (iXBRL) jsou strukturované elektronické obchodní zprávy, které splňují různé obchodní požadavky. Není to jen další typ nudného obchodního dokumentu – dokumenty XBRL obsahují určitou strukturu, formát a vlastnosti, které lze použít k ověření finančních dokumentů. Můžeme snadno programově ověřit dokument instance XBRL nebo iXBRL. V tomto článku se naučíme, jak ověřit XBRL dokument v Pythonu.

Tento článek bude obsahovat následující témata:

  1. Python XBRL Validator API pro ověření dokumentu XBRL
  2. Ověřit soubor XBRL
  3. Ověřit vložený soubor XBRL

Python XBRL Validator API pro ověření dokumentu XBRL

K ověření souboru XBRL nebo dokumentu instance budeme používat Aspose.Finance for Python API. Umožňuje vytváření instancí XBRL, analýzu a ověřování souborů XBRL nebo iXBRL.

Rozhraní API poskytuje třídu XbrlDocument, která představuje dokument XBRL obsahující jednu nebo více instancí XBRL. Instance XBRL je fragment XML, přičemž kořenový prvek má značku XBRL. Třída XbrlInstance poskytuje různé metody a vlastnosti pro práci s instancemi XBRL. Metoda validate() této třídy ověřuje vybranou instanci XBRL. Máme třídu InlineXbrlDocument API, která představuje vložený dokument XBRL. Kromě toho výčet ValidationErrorCode API definuje všechny kódy chyb ověření a příslušné chybové zprávy.

Prosím buď stáhněte si balíček, nebo nainstalujte API z PyPI pomocí následujícího příkazu pip v konzole:

pip install aspose-finance

Ověřte dokument XBRL v Pythonu

Dokument instance XBRL můžeme snadno načíst a ověřit podle následujících kroků:

  1. Nejprve načtěte soubor XBRL pomocí třídy XbrlDocument.
  2. Dále získejte všechny instance pomocí xbrlinstance.
  3. Poté z kolekce přistupte k požadované instanci XBRL.
  4. Poté zavolejte metodu validate() k ověření instance XBRL.
  5. Nakonec ukažte případné chyby.

Následující ukázka kódu ukazuje, jak ověřit instanci XBRL v Pythonu.

# Tento příklad kódu ukazuje, jak ověřit dokument instance XBRL.
from aspose.finance.xbrl import XbrlDocument

# Cesta ke vstupnímu dokumentu
inputFile = "C:\Files\sample.xbrl"

# Načtěte soubor XBRL
document = XbrlDocument(inputFile)

# Získejte instance
xbrlInstances = document.xbrl_instances

# Vyberte konkrétní instanci
xbrlInstance = xbrlInstances[0]

# Ověřit
xbrlInstance.validate()

# Zobrazit případné chyby ověření
if xbrlInstance.validation_errors.length > 0:
   for validationError in xbrlInstance.validation_errors:
        print(validationError.message)

Ověřte vložený dokument XBRL v Pythonu

Dokument iXBRL můžeme také ověřit podle následujících kroků:

  1. Nejprve načtěte soubor iXBRL pomocí třídy InlineXbrlDocument.
  2. Poté zavolejte metodu validate() k ověření instance XBRL.
  3. Nakonec ukažte případné chyby.

Následující ukázka kódu ukazuje, jak ověřit vložený dokument XBRL nebo iXBRL v Pythonu.

# Tento příklad kódu ukazuje, jak ověřit vložený dokument XBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument

# Cesta ke vstupnímu dokumentu
inputFile = "C:\Files\sample.html"

# Načtěte soubor XBRL
document = InlineXbrlDocument(inputFile)

# Ověřit
document.validate();

# Zobrazit případné chyby ověření
if document.validation_errors.length > 0:
   for validationError in document.validation_errors:
        print(validationError.message)

Získejte bezplatnou licenci

Můžete získat bezplatnou dočasnou licenci a vyzkoušet knihovnu bez omezení hodnocení.

Závěr

V tomto článku jsme se naučili, jak ověřit XBRL dokument v Pythonu. Také jsme viděli, jak programově ověřit vložený dokument XBRL. Kromě toho se můžete dozvědět více o Aspose.Finance pro Python API pomocí dokumentace. V případě jakýchkoliv nejasností nás neváhejte kontaktovat na našem bezplatném fóru podpory.

Viz také