Tables

Parsowanie tabel — Aspose.Note FOSS dla Python

Tabele w dokumentach OneNote są udostępniane jako trójpoziomowa hierarchia: Table → TableRow → TableCell. Każda komórka może zawierać RichText, Image, oraz inne węzły treści. Ta strona opisuje wszystkie wzorce parsowania tabel obsługiwane przez Aspose.Note FOSS dla Python.

Podstawowa iteracja tabel

Pobierz wszystkie tabele w dokumencie i odczytaj tekst ich komórek:

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

Właściwości tabeli

Właściwość	Typ	Opis
`Columns`	`list[TableColumn]`	Definicje kolumn; każda `TableColumn` ma `.Width` (float) i `.LockedWidth` (bool)
`IsBordersVisible`	`bool`	Czy krawędzie tabeli są wyświetlane
`Tags`	`list[NoteTag]`	Tagi OneNote dołączone do tabeli

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

Eksportuj tabelę do CSV

Konwertuj tabelę do formatu 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())

Wyodrębnianie tabel na stronę

Ogranicz wyodrębnianie tabel do poszczególnych stron:

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

Zawartość komórek poza zwykłym tekstem

Komórki tabeli mogą zawierać Image i inne CompositeNode zawartość obok 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)}")

Policz i podsumuj tabele

Zbierz statystyki dotyczące wszystkich tabel w dokumencie:

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

Sprawdź tagi w tabelach

Tabele obsługują NoteTag elementy bezpośrednio:

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

Pozycja DOM tabel

Tabele pojawiają się jako elementy podrzędne OutlineElement węzły w Outline kontenery na każdym Page. Hierarchia jest:

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

Możesz także uzyskać dostęp do tabel poprzez GetChildNodes(Table) na dowolnym poziomie węzła nadrzędnego i przeszukuje cały poddrzewo.

Wskazówki

table.Columns jest listą TableColumn obiektów; użyj [col.Width for col in table.Columns] aby uzyskać szerokości kolumn w punktach. Długość równa się liczbie kolumn.
Zawartość komórki nie zawsze jest czysto RichText; zawsze sprawdzaj Image węzły również, jeśli pełna wierność ma znaczenie.
Użyj table.GetChildNodes(TableRow) zamiast iterować for row in table jeśli potrzebujesz listy typowanej zamiast ogólnego iteratora.
IsBordersVisible odzwierciedla preferencję wyświetlania użytkownika OneNote w momencie zapisu; nie wpływa na ekstrakcję treści.