اسناد XBRL و Inline XBRL (iXBRL) گزارش‌های کسب‌وکار الکترونیکی ساختاریافته‌ای هستند که نیازمندی‌های مختلف تجاری را برآورده می‌کنند. یک سند XBRL مجموعه ای از حقایق است که با هم یک گزارش تجاری را تشکیل می دهند. در حالی که گزارش iXBRL یک گزارش قابل خواندن برای انسان است که داده های برچسب گذاری شده در آن تعبیه شده است. ما به راحتی می توانیم یک سند نمونه XBRL یا iXBRL را به صورت برنامه نویسی تجزیه کنیم و اشیا یا عناصری مانند مرجع طرحواره، زمینه، واحد، موارد و غیره را بخوانیم. در پست قبلی، نحوه ایجاد یک سند XBRL را دیدیم. در این مقاله نحوه تجزیه یک سند XBRL در پایتون را خواهیم آموخت.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- کتابخانه مالی پایتون برای تجزیه XBRL
- [فایل XBRL] را تجزیه کنید4
- فایل iXBRL را تجزیه کنید
کتابخانه مالی پایتون برای تجزیه XBRL
برای تجزیه یک فایل XBRL یا سند نمونه، از API Aspose.Finance for Python استفاده خواهیم کرد. این امکان ایجاد نمونه های XBRL، تجزیه و اعتبارسنجی فایل های XBRL یا iXBRL را فراهم می کند.
کلاس XbrlDocument API یک سند XBRL حاوی یک یا چند نمونه XBRL را نشان می دهد. یک نمونه XBRL یک قطعه XML است که عنصر ریشه دارای یک تگ XBRL است. کلاس XbrlInstance روش ها و ویژگی های مختلفی را برای کار با نمونه های XBRL ارائه می دهد. کلاس InlineXbrlDocument API نشان دهنده یک سند XBRL درون خطی است.
لطفاً یا پکیج را دانلود کنید یا API را از PyPI با استفاده از دستور pip زیر در کنسول نصب کنید:
pip install aspose-finance
فایل XBRL را در پایتون تجزیه کنید
با دنبال کردن مراحل زیر می توانیم به راحتی یک سند نمونه XBRL را بارگیری و تجزیه کنیم:
- ابتدا یک فایل XBRL را با استفاده از کلاس XbrlDocument بارگذاری کنید.
- در مرحله بعد، تمام نمونه ها را با استفاده از xbrlinstances دریافت کنید.
- سپس، به نمونه XBRL مورد نظر از مجموعه دسترسی پیدا کنید.
- پس از آن، محتوای نمونه XBRL را تجزیه کنید.
- در نهایت داده ها/اطلاعات مورد نیاز را نشان دهید.
نمونه کد زیر نحوه تجزیه یک نمونه XBRL در پایتون را نشان می دهد.
# این نمونه کد نحوه تجزیه سند XBRL را نشان می دهد.
from aspose.finance.xbrl import XbrlDocument
# مسیر دایرکتوری اسناد
inputFile = "C:\\Files\\Finance\\sample.xbrl"
# XbrlDocument را راه اندازی کنید
document = XbrlDocument(inputFile)
# دریافت نمونه
xbrlInstances = document.xbrl_instances
# نمونه خاصی را انتخاب کنید
xbrlInstance = xbrlInstances[0]
# تجزیه
facts = xbrlInstance.facts
schemaRefs = xbrlInstance.schema_refs
contexts = xbrlInstance.contexts
units = xbrlInstance.units
# نمایش داده ها
if contexts.length > 0:
for x in contexts:
print("id: " + x.id)
print("Entity Identifier : " + x.entity.identifier)
فایل iXBRL را در پایتون تجزیه کنید
ما همچنین می توانیم یک سند iXBRL را با دنبال کردن مراحل زیر تجزیه کنیم:
- ابتدا یک فایل iXBRL را با استفاده از کلاس InlineXbrlDocument بارگذاری کنید.
- محتوای سند iXBRL را تجزیه کنید.
نمونه کد زیر نحوه تجزیه یک iXBRL در پایتون را نشان می دهد.
# این نمونه کد نحوه تجزیه سند iXBRL را نشان می دهد.
from aspose.finance.xbrl.inline import InlineXbrlDocument
# مسیر دایرکتوری اسناد
inputFile = "C:\\Files\\Finance\\Output.html"
# فایل ورودی را بارگیری کنید
document = InlineXbrlDocument(inputFile)
# تجزیه
inlineFacts = document.facts
contexts = document.contexts
units = document.units
مجوز رایگان دریافت کنید
می‌توانید [یک مجوز موقت رایگان] دریافت کنید12 تا کتابخانه را بدون محدودیت ارزیابی امتحان کنید.
نتیجه
در این مقاله نحوه تجزیه یک سند XBRL یا iBXRL در پایتون را یاد گرفتیم. ما همچنین نحوه استخراج داده ها از اشیاء نمونه XBRL را به صورت برنامه نویسی دیده ایم. علاوه بر این، می‌توانید با استفاده از مستندات درباره Aspose.Finance for Python API اطلاعات بیشتری کسب کنید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار گفتمان14 تماس بگیرید.