Ako uložiť pripojené súbory z OneNote v Pythone

OneNote .one súbory môžu obsahovať vložené prílohy súborov: akýkoľvek typ súboru, ktorý bol vložený na stránku pomocou Insert → File Attachment v OneNote. Aspose.Note FOSS pre Python ich sprístupňuje prostredníctvom triedy AttachedFile, ktorá poskytuje pôvodný názov súboru a surové bajty vloženého súboru.

Predpoklady

pip install aspose-note

Krok 1: Načítajte dokument

from aspose.note import Document

doc = Document("MyNotes.one")

Krok 2: Nájsť všetky pripojené súbory

Použite GetChildNodes(AttachedFile) na rekurzívne zhromaždenie každej prílohy v dokumente, bez ohľadu na to, na ktorej stránke alebo v ktorej osnove sa nachádza:

from aspose.note import Document, AttachedFile

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

Krok 3: Uložiť každú prílohu na disk

Prístup af.Bytes k surovému obsahu súboru a af.FileName k pôvodnému názvu. Vždy sa chráňte pred názvom súboru None: knižnica vráti None, keď metadáta názvu súboru neboli uložené v súbore:

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

Kompletný príklad

Tento skript extrahuje všetky prílohy zo súboru .one a uloží ich do vyhradeného výstupného adresára:

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

Poznámky

af.Bytes vracia b"" (prázdne bajty), keď sa dáta prílohy nepodarilo analyzovať z binárneho súboru. Skontrolujte len(af.Bytes) > 0 pred uložením, ak chcete preskočiť prázdne prílohy.
af.Tags je zoznam objektov NoteTag, ak má príloha nejaké použité značky OneNote.
Aspose.Note FOSS pre Python číta súbory .one, ale neukladá späť do .one. Nie je možné vytvárať ani upravovať prílohy.