Trong bài trước, chúng ta đã học cách thêm đối tượng tham chiếu lược đồ, ngữ cảnh, đơn vị và dữ kiện vào tài liệu cá thể XBRL bằng cách sử dụng C#. Trong bài viết này, chúng ta sẽ tìm hiểu cách thêm liên kết chú thích cuối trang và đối tượng tham chiếu vai trò vào XBRL bằng cách sử dụng C#.
Các chủ đề sau sẽ được đề cập trong bài viết này:
- API C# để thêm liên kết chú thích cuối trang và đối tượng tham chiếu vai trò vào XBRL
- Thêm liên kết chú thích cuối trang vào XBRL
- Thêm đối tượng tham chiếu vai trò vào XBRL
- Đối tượng tham chiếu vai trò Arc trong XBRL
API C# để thêm liên kết chú thích cuối trang và đối tượng tham chiếu vai trò vào XBRL
Để thêm các đối tượng tham chiếu vai trò và tham chiếu vai trò cung vào tài liệu phiên bản XBRL, chúng tôi sẽ sử dụng API Aspose.Finance cho .NET. Nó cho phép tạo các phiên bản XBRL, phân tích cú pháp và xác thực các tệp XBRL hoặc iXBRL. Lớp XbrlDocument của API đại diện cho một tài liệu XBRL có chứa một hoặc nhiều trường hợp XBRL. Một phiên bản XBRL là một phân đoạn XML, với phần tử gốc có thẻ XBRL. Lớp XbrlInstance cung cấp các phương thức và thuộc tính khác nhau để làm việc với cá thể XBRL. Lớp FootnoteLink chứa các trình định vị, tài nguyên và cung để mô tả mối quan hệ giữa các dữ kiện trong một Phiên bản XBRL. API cung cấp lớp RoleReference cho phép tham chiếu các định nghĩa của bất kỳ giá trị thuộc tính vai trò tùy chỉnh nào được sử dụng trong các liên kết chú thích cuối trang trong phiên bản XBRL. Tương tự, lớp ArcRoleReference cho phép phân giải các giá trị vai trò vòng cung tùy chỉnh được sử dụng trong cơ sở Liên kết hoặc Phiên bản XBRL.
Vui lòng tải xuống DLL của API hoặc cài đặt nó bằng NuGet.
PM> Install-Package Aspose.Finance
Thêm các liên kết chú thích vào XBRL bằng C#
Chúng tôi có thể thêm liên kết chú thích cuối trang trong tài liệu phiên bản XBRL bằng cách làm theo các bước được cung cấp bên dưới:
- Đầu tiên, tạo một phiên bản của lớp XbrlDocument.
- Thêm một phiên bản XBRL mới vào các phiên bản của đối tượng XbrlDocument.
- Thêm một tham chiếu lược đồ mới vào các tham chiếu lược đồ của đối tượng XbrlInstance.
- Lấy SchemaRef theo chỉ mục của nó từ SchemaRefCollection.
- Khởi tạo thể hiện Context và thêm nó vào tập hợp Context objects.
- Xác định một phiên bản Footnote và đặt nhãn và văn bản của nó.
- Khởi tạo kiểu Định vị bằng cách sử dụng cá thể lớp Loc.
- Xác định FootnoteArc với nhãn Định vị và nhãn Footnote làm đối số.
- Tạo một thể hiện của lớp FootnoteLink.
- Thêm Footnote, Locator và FootnoteArc vào các bộ sưu tập FootnoteLink có liên quan.
- Sau đó, thêm FootnoteLink vào bộ sưu tập FootnoteLinks.
- Cuối cùng, lưu tệp XBRL bằng phương thức XbrlDocument.Save(). Nó lấy đường dẫn tệp đầu ra làm đối số.
Mẫu mã sau đây cho thấy cách thêm liên kết chú thích cuối trang trong tài liệu phiên bản XBRL bằng cách sử dụng C#.
// Tạo một phiên bản của lớp XbrlDocument
XbrlDocument document = new XbrlDocument();
// Nhận XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
// Thêm XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];
// Xác định tham chiếu lược đồ
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"C:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");
SchemaRef schema = schemaRefs[0];
// Xác định ngữ cảnh
ContextPeriod contextPeriod = new ContextPeriod(DateTime.Parse("2020-01-01"), DateTime.Parse("2020-02-10"));
ContextEntity contextEntity = new ContextEntity("exampleIdentifierScheme", "exampleIdentifier");
Context context = new Context(contextPeriod, contextEntity);
context.Id = "cd1";
xbrlInstance.Contexts.Add(context);
// Xác định chú thích cuối trang
Footnote footnote = new Footnote("footnote1");
footnote.Text = "Including the effects of the merger.";
// Xác định bộ định vị
Loc loc = new Loc("#cd1", "fact1");
// Xác định chú thích cuối trangArc
FootnoteArc footnoteArc = new FootnoteArc(loc.Label, footnote.Label);
// Xác định chú thích cuối trang link
FootnoteLink footnoteLink = new FootnoteLink();
footnoteLink.Footnotes.Add(footnote);
footnoteLink.Locators.Add(loc);
footnoteLink.FootnoteArcs.Add(footnoteArc);
xbrlInstance.FootnoteLinks.Add(footnoteLink);
// Lưu tài liệu
document.Save(@"C:\Files\Finance\document6.xbrl");
Thêm đối tượng tham chiếu vai trò vào XBRL bằng C#
Chúng tôi có thể thêm tham chiếu Vai trò trong tài liệu phiên bản XBRL bằng cách thực hiện theo các bước dưới đây:
- Đầu tiên, tạo một phiên bản của lớp XbrlDocument.
- Tiếp theo, thêm một thể hiện XBRL mới vào các thể hiện của đối tượng XbrlDocument.
- Sau đó, thêm một tham chiếu lược đồ mới vào các tham chiếu lược đồ của đối tượng XbrlInstance.
- Nhận SchemaRef theo chỉ mục của nó từ SchemaRefCollection.
- Tiếp theo, lấy RoleType từ phương thức GetRoleTypeByURI().
- Sau đó, tạo một thể hiện của lớp RoleReference với đối tượng RoleType làm đối số.
- Sau đó, thêm RoleReference vào bộ sưu tập các đối tượng RoleReference.
- Cuối cùng, lưu tệp XBRL bằng phương thức XbrlDocument.Save(). Nó lấy đường dẫn tệp đầu ra làm đối số.
Mẫu mã sau đây cho thấy cách thêm tham chiếu vai trò trong tài liệu phiên bản XBRL bằng cách sử dụng C#.
// Tạo một phiên bản của lớp XbrlDocument
XbrlDocument document = new XbrlDocument();
// Nhận XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
// Thêm XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];
// Xác định tham chiếu lược đồ
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"C:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");
SchemaRef schema = schemaRefs[0];
// Thêm tham chiếu vai trò
RoleType roleType = schema.GetRoleTypeByURI("http://abc.com/role/link1");
if (roleType != null)
{
RoleReference roleReference = new RoleReference(roleType);
xbrlInstance.RoleReferences.Add(roleReference);
}
// Lưu tài liệu
document.Save(@"C:\Files\Finance\document7.xbrl");
Thêm đối tượng tham chiếu vai trò Arc vào XBRL bằng C#
Chúng tôi có thể thêm tham chiếu vai trò Arc trong tài liệu phiên bản XBRL bằng cách làm theo các bước được đưa ra bên dưới:
- Đầu tiên, tạo một phiên bản của lớp XbrlDocument.
- Tiếp theo, thêm một thể hiện XBRL mới vào các thể hiện của đối tượng XbrlDocument.
- Sau đó, thêm một tham chiếu lược đồ mới vào các tham chiếu lược đồ của đối tượng XbrlInstance.
- Tiếp theo, lấy SchemaRef theo chỉ mục của nó từ SchemaRefCollection.
- Sau đó, lấy ArcRoleType từ phương thức GetArcroleTypeByURI().
- Tiếp theo, tạo một thể hiện của lớp ArcRoleReference với đối tượng ArcRoleType làm đối số.
- Sau đó, thêm ArcRoleReference vào bộ sưu tập các đối tượng ArcRoleReference.
- Cuối cùng, lưu tệp XBRL bằng phương thức XbrlDocument.Save(). Nó lấy đường dẫn tệp đầu ra làm đối số.
Mẫu mã sau đây cho thấy cách thêm tham chiếu vai trò cung trong tài liệu phiên bản XBRL bằng cách sử dụng C#.
// Tạo một phiên bản của lớp XbrlDocument
XbrlDocument document = new XbrlDocument();
// Nhận XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
// Thêm XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];
// Xác định tham chiếu lược đồ
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"C:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");
SchemaRef schema = schemaRefs[0];
// Thêm tham chiếu vai trò Arc
ArcroleType arcroleType = schema.GetArcroleTypeByURI("http://abc.com/arcrole/footnote-test");
if (arcroleType != null)
{
ArcroleReference arcroleReference = new ArcroleReference(arcroleType);
xbrlInstance.ArcroleReferences.Add(arcroleReference);
}
// Lưu tài liệu
document.Save(@"C:\Files\Finance\document8.xbrl");
Nhận giấy phép miễn phí
Bạn có thể nhận giấy phép tạm thời miễn phí để dùng thử thư viện mà không có giới hạn đánh giá.
Sự kết luận
Trong bài viết này, chúng tôi đã học cách:
- tạo tài liệu XBRL bằng C#;
- thêm chú thích cuối trang và vòng cung chú thích bằng cách sử dụng liên kết chú thích cuối trang tới các đối tượng XBRL theo chương trình;
- thêm tham chiếu vai trò và vòng cung trong XBRL trong C#.
Bên cạnh đó, bạn có thể tìm hiểu thêm về Aspose.Finance cho .NET API bằng cách sử dụng tài liệu. Trong trường hợp có bất kỳ sự mơ hồ nào, vui lòng liên hệ với chúng tôi trên diễn đàn.