Row

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

A “row” is lines of text distributed along a horizontal line. Each matching line in the “row” must have a top boundary that’s within 0.08 inches below or above the anchor’s top boundary (total range is 0.16” inches). For example, the following image shows a red line that defines the alignment for a row of text:

Parameters
Examples
Notes

Parameters

key	value	description
id (required)	row
includeAnchor	boolean. default: false	Includes the anchor line in the method output
position	right, left. default: right	Matches to the left or right
tiebreaker	For information about this global parameter, see Method.	For information about this global parameter, see Method.

Examples

The following example shows extracting data from two consecutive tables using the Row method:

1. The first field has an anchor with two matches to avoid duplicate text in the second table. First the anchor matches the text most popular on github, then it anchors on the text first in a row. The method then extracts the top-ranked GitHub language name to the left of the anchor match.
2. The second field also has an anchor with two matches. It anchors on the row containing Python, then extracts the second percentage in the row to the right of the anchor.

Config

JSON

{
  "fields": [
    {
      "id": "number_1_language_on_github",
      "anchor": {
        "match": [
          {
            "text": "most popular on github",
            "type": "includes"
          },
          {
            "text": "first",
            "type": "startsWith"
          }
        ]
      },
      "method": {
        "id": "row",
        "position": "left",
      }
    },
    {
      "id": "python_change_in_TIBOE_rating",
      "type": "percentage",
      "anchor": {
        "match": [
          {
            "text": "popular in search engines",
            "type": "includes"
          },
          {
            "text": "Python",
            "type": "startsWith"
          }
        ]
      },
      "method": {
        "id": "row",
        "tiebreaker": 1
      }
    }
  ]
}

Example document

The following image shows the data extracted by this config for the following example document:

Example document	Download link

Output

JSON

{
  "number_1_language_on_github": {
    "value": "Javascript",
    "type": "string"
  },
  "python_change_in_TIBOE_rating": {
    "source": "2.75%",
    "value": 2.75,
    "type": "percentage"
  }
}

Notes

• To extract an entire table, see the table methods.
• To extract a column, see the Column method.
• In a row with optional empty cells, a tiebreaker can return lines from inconsistent columns. Use the Intersection method instead.
• The Row method can’t extract multiple lines in a cell. Use the Document Range or Intersection methods instead.