Goto step properties

The Goto step moves the pointer within the source data to a position that is relative to the top of the record or to the current position. See also: Steps.

The properties of the Goto step described in this topic become visible in the Step properties pane when you select the Goto step on the Steps pane.

Description

This subsection is collapsed by default in the interface, to give more screen space to other important parts.

Name: The name of the step. This name will be displayed on top of the step's icon in the Steps pane.

Comments: The text entered here will be displayed in the tooltip that appears when hovering over the step in the Steps pane.

Goto Definition

With each type of source data, the movement of the cursor is defined in a specific way.

Text file

  • Target Type: Defines the type of jump.

    • Line: Jumps a certain number of lines or to a specific line.

      • From: Defines where the jump begins:

        • Current Position: The Goto begins at the current cursor position.

        • Top of record: The Goto begins at line 1 of the source record.

      • Move by: Enter the number of lines or pages to jump.

    • Page: Jumps between pages or to a specific page.

      • From: Defines where the jump begins:

        • Current Position: The Goto begins at the current cursor position.

        • Top of record: The Goto begins at line 1 of the source record.

      • Move by: Enter the number of lines or pages to jump.

    • Next line with content: Jumps to the next line that has contents, either anywhere on the line or in specific columns.

      • Inspect entire page width: When checked, the Next line with content and Next occurrence of options will look anywhere on the line. If unchecked, options appear below to specify in which area of each line the Goto step checks in:

        • Left: The starting column, inclusively.

        • Right: The end column, inclusively.

        • Use selection: Click while a selection is made in the Data Viewer to automatically set the left and right values to the left and right edges of the selection.

    • Next occurrence of: Jumps to the next occurrence of specific text or a text pattern, either anywhere on the line or in specific columns.

      • Inspect entire page width: When checked, the Next line with content and Next occurrence of options will look anywhere on the line. If unchecked, options appear below to specify in which area of each line the Goto step checks in:

        • Left: The starting column, inclusively.

        • Right: The end column, inclusively.

        • Use selection: Click while a selection is made in the Data Viewer to automatically set the left and right values to the left and right edges of the selection.

      • Expression: Enter the text or Regex expression to look for on the page.

      • Use selection: Click while a selection is made in the Data Viewer to copy the contents of the first line of the selection into the Expression box.

      • Use regular expression: Check so that the Expression box is treated as a regular expression instead of static text. For example, using the expression (aaa|bbb|ccc) will move the data pointer to the next line in which either "aaa", "bbb" or "ccc" occurs.
        For more information on using Regular Expressions (regex), see the Regular-Expressions.info Tutorial.

PDF file

  • Target Type: Defines the type of jump .

    • Physical distance:

      • From: Defines where the jump begins:

        • Current Position: The Goto begins at the current cursor position.

        • Top of record: The Goto begins at line 1 of the source record.

      • Move by: Enter distance to jump.

    • Page: Jumps between pages or to a specific page.

      • From: Defines where the jump begins:

        • Current Position: The Goto begins at the current cursor position.

        • Top of record: The Goto begins at line 1 of the source record.

      • Move by: Enter the number pages to jump.

    • Next line with content: Jumps to the next line that has contents, either anywhere on the line or in specific columns.

      • Inspect entire page width: When checked, the Next line with content and Next occurrence of options will look anywhere on the line. If unchecked, options appear below to specify in which area of each line the Gotostep checks in:

        • Left: The starting column, inclusively.

        • Right: The end column, inclusively.

        • Use selection: Click while a selection is made in the Data Viewer to automatically set the left and right values to the left and right edges of the selection.

    • Next occurrence of: Jumps to the next occurrence of specific text or a text pattern, either anywhere on the line or in specific columns.

      • Inspect entire page width: When checked, the Next line with content and Next occurrence of options will look anywhere on the line. If unchecked, options appear below to specify in which area of each line the Goto step checks in:

        • Left: The starting column, inclusively.

        • Right: The end column, inclusively.

        • Use selection: Click while a selection is made in the Data Viewer to automatically set the left and right values to the left and right edges of the selection.

      • Expression: Enter the text or Regex expression to look for on the page.

      • Use selection: Click while a selection is made in the Data Viewer to copy the contents of the first line of the selection into the Expression box.

      • Use regular expression: Check so that the Expression box is treated as a regular expression instead of static text. For more information on using Regular Expressions (regex), see the Regular-Expressions informational Tutorial.

CSV file

  • From (CSV files): Defines where the jump begins:

    • Current Position: The Goto begins at the current cursor position.

      • Move by: Enter the number of lines or pages to jump.

    • Top of record: The Goto begins at line 1 of the source record.

      • Move to: Enter the number of lines or pages to jump.

XML file

  • Destination (XML files): Defines what type of jump to make:

    • Sibling element: Jumps the number of siblings (nodes at the same level) defined in the Move by option.

    • Sibling element with same name: Jumps the number of same name siblings (nodes at the same level of which the node is the same name) defined in the Move by option.

    • Element, from top of record: Jumps to the specified node. The XPATH in the Absolute XPATH option starts from the root node defined by /.

    • Element from current position: Jumps to a position relative to the current position of the cursor. The XPATH in the Relative XPATH option defines where to go, ../ goes up a level, ./ refers to the current level.

    • Level Up/Down: Jumps up or down one node level (up to the parent, down to a child). The number of levels to change is defined in the Move by option. Use a negative value to jump to a parent element, a positive value to go to a child element.

JSON file

  • Destination: Defines what type of jump to make:

    • Sibling element: Jumps the number of siblings (elements at the same level) defined in the Move by option. Use a negative value to jump to the previous sibling, or a positive value to go to the next sibling. If there are not enough siblings to make the requested move, the cursor will not move.

    • Element, from top of record: Jumps to the specified element. The JsonPath in the Absolute JsonPath option starts from the root defined by $.

    • Element from current position: Jumps to a child element starting from the current position of the cursor. The JsonPath in the Relative JsonPath option defines where to go. Going up to a parent element is not possible with a relative JsonPath.If a JsonPath returns a collection of elements instead of a single element, then the GoTo step moves to the position of the first element in the collection. Other elements in the collection are ignored.

    • Level Up/Down: Jumps up or down a number of element levels (up to a parent, down to a child). The number of levels to change is defined in the Move by option. Use a negative value to jump to a parent element, or a positive value to go to a child element.