Python で XBRL ファイルを読み取る

構造化された電子ビジネス レポートは、XBRL ドキュメントとインライン XBRL (iXBRL) ドキュメントで構成されます。 XBRL では、ビジネス レポートは事実の集まりです。あるいは、iXBRL レポートは人間が判読でき、タグ付きデータが含まれています。プログラムで、XBRL または iXBRL インスタンス ドキュメントを読み取り、スキーマ参照、コンテキスト、アイテムなどを取得できます。この記事では、Python で XBRL ファイルを読み取る方法を学習します。

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

  1. XBRLを読むためのPython XBRL Reader
  2. XBRLファイルを読み込む
  3. iXBRL ファイルの読み込み

XBRL を読み取るための Python XBRL リーダー

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

API は、1 つ以上の XBRL インスタンスを含む XBRL ドキュメントを表す XbrlDocument クラスを提供します。 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 の詳細を学ぶことができます。ご不明な点がございましたら、無料サポート フォーラム までお気軽にお問い合わせください。

関連項目