Come salvare i file allegati da OneNote in Python

Come salvare i file allegati da OneNote in Python

I file OneNote .one possono contenere allegati di file incorporati: qualsiasi tipo di file inserito in una pagina usando Insert → File Attachment in OneNote. Aspose.Note FOSS per Python espone questi tramite la classe AttachedFile, che fornisce il nome file originale e i byte grezzi del file incorporato.


Prerequisiti

pip install aspose-note

Passo 1: Carica il documento

from aspose.note import Document

doc = Document("MyNotes.one")

Passo 2: Trova tutti i file allegati

Utilizza GetChildNodes(AttachedFile) per raccogliere ricorsivamente ogni allegato nel documento, indipendentemente dalla pagina o dalla struttura in cui appare:

from aspose.note import Document, AttachedFile

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

Passo 3: Salva ogni allegato su disco

Accedi a af.Bytes per il contenuto grezzo del file e a af.FileName per il nome originale. Proteggi sempre da un nome file None: la libreria restituisce None quando i metadati del nome file non sono stati memorizzati nel file:

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

Esempio completo

Questo script estrae tutti gli allegati da un file .one e li salva in una directory di output dedicata:

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

Note

  • af.Bytes restituisce b"" (byte vuoti) quando i dati dell’allegato non possono essere analizzati dal file binario. Controlla len(af.Bytes) > 0 prima di salvare se vuoi ignorare gli allegati vuoti.
  • af.Tags è un elenco di oggetti NoteTag se l’allegato ha dei tag OneNote applicati.
  • Aspose.Note FOSS per Python legge i file .one ma non scrive su .one. Non è possibile creare o modificare gli allegati.

Vedi anche

 Italiano