Python で XBRL を読む

XBRL およびインライン XBRL (iXBRL) ドキュメントは、さまざまなビジネス要件を満たす構造化された電子ビジネス レポートです。 XBRL ドキュメントは、ビジネス レポートを構成する事実の集まりです。一方、iXBRL レポートは、タグ付きデータが埋め込まれた人間が判読できるレポートです。 XBRL または iXBRL インスタンス ドキュメントをプログラムで簡単に解析し、スキーマ参照、コンテキスト、ユニット、アイテムなどのオブジェクトまたは要素を読み取ることができます。前回の投稿 で、XBRL ドキュメントの作成方法を見てきました。この記事では、Python で XBRL ドキュメントを解析する方法を学びます。

この記事では、次のトピックについて説明します。

  1. XBRL を解析する Python Finance Library
  2. XBRL ファイルの解析
  3. iXBRL ファイルのパース

XBRL を解析するための Python 金融ライブラリ

XBRL ファイルまたはインスタンス ドキュメントを解析するには、Aspose.Finance for Python API を使用します。 XBRL インスタンスの作成、解析、および XBRL または iXBRL ファイルの検証を行うことができます。

API の XbrlDocument クラスは、1 つ以上の XBRL インスタンスを含む XBRL ドキュメントを表します。 XBRL インスタンスは、XBRL タグを持つルート要素を持つ XML フラグメントです。 XbrlInstance クラスは、XBRL インスタンスを操作するためのさまざまなメソッドとプロパティを提供します。 API の InlineXbrlDocument クラスは、インライン XBRL ドキュメントを表します。

パッケージをダウンロードするか、コンソールで次の 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

# ドキュメント ディレクトリへのパス。
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)

Python で iXBRL ファイルを解析する

以下の手順に従って iXBRL ドキュメントを解析することもできます。

  1. まず、InlineXbrlDocument クラスを使用して iXBRL ファイルをロードします。
  2. iXBRL ドキュメントのコンテンツを解析します。

次のコード サンプルは、Python で iXBRL を解析する方法を示しています。

# このコード例は、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

無料ライセンスを取得する

無料の一時ライセンスを取得して、評価制限なしでライブラリを試すことができます。

結論

この記事では、Python で XBRL または iBXRL ドキュメントを解析する方法を学びました。プログラムで XBRL インスタンス オブジェクトからデータを抽出する方法も説明しました。また、ドキュメント を使用して、Aspose.Finance for Python API の詳細を学ぶことができます。ご不明な点がございましたら、フォーラムまでお気軽にお問い合わせください。

関連項目