Tables

Anàlisi de taules — Aspose.Note FOSS per a Python

Les taules en documents OneNote es presenten com una jerarquia de tres nivells: Table → TableRow → TableCell. Cada cel·la pot contenir RichText, Image, i altres nodes de contingut. Aquesta pàgina cobreix tots els patrons d’anàlisi de taules compatibles amb Aspose.Note FOSS per a Python.

Iteració bàsica de taules

Recupera totes les taules del document i llegeix el text de les seves cel·les:

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

doc = Document("MyNotes.one")

for table_num, table in enumerate(doc.GetChildNodes(Table), start=1):
    print(f"\nTable {table_num}: {len(table.Columns)} column(s)")
    for r, row in enumerate(table.GetChildNodes(TableRow), start=1):
        cells = row.GetChildNodes(TableCell)
        values = [
            " ".join(rt.Text for rt in cell.GetChildNodes(RichText)).strip()
            for cell in cells
        ]
        print(f"  Row {r}: {values}")

Propietats de la taula

Propietat	Tipus	Descripció
`Columns`	`list[TableColumn]`	Definicions de columnes; cada `TableColumn` té `.Width` (float) i `.LockedWidth` (bool)
`IsBordersVisible`	`bool`	Si es mostren les vores de la taula
`Tags`	`list[NoteTag]`	Etiquetes d’OneNote adjuntes a la taula

from aspose.note import Document, Table

doc = Document("MyNotes.one")
for table in doc.GetChildNodes(Table):
    print(f"Columns: {len(table.Columns)}")
    print(f"Widths (pts): {[col.Width for col in table.Columns]}")
    print(f"Borders visible: {table.IsBordersVisible}")

Exporta la taula a CSV

Converteix una taula al format CSV:

import csv
import 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 line between tables

print(output.getvalue())

Extreu taules per pàgina

Limita l’extracció de taules a pàgines individuals:

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

doc = Document("MyNotes.one")
for page_num, page in enumerate(doc.GetChildNodes(Page), start=1):
    tables = page.GetChildNodes(Table)
    if not tables:
        continue
    title = (
        page.Title.TitleText.Text
        if page.Title and page.Title.TitleText
        else f"Page {page_num}"
    )
    print(f"\n=== {title} ({len(tables)} table(s)) ===")
    for t, table in enumerate(tables, start=1):
        print(f"  Table {t}:")
        for row in table.GetChildNodes(TableRow):
            cells = row.GetChildNodes(TableCell)
            row_text = [
                " ".join(rt.Text for rt in cell.GetChildNodes(RichText)).strip()
                for cell in cells
            ]
            print(f"    {row_text}")

Contingut de les cel·les més enllà del text pla

Les cel·les de la taula poden contenir Image i altres CompositeNode contingut al costat de RichText:

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

doc = Document("MyNotes.one")
for table in doc.GetChildNodes(Table):
    for row in table.GetChildNodes(TableRow):
        for cell in row.GetChildNodes(TableCell):
            texts = [rt.Text for rt in cell.GetChildNodes(RichText) if rt.Text]
            images = cell.GetChildNodes(Image)
            print(f"  Cell texts: {texts}  images: {len(images)}")

Compta i resumeix les taules

Recull estadístiques sobre totes les taules d’un document:

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

doc = Document("MyNotes.one")
tables = doc.GetChildNodes(Table)
print(f"Total tables: {len(tables)}")

for i, table in enumerate(tables, start=1):
    rows = table.GetChildNodes(TableRow)
    if rows:
        cols = len(rows[0].GetChildNodes(TableCell))
    else:
        cols = 0
    print(f"  Table {i}: {len(rows)} row(s) x {cols} column(s)  widths={[col.Width for col in table.Columns]}")

Inspecciona les etiquetes de les taules

Les taules admeten NoteTag elements directament:

from aspose.note import Document, Table, TagStatus

doc = Document("MyNotes.one")
for table in doc.GetChildNodes(Table):
    for tag in table.Tags:
        is_completed = tag.Status == TagStatus.Completed
        print(f"Table tag: {tag.Label}  icon={tag.Icon}  completed={is_completed}")

Posició DOM de les taules

Les taules apareixen com a fills de OutlineElement nodes dins de Outline contenidors a cada Page. La jerarquia és:

Page
  └── Outline
        └── OutlineElement
              └── Table
                    └── TableRow
                          └── TableCell
                                └── RichText / Image

També podeu accedir a les taules a través de GetChildNodes(Table) a qualsevol nivell de node ancestre, i cerca tot el subarbre.

Consells

table.Columns és una llista de TableColumn objectes; utilitzeu [col.Width for col in table.Columns] per obtenir l’amplada de les columnes en punts. La longitud és igual al nombre de columnes.
El contingut de la cel·la no és sempre purament RichText; sempre comproveu Image nodes també si la fidelitat completa és important.
Utilitzeu table.GetChildNodes(TableRow) en comptes d’iterar for row in table si necessiteu una llista tipada en comptes d’un iterador genèric.
IsBordersVisible reflecteix la preferència de visualització de l’usuari de OneNote en el moment del desament; no afecta l’extracció del contingut.