Tambahkan Objek ke Dokumen XBRL menggunakan C#

XBRL (eXtensible Business Reporting Language) mendefinisikan dan bertukar informasi keuangan, seperti laporan keuangan. Dokumen contoh XBRL adalah kumpulan fakta yang bersama-sama membentuk laporan bisnis. Kita dapat dengan mudah membuat dokumen instance XBRL secara terprogram dan menambahkan objek atau elemen seperti referensi skema, konteks, unit, item, dll. Pada artikel ini, kita akan mempelajari cara menambahkan objek ke dokumen instance XBRL menggunakan C#.

Topik-topik berikut akan dibahas dalam artikel ini:

C# API untuk Menambahkan Objek ke Dokumen Instance XBRL

Untuk membuat dokumen instance XBRL dan menambahkan objek, kita akan menggunakan API Aspose.Finance for .NET. Ini memungkinkan pembuatan instance XBRL, parsing, dan memvalidasi file XBRL atau iXBRL. Harap unduh DLL API atau instal menggunakan NuGet.

PM> Install-Package Aspose.Finance

Tambahkan Referensi Skema ke XBRL menggunakan C#

Kami dapat menambahkan referensi skema dalam dokumen contoh XBRL dengan mengikuti langkah-langkah berikut:

  1. Pertama, buat instance dari kelas XbrlDocument.
  2. Selanjutnya, dapatkan koleksi instance objek XbrlDocument ke dalam objek XbrlInstanceCollection.
  3. Kemudian, tambahkan instance XBRL baru menggunakan metode XbrlInstanceCollection.Add().
  4. Selanjutnya, dapatkan koleksi referensi skema objek XbrlInstance ke objek SchemaRefCollection.
  5. Setelah itu, tambahkan referensi skema baru menggunakan metode SchemaRefCollection.Add().
  6. Terakhir, simpan file XBRL menggunakan metode XbrlDocument.Save(). Dibutuhkan jalur file keluaran sebagai argumen.

Contoh kode berikut menunjukkan cara menambahkan referensi skema dalam dokumen contoh XBRL menggunakan C#.

// Contoh kode ini menunjukkan cara menambahkan objek SchemaReference ke XBRL.
// Buat instance kelas XbrlDocument
XbrlDocument document = new XbrlDocument();

// Dapatkan XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;

// Tambahkan XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];

// Dapatkan koleksi referensi Skema
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;

// Tambahkan referensi Skema
schemaRefs.Add(@"D:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");

// Simpan file keluaran
document.Save(@"D:\Files\Finance\output.xbrl");

Tambahkan Objek Konteks di XBRL menggunakan CSharp

Kami dapat menambahkan konteks ke dokumen contoh XBRL dengan mengikuti langkah-langkah yang diberikan di bawah ini:

  1. Pertama, buat instance dari kelas XbrlDocument.
  2. Selanjutnya, dapatkan koleksi instance objek XbrlDocument ke dalam objek XbrlInstanceCollection.
  3. Kemudian, tambahkan instance XBRL baru menggunakan metode XbrlInstanceCollection.Add().
  4. Selanjutnya, buat instance dari kelas ContextPeriod dengan tanggal mulai dan berakhir.
  5. Kemudian, buat ContextEntity dan berikan skema dan pengenal.
  6. Selanjutnya, buat instance dari kelas Context dengan ContextPeriod dan ContextEntity yang ditentukan.
  7. Setelah itu, tambahkan objek Konteks ke koleksi Objek konteks.
  8. Terakhir, simpan file XBRL menggunakan metode XbrlDocument.Save(). Dibutuhkan jalur file keluaran sebagai argumen.

Contoh kode berikut menunjukkan cara menambahkan objek konteks dalam dokumen contoh XBRL menggunakan C#.

// Contoh kode ini menunjukkan cara menambahkan objek Konteks ke XBRL.
// Buat instance kelas XbrlDocument
XbrlDocument document = new XbrlDocument();

// Dapatkan XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;

// Tambahkan XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];

// Tentukan periode konteks
ContextPeriod contextPeriod = new ContextPeriod(DateTime.Parse("2020-01-01"), DateTime.Parse("2020-02-10"));

// Entri konteks Cretae
ContextEntity contextEntity = new ContextEntity("exampleIdentifierScheme", "exampleIdentifier");

// Buat konteks
Context context = new Context(contextPeriod, contextEntity);

// Tambahkan konteks
xbrlInstance.Contexts.Add(context);

// Simpan file keluaran
document.Save(@"D:\Files\Finance\Output.xbrl");

Buat Unit di XBRL menggunakan C#

Satuan dalam XBRL mengukur Item numerik. Kita dapat menambahkan unit dalam dokumen instance XBRL dengan mengikuti langkah-langkah berikut:

  1. Pertama, buat instance dari kelas XbrlDocument.
  2. Selanjutnya, dapatkan koleksi instance objek XbrlDocument ke dalam objek XbrlInstanceCollection.
  3. Kemudian, tambahkan instance XBRL baru menggunakan metode XbrlInstanceCollection.Add().
  4. Selanjutnya, buat instance dari kelas Unit dengan UnitType sebagai Ukuran.
  5. Kemudian, tambahkan QualifiedName ke koleksi MeasureQualifiedNames.
  6. Setelah itu, tambahkan Unit ke koleksi Objek Unit.
  7. Terakhir, simpan file XBRL menggunakan metode XbrlDocument.Save(). Dibutuhkan jalur file keluaran sebagai argumen.

Contoh kode berikut menunjukkan cara menambahkan objek unit dalam dokumen contoh XBRL menggunakan C#.

// Contoh kode ini menunjukkan cara menambahkan objek Unit ke XBRL.
// Buat instance kelas XbrlDocument
XbrlDocument document = new XbrlDocument();

// Dapatkan XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;

// Tambahkan XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];

// Tentukan Satuan
Unit unit = new Unit(UnitType.Measure);

// Tambahkan nama kualifikasi
unit.MeasureQualifiedNames.Add(new QualifiedName("USD", "iso4217", "http://www.xbrl.org/2003/iso4217"));

// Tambahkan satuan
xbrlInstance.Units.Add(unit);

// Simpan file keluaran
document.Save(@"D:\Files\Finance\Output.xbrl");

Tambahkan Objek Fakta di XBRL menggunakan C#

Fakta dalam XBRL didefinisikan menggunakan elemen item. Item dalam XBRL berisi nilai fakta sederhana dan referensi ke konteks untuk menafsirkan fakta itu dengan benar. Kami dapat menambahkan item dalam dokumen contoh XBRL dengan mengikuti langkah-langkah berikut:

  1. Pertama, buat instance dari kelas XbrlDocument.
  2. Tambahkan instance XBRL baru ke instance objek XbrlDocument.
  3. Tambahkan referensi skema baru ke referensi skema objek XbrlInstance.
  4. Dapatkan SchemaRef berdasarkan indeksnya dari SchemaRefCollection.
  5. Inisialisasi instance Context dan tambahkan ke koleksi objek Konteks.
  6. Tentukan turunan Unit dan tambahkan ke koleksi Objek unit.
  7. Buat instance kelas Concept menggunakan metode SchemaRef.GetConceptByName().
  8. Buat instance dari kelas Item dengan objek Konsep sebagai argumen.
  9. Tetapkan properti item seperti ContextRef, UnitRef, Precision, Value, dll.
  10. Setelah itu, tambahkan Item ke koleksi Objek Fakta.
  11. Terakhir, simpan file XBRL menggunakan metode XbrlDocument.Save(). Dibutuhkan jalur file keluaran sebagai argumen.

Contoh kode berikut menunjukkan cara menambahkan fakta sebagai elemen item dalam dokumen contoh XBRL menggunakan C#.

// Contoh kode ini menunjukkan cara menambahkan objek item Fakta ke XBRL.
// Buat XbrlDocument
XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];

// Tentukan referensi Skema
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"D:\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);
xbrlInstance.Contexts.Add(context);

// Tentukan Satuan
Unit unit = new Unit(UnitType.Measure);
unit.MeasureQualifiedNames.Add(new QualifiedName("USD", "iso4217", "http://www.xbrl.org/2003/iso4217"));
xbrlInstance.Units.Add(unit);

// Dapatkan konsep
Concept fixedAssetsConcept = schema.GetConceptByName("fixedAssets");
if (fixedAssetsConcept != null)
{
    // Tentukan elemen Item untuk fakta
    Item item = new Item(fixedAssetsConcept);
    item.ContextRef = context;
    item.UnitRef = unit;
    item.Precision = 4;
    item.Value = "1444";
    
    // Tambahkan elemen item ke fakta
    xbrlInstance.Facts.Add(item);
}

// Simpan file keluaran
document.Save(@"D:\Files\Finance\Output.xbrl");

Dapatkan Lisensi Gratis

Anda bisa mendapatkan lisensi sementara gratis untuk mencoba perpustakaan tanpa batasan evaluasi.

Kesimpulan

Pada artikel ini, kita telah mempelajari cara membuat dokumen XBRL menggunakan C#. Kami juga telah melihat cara menambahkan berbagai objek XBRL ke dokumen contoh XBRL yang dibuat secara terprogram. 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.

Lihat juga