Структурированные электронные бизнес-отчеты состоят из документов XBRL и документов Inline XBRL (iXBRL). В XBRL бизнес-отчеты представляют собой наборы фактов. Кроме того, отчет iXBRL удобочитаем и содержит тегированные данные. Программно мы можем читать документы экземпляров XBRL или iXBRL и извлекать ссылки на схемы, контексты, элементы и т. д. В этой статье мы узнаем, как читать файлы XBRL в Python.
В этой статье должны быть раскрыты следующие темы:
Python XBRL Reader для чтения XBRL
Для чтения файлов XBRL или экземпляров документов мы будем использовать API Aspose.Finance for Python. Он позволяет создавать отчетные документы XBRL, анализировать и проверять файлы XBRL или iXBRL.
API предоставляет класс XbrlDocument, который представляет документ XBRL, содержащий один или несколько экземпляров XBRL. Класс XbrlInstance предоставляет различные методы и свойства для работы с экземплярами XBRL. У нас есть класс InlineXbrlDocument, который представляет встроенный документ XBRL.
Пожалуйста, загрузите пакет или установите API из PyPI, используя следующую команду pip в консоли:
pip install aspose-finance
Чтение файлов XBRL с помощью Python
Мы можем легко загрузить и прочитать экземпляр документа XBRL, выполнив шаги, указанные ниже:
- Во-первых, загрузите файл XBRL, используя класс XbrlDocument.
- Затем получите все экземпляры с помощью xbrlinstances.
- Затем получите доступ к нужному отчету XBRL, используя его индекс из коллекции.
- После этого прочитайте содержимое экземпляра XBRL.
- Наконец, покажите необходимые данные/информацию.
В следующем примере кода показано, как прочитать файл XBRL в Python.
# Этот пример кода демонстрирует, как читать файл 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)
Чтение файлов iXBRL в Python
Мы также можем прочитать документ iXBRL, выполнив следующие шаги:
- Во-первых, загрузите файл iXBRL, используя класс InlineXbrlDocument.
- Прочтите содержимое документа iXBRL.
В следующем примере кода показано, как прочитать файл iXBRL в Python.
# Этот пример кода демонстрирует, как анализировать документ 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
Получить бесплатную лицензию
Вы можете получить бесплатную временную лицензию, чтобы попробовать библиотеку без ограничений пробной версии.
Вывод
В этой статье мы узнали, как читать файлы XBRL в Python. Мы также видели, как программно извлекать данные из экземпляров объектов XBRL. Кроме того, вы можете узнать больше об Aspose.Finance for Python API, используя документацию. В случае возникновения каких-либо неясностей, пожалуйста, свяжитесь с нами на нашем бесплатном форуме поддержки.