aspose.財務

本文提供有關使用 XBRL 標準的業務報告、XBRL 的用途以及如何在 .NET 應用程序中自動創建基於 XBRL 的業務報告的過程的信息。此外,它包含分步方法來解析 XBRL 和 iXBRL 文件並使用 C# 以編程方式檢索數據。最後但同樣重要的是,它提供了一些使用 C# 驗證 XBRL 和 iXBRL 文件的簡單方法。

可擴展商業報告語言 (XBRL)

XBRL 是全球使用的基於 XML 的商業報告標準和文件格式。它使各種公司和會計組織更容易高效、準確地組織、編制和傳達財務報表或其他與財務相關的信息/數據。由於 XBRL 基於 XML(可擴展標記語言),它使用標籤來保存和解析每一個財務數據。 iXBRL(內聯 XBRL)是另一種變體,可以同時以人類可讀和機器可讀的形式保存財務數據。與 XBRL 不同,iXBRL 使用 HTML 標準以及一些用於圖形和報表的額外標籤。

XBRL 和 iXBRL 中的標籤都使用與 XBRL 兼容的軟件進行解析以檢索數據。為了自動化 XBRL 解析,Aspose 提供了 Aspose.Finance for .NET API。它是一個 .NET 類庫,可以更輕鬆地使用 C# 或 VB.NET 以編程方式創建 XBRL 實例。此外,它還允許您在 .NET 應用程序中解析和驗證 XBRL 或 iXBRL 文件。 Aspose.Finance for .NET 提供了以下您將在本文中學習的 XBRL/iXBRL 操作功能。

您可以從 NuGet下載 它的 DLL 安裝 Aspose.Finance for .NET 以在您的項目中手動引用它。

在 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 實例後,您可以向其中插入對象,這些將在以下文章中討論:

在 C# 中解析 XBRL 或 iXBRL 文件

Aspose.Finance for .NET 提供了一種簡單的方法來解析 XBRL 文件並在幾行代碼內檢索其內容。以下部分包含如何解析 XBRL 和 iXBRL 文件的步驟和代碼示例。

在 C# 中解析 XBRL 文件

以下是使用 Aspose.Finance for .NET 解析 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 文件相對容易,可以使用以下步驟完成。

以下代碼示例顯示瞭如何在 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.Finance for .NET

Aspose 提供臨時許可證以免費評估其 API。您也可以發布您的請求並獲得臨時許可證

也可以看看