Чтение XBRL на Python

Документы XBRL и Inline XBRL (iXBRL) представляют собой структурированные электронные бизнес-отчеты, отвечающие различным бизнес-требованиям. Документ XBRL представляет собой набор фактов, которые вместе составляют бизнес-отчет. Принимая во внимание, что отчет iXBRL представляет собой удобочитаемый отчет со встроенными в него данными с тегами. Мы можем легко программно проанализировать экземпляр документа XBRL или iXBRL и прочитать объекты или элементы, такие как ссылка на схему, контекст, единица измерения, элементы и т. д. В предыдущем посте мы видели, как создать документ XBRL. В этой статье мы узнаем, как анализировать документ XBRL в Python.

В этой статье должны быть раскрыты следующие темы:

  1. Финансовая библиотека Python для анализа XBRL
  2. Разобрать файл XBRL
  3. Разобрать файл iXBRL

Финансовая библиотека Python для анализа XBRL

Для анализа XBRL-файла или экземпляра документа мы будем использовать API Aspose.Finance for Python. Он позволяет создавать экземпляры XBRL, анализировать и проверять файлы XBRL или iXBRL.

Класс XbrlDocument API представляет документ XBRL, содержащий один или несколько экземпляров XBRL. Отчет XBRL представляет собой фрагмент XML, корневой элемент которого имеет тег XBRL. Класс XbrlInstance предоставляет различные методы и свойства для работы с экземплярами XBRL. Класс InlineXbrlDocument API представляет встроенный документ XBRL.

Пожалуйста, загрузите пакет или установите API из PyPI, используя следующую команду pip в консоли:

pip install aspose-finance

Разобрать файл XBRL в Python

Мы можем легко загрузить и проанализировать экземпляр документа XBRL, выполнив шаги, указанные ниже:

  1. Во-первых, загрузите файл XBRL, используя класс XbrlDocument.
  2. Затем получите все экземпляры с помощью xbrlinstances.
  3. Затем получите доступ к нужному экземпляру XBRL из коллекции.
  4. После этого проанализируйте содержимое экземпляра XBRL.
  5. Наконец, покажите необходимые данные/информацию.

В следующем примере кода показано, как анализировать экземпляр XBRL в Python.

# Этот пример кода демонстрирует, как анализировать документ XBRL.
from aspose.finance.xbrl import XbrlDocument

# Путь к каталогу документов.
inputFile = "C:\\Files\\Finance\\sample.xbrl"

# Инициализировать XbrlDocument
document = XbrlDocument(inputFile)

# Получить экземпляры
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, выполнив следующие шаги:

  1. Во-первых, загрузите файл iXBRL, используя класс InlineXbrlDocument.
  2. Проанализируйте содержимое документа iXBRL.

В следующем примере кода показано, как анализировать iXBRL в Python.

# Этот пример кода демонстрирует, как анализировать документ iXBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument

# Путь к каталогу документов.
inputFile = "C:\\Files\\Finance\\Output.html"

# Загрузить входной файл
document = InlineXbrlDocument(inputFile)

# Разобрать
inlineFacts = document.facts
contexts = document.contexts
units = document.units

Получить бесплатную лицензию

Вы можете получить бесплатную временную лицензию, чтобы попробовать библиотеку без ограничений пробной версии.

Вывод

В этой статье мы узнали, как анализировать документ XBRL или iBXRL в Python. Мы также видели, как программно извлекать данные из экземпляров объектов XBRL. Кроме того, вы можете узнать больше об Aspose.Finance for Python API, используя документацию. В случае возникновения каких-либо неясностей, пожалуйста, свяжитесь с нами на нашем форуме.

Смотрите также