تحقق من صحة XBRL في Python

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

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

  1. Python XBRL Validator API للتحقق من صحة مستند XBRL
  2. التحقق من صحة ملف XBRL
  3. التحقق من صحة ملف XBRL المضمن

Python XBRL Validator API للتحقق من صحة مستند XBRL

للتحقق من صحة ملف XBRL أو مستند مثيل ، سنستخدم Aspose.Finance for Python API. يسمح بإنشاء مثيلات XBRL والتحليل والتحقق من صحة ملفات XBRL أو iXBRL.

يوفر API فئة XbrlDocument التي تمثل مستند XBRL الذي يحتوي على واحد أو أكثر من مثيلات XBRL. مثيل XBRL هو جزء من XML ، مع العنصر الجذر الذي يحتوي على علامة XBRL. توفر فئة XbrlInstance طرقًا وخصائص متنوعة للعمل مع مثيلات XBRL. تقوم طريقة validate() لهذه الفئة بالتحقق من صحة مثيل XBRL المحدد. لدينا فئة InlineXbrlDocument من API التي تمثل مستند XBRL مضمن. علاوة على ذلك ، فإن تعداد ValidationErrorCode الخاص بواجهة برمجة التطبيقات يحدد جميع رموز خطأ التحقق من الصحة ورسالة الخطأ ذات الصلة.

يرجى إما تنزيل الحزمة أو تثبيت API من PyPI باستخدام أمر pip التالي في وحدة التحكم:

pip install aspose-finance

تحقق من صحة مستند XBRL في Python

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

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

يوضح نموذج التعليمات البرمجية التالي كيفية التحقق من صحة مثيل XBRL في Python.

# يوضح مثال التعليمات البرمجية هذا كيفية التحقق من صحة مستند مثيل XBRL.
from aspose.finance.xbrl import XbrlDocument

# المسار إلى مستند الإدخال
inputFile = "C:\Files\sample.xbrl"

# قم بتحميل ملف XBRL
document = XbrlDocument(inputFile)

# احصل على أمثلة
xbrlInstances = document.xbrl_instances

# حدد مثيلًا محددًا
xbrlInstance = xbrlInstances[0]

# تحقق
xbrlInstance.validate()

# إظهار أخطاء التحقق من الصحة إن وجدت
if xbrlInstance.validation_errors.length > 0:
    for validationError in xbrlInstance.validation_errors:
        print(validationError.message)

تحقق من صحة مستند XBRL المضمن في Python

يمكننا أيضًا التحقق من صحة مستند iXBRL باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بتحميل ملف iXBRL باستخدام فئة InlineXbrlDocument.
  2. بعد ذلك ، قم باستدعاء أسلوب validate() للتحقق من صحة مثيل XBRL.
  3. أخيرًا ، اعرض الأخطاء إن وجدت.

يوضح نموذج التعليمات البرمجية التالي كيفية التحقق من صحة مستند XBRL أو iXBRL مضمّن في Python.

# يوضح مثال التعليمات البرمجية هذا كيفية التحقق من صحة مستند Inline XBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument

# المسار إلى مستند الإدخال
inputFile = "C:\Files\sample.html"

# قم بتحميل ملف XBRL
document = InlineXbrlDocument(inputFile)

# تحقق
document.validate();

# إظهار أخطاء التحقق من الصحة إن وجدت
if document.validation_errors.length > 0:
    for validationError in document.validation_errors:
        print(validationError.message)

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

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

استنتاج

في هذه المقالة ، تعلمنا كيفية التحقق من صحة مستند XBRL في Python. لقد رأينا أيضًا كيفية التحقق من صحة مستند XBRL المضمّن برمجيًا. بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول Aspose.Finance for Python API باستخدام التوثيق. في حالة وجود أي غموض ، لا تتردد في الاتصال بنا على منتدى الدعم المجاني.

أنظر أيضا