在 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 的信息。如有任何疑问,请随时通过我们的免费支持论坛与我们联系。

也可以看看