כיצד לשמור קבצים מצורפים מ‑OneNote בפייתון

כיצד לשמור קבצים מצורפים מ‑OneNote בפייתון

קבצי OneNote .one יכולים להכיל קבצי קבצים משולבים: כל סוג קובץ שהוכנס לדף באמצעות Insert → File Attachment ב‑OneNote. Aspose.Note FOSS for Python חושף אותם דרך המחלקה AttachedFile, המספקת את שם הקובץ המקורי ואת הבייטים הגולמיים של הקובץ המשולב.


דרישות מקדימות

pip install aspose-note

שלב 1: טען את המסמך

from aspose.note import Document

doc = Document("MyNotes.one")

שלב 2: מצא את כל הקבצים המצורפים

השתמש ב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 for Python קורא קבצי .one אך אינו כותב חזרה ל.one. לא ניתן ליצור או לשנות קבצים מצורפים.

ראה גם

 עברית