إضافة كائنات إلى مستندات XBRL باستخدام C#

XBRL(لغة تقارير الأعمال الموسعة) يعرف ويتبادل المعلومات المالية ، مثل البيانات المالية. مستند مثيل XBRL عبارة عن مجموعة من الحقائق التي تشكل معًا تقريرًا تجاريًا. يمكننا بسهولة إنشاء مستند مثيل XBRL برمجيًا وإضافة كائنات أو عناصر مثل مرجع المخطط ، والسياق ، والوحدة ، والعناصر ، وما إلى ذلك في هذه المقالة ، سنتعلم كيفية إضافة كائنات إلى مستندات مثيل XBRL باستخدام C#.

سيتم تناول الموضوعات التالية في هذه المقالة:

C# API لإضافة كائنات إلى مستندات مثيل XBRL

لإنشاء مستند مثيل XBRL وإضافة كائنات ، سنستخدم Aspose.Finance for .NET API. يسمح بإنشاء مثيلات XBRL والتحليل والتحقق من صحة ملفات XBRL أو iXBRL. يرجى إما تنزيل DLL الخاصة بواجهة برمجة التطبيقات أو تثبيته باستخدام NuGet.

PM> Install-Package Aspose.Finance

إضافة مرجع مخطط إلى XBRL باستخدام C#

يمكننا إضافة مرجع مخطط في مستند مثيل XBRL باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل للفئة XbrlDocument.
  2. بعد ذلك ، احصل على مجموعة مثيلات كائن XbrlDocument في كائن XbrlInstanceCollection.
  3. ثم قم بإضافة مثيل XBRL جديد باستخدام أسلوب XbrlInstanceCollection.Add().
  4. بعد ذلك ، احصل على مجموعة مرجع مخطط كائن XbrlInstance في كائن SchemaRefCollection.
  5. بعد ذلك ، قم بإضافة مرجع مخطط جديد باستخدام طريقة SchemaRefCollection.Add().
  6. أخيرًا ، احفظ ملف XBRL باستخدام طريقة XbrlDocument.Save(). يأخذ مسار ملف الإخراج كوسيطة.

يُظهر نموذج التعليمات البرمجية التالي كيفية إضافة مرجع مخطط في مستند مثيل XBRL باستخدام C#.

// يوضح مثال التعليمات البرمجية هذا كيفية إضافة كائن SchemaReference إلى XBRL.
// قم بإنشاء مثيل لفئة XbrlDocument
XbrlDocument document = new XbrlDocument();

// احصل على XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;

// أضف XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];

// احصل على مجموعة مراجع المخطط
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;

// أضف مرجع المخطط
schemaRefs.Add(@"D:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");

// احفظ ملف الإخراج
document.Save(@"D:\Files\Finance\output.xbrl");

إضافة كائن سياق في XBRL باستخدام CSharp

يمكننا إضافة سياق إلى مستند مثيل XBRL باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل للفئة XbrlDocument.
  2. بعد ذلك ، احصل على مجموعة مثيلات كائن XbrlDocument في كائن XbrlInstanceCollection.
  3. ثم قم بإضافة مثيل XBRL جديد باستخدام أسلوب XbrlInstanceCollection.Add().
  4. بعد ذلك ، قم بإنشاء مثيل لفئة ContextPeriod مع تاريخي البدء والانتهاء.
  5. ثم قم بإنشاء ContextEntity وقم بتوفير المخطط والمعرف.
  6. بعد ذلك ، قم بإنشاء مثيل لفئة السياق باستخدام ContextPeriod و ContextEntity المحدد.
  7. بعد ذلك ، قم بإضافة كائن السياق إلى مجموعة كائنات السياق.
  8. أخيرًا ، احفظ ملف XBRL باستخدام طريقة XbrlDocument.Save(). يأخذ مسار ملف الإخراج كوسيطة.

يُظهر نموذج التعليمات البرمجية التالي كيفية إضافة كائن سياق في مستند مثيل XBRL باستخدام C#.

// يوضح مثال التعليمات البرمجية هذا كيفية إضافة كائن السياق إلى XBRL.
// قم بإنشاء مثيل لفئة XbrlDocument
XbrlDocument document = new XbrlDocument();

// احصل على XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;

// أضف XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];

// حدد فترة السياق
ContextPeriod contextPeriod = new ContextPeriod(DateTime.Parse("2020-01-01"), DateTime.Parse("2020-02-10"));

// إدخال سياق Cretae
ContextEntity contextEntity = new ContextEntity("exampleIdentifierScheme", "exampleIdentifier");

// خلق السياق
Context context = new Context(contextPeriod, contextEntity);

// أضف السياق
xbrlInstance.Contexts.Add(context);

// احفظ ملف الإخراج
document.Save(@"D:\Files\Finance\Output.xbrl");

إنشاء وحدات في XBRL باستخدام C#

تقيس الوحدات في XBRL العناصر الرقمية. يمكننا إضافة وحدة في مستند مثيل XBRL باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل للفئة XbrlDocument.
  2. بعد ذلك ، احصل على مجموعة مثيلات كائن XbrlDocument في كائن XbrlInstanceCollection.
  3. ثم قم بإضافة مثيل XBRL جديد باستخدام أسلوب XbrlInstanceCollection.Add().
  4. بعد ذلك ، قم بإنشاء مثيل للفئة Unit باستخدام UnitType كمقياس.
  5. ثم أضف QualifiedName إلى مجموعة MeasureQualifiedNames.
  6. بعد ذلك ، أضف الوحدة إلى مجموعة كائنات الوحدة.
  7. أخيرًا ، احفظ ملف XBRL باستخدام طريقة XbrlDocument.Save(). يأخذ مسار ملف الإخراج كوسيطة.

The following code sample shows how to add a unit object in an XBRL instance document using C#.

Add Fact Object in XBRL using C#

Facts in XBRL are defined using item elements. An item in XBRL contains the value of the simple fact and a reference to the context to correctly interpret that fact. We can add an item in an XBRL instance document by following the steps given below:

  1. Firstly, create an instance of the XbrlDocument class.
  2. Add a new XBRL instance to the XbrlDocument object’s instances.
  3. Add a new schema reference to the XbrlInstance object’s schema references.
  4. احصل على SchemaRef من خلال فهرسها من SchemaRefCollection.
  5. قم بتهيئة مثيل السياق وإضافته إلى مجموعة كائنات السياق.
  6. حدد نسخة وحدة وأضفها إلى مجموعة كائنات الوحدة.
  7. قم بإنشاء مثيل فئة Concept باستخدام أسلوب SchemaRef.GetConceptByName().
  8. قم بإنشاء مثيل لفئة Item باستخدام كائن Concept كوسيطة.
  9. قم بتعيين خصائص العنصر مثل ContextRef و UnitRef والدقة والقيمة وما إلى ذلك.
  10. بعد ذلك ، أضف العنصر إلى مجموعة كائنات الحقائق.
  11. أخيرًا ، احفظ ملف XBRL باستخدام طريقة XbrlDocument.Save(). يأخذ مسار ملف الإخراج كوسيطة.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة حقيقة كعنصر عنصر في مستند مثيل XBRL باستخدام C#.

// يوضح مثال التعليمات البرمجية هذا كيفية إضافة كائن عنصر Fact إلى XBRL.
// قم بإنشاء XbrlDocument
XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];

// تحديد مرجع المخطط
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"D:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");
SchemaRef schema = schemaRefs[0];

// حدد السياق
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);

// تحديد الوحدة
Unit unit = new Unit(UnitType.Measure);
unit.MeasureQualifiedNames.Add(new QualifiedName("USD", "iso4217", "http://www.xbrl.org/2003/iso4217"));
xbrlInstance.Units.Add(unit);

// احصل على المفهوم
Concept fixedAssetsConcept = schema.GetConceptByName("fixedAssets");
if (fixedAssetsConcept != null)
{
    // تحديد عنصر العنصر للحقيقة
    Item item = new Item(fixedAssetsConcept);
    item.ContextRef = context;
    item.UnitRef = unit;
    item.Precision = 4;
    item.Value = "1444";
    
    // أضف عنصر العنصر إلى الحقائق
    xbrlInstance.Facts.Add(item);
}

// احفظ ملف الإخراج
document.Save(@"D:\Files\Finance\Output.xbrl");

احصل على رخصة مجانية

يمكنك الحصول على ترخيص مؤقت مجاني لتجربة المكتبة دون قيود التقييم.

استنتاج

في هذه المقالة ، تعلمنا كيفية إنشاء مستند XBRL باستخدام C#. لقد رأينا أيضًا كيفية إضافة كائنات XBRL المختلفة إلى مستند مثيل XBRL الذي تم إنشاؤه برمجيًا. علاوة على ذلك ، يمكنك معرفة المزيد حول Aspose.Finance لـ .NET API باستخدام التوثيق. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا