在 Python 中讀取 XBRL 文件

結構化電子商務報告由 XBRL 文件和內聯 XBRL (iXBRL) 文件組成。在 XBRL 中,商業報告是事實的集合。或者,iXBRL 報告是人類可讀的並包含標記數據。通過編程,我們可以讀取 XBRL 或 iXBRL 實例文檔並檢索模式引用、上下文、項目等。在本文中,我們將學習如何使用 Python 讀取 XBRL 文件。

本文應涵蓋以下主題:

  1. 閱讀 XBRL 的 Python XBRL 閱讀器
  2. 閱讀 XBRL 文件
  3. 閱讀 iXBRL 文件

用於閱讀 XBRL 的 Python XBRL 閱讀器

為了讀取 XBRL 文件或實例文檔,我們將使用 Aspose.Finance for Python API。它允許創建 XBRL 實例文檔、解析和驗證 XBRL 或 iXBRL 文件。

API 提供了 XbrlDocument 類,代表包含一個或多個 XBRL 實例的 XBRL 文檔。 XbrlInstance 類提供各種方法和屬性來處理 XBRL 實例。我們有代表內聯 XBRL 文檔的 InlineXbrlDocument 類。

下載軟件包 或在控制台中使用以下 pip 命令從 PyPI 安裝 API:

pip install aspose-finance

使用 Python 讀取 XBRL 文件

我們可以按照以下步驟輕鬆加載和讀取 XBRL 實例文檔:

  1. 首先,使用 XbrlDocument 類加載 XBRL 文件。
  2. 接下來,使用 xbrlinstances 獲取所有實例。
  3. 然後,通過使用集合中的索引訪問所需的 XBRL 實例。
  4. 之後,讀取 XBRL 實例的內容。
  5. 最後,顯示所需的數據/信息。

以下代碼示例顯示瞭如何在 Python 中讀取 XBRL 文件。

# 此代碼示例演示瞭如何讀取 XBRL 文件。
from aspose.finance.xbrl import XbrlDocument

# 加載 XBRL 文件
document = XbrlDocument("C:\\Files\\sample.xbrl")

# 獲取實例
xbrlInstances = document.xbrl_instances

# 選擇具體實例
xbrlInstance = xbrlInstances[0]

# 提取和閱讀
facts = xbrlInstance.facts
schemaRefs = xbrlInstance.schema_refs
contexts = xbrlInstance.contexts
units = xbrlInstance.units

# 顯示數據
if contexts.length > 0:
    for x in contexts:
        print("id: " + x.id)
        print("Entity Identifier : " + x.entity.identifier)

在 Python 中讀取 iXBRL 文件

我們還可以按照以下步驟閱讀 iXBRL 文檔:

  1. 首先,使用 InlineXbrlDocument 類加載 iXBRL 文件。
  2. 閱讀 iXBRL 文檔的內容。

以下代碼示例顯示瞭如何在 Python 中讀取 iXBRL 文件。

# 此代碼示例演示瞭如何解析 iXBRL 文檔。
from aspose.finance.xbrl.inline import InlineXbrlDocument

# 文檔目錄的路徑。
inputFile = "C:\\Files\\Output.html"

# 加載輸入文件
document = InlineXbrlDocument(inputFile)

# 解析
inlineFacts = document.facts
contexts = document.contexts
units = document.units

獲得免費許可證

您可以 獲得免費的臨時許可證 來試用該庫,而沒有評估限制。

結論

在本文中,我們學習瞭如何使用 Python 讀取 XBRL 文件。我們還了解瞭如何以編程方式從 XBRL 實例對像中提取數據。此外,您可以使用 文檔 了解更多關於 Aspose.Finance for Python API 的信息。如有任何疑問,請隨時通過我們的免費支持論壇與我們聯繫。

也可以看看