Artikel ini memberikan informasi tentang pelaporan bisnis menggunakan standar XBRL, tujuan XBRL, dan cara mengotomatiskan proses pembuatan laporan bisnis berbasis XBRL di aplikasi .NET. Selain itu, ini berisi metode langkah demi langkah untuk mem-parsing file XBRL dan iXBRL dan mengambil data secara terprogram menggunakan C#. Last but not least, ini menyediakan beberapa cara sederhana untuk memvalidasi file XBRL dan iXBRL menggunakan C #.
Bahasa Pelaporan Bisnis eXtensible (XBRL)
XBRL adalah standar berbasis XML dan format file yang digunakan secara global untuk pelaporan bisnis. Ini memudahkan berbagai perusahaan dan organisasi akuntansi untuk secara efisien dan akurat mengatur, menyusun, dan mengkomunikasikan laporan keuangan atau informasi/data terkait keuangan lainnya. Karena XBRL didasarkan pada XML (Extensible Markup Language), XBRL menggunakan tag untuk menyimpan dan mengurai setiap data keuangan. iXBRL (XBRL sebaris) adalah varian lain yang memungkinkan untuk menyimpan data keuangan dalam bentuk yang dapat dibaca manusia dan dapat dibaca mesin secara bersamaan. Berbeda dengan XBRL, iXBRL menggunakan standar HTML bersama dengan beberapa tag tambahan untuk angka dan pernyataan.
Tag di keduanya, XBRL dan iXBRL, diurai menggunakan perangkat lunak yang kompatibel dengan XBRL untuk mengambil data. Untuk mengotomatiskan penguraian XBRL, Aspose menawarkan Aspose.Finance for .NET API. Ini adalah pustaka kelas .NET yang membuatnya lebih mudah untuk membuat instance XBRL secara terprogram menggunakan C# atau VB.NET. Selain itu, ini memungkinkan Anda untuk mengurai dan memvalidasi file XBRL atau iXBRL dalam aplikasi .NET. Aspose.Finance for .NET menyediakan fitur manipulasi XBRL/iXBRL berikut yang akan Anda pelajari di artikel ini.
Anda dapat menginstal Aspose.Finance for .NET dari NuGet atau unduh DLL-nya untuk mereferensikannya secara manual di proyek Anda.
Buat Instance XBRL dari Awal di C#
Aspose.Finance for .NET memudahkan pembuatan instans XBRL dari awal. Anda juga dapat menambahkan referensi skema, konteks, unit, item, tautan catatan kaki, referensi peran, dan referensi peran busur dalam instans XBRL yang baru dibuat. Berikut adalah langkah-langkah untuk membuat instance XBRL:
- Buat instance dari kelas XbrlDocument.
- Akses koleksi instance dari objek XbrlDocument ke objek XbrlInstanceCollection.
- Tambahkan instance XBRL baru menggunakan metode XbrlInstanceCollection.Add().
- Simpan file XBRL menggunakan metode XbrlDocument.Save(string).
Contoh kode berikut menunjukkan cara membuat instance XBRL di C#.
XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");
Setelah Anda membuat instance XBRL, Anda dapat menyisipkan objek ke dalamnya yang dibahas dalam artikel berikut:
- Tentukan referensi skema di XBRL
- Tambahkan konteks di XBRL
- Masukkan unit dalam XBRL
- Tambahkan item dalam XBRL
- dan selengkapnya.
Parsing File XBRL atau iXBRL dalam C#
Aspose.Finance for .NET menyediakan cara mudah untuk mem-parsing file XBRL dan mengambil kontennya dalam beberapa baris kode. Bagian berikut berisi langkah-langkah dan contoh kode tentang cara mengurai file XBRL dan iXBRL.
Parsing File XBRL di C#
Berikut adalah langkah-langkah untuk mengurai file XBRL menggunakan Aspose.Finance for .NET.
- Buat instance dari kelas XbrlDocument dan inisialisasi dengan jalur file XBRL.
- Dapatkan instance di XBRL ke objek XbrlInstanceCollection menggunakan properti XbrlDocument.XbrlInstances.
- Akses instance XBRL yang diinginkan dari koleksi menggunakan kelas XbrlInstance.
- Parsing konten instance XBRL.
Contoh kode berikut menunjukkan cara mengurai file XBRL di 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;
Parsing File iXBRL di C
Mem-parsing file iXBRL relatif lebih mudah dan dapat dilakukan dengan menggunakan langkah-langkah berikut.
- Buat objek kelas InlineXbrlDocument dan inisialisasi dengan jalur file iXBRL.
- Akses konten file menggunakan objek InlineXbrlDocument, yaitu InlineXbrlDocument.Facts dll.
Contoh kode berikut menunjukkan cara mengurai dan membaca file iXBRL di C#.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;
Validasi File XBRL atau iXBRL di C#
File XBRL dan iXBRL harus mematuhi aturan validasi dalam spesifikasi XBRL dan spesifikasi iXBRL. Tidak mematuhi aturan spesifikasi dapat membatalkan file. Aspose.Finance for .NET juga memungkinkan Anda memvalidasi file XBRL atau iXBRL untuk mengetahui kesalahannya. Bagian berikut menunjukkan cara memvalidasi file XBRL dan iXBRL.
Validasi File XBRL di C#
Berikut ini adalah langkah-langkah untuk memvalidasi file XBRL:
- Buat instance dari kelas XbrlDocument.
- Akses instance yang akan divalidasi dari XbrlInstanceCollection.
- Validasi instance XBRL menggunakan metode XbrlInstance.Validate().
Contoh kode berikut menunjukkan cara memvalidasi file XBRL di 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;
}
Validasi File iXBRL di C#
Langkah-langkah di bawah ini digunakan untuk memvalidasi file Inline XBRL.
- Buat instance dari kelas InlineXbrlDocument dan inisialisasi dengan jalur file iXBRL.
- Panggil metode InlineXbrlDocument.Validate().
Contoh kode berikut menunjukkan cara memvalidasi file iXBRL di C#.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
List<ValidationError> validationErrors = document.ValidationErrors;
}
Pelajari lebih lanjut tentang kode kesalahan validasi dan pesan kesalahan dari di sini.
Jelajahi API
Anda dapat mempelajari selengkapnya tentang cara membuat, mengurai, dan memvalidasi file XBRL dan iXBRL dari sumber berikut:
Coba Aspose.Finance for .NET Gratis
Aspose menawarkan lisensi sementara untuk mengevaluasi API-nya tanpa biaya. Anda juga dapat memposting permintaan Anda dan mendapatkan lisensi sementara.