Tables

Парсинг таблиць — Aspose.Note FOSS для Python

Таблиці у документах OneNote представлені як ієрархія з трьох рівнів: Table → TableRow → TableCell. Кожна клітинка може містити RichText, Image, та інші вузли вмісту. Ця сторінка охоплює всі шаблони розбору таблиць, підтримувані Aspose.Note FOSS для Python.

Базова ітерація таблиць

Отримайте всі таблиці в документі та прочитайте текст їх клітинок:

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

Властивості таблиці

Властивість	Тип	Опис
`Columns`	`list[TableColumn]`	Визначення стовпців; кожен `TableColumn` має `.Width` (float) і `.LockedWidth` (bool)
`IsBordersVisible`	`bool`	Чи відображаються межі таблиці
`Tags`	`list[NoteTag]`	Теги OneNote, прикріплені до таблиці

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

Експорт таблиці у CSV

Перетворити таблицю у формат 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())

Витяг таблиць по сторінках

Обмежте витяг таблиць окремими сторінками:

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

Вміст клітинки, що виходить за межі простого тексту

Комірки таблиці можуть містити Image і інші CompositeNode вміст поряд 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)}")

Підрахунок та підсумок таблиць

Зберіть статистику про всі таблиці в документі:

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

Перевірка тегів у таблицях

Таблиці підтримують NoteTag елементи безпосередньо:

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

Позиція DOM таблиць

Таблиці з’являються як дочірні елементи OutlineElement вузли в Outline контейнери на кожному Page. Ієрархія така:

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

Ви також можете отримати доступ до таблиць через GetChildNodes(Table) на будь-якому рівні предкового вузла, і він шукає повне піддерево.

Поради

table.Columns є списком of TableColumn об’єкти; використовуйте [col.Width for col in table.Columns] щоб отримати ширину стовпців у пунктах. Довжина дорівнює кількості стовпців.
Вміст комірки не завжди є чисто RichText; завжди перевіряйте Image вузли також, якщо важлива повна достовірність.
Використовуйте table.GetChildNodes(TableRow) замість ітерації for row in table якщо вам потрібен типізований список замість загального ітератора.
IsBordersVisible відображає налаштування відображення користувача OneNote під час збереження; це не впливає на вилучення вмісту.