Cómo guardar archivos adjuntos de OneNote en Python

Los archivos OneNote .one pueden contener archivos adjuntos incrustados: cualquier tipo de archivo que se insertó en una página usando Insertar → Archivo adjunto en OneNote. Aspose.Note FOSS for Python los expone a través de la clase AttachedFile, que proporciona el nombre de archivo original y los bytes sin procesar del archivo incrustado.

Requisitos

pip install aspose-note

Paso 1: Cargar el documento

from aspose.note import Document

doc = Document("MyNotes.one")

Paso 2: Encontrar todos los archivos adjuntos

Utilice GetChildNodes(AttachedFile) para recopilar recursivamente cada adjunto en el documento, sin importar en qué página o esquema aparezca:

from aspose.note import Document, AttachedFile

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

Paso 3: Guardar cada archivo adjunto en disco

Acceda af.Bytes para el contenido bruto del archivo y af.FileName para el nombre original. Siempre proteja contra un nombre de archivo None: la biblioteca devuelve None cuando los metadatos del nombre de archivo no se almacenaron en el archivo:

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

Ejemplo completo

Este script extrae todos los archivos adjuntos de un archivo .one y los guarda en un directorio de salida dedicado:

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

Notas

af.Bytes devuelve b"" (bytes vacíos) cuando los datos del adjunto no pudieron ser analizados desde el archivo binario. Verifique len(af.Bytes) > 0 antes de guardar si desea omitir los adjuntos vacíos.
af.Tags es una lista de objetos NoteTag si el adjunto tiene alguna etiqueta de OneNote aplicada.
Aspose.Note FOSS for Python lee archivos .one pero no escribe de vuelta a .one. No puede crear ni modificar adjuntos.