结构化电子商务报告由 XBRL 文件和内联 XBRL (iXBRL) 文件组成。在 XBRL 中,商业报告是事实的集合。或者,iXBRL 报告是人类可读的并包含标记数据。通过编程,我们可以读取 XBRL 或 iXBRL 实例文档并检索模式引用、上下文、项目等。在本文中,我们将学习如何使用 Python 读取 XBRL 文件。
本文应涵盖以下主题:
用于阅读 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 实例文档:
- 首先,使用 XbrlDocument 类加载 XBRL 文件。
- 接下来,使用 xbrlinstances 获取所有实例。
- 然后,通过使用集合中的索引访问所需的 XBRL 实例。
- 之后,读取 XBRL 实例的内容。
- 最后,显示所需的数据/信息。
以下代码示例显示了如何在 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 文档:
- 首先,使用 InlineXbrlDocument 类加载 iXBRL 文件。
- 阅读 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 的信息。如有任何疑问,请随时通过我们的免费支持论坛与我们联系。