Di posting sebelumnya, kami belajar cara menambahkan referensi skema, konteks, unit, dan objek fakta ke dokumen instance XBRL menggunakan C#. Pada artikel ini, kita akan mempelajari cara menambahkan tautan catatan kaki dan objek referensi peran ke XBRL menggunakan C#.
Topik-topik berikut akan dibahas dalam artikel ini:
- C# API untuk Menambahkan Tautan Catatan Kaki dan Objek Referensi Peran ke XBRL
- Tambahkan Tautan Catatan Kaki ke XBRL
- Tambahkan Objek Referensi Peran ke XBRL
- Objek Referensi Peran Arc di XBRL
C# API untuk Menambahkan Tautan Catatan Kaki dan Objek Referensi Peran ke XBRL
Untuk menambahkan objek referensi peran dan referensi peran busur ke dokumen instans XBRL, kami akan menggunakan API Aspose.Finance for .NET. Ini memungkinkan pembuatan instance XBRL, parsing, dan memvalidasi file XBRL atau iXBRL. Kelas XbrlDocument API mewakili dokumen XBRL yang berisi satu atau beberapa instance XBRL. Instance XBRL adalah fragmen XML, dengan elemen root memiliki tag XBRL. Kelas XbrlInstance menyediakan berbagai metode dan properti untuk bekerja dengan instance XBRL. Kelas FootnoteLink berisi pencari lokasi, sumber daya, dan busur untuk menjelaskan hubungan antar fakta dalam Instans XBRL. API menyediakan kelas RoleReference yang memungkinkan referensi definisi nilai atribut peran kustom apa pun yang digunakan dalam tautan catatan kaki dalam instance XBRL. Demikian pula, kelas ArcRoleReference memungkinkan penyelesaian nilai peran busur kustom yang digunakan dalam basis Tautan atau Instans XBRL.
Harap unduh DLL API atau instal menggunakan NuGet.
PM> Install-Package Aspose.Finance
Tambahkan Tautan Catatan Kaki ke XBRL menggunakan C#
Kami dapat menambahkan tautan catatan kaki dalam dokumen contoh XBRL dengan mengikuti langkah-langkah berikut:
- Pertama, buat instance kelas XbrlDocument.
- Tambahkan instance XBRL baru ke instance objek XbrlDocument.
- Tambahkan referensi skema baru ke referensi skema objek XbrlInstance.
- Dapatkan SchemaRef berdasarkan indeksnya dari SchemaRefCollection.
- Inisialisasi instance Konteks dan tambahkan ke koleksi Objek konteks.
- Tentukan instance Catatan Kaki dan atur label dan teksnya.
- Inisialisasi tipe Locator menggunakan instance kelas Loc.
- Tentukan FootnoteArc dengan label Locator dan label Footnote sebagai argumen.
- Buat instance dari kelas FootnoteLink.
- Tambahkan Footnote, Locator, dan FootnoteArc ke koleksi FootnoteLink yang relevan.
- Setelah itu, tambahkan FootnoteLink ke koleksi FootnoteLinks.
- Terakhir, simpan file XBRL menggunakan metode XbrlDocument.Save(). Dibutuhkan jalur file keluaran sebagai argumen.
Contoh kode berikut menunjukkan cara menambahkan tautan catatan kaki di dokumen contoh XBRL menggunakan C#.
// Buat instance kelas XbrlDocument
XbrlDocument document = new XbrlDocument();
// Dapatkan XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
// Tambahkan XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];
// Tentukan referensi Skema
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"C:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");
SchemaRef schema = schemaRefs[0];
// Tentukan konteks
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);
// Tentukan Catatan Kaki
Footnote footnote = new Footnote("footnote1");
footnote.Text = "Including the effects of the merger.";
// Tentukan Pencari Lokasi
Loc loc = new Loc("#cd1", "fact1");
// Tentukan Catatan KakiArc
FootnoteArc footnoteArc = new FootnoteArc(loc.Label, footnote.Label);
// Tentukan Catatan Kaki link
FootnoteLink footnoteLink = new FootnoteLink();
footnoteLink.Footnotes.Add(footnote);
footnoteLink.Locators.Add(loc);
footnoteLink.FootnoteArcs.Add(footnoteArc);
xbrlInstance.FootnoteLinks.Add(footnoteLink);
// Simpan dokumen
document.Save(@"C:\Files\Finance\document6.xbrl");
Tambahkan Objek Referensi Peran ke XBRL menggunakan C#
Kita dapat menambahkan referensi Peran dalam dokumen contoh XBRL dengan mengikuti langkah-langkah berikut:
- Pertama, buat instance kelas XbrlDocument.
- Selanjutnya, tambahkan instance XBRL baru ke instance objek XbrlDocument.
- Kemudian, tambahkan referensi skema baru ke referensi skema objek XbrlInstance.
- Dapatkan SchemaRef berdasarkan indeksnya dari SchemaRefCollection.
- Selanjutnya, dapatkan RoleType dari metode GetRoleTypeByURI().
- Kemudian, buat instance kelas RoleReference dengan objek RoleType sebagai argumen.
- Setelah itu, tambahkan RoleReference ke koleksi objek RoleReference.
- Terakhir, simpan file XBRL menggunakan metode XbrlDocument.Save(). Dibutuhkan jalur file keluaran sebagai argumen.
Contoh kode berikut menunjukkan cara menambahkan referensi peran dalam dokumen contoh XBRL menggunakan C#.
// Buat instance kelas XbrlDocument
XbrlDocument document = new XbrlDocument();
// Dapatkan XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
// Tambahkan XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];
// Tentukan referensi Skema
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"C:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");
SchemaRef schema = schemaRefs[0];
// Tambahkan Referensi Peran
RoleType roleType = schema.GetRoleTypeByURI("http://abc.com/role/link1");
if (roleType != null)
{
RoleReference roleReference = new RoleReference(roleType);
xbrlInstance.RoleReferences.Add(roleReference);
}
// Simpan dokumen
document.Save(@"C:\Files\Finance\document7.xbrl");
Menambahkan Objek Referensi Peran Arc ke XBRL menggunakan C#
Kita dapat menambahkan referensi peran Arc dalam dokumen contoh XBRL dengan mengikuti langkah-langkah berikut:
- Pertama, buat instance kelas XbrlDocument.
- Selanjutnya, tambahkan instance XBRL baru ke instance objek XbrlDocument.
- Kemudian, tambahkan referensi skema baru ke referensi skema objek XbrlInstance.
- Selanjutnya, dapatkan SchemaRef dengan indeksnya dari SchemaRefCollection.
- Kemudian, dapatkan ArcRoleType dari metode GetArcroleTypeByURI().
- Selanjutnya, buat instance kelas ArcRoleReference dengan objek ArcRoleType sebagai argumen.
- Setelah itu, tambahkan ArcRoleReference ke koleksi objek ArcRoleReference.
- Terakhir, simpan file XBRL menggunakan metode XbrlDocument.Save(). Dibutuhkan jalur file keluaran sebagai argumen.
Contoh kode berikut menunjukkan cara menambahkan referensi peran busur dalam dokumen contoh XBRL menggunakan C#.
// Buat instance kelas XbrlDocument
XbrlDocument document = new XbrlDocument();
// Dapatkan XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
// Tambahkan XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];
// Tentukan referensi Skema
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"C:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");
SchemaRef schema = schemaRefs[0];
// Tambahkan Referensi Peran Arc
ArcroleType arcroleType = schema.GetArcroleTypeByURI("http://abc.com/arcrole/footnote-test");
if (arcroleType != null)
{
ArcroleReference arcroleReference = new ArcroleReference(arcroleType);
xbrlInstance.ArcroleReferences.Add(arcroleReference);
}
// Simpan dokumen
document.Save(@"C:\Files\Finance\document8.xbrl");
Dapatkan Lisensi Gratis
Anda bisa mendapatkan lisensi sementara gratis untuk mencoba perpustakaan tanpa batasan evaluasi.
Kesimpulan
Dalam artikel ini, kita telah mempelajari cara:
- buat dokumen XBRL menggunakan C#;
- tambahkan busur catatan kaki dan catatan kaki menggunakan tautan catatan kaki ke objek XBRL secara terprogram;
- tambahkan referensi role dan arc role di XBRL di C#.
Selain itu, Anda dapat mempelajari lebih lanjut tentang Aspose.Finance for .NET API menggunakan dokumentasi. Jika ada ambiguitas, jangan ragu untuk menghubungi kami di forum.