aspose.finance

Bài viết này cung cấp thông tin về báo cáo kinh doanh sử dụng tiêu chuẩn XBRL, mục đích của XBRL và cách tự động hóa quy trình tạo báo cáo kinh doanh dựa trên XBRL trong các ứng dụng .NET. Hơn nữa, nó chứa các phương pháp từng bước để phân tích các tệp XBRL và iXBRL và truy xuất dữ liệu theo chương trình bằng C#. Cuối cùng nhưng không kém phần quan trọng, nó cung cấp một số cách đơn giản để xác thực các tệp XBRL và iXBRL bằng C#.

eXtensible Business Reporting Language (XBRL)

XBRL là định dạng tệp và tiêu chuẩn dựa trên XML được sử dụng toàn cầu để báo cáo kinh doanh. Nó giúp các công ty và tổ chức kế toán khác nhau dễ dàng tổ chức, biên soạn và truyền đạt báo cáo tài chính hoặc thông tin/dữ liệu liên quan đến tài chính khác một cách hiệu quả và chính xác. Vì XBRL dựa trên XML (Ngôn ngữ đánh dấu mở rộng), nên nó sử dụng các thẻ để lưu giữ và phân tích cú pháp mọi phần dữ liệu tài chính. iXBRL(XBRL nội tuyến) là một biến thể khác giúp giữ dữ liệu tài chính ở dạng mà con người có thể đọc được và máy có thể đọc được cùng một lúc. Ngược lại với XBRL, iXBRL sử dụng tiêu chuẩn HTML cùng với một số thẻ bổ sung cho các số liệu và câu lệnh.

Các thẻ trong cả hai, XBRL và iXBRL, được phân tích cú pháp bằng phần mềm tương thích với XBRL để truy xuất dữ liệu. Để tự động hóa phân tích cú pháp XBRL, Aspose cung cấp Aspose.Finance for .NET API. Nó là một thư viện lớp .NET giúp tạo các phiên bản XBRL theo chương trình dễ dàng hơn bằng cách sử dụng C# hoặc VB.NET. Ngoài ra, nó cho phép bạn phân tích cú pháp và xác thực các tệp XBRL hoặc iXBRL trong các ứng dụng .NET. Aspose.Finance cho .NET cung cấp các tính năng thao tác XBRL/iXBRL sau mà bạn sẽ tìm hiểu trong bài viết này.

Bạn có thể cài đặt Aspose.Finance cho .NET từ NuGet hoặc download DLL của nó để tham chiếu thủ công trong dự án của bạn.

Tạo phiên bản XBRL từ đầu trong C#

Aspose.Finance dành cho .NET giúp việc tạo phiên bản XBRL từ đầu trở nên đơn giản. Bạn cũng có thể thêm tham chiếu lược đồ, ngữ cảnh, đơn vị, mục, liên kết chú thích cuối trang, tham chiếu vai trò và tham chiếu vai trò vòng cung trong phiên bản XBRL mới được tạo. Sau đây là các bước để tạo phiên bản XBRL:

Mẫu mã sau đây cho biết cách tạo phiên bản XBRL trong C#.

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

Khi bạn đã tạo phiên bản của XBRL, bạn có thể chèn các đối tượng vào nó, điều này sẽ được thảo luận trong các bài viết sau:

Phân tích tệp XBRL hoặc iXBRL trong C#

Aspose.Finance dành cho .NET cung cấp một cách dễ dàng để phân tích cú pháp các tệp XBRL và truy xuất nội dung của chúng trong một vài dòng mã. Các phần sau chứa các bước và mẫu mã về cách phân tích cú pháp các tệp XBRL và iXBRL.

Phân tích tệp XBRL trong C#

Sau đây là các bước để phân tích cú pháp tệp XBRL bằng Aspose.Finance cho .NET.

  • Tạo một thể hiện của lớp XbrlDocument và khởi tạo nó bằng đường dẫn của tệp XBRL.
  • Đưa các phiên bản trong XBRL vào đối tượng XbrlInstanceCollection bằng thuộc tính XbrlDocument.XbrlInstances.
  • Truy cập phiên bản XBRL mong muốn từ bộ sưu tập bằng lớp XbrlInstance.
  • Phân tích cú pháp nội dung của phiên bản XBRL.

Mẫu mã sau đây trình bày cách phân tích tệp XBRL trong C#.

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;

Phân tích tệp iXBRL trong C#

Phân tích cú pháp tệp iXBRL tương đối dễ dàng hơn và có thể được thực hiện bằng các bước sau.

  • Tạo một đối tượng của lớp InlineXbrlDocument và khởi tạo nó bằng đường dẫn của tệp iXBRL.
  • Truy cập nội dung của tệp bằng đối tượng InlineXbrlDocument, tức là InlineXbrlDocument.Facts, v.v.

Mẫu mã sau đây cho biết cách phân tích cú pháp và đọc tệp iXBRL trong C#.

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

Xác thực tệp XBRL hoặc iXBRL trong C#

Các tệp XBRL và iXBRL phải tuân thủ các quy tắc xác thực trong đặc tả XBRL và đặc tả iXBRL tương ứng. Việc không tuân thủ các quy tắc đặc tả có thể làm mất hiệu lực các tệp. Aspose.Finance dành cho .NET cũng cho phép bạn xác thực các tệp XBRL hoặc iXBRL để tìm ra lỗi. Các phần sau đây trình bày cách xác thực các tệp XBRL và iXBRL.

Xác thực tệp XBRL trong C#

Sau đây là các bước để xác thực tệp XBRL:

Mẫu mã sau đây cho biết cách xác thực tệp XBRL trong C#.

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;
}

Xác thực tệp iXBRL trong C#

Các bước dưới đây được sử dụng để xác thực tệp XBRL nội tuyến.

Mẫu mã sau đây cho biết cách xác thực tệp iXBRL trong C#.

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

Tìm hiểu thêm về mã lỗi xác thực và thông báo lỗi từ tại đây.

Khám phá API

Bạn có thể tìm hiểu thêm về cách tạo, phân tích cú pháp và xác thực các tệp XBRL và iXBRL từ tài nguyên sau:

Dùng thử miễn phí Aspose.Finance cho .NET

Aspose cung cấp giấy phép tạm thời để đánh giá các API của mình miễn phí. Bạn cũng có thể đăng yêu cầu của mình và xin giấy phép tạm thời.

Xem thêm