Jak zapisać załączone pliki z OneNote w Pythonie

Pliki OneNote .one mogą zawierać osadzone załączniki plików: każdy typ pliku, który został wstawiony na stronę przy użyciu Insert → File Attachment w OneNote. Aspose.Note FOSS for Python udostępnia je poprzez klasę AttachedFile, która zapewnia oryginalną nazwę pliku oraz surowe bajty osadzonego pliku.

Wymagania wstępne

pip install aspose-note

Krok 1: Załaduj dokument

from aspose.note import Document

doc = Document("MyNotes.one")

Krok 2: Znajdź wszystkie załączone pliki

Użyj GetChildNodes(AttachedFile), aby rekurencyjnie zebrać każdy załącznik w dokumencie, niezależnie od tego, na której stronie lub w jakim konspekcie się znajduje:

from aspose.note import Document, AttachedFile

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

Krok 3: Zapisz każdy załącznik na dysku

Uzyskaj dostęp do af.Bytes, aby uzyskać surową zawartość pliku, oraz do af.FileName, aby uzyskać oryginalną nazwę. Zawsze zabezpieczaj się przed nazwą pliku None: biblioteka zwraca None, gdy metadane nazwy pliku nie zostały zapisane w pliku:

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)")

Pełny przykład

Ten skrypt wyodrębnia wszystkie załączniki z pliku .one i zapisuje je w dedykowanym katalogu wyjściowym:

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")

Notatki

af.Bytes zwraca b"" (puste bajty), gdy dane załącznika nie mogły zostać sparsowane z pliku binarnego. Sprawdź len(af.Bytes) > 0 przed zapisem, jeśli chcesz pominąć puste załączniki.
af.Tags jest listą obiektów NoteTag, jeśli załącznik ma zastosowane jakiekolwiek tagi OneNote.
Aspose.Note FOSS for Python odczytuje pliki .one, ale nie zapisuje ich do .one. Nie możesz tworzyć ani modyfikować załączników.