XBRL مخفف XML Based Business Reporting Language است. این به سادگی طرحی است که به شرکت ها کمک می کند تا داده های خود را سازماندهی کنند تا بتوانند اطلاعات را بین بخش های مختلف شرکت خود به اشتراک بگذارند. اسناد XBRL و Inline XBRL (iXBRL) گزارش‌های کسب‌وکار الکترونیکی ساختاریافته‌ای هستند که نیازهای مختلف تجاری را برآورده می‌کنند. این فقط نوع دیگری از اسناد تجاری خسته کننده نیست - اسناد XBRL حاوی ساختار، فرمت و ویژگی های خاصی است که می تواند برای تأیید اسناد مالی مورد استفاده قرار گیرد. ما به راحتی می توانیم یک سند نمونه XBRL یا iXBRL را به صورت برنامه نویسی تایید کنیم. در این مقاله نحوه اعتبارسنجی سند XBRL در پایتون را یاد خواهیم گرفت.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
Python XBRL Validator API برای اعتبارسنجی سند XBRL
برای تأیید اعتبار یک فایل XBRL یا سند نمونه، از API Aspose.Finance for Python استفاده خواهیم کرد. این امکان ایجاد نمونه های XBRL، تجزیه و اعتبارسنجی فایل های XBRL یا iXBRL را فراهم می کند.
API کلاس XbrlDocument را ارائه می‌کند که یک سند XBRL حاوی یک یا چند نمونه XBRL را نشان می‌دهد. یک نمونه XBRL یک قطعه XML است که عنصر ریشه دارای یک تگ XBRL است. کلاس XbrlInstance روش ها و ویژگی های مختلفی را برای کار با نمونه های XBRL ارائه می دهد. متد validate() این کلاس نمونه XBRL انتخاب شده را تایید می کند. ما کلاس InlineXbrlDocument از API را داریم که نشان دهنده یک سند XBRL درون خطی است. علاوه بر این، شمارش ValidationErrorCode API تمام کدهای خطای اعتبارسنجی و پیام خطای مربوطه را تعریف می‌کند.
لطفاً یا پکیج را دانلود کنید یا API را از PyPI با استفاده از دستور pip زیر در کنسول نصب کنید:
pip install aspose-finance
اعتبار سنجی سند XBRL در پایتون
با دنبال کردن مراحل زیر می‌توانیم به راحتی یک سند نمونه XBRL را بارگیری و تأیید کنیم:
- ابتدا یک فایل XBRL را با استفاده از کلاس XbrlDocument بارگذاری کنید.
- در مرحله بعد، تمام نمونه ها را با استفاده از xbrlinstances دریافت کنید.
- سپس، به نمونه XBRL مورد نظر از مجموعه دسترسی پیدا کنید.
- پس از آن، متد validate() را برای اعتبارسنجی نمونه XBRL فراخوانی کنید.
- در نهایت، خطاها را در صورت وجود نشان دهید.
نمونه کد زیر نحوه تأیید اعتبار یک نمونه XBRL در پایتون را نشان می دهد.
# این مثال کد نحوه اعتبار سنجی سند نمونه 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 درون خطی در پایتون
ما همچنین می توانیم یک سند iXBRL را با دنبال کردن مراحل زیر تأیید کنیم:
- ابتدا یک فایل iXBRL را با استفاده از کلاس InlineXbrlDocument بارگذاری کنید.
- پس از آن، متد validate() را برای اعتبارسنجی نمونه XBRL فراخوانی کنید.
- در نهایت، خطاها را در صورت وجود نشان دهید.
نمونه کد زیر نحوه اعتبارسنجی یک سند XBRL یا iXBRL درون خطی در پایتون را نشان می دهد.
# این مثال کد نحوه اعتبار سنجی سند 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 در پایتون را یاد گرفتیم. ما همچنین نحوه تأیید اعتبار یک سند XBRL درون خطی را به صورت برنامه‌ریزی دیده‌ایم. علاوه بر این، می‌توانید با استفاده از مستندات درباره Aspose.Finance for Python API اطلاعات بیشتری کسب کنید. در صورت وجود هرگونه ابهامی، لطفاً با ما در [تالار گفتمان پشتیبانی رایگان16 تماس بگیرید.