aspose.finance

この記事では、XBRL標準を使用したビジネスレポート、XBRLの目的、および.NETアプリケーションでXBRLベースのビジネスレポートを作成するプロセスを自動化する方法について説明します。さらに、XBRLおよびiXBRLファイルを解析し、C#を使用してプログラムでデータを取得するためのステップバイステップのメソッドが含まれています。最後になりましたが、C#を使用してXBRLおよびiXBRLファイルを検証する簡単な方法をいくつか提供します。

eXtensible Business Reporting Language(XBRL)

XBRLは、ビジネスレポートに世界的に使用されているXMLベースの標準およびファイル形式です。これにより、さまざまな企業や会計組織が、財務諸表やその他の財務関連の情報/データを効率的かつ正確に整理、編集、および伝達することが容易になります。 XBRLはXML(Extensible Markup Language)に基づいているため、タグを使用してすべての財務データを保持および解析します。 iXBRL(インラインXBRL)は、財務データを人間が読み取れる形式と機械が読み取れる形式で同時に保持できるようにするもう1つのバリアントです。 XBRLとは対照的に、iXBRLはHTML標準を使用し、図やステートメントにいくつかの追加のタグを付けます。

XBRLとiXBRLの両方のタグは、XBRL互換ソフトウェアを使用して解析され、データを取得します。 XBRL解析を自動化するために、AsposeはAspose.Finance for .NETAPIを提供しています。これは、C#またはVB.NETを使用してプログラムでXBRLインスタンスを作成するのをさらに簡単にする.NETクラスライブラリです。さらに、.NETアプリケーション内のXBRLまたはiXBRLファイルを解析および検証できます。 Aspose.Finance for .NETは、この記事で学習する次のXBRL/iXBRL操作機能を提供します。

Aspose.Finance for .NETは、NuGetまたはダウンロードそのDLLからインストールして、プロジェクトで手動で参照できます。

C#で最初からXBRLインスタンスを作成する

Aspose.Finance for .NETを使用すると、XBRLインスタンスを最初から簡単に作成できます。新しく作成されたXBRLインスタンスに、スキーマ参照、コンテキスト、ユニット、アイテム、脚注リンク、役割参照、およびアーク役割参照を追加することもできます。 XBRLインスタンスを作成する手順は次のとおりです。

次のコードサンプルは、C#でXBRLインスタンスを作成する方法を示しています。

XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");

XBRLのインスタンスを作成したら、次の記事で説明するオブジェクトをインスタンスに挿入できます。

XBRLまたはiXBRLファイルをC#で解析する

Aspose.Finance for .NETは、XBRLファイルを解析し、数行のコード内でそれらのコンテンツを取得する簡単な方法を提供します。次のセクションには、XBRLファイルとiXBRLファイルを解析する方法の手順とコードサンプルが含まれています。

XBRLファイルをC#で解析する

以下は、Aspose.Financefor.NETを使用してXBRLファイルを解析する手順です。

  • XbrlDocumentクラスのインスタンスを作成し、XBRLファイルのパスで初期化します。
  • XbrlDocument.XbrlInstancesプロパティを使用して、XBRL内のインスタンスをXbrlInstanceCollectionオブジェクトに取得します。
  • XbrlInstanceクラスを使用して、コレクションから目的のXBRLインスタンスにアクセスします。
  • XBRLインスタンスのコンテンツを解析します。

次のコードサンプルは、C#でXBRLファイルを解析する方法を示しています。

XbrlDocument document = new XbrlDocument(XbrlFilePath + @"IdScopeContextPeriodStartAfterEnd.xml");
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[0];
List<Fact> facts = xbrlInstance.Facts;
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
List<Context> contexts = xbrlInstance.Contexts;
List<Unit> units = xbrlInstance.Units;

C#でiXBRLファイルを解析する

iXBRLファイルの解析は比較的簡単で、次の手順を使用して実行できます。

  • InlineXbrlDocumentクラスのオブジェクトを作成し、iXBRLファイルのパスで初期化します。
  • InlineXbrlDocumentオブジェクト、つまりInlineXbrlDocument.Factsなどを使用してファイルのコンテンツにアクセスします。

次のコードサンプルは、C#でiXBRLファイルを解析して読み取る方法を示しています。

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;

C#でXBRLまたはiXBRLファイルを検証する

XBRLファイルとiXBRLファイルは、それぞれXBRL仕様とiXBRL仕様の検証ルールに準拠している必要があります。仕様ルールに従わないと、ファイルが無効になる場合があります。 Aspose.Finance for .NETでは、エラーを見つけるためにXBRLまたはiXBRLファイルを検証することもできます。次のセクションでは、XBRLおよびiXBRLファイルを検証する方法を示します。

C#でXBRLファイルを検証する

XBRLファイルを検証する手順は次のとおりです。

次のコードサンプルは、C#でXBRLファイルを検証する方法を示しています。

XbrlDocument document = new XbrlDocument(XbrlFilePath + @"IdScopeContextPeriodStartAfterEnd.xml");
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[0];
xbrlInstance.Validate();
if(xbrlInstance.ValidationErrors.Count > 0)
{
    List<ValidationError> validationErrors = xbrlInstance.ValidationErrors;
}

C#でiXBRLファイルを検証する

以下の手順は、インラインXBRLファイルを検証するために使用されます。

次のコードサンプルは、C#でiXBRLファイルを検証する方法を示しています。

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
    List<ValidationError> validationErrors = document.ValidationErrors;
}

検証エラーコードとエラーメッセージの詳細については、こちらをご覧ください。

APIを探索する

次のリソースから、XBRLおよびiXBRLファイルを作成、解析、および検証する方法について詳しく知ることができます。

Aspose.Financefor.NETを無料でお試しください

Asposeは、APIを無料で評価するための一時ライセンスを提供しています。リクエストを投稿して一時ライセンスを取得することもできます。

関連項目