تبدیل گزارش‌های XBRL به جدول‌های XLSX یک نیاز مکرر برای تحلیل‌گران مالی است که نیاز به دستکاری داده‌ها در اکسل دارند. Aspose.Finance for Python via .NET یک SDK قدرتمند فراهم می‌کند که این تبدیل را ساده می‌سازد. این راهنما شما را از نصب کتابخانه تا بهینه‌سازی عملکرد قدم به قدم راهنمایی می‌کند تا بتوانید به‌صورت قابل اطمینان کتاب‌های کار اکسل را از فایل‌های XBRL یا iXBRL تولید کنید.

مراحل تبدیل XBRL به XLSX در پایتون

  1. نصب SDK: از pip برای افزودن Aspose.Finance به پروژه خود استفاده کنید.
pip install aspose-finance

SDK شامل تمام باینری‌های لازم برای تجزیه XBRL و تولید Excel است.

  1. بارگذاری سند XBRL: یک نمونه XbrlDocument ایجاد کنید و فایل منبع خود را باز کنید.

    from aspose.finance.xbrl import *
    xbrl_doc = XbrlDocument("financial_report.xbrl")
    
  2. پیکربندی گزینه‌های تبدیل: نام‌گذاری شیت‌ها، قالب‌های تاریخ و دقت عددی را در صورت نیاز تنظیم کنید.

    options = SaveOptions()
    options.save_format = SaveFormat.XLSX
    

    تعاریف دقیق گزینه‌ها در مرجع API موجود است.

  3. اجرای تبدیل: متد save() را با گزینه‌های پیکربندی‌شده فراخوانی کنید.

xbrl_doc.save("output_report.xlsx", options)

این متد یک کتاب‌کار Excel کاملاً قالب‌بندی‌شده را در مسیر مشخص‌شده می‌نویسد.

  1. نتیجه را اعتبارسنجی کنید: فایل XLSX تولید شده را در Excel باز کنید یا از کتابخانه‌ای مانند openpyxl برای تأیید یکپارچگی داده‌ها استفاده کنید.

تبدیل XBRL Instance به XLSX - مثال کامل کد

اسکریپت زیر یک تبدیل کامل انتها به انتها را نشان می‌دهد که شامل مدیریت خطا و پاک‌سازی منابع است.

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (sample_report.xbrl, sample_report.xlsx) را به مکان‌های واقعی خود به‌روز کنید، اطمینان حاصل کنید تمام وابستگی‌های مورد نیاز نصب شده‌اند، و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا با تیم پشتیبانی تماس بگیرید.

تبدیل Xbrl به XLSX در پایتون با Aspose.Finance

Aspose.Finance یک موتور پردازش XBRL اختصاصی ارائه می‌دهد که ساختارهای پیچیده طبقه‌بندی مورد استفاده در گزارش‌گری مالی را درک می‌کند. SDK حقایق، زمینه‌ها و واحدها را استخراج می‌کند و سپس آن‌ها را به ردیف‌ها و ستون‌های Excel نگاشت می‌کند در حالی که روابط سلسله‌مراتبی را حفظ می‌نماید. این تبدیل را برای هر دو پرونده‌های نظارتی و تحلیل داخلی قابل اعتماد می‌سازد.

ویژگی‌های Aspose.Finance که برای این کار مهم هستند

  • تفسیر دقیق طبقه‌بندی - US GAAP، IFRS و طبقه‌بندی‌های سفارشی را بدون از دست دادن معنا پردازش می‌کند.
  • تبدیل جریان‌دار - فایل‌های بزرگ XBRL (>100 MB) را با مصرف حافظه کم پردازش می‌کند.
  • خروجی قابل تنظیم - به شما امکان می‌دهد شیت‌ها را تغییر نام دهید، سلول‌ها را قالب‌بندی کنید و فرمول‌ها را مستقیماً از گزینه‌های تبدیل جاسازی کنید.
  • سازگاری چند‑پلتفرمی - بر روی Windows، Linux و macOS با همان API پایتون کار می‌کند.

نصب و راه‌اندازی در پایتون

  1. اطمینان حاصل کنید که Python 3.8 یا نسخه جدیدتر آن نصب شده است.
  2. SDK را با استفاده از دستوری که قبلاً نشان داده شد نصب کنید.
  3. (اختیاری) آخرین بسته باینری را از صفحه دانلود دریافت کنید.
  4. نصب را با وارد کردن کتابخانه همان‌طور که در بالا توضیح داده شد، تأیید کنید.

نتیجه‌گیری

تبدیل XBRL به XLSX در پایتون با استفاده از Aspose.Finance for Python via .NET به سادگی انجام می‌شود. این SDK پردازش طبقه‌بندی، تبدیل جریان‌دار و سفارشی‌سازی گسترده را مدیریت می‌کند و به تحلیل‌گران داده‌های مالی و توسعه‌دهندگان امکان می‌دهد تا به‌سرعت کتاب‌های کار Excel دقیق تولید کنند. به‌خاطر داشته باشید که برای دریافت مجوز مناسب، مجوزهای موقت در صفحه مجوز موقت موجود است و جزئیات مجوزهای کامل می‌تواند در صفحه قیمت‌گذاری بررسی شود. با گام‌ها، کد و نکات بهینه‌سازی ارائه‌شده، آماده‌اید تا تبدیل XBRL به XLSX را در خطوط داده خود ادغام کنید.

ادامه مطلب