چگونه فایل‌های پیوست‌شده از OneNote را در Python ذخیره کنیم

فایل‌های OneNote .one می‌توانند پیوست‌های فایل تعبیه‌شده داشته باشند: هر نوع فایلی که با استفاده از Insert → File Attachment در OneNote به یک صفحه اضافه شده باشد. Aspose.Note FOSS برای Python این موارد را از طریق کلاس AttachedFile در دسترس قرار می‌دهد که نام فایل اصلی و بایت‌های خام فایل تعبیه‌شده را فراهم می‌کند.

پیش‌نیازها

pip install aspose-note

مرحله ۱: بارگذاری سند

from aspose.note import Document

doc = Document("MyNotes.one")

مرحله ۲: یافتن تمام فایل‌های پیوست شده

از GetChildNodes(AttachedFile) برای جمع‌آوری بازگشتی تمام پیوست‌ها در سند استفاده کنید، بدون توجه به این‌که در کدام صفحه یا طرح‌واره ظاهر می‌شوند:

from aspose.note import Document, AttachedFile

doc = Document("MyNotes.one")
attachments = doc.GetChildNodes(AttachedFile)
print(f"Found {len(attachments)} attachment(s)")

مرحله 3: ذخیرهٔ هر پیوست به دیسک

برای دسترسی به محتوای خام فایل af.Bytes و برای نام اصلی af.FileName استفاده کنید. همیشه در برابر نام فایل None مراقب باشید: کتابخانه None را برمی‌گرداند وقتی که فراداده نام فایل در فایل ذخیره نشده باشد:

from aspose.note import Document, AttachedFile

doc = Document("MyNotes.one")

for i, af in enumerate(doc.GetChildNodes(AttachedFile), start=1):
    name = af.FileName or f"attachment_{i}.bin"
    with open(name, "wb") as f:
        f.write(af.Bytes)
    print(f"Saved: {name} ({len(af.Bytes):,} bytes)")

مثال کامل

این اسکریپت تمام پیوست‌ها را از یک فایل .one استخراج می‌کند و آن‌ها را در یک پوشه خروجی اختصاصی ذخیره می‌نماید:

from pathlib import Path
from aspose.note import Document, AttachedFile

def save_all_attachments(one_path: str, out_dir: str = "attachments") -> None:
    doc = Document(one_path)
    out = Path(out_dir)
    out.mkdir(exist_ok=True)

    attachments = doc.GetChildNodes(AttachedFile)
    if not attachments:
        print("No attachments found.")
        return

    for i, af in enumerate(attachments, start=1):
        name = af.FileName or f"attachment_{i}.bin"
        dest = out / name
        dest.write_bytes(af.Bytes)
        print(f"  [{i}] {name}  ({len(af.Bytes):,} bytes)")

    print(f"\nSaved {len(attachments)} file(s) to '{out_dir}/'")

save_all_attachments("MyNotes.one")

یادداشت‌ها

af.Bytes زمانی که دادهٔ پیوست از فایل باینری تجزیه نشود، b"" (بایت‌های خالی) را برمی‌گرداند. اگر می‌خواهید پیوست‌های خالی را نادیده بگیرید، قبل از ذخیره‌سازی len(af.Bytes) > 0 را بررسی کنید.
af.Tags فهرستی از اشیاء NoteTag است اگر پیوست دارای برچسب‌های OneNote باشد.
Aspose.Note FOSS برای Python فایل‌های .one را می‌خواند اما به .one نمی‌نویسد. شما نمی‌توانید پیوست‌ها را ایجاد یا تغییر دهید.