Index PDF tables

Project TABLE segments into bounded, Table.vue-ready pdf_table rows.

When to use it

Turn extracted table segments into bounded rows suitable for a table view. This is a projection of detected table content; it is different from accepting a model-proposed editable user table.

Add and configure

Add Index PDF tables from the workflow step picker.
Give the step a recognisable name and connect its required inputs.
Set the options below. Nested names identify fields within an object or a list item.
Validate the recipe, inspect the test result, then run it on the intended data.

The step identifier used in the editor’s code view is table_index.

Settings

Setting	Accepted value	Required	Default	What it controls
Emit Manifest (`emit_manifest`)	boolean	No	true	Emit the table_index_meta manifest.
File Key Field (`file_key_field`)	string	No	"object_key"	File reference field.
Record Type (`record_type`)	string	No	"pdf_tables"	record_type column stamp for ALL emitted rows. The payload-level record_type discriminates kinds: pdf_table \| table_index_meta.
Segment Kind Field (`segment_kind_field`)	string	No	"kind"	Segment kind field.

Inputs and outputs

Direction	Port	Content	Required	Multiple records
Inputs	`in`	records	Yes	Yes
Outputs	`out`	records	Yes	Yes

Effects, testing, and recovery

Transforms or passes records without a declared external side effect.

The declared preview behaviour is to execute this step. Reads, processing, or model usage can therefore be real. Read dry runs before using a preview with live connections.

No duplicate-prevention key is declared for this step. The step declares safe replay for its supported recovery path.

Example: Project a native table grid into Table.vue rows

Step settings:

{
  "emit_manifest": false
}

Input records:

[
  {
    "content_hash": "c3",
    "document_id": "doc-q3",
    "index": 4,
    "kind": "TABLE",
    "meta_data": {
      "grid": {
        "grid_version": 1,
        "headers": [
          "Region",
          "Revenue"
        ],
        "provenance": {
          "source": "xlsx",
          "table_id": "sheet1-t0"
        },
        "rows": [
          [
            "EU",
            "1200"
          ],
          [
            "US",
            "950"
          ]
        ]
      }
    },
    "object_key": "reports/q3.xlsx",
    "page_number": 1
  }
]

Expected output for this example:

[
  {
    "cell_text_truncated": false,
    "cells": [],
    "cells_capped": false,
    "cells_have_bbox": false,
    "columns": [
      "Region",
      "Revenue"
    ],
    "columns_truncated": false,
    "content_hash": "c3",
    "document_id": "doc-q3",
    "file_name": "q3.xlsx",
    "n_cols": 2,
    "n_rows": 2,
    "nbbox": null,
    "object_key": "reports/q3.xlsx",
    "page": 1,
    "record_type": "pdf_table",
    "row_spans": [],
    "rows": [
      {
        "Region": "EU",
        "Revenue": "1200"
      },
      {
        "Region": "US",
        "Revenue": "950"
      }
    ],
    "rows_truncated": false,
    "segment_index": 4,
    "source": "xlsx",
    "table_id": "sheet1-t0",
    "table_index_version": 1
  }
]

Example: Only TABLE segments with a table contract become rows