في المنشور السابق ، تعلمنا كيفية إضافة مرجع مخطط وسياق ووحدة وكائنات واقعية إلى مستندات مثيل XBRL باستخدام C#. في هذه المقالة ، سوف نتعلم كيفية إضافة روابط الحواشي السفلية وكائنات مرجع الأدوار إلى XBRL باستخدام C#.
سيتم تناول الموضوعات التالية في هذه المقالة:
- C# API لإضافة روابط حاشية سفلية وكائنات مرجع الدور إلى XBRL
- أضف ارتباطات حاشية سفلية إلى XBRL
- إضافة كائن مرجع الدور إلى XBRL
- كائن مرجعي لدور القوس في XBRL
C# API لإضافة روابط حاشية سفلية وكائنات مرجع الدور إلى XBRL
لإضافة مرجع الدور وكائنات مرجع دور القوس إلى مستند مثيل XBRL ، سنستخدم Aspose.Finance for .NET API. يسمح بإنشاء مثيلات XBRL والتحليل والتحقق من صحة ملفات XBRL أو iXBRL. فئة XbrlDocument من API تمثل مستند XBRL الذي يحتوي على واحد أو أكثر من مثيلات XBRL. مثيل XBRL هو جزء من XML ، مع العنصر الجذر الذي يحتوي على علامة XBRL. توفر الفئة XbrlInstance أساليب وخصائص متنوعة للعمل مع مثيل XBRL. تحتوي فئة FootnoteLink على محددات مواقع وموارد وأقواس لوصف العلاقات بين الحقائق في مثيل XBRL. توفر واجهة برمجة التطبيقات RoleReference فئة تسمح بالإشارة إلى تعريفات أي قيم سمات دور مخصصة مستخدمة في روابط الحواشي السفلية في مثيل XBRL. وبالمثل ، تتيح فئة ArcRoleReference حل قيم دور القوس المخصصة المستخدمة في قاعدة الارتباط أو مثيل XBRL.
يرجى إما تنزيل DLL الخاصة بواجهة برمجة التطبيقات أو تثبيته باستخدام NuGet.
PM> Install-Package Aspose.Finance
إضافة روابط حاشية سفلية إلى XBRL باستخدام C#
يمكننا إضافة رابط حاشية سفلية في مستند مثيل XBRL باتباع الخطوات الواردة أدناه:
- أولاً ، قم بإنشاء مثيل لفئة XbrlDocument.
- إضافة مثيل XBRL جديد إلى مثيلات الكائن XbrlDocument.
- قم بإضافة مرجع مخطط جديد إلى مراجع مخطط كائن XbrlInstance.
- احصل على SchemaRef بفهرسها من SchemaRefCollection.
- قم بتهيئة مثيل السياق وإضافته إلى مجموعة كائنات السياق.
- عرّف مثيلاً حاشية سفلية وعيّن تسميته ونصه.
- تهيئة نوع محدد المواقع باستخدام مثيل الفئة Loc.
- قم بتعريف FootnoteArc باستخدام تسمية محدد المواقع وتسمية الحاشية السفلية كوسائط.
- قم بإنشاء مثيل لفئة FootnoteLink.
- أضف حاشية سفلية ومحدد موقع وخط حاشية سفلية إلى مجموعات FootnoteLink ذات الصلة.
- بعد ذلك ، أضف FootnoteLink إلى مجموعة FootnoteLinks.
- أخيرًا ، احفظ ملف XBRL باستخدام طريقة XbrlDocument.Save(). يأخذ مسار ملف الإخراج كوسيطة.
يوضح نموذج التعليمات البرمجية التالي كيفية إضافة ارتباط حاشية سفلية في مستند مثيل XBRL باستخدام C#.
// قم بإنشاء مثيل لفئة XbrlDocument
XbrlDocument document = new XbrlDocument();
// احصل على XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
// أضف XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];
// تحديد مرجع المخطط
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"C:\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);
context.Id = "cd1";
xbrlInstance.Contexts.Add(context);
// تعريف الحاشية السفلية
Footnote footnote = new Footnote("footnote1");
footnote.Text = "Including the effects of the merger.";
// تحديد محدد
Loc loc = new Loc("#cd1", "fact1");
// تعريف الحاشية السفليةArc
FootnoteArc footnoteArc = new FootnoteArc(loc.Label, footnote.Label);
// تعريف الحاشية السفلية link
FootnoteLink footnoteLink = new FootnoteLink();
footnoteLink.Footnotes.Add(footnote);
footnoteLink.Locators.Add(loc);
footnoteLink.FootnoteArcs.Add(footnoteArc);
xbrlInstance.FootnoteLinks.Add(footnoteLink);
// احفظ المستند
document.Save(@"C:\Files\Finance\document6.xbrl");
إضافة كائن مرجع الدور إلى XBRL باستخدام C#
يمكننا إضافة مرجع دور في مستند مثيل XBRL باتباع الخطوات الواردة أدناه:
- أولاً ، قم بإنشاء مثيل لفئة XbrlDocument.
- بعد ذلك ، قم بإضافة مثيل XBRL جديد إلى مثيلات كائن XbrlDocument.
- ثم قم بإضافة مرجع مخطط جديد إلى مراجع مخطط كائن XbrlInstance.
- احصل على SchemaRef من خلال فهرسها من SchemaRefCollection.
- بعد ذلك ، احصل على RoleType من طريقة GetRoleTypeByURI().
- بعد ذلك ، قم بإنشاء مثيل للفئة RoleReference باستخدام كائن RoleType كوسيطة.
- بعد ذلك ، أضف دور ريفرينس إلى مجموعة كائنات روليريفيرنس.
- أخيرًا ، احفظ ملف XBRL باستخدام طريقة XbrlDocument.Save(). يأخذ مسار ملف الإخراج كوسيطة.
يُظهر نموذج التعليمات البرمجية التالي كيفية إضافة مرجع دور في مستند مثيل XBRL باستخدام C#.
// قم بإنشاء مثيل لفئة XbrlDocument
XbrlDocument document = new XbrlDocument();
// احصل على XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
// أضف XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];
// تحديد مرجع المخطط
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"C:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");
SchemaRef schema = schemaRefs[0];
// إضافة مرجع الدور
RoleType roleType = schema.GetRoleTypeByURI("http://abc.com/role/link1");
if (roleType != null)
{
RoleReference roleReference = new RoleReference(roleType);
xbrlInstance.RoleReferences.Add(roleReference);
}
// احفظ المستند
document.Save(@"C:\Files\Finance\document7.xbrl");
إضافة كائن مرجعي لدور القوس إلى XBRL باستخدام C#
يمكننا إضافة مرجع دور Arc في مستند مثيل XBRL باتباع الخطوات الواردة أدناه:
- أولاً ، قم بإنشاء مثيل لفئة XbrlDocument.
- بعد ذلك ، قم بإضافة مثيل XBRL جديد إلى مثيلات كائن XbrlDocument.
- ثم قم بإضافة مرجع مخطط جديد إلى مراجع مخطط كائن XbrlInstance.
- بعد ذلك ، احصل على SchemaRef من خلال فهرسها من SchemaRefCollection.
- ثم ، احصل على ArcRoleType من طريقة GetArcroleTypeByURI().
- بعد ذلك ، قم بإنشاء مثيل لفئة ArcRoleReference باستخدام كائن ArcRoleType كوسيطة.
- بعد ذلك ، أضف ArcRoleReference إلى مجموعة كائنات ArcRoleReference.
- أخيرًا ، احفظ ملف XBRL باستخدام طريقة XbrlDocument.Save(). يأخذ مسار ملف الإخراج كوسيطة.
يوضح نموذج التعليمات البرمجية التالي كيفية إضافة مرجع دور القوس في مستند مثيل XBRL باستخدام C#.
// قم بإنشاء مثيل لفئة XbrlDocument
XbrlDocument document = new XbrlDocument();
// احصل على XbrlInstances
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
// أضف XbrlInstance
xbrlInstances.Add();
XbrlInstance xbrlInstance = xbrlInstances[0];
// تحديد مرجع المخطط
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
schemaRefs.Add(@"C:\Files\Finance\schema.xsd", "example", "http://example.com/xbrl/taxonomy");
SchemaRef schema = schemaRefs[0];
// إضافة مرجع دور القوس
ArcroleType arcroleType = schema.GetArcroleTypeByURI("http://abc.com/arcrole/footnote-test");
if (arcroleType != null)
{
ArcroleReference arcroleReference = new ArcroleReference(arcroleType);
xbrlInstance.ArcroleReferences.Add(arcroleReference);
}
// احفظ المستند
document.Save(@"C:\Files\Finance\document8.xbrl");
احصل على رخصة مجانية
يمكنك الحصول على ترخيص مؤقت مجاني لتجربة المكتبة دون قيود التقييم.
استنتاج
في هذه المقالة ، تعلمنا كيفية:
- إنشاء مستند XBRL باستخدام C# ؛
- إضافة حاشية سفلية وقوس حاشية سفلية باستخدام ارتباط الحاشية السفلية لكائنات XBRL برمجيًا ؛
- إضافة مراجع الدور والقوس في XBRL في C#.
بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول Aspose.Finance لـ .NET API باستخدام التوثيق. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.