فایل های XBRL را در پایتون بخوانید

گزارش های کسب و کار الکترونیکی ساختاریافته از اسناد XBRL و اسناد XBRL درون خطی (iXBRL) تشکیل شده است. در XBRL، گزارش های تجاری مجموعه ای از حقایق هستند. متناوبا، گزارش iXBRL برای انسان قابل خواندن است و حاوی داده های برچسب گذاری شده است. به صورت برنامه نویسی می توانیم اسناد نمونه XBRL یا iXBRL را بخوانیم و ارجاعات طرحواره، زمینه ها، آیتم ها و غیره را بازیابی کنیم. در این مقاله نحوه خواندن فایل های XBRL در پایتون را یاد می گیریم.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

  1. Python XBRL Reader برای خواندن XBRL
  2. فایل XBRL را بخوانید
  3. فایل iXBRL را بخوانید

پایتون XBRL Reader برای خواندن XBRL

برای خواندن فایل‌های XBRL یا اسناد نمونه، از API Aspose.Finance for Python استفاده می‌کنیم. این امکان ایجاد اسناد نمونه XBRL، تجزیه و اعتبارسنجی فایل های XBRL یا iXBRL را فراهم می کند.

API کلاس XbrlDocument را ارائه می‌کند که یک سند XBRL حاوی یک یا چند نمونه XBRL را نشان می‌دهد. کلاس XbrlInstance روش ها و ویژگی های مختلفی را برای کار با نمونه های XBRL ارائه می دهد. ما کلاس InlineXbrlDocument را داریم که نشان دهنده یک سند XBRL درون خطی است.

لطفاً یا پکیج را دانلود کنید یا API را از PyPI با استفاده از دستور pip زیر در کنسول نصب کنید:

pip install aspose-finance

خواندن فایل های XBRL با استفاده از پایتون

با دنبال کردن مراحل زیر می توانیم به راحتی یک سند نمونه XBRL را بارگیری و مطالعه کنیم:

  1. ابتدا یک فایل XBRL را با استفاده از کلاس XbrlDocument بارگذاری کنید.
  2. در مرحله بعد، تمام نمونه ها را با استفاده از xbrlinstances دریافت کنید.
  3. سپس با استفاده از نمایه آن از مجموعه، به نمونه XBRL مورد نظر دسترسی پیدا کنید.
  4. پس از آن، محتوای نمونه XBRL را بخوانید.
  5. در نهایت داده ها/اطلاعات مورد نیاز را نشان دهید.

نمونه کد زیر نحوه خواندن یک فایل XBRL در پایتون را نشان می دهد.

# این نمونه کد نحوه خواندن یک فایل XBRL را نشان می دهد.
from aspose.finance.xbrl import XbrlDocument

# بارگذاری سند XBRL
document = XbrlDocument("C:\\Files\\sample.xbrl")

# دریافت نمونه
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 را با دنبال کردن مراحل زیر بخوانیم:

  1. ابتدا یک فایل iXBRL را با استفاده از کلاس InlineXbrlDocument بارگذاری کنید.
  2. محتوای سند iXBRL را بخوانید.

نمونه کد زیر نحوه خواندن یک فایل iXBRL در پایتون را نشان می دهد.

# این نمونه کد نحوه تجزیه سند iXBRL را نشان می دهد.
from aspose.finance.xbrl.inline import InlineXbrlDocument

# مسیر دایرکتوری اسناد
inputFile = "C:\\Files\\Output.html"

# فایل ورودی را بارگیری کنید
document = InlineXbrlDocument(inputFile)

# تجزیه
inlineFacts = document.facts
contexts = document.contexts
units = document.units

مجوز رایگان دریافت کنید

می‌توانید [یک مجوز موقت رایگان] دریافت کنید11 تا کتابخانه را بدون محدودیت ارزیابی امتحان کنید.

نتیجه

در این مقاله نحوه خواندن فایل های XBRL در پایتون را یاد گرفتیم. ما همچنین نحوه استخراج داده ها از اشیاء نمونه XBRL را به صورت برنامه نویسی دیده ایم. علاوه بر این، می‌توانید درباره Aspose.Finance for Python API با استفاده از documentation اطلاعات بیشتری کسب کنید. در صورت وجود هرگونه ابهام، لطفاً با ما در تالار گفتمان پشتیبانی رایگان تماس بگیرید.

همچنین ببینید