Analisar Tabelas do OneNote em Python

O Microsoft OneNote permite que os usuários incorporem tabelas estruturadas diretamente nas páginas, ideal para listas de tarefas, agendas, matrizes de comparação e formulários de coleta de dados. Aspose.Note FOSS para Python possibilita extrair todos esses dados tabulares programaticamente, sem necessidade de instalação do Microsoft Office.

Instalar

pip install aspose-note

Carregue o Documento e Encontre Tabelas

GetChildNodes(Table) executa uma busca recursiva em todo o documento e retorna cada tabela como um Table objeto:

from aspose.note import Document, Table

doc = Document("MyNotes.one")
tables = doc.GetChildNodes(Table)
print(f"Found {len(tables)} table(s)")

Ler Valores das Células

As tabelas seguem uma hierarquia de três níveis: Table → TableRow → TableCell. Cada célula contém RichText nós cujos .Text fornece o conteúdo em texto simples:

from aspose.note import Document, Table, TableRow, TableCell, RichText

doc = Document("MyNotes.one")

for t_num, table in enumerate(doc.GetChildNodes(Table), start=1):
    print(f"\nTable {t_num}:")
    for r_num, row in enumerate(table.GetChildNodes(TableRow), start=1):
        cells = row.GetChildNodes(TableCell)
        row_values = [
            " ".join(rt.Text for rt in cell.GetChildNodes(RichText)).strip()
            for cell in cells
        ]
        print(f"  Row {r_num}: {row_values}")

Inspecionar Larguras das Colunas

Table.ColumnWidths retorna a largura armazenada de cada coluna em pontos:

from aspose.note import Document, Table

doc = Document("MyNotes.one")
for i, table in enumerate(doc.GetChildNodes(Table), start=1):
    print(f"Table {i}: {len(table.ColumnWidths)} column(s)")
    print(f"  Widths (pts): {table.ColumnWidths}")
    print(f"  Borders visible: {table.BordersVisible}")

Exportar Todas as Tabelas para CSV

Converter cada tabela no documento para o formato CSV:

import csv, io
from aspose.note import Document, Table, TableRow, TableCell, RichText

doc = Document("MyNotes.one")
output = io.StringIO()
writer = csv.writer(output)

for table in doc.GetChildNodes(Table):
    for row in table.GetChildNodes(TableRow):
        values = [
            " ".join(rt.Text for rt in cell.GetChildNodes(RichText)).strip()
            for cell in row.GetChildNodes(TableCell)
        ]
        writer.writerow(values)
    writer.writerow([])   # blank row between tables

with open("tables.csv", "w", encoding="utf-8", newline="") as f:
    f.write(output.getvalue())

print("Saved tables.csv")

Exportar Tabelas para um Dicionário Python / JSON

import json
from aspose.note import Document, Table, TableRow, TableCell, RichText

doc = Document("MyNotes.one")
result = []

for table in doc.GetChildNodes(Table):
    rows = []
    for row in table.GetChildNodes(TableRow):
        cells = [
            " ".join(rt.Text for rt in cell.GetChildNodes(RichText)).strip()
            for cell in row.GetChildNodes(TableCell)
        ]
        rows.append(cells)
    result.append({"rows": rows, "column_widths": table.ColumnWidths})

print(json.dumps(result, indent=2))

Usar a Primeira Linha como Cabeçalhos

from aspose.note import Document, Table, TableRow, TableCell, RichText

doc = Document("MyNotes.one")

for table in doc.GetChildNodes(Table):
    rows = table.GetChildNodes(TableRow)
    if not rows:
        continue

    def row_text(row):
        return [
            " ".join(rt.Text for rt in cell.GetChildNodes(RichText)).strip()
            for cell in row.GetChildNodes(TableCell)
        ]

    headers = row_text(rows[0])
    print("Headers:", headers)
    for row in rows[1:]:
        record = dict(zip(headers, row_text(row)))
        print("  Record:", record)

O que a Biblioteca Suporta para Tabelas

Recurso	Suportado
`Table.ColumnWidths`	Sim: larguras de coluna em pontos
`Table.BordersVisible`	Sim
`Table.Tags`	Sim: tags do OneNote em tabelas
Texto da célula via `RichText`	Sim
Imagens da célula via `Image`	Sim
Células mescladas (metadados de rowspan/colspan)	Não exposto na API pública
Escrever/editar tabelas e salvar em `.one`	Não