key | value | description |
---|---|---|
id required | table | When you specify this method, you must also specify “type”: “table” in the field’s parameters. |
columns required | array | An array of objects with the following parameters: -id (required): The id for the column in the extraction output. -minX (required): The distance in inches on the page from the left edge of the page to the left edge of the column. To visually determine this coordinate, click a point in the document in the Sensible app, then drag to display inch dimensions. -maxX (required): The distance in inches on the page from the left edge of the page to the right edge of the column. To visually determine this coordinate, click a point in the document in the Sensible app, then drag to display inch dimensions. -type: The table cell’s type. For more information about types, see Types. -isRequired (default false): If true, Sensible omits a row if its cell is empty in this column. If false, Sensible returns nulls for empty cells in the row. Note that if you set this parameter to true for one column, Sensible omits the row for all columns, even if the row had content under other columns.Tip: You can define columns with overlapping coordinates, for example in order to output data in a single column as multiple columns. For more information, see the Examples section. |
offsetY | number in inches. | Defines a starting point for recognizing a table, offset vertically from the anchor line’s lower boundary. For example, if no table title precedes the table, then anchor instead on a column heading and use a negative Offset Y parameter to define a starting point above the table. |
stop | Match object, array of Match objects, or number (inches) | (Recommended) Line to match or number in inches to stop table recognition:. - A Match object or array specifies to stop table recognition when Sensible matches text. - A number specifies the end of the table as the number of the inches offset along a Y-axis from the start of the table.Specify this parameter to prevent extracting non-table data and to enable recognizing a table that spans pages. If you don’t specify this parameter, the table extends to the end of the page.Tip: In advanced use cases, you can use the syntax “stop”: {“type”: “last”} to recognize tables that span pages, but where there’s no text you can use match on with the Stop parameter. This type of stop specifies to end the table at the end of the document or section. For example, use this type of stop to recognize tables in sections, where each table extends to the end of each section. |
startOnRow | integer. default: 0 | Zero-indexed row number at which to start table extraction. For example, use this to exclude column headings from the output. As a stricter alternative, set the Is Required parameter on a column and set a type on the column (see example in Examples section). |
detectMultipleLinesPerRow | boolean. default: false | If true, Sensible detects table cells containing multiple lines, rather than the default of treating each line as a new row. In detail, Sensible detects that a cell contains multiple lines if the vertical gap between two lines is less than half the height of the second line.Set this to false if row gutters are narrow. For example, if vertical gaps between lines in the cells are the same height as row gutters, Sensible can incorrectly merge multiple rows into one. |
columnsRelativeToAnchor | boolean. Default: false | If true, specifies that the column coordinates minX and maxX are relative to the left edge of the anchor line, rather than to the left edge of the page. For example, use this parameter to recognize nested tables inside tables. |
Example document | Download link |
---|
Example document | Download link |
---|