Tables

Analyzovanie tabuliek — Aspose.Note FOSS pre Python

Tabuľky v dokumentoch OneNote sú vystavené ako trojúrovňová hierarchia: Table → TableRow → TableCell. Každá bunka môže obsahovať RichText, Image, a ďalšie uzly obsahu. Táto stránka pokrýva všetky vzory parsovania tabuliek podporované Aspose.Note FOSS pre Python.

Základná iterácia tabuliek

Získajte všetky tabuľky v dokumente a prečítajte text ich buniek:

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

Vlastnosti tabuľky

Vlastnosť	Typ	Popis
`Columns`	`list[TableColumn]`	Definície stĺpcov; každý `TableColumn` má `.Width` (float) a `.LockedWidth` (bool)
`IsBordersVisible`	`bool`	Či sú okraje tabuľky zobrazené
`Tags`	`list[NoteTag]`	Značky OneNote pripojené k tabuľke

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

Exportovať tabuľku do CSV

Previesť tabuľku do formátu 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())

Extrahovať tabuľky podľa stránok

Obmedzte extrakciu tabuliek na jednotlivé stránky:

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

Obsah bunky nad rámec obyčajného textu

Bunky tabuľky môžu obsahovať Image a ďalšie CompositeNode obsah vedľa 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)}")

Počítať a sumarizovať tabuľky

Zhromaždiť štatistiky o všetkých tabuľkách v dokumente:

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

Skontrolovať značky na tabuľkách

Tabuľky podporujú NoteTag položky priamo:

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

Pozícia DOM tabuliek

Tabuľky sa zobrazujú ako podriadené OutlineElement uzly v Outline kontajnery na každom Page. Hierarchia je:

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

Tabuľky môžete tiež dosiahnuť cez GetChildNodes(Table) na akejkoľvek úrovni predka uzla a prehľadáva celý podstrom.

Tipy

table.Columns je zoznamom TableColumn objektov; použite [col.Width for col in table.Columns] na získanie šírok stĺpcov v bodoch. Dĺžka sa rovná počtu stĺpcov.
Obsah bunky nie je vždy čisto RichText; vždy skontrolujte Image uzly tiež, ak je dôležitá úplná vernosť.
Použite table.GetChildNodes(TableRow) namiesto iterovania for row in table ak potrebujete typovaný zoznam namiesto generického iterátora.
IsBordersVisible odráža preferenciu zobrazenia používateľa OneNote v čase ukladania; neovplyvňuje extrakciu obsahu.