Как сохранить вложенные файлы из 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. Вы не можете создавать или изменять вложения.