التمويل

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

لغة تقارير الأعمال القابلة للتوسيع (XBRL)

XBRL هو تنسيق ملف ومعيار قائم على XML يستخدم عالميًا لإعداد تقارير الأعمال. يسهل على العديد من الشركات والمؤسسات المحاسبية تنظيم البيانات المالية وتجميعها وتوصيلها بكفاءة ودقة أو معلومات / بيانات أخرى متعلقة بالتمويل. نظرًا لأن XBRL يعتمد على XML (لغة التوصيف الموسعة) ، فإنه يستخدم العلامات للاحتفاظ بكل جزء من البيانات المالية وتحليلها. iXBRL(Inline XBRL) هو متغير آخر يجعل من الممكن الاحتفاظ بالبيانات المالية في نموذج يمكن قراءته بواسطة الإنسان وقراءته آليًا في نفس الوقت. على عكس XBRL ، يستخدم iXBRL معيار HTML مع بعض العلامات الإضافية للأشكال والعبارات.

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

يمكنك تثبيت Aspose.Finance for .NET من NuGet أو تحميل DLL الخاص به للرجوع إليه يدويًا في مشروعك.

إنشاء مثيل XBRL من الصفر في C#

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

يُظهر نموذج التعليمات البرمجية التالي كيفية إنشاء مثيل XBRL في C#.

XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");

بمجرد إنشاء مثيل XBRL ، يمكنك إدراج كائنات إليه والتي تمت مناقشتها في المقالات التالية:

تحليل ملفات XBRL أو iXBRL في C#

يوفر Aspose.Finance لـ .NET طريقة سهلة لتحليل ملفات XBRL واسترداد محتوياتها في غضون بضعة أسطر من التعليمات البرمجية. تحتوي الأقسام التالية على الخطوات ونماذج التعليمات البرمجية الخاصة بكيفية تحليل ملفات XBRL و iXBRL.

تحليل ملفات XBRL في C#

فيما يلي خطوات تحليل ملف XBRL باستخدام Aspose.Finance لـ .NET.

  • قم بإنشاء مثيل لفئة XbrlDocument وتهيئته بمسار ملف XBRL.
  • احصل على المثيلات الموجودة في XBRL في كائن XbrlInstanceCollection باستخدام خاصية XbrlDocument.XbrlInstances.
  • الوصول إلى مثيل XBRL المطلوب من المجموعة باستخدام فئة XbrlInstance.
  • تحليل محتوى مثيل XBRL.

يوضح نموذج التعليمات البرمجية التالي كيفية تحليل ملف XBRL في 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;

تحليل ملفات iXBRL في C#

يعد تحليل ملف iXBRL أسهل نسبيًا ويمكن إجراؤه باستخدام الخطوات التالية.

  • قم بإنشاء كائن من فئة InlineXbrlDocument وتهيئته باستخدام مسار ملف iXBRL.
  • قم بالوصول إلى محتوى الملف باستخدام كائن InlineXbrlDocument ، أي InlineXbrlDocument.Facts إلخ.

يُظهر نموذج التعليمات البرمجية التالي كيفية تحليل ملف iXBRL وقراءته في C#.

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;

التحقق من صحة ملفات XBRL أو iXBRL في C#

يجب أن تتوافق ملفات XBRL و iXBRL مع قواعد التحقق من الصحة في مواصفات XBRL و مواصفات iXBRL على التوالي. قد يؤدي مخالفة قواعد المواصفات إلى إبطال الملفات. يتيح لك Aspose.Finance لـ .NET أيضًا التحقق من صحة ملفات XBRL أو iXBRL لاكتشاف الأخطاء. توضح الأقسام التالية كيفية التحقق من صحة ملفات XBRL و iXBRL.

التحقق من صحة ملفات XBRL في C#

فيما يلي خطوات التحقق من صحة ملف XBRL:

يُظهر نموذج التعليمات البرمجية التالي كيفية التحقق من صحة ملف XBRL في 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;
}

التحقق من صحة ملفات iXBRL في C#

يتم استخدام الخطوات أدناه للتحقق من صحة ملف Inline XBRL.

يُظهر نموذج التعليمات البرمجية التالي كيفية التحقق من صحة ملف iXBRL في C#.

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
    List<ValidationError> validationErrors = document.ValidationErrors;
}

تعرف على المزيد حول رموز خطأ التحقق من الصحة ورسائل الخطأ من هنا.

استكشف API

يمكنك معرفة المزيد حول كيفية إنشاء ملفات XBRL و iXBRL وتحليلها والتحقق من صحتها من المورد التالي:

جرب Aspose.Finance لـ .NET مجانًا

تقدم Aspose ترخيصًا مؤقتًا لتقييم واجهات برمجة التطبيقات الخاصة بها مجانًا. يمكنك أيضًا نشر طلبك و الحصول على ترخيص مؤقت.

أنظر أيضا