Sensible

The Sensible Developer Hub

Welcome to the Sensible developer hub. You'll find comprehensive guides and documentation to help you start working with Sensible as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Matches all lines to the left or right of the anchor line.

A "row" is defined as lines of text distributed along an x-axis. Each matching line in the "row" must have a top boundary that is within 0.08 inches of the anchor's top boundary. For example, the following image shows a red line that defines the alignment for a row of bold text:

Examples

The following image shows an example of the row method in the Sensible app:

You can try out this example yourself in the Sensible app using the following downloadable PDF and config:

Example PDF for rowDownload link

The preceding example demonstrates choosing data from two consecutive tables:

  1. The first field has an anchor with two matches: first the anchor matches the heading Languages by Github rank to ensure we are in the first table, and then it matches on the text first to find the row with the top-ranked Github language. The method then grabs the language name to the left of the last anchor match (first).
  2. The second field also has an anchor with two matches: first the anchor matches the heading Languages ranked by search engine to ensure we are in the second table, and then it finds the word Python to find the first row with that language. The method then grabs the % change in ranking for Python by taking the second item in the row to the right of the last anchor match (Python).
{
  "fields": [
    {
      "id": "number_1_language_on_github",
      "anchor": {
        "match": [
          {
            "text": "Languages by Github rank",
            "type": "startsWith"
          },
          {
            "text": "first",
            "type": "startsWith"
          }
        ]
      },
      "method": {
        "id": "row",
        "tiebreaker": "first",
        "position": "left",
        "includeAnchor": true
      }
    },
    {
      "id": "python_change_in_TIBOE_rating",
      "anchor": {
        "match": [
          {
            "text": "Languages ranked by search engine",
            "type": "startsWith"
          },
          {
            "text": "Python",
            "type": "startsWith"
          }
        ]
      },
      "method": {
        "id": "row",
        "tiebreaker": "second"
      }
    },
  ]
}

Parameters

keyvaluedescription
id (required)row
includeAnchorboolean. default: falseIncludes the anchor line in the method output
positionright, left. default: rightMatches to the left or right
tiebreakerfirst, second, third, last, >, <Which line in the row is the target. Use the comparisons > and < to grab maximum and minimum values in the row. By default the comparisons are sorted alphanumerically using unicode values. If you want to compare numeric amounts and ignore non-numbers in the row, then add type: number or type: currency as a top-level parameter to the field.

Notes

To grab an entire table, see the Table method. To grab a column, see the Column method.

Updated 10 days ago


Row


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.