Como Ler Metadados de Página do OneNote em Python

OneNote .one os arquivos armazenam metadados que podem ser lidos sem analisar o DOM completo do documento. No documento nível, Document.FileFormat informa qual variante do OneNote o arquivo usa. No página nível, cada Page contém o autor, o carimbo de data/hora de criação, o carimbo de data/hora da última modificação e o nível hierárquico. Aspose.Note FOSS para Python expõe esses através do Document e Page classes.

Pré-requisitos

pip install aspose-note

Metadados ao Nível de Documento

O Document objeto expõe uma propriedade de metadados:

Propriedade	Tipo	Descrição
`doc.FileFormat`	`FileFormat`	A variante do OneNote: `FileFormat.OneNote2010`, `FileFormat.OneNoteOnline`, ou `FileFormat.Unknown`.

from aspose.note import Document

doc = Document("MyNotes.one")
print(f"File format: {doc.FileFormat}")

Metadados ao Nível de Página

Cada Page objeto contém:

Propriedade	Tipo	Descrição
`page.Author`	`str	None`
`page.CreationTime`	`datetime	None`
`page.LastModifiedTime`	`datetime	None`
`page.Level`	`int	None`

Etapa 1: Ler Metadados de Cada Página

from aspose.note import Document, Page

doc = Document("ProjectNotes.one")

for i, page in enumerate(doc, start=1):
    title = ""
    if page.Title and page.Title.TitleText:
        title = page.Title.TitleText.Text.strip()

    level = page.Level or 0
    indent = "  " * level

    author = page.Author or "(unknown)"
    created = page.CreationTime.strftime("%Y-%m-%d") if page.CreationTime else "(none)"
    modified = page.LastModifiedTime.strftime("%Y-%m-%d %H:%M") if page.LastModifiedTime else "(none)"

    print(f"{indent}[{i}] {title or '(untitled)'}")
    print(f"{indent}    Author:   {author}")
    print(f"{indent}    Created:  {created}")
    print(f"{indent}    Modified: {modified}")
    print(f"{indent}    Level:    {level}")

Exemplo Completo: Relatório de Metadados

from aspose.note import Document

def print_metadata_report(one_path: str) -> None:
    doc = Document(one_path)

    print()

    for i, page in enumerate(doc, start=1):
        title = ""
        if page.Title and page.Title.TitleText:
            title = page.Title.TitleText.Text.strip()

        level = page.Level or 0
        prefix = "  " * level + f"[{i}]"

        parts = [prefix, f'"{title or "(untitled)"}"']
        if page.Author:
            parts.append(f"by {page.Author}")
        if page.CreationTime:
            parts.append(f"created {page.CreationTime.strftime('%Y-%m-%d')}")
        if page.LastModifiedTime:
            parts.append(f"modified {page.LastModifiedTime.strftime('%Y-%m-%d')}")

        print("  ".join(parts))

print_metadata_report("ProjectNotes.one")

Detectando Subpáginas

No OneNote, as subpáginas são visualmente recuadas sob a página pai. O page.Level propriedade reflete esse aninhamento:

from aspose.note import Document

doc = Document("MyNotes.one")

for page in doc:
    level = page.Level or 0
    title = ""
    if page.Title and page.Title.TitleText:
        title = page.Title.TitleText.Text.strip()

    indent = "  " * level
    marker = "├─" if level > 0 else "•"
    print(f"{indent}{marker} {title or '(untitled)'}")

Valores de nível:

0: página de nível superior
1: subpágina de primeiro nível (um recuo)
2:subpágina de segundo nível (duas identações)

Observações

Todos os timestamps (CreationTime, LastModifiedTime) datetime objetos em UTC quando presentes.
page.Level retorna None para páginas onde o nível não foi armazenado no formato binário. Trate None como 0 usando page.Level or 0.