Як зберегти прикріплені файли з OneNote у Python

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. Ви не можете створювати або змінювати вкладення.