Editing Table Format Data Linked to a Parameter

You can edit the data linked to a parameter in a Table data source.

You can use the Table format to read/write a whole (one-dimensional or two-dimensional) array at once. A new parameter is created having as many elements as the swipe. To read/write an existing array, you must have a swipe exactly as large as the array parameter or the parameter must be resizable.

The Table format can read/write a cell (scalar), a whole or portion of a row or column (a one-dimensional array), or a sub-table (a two-dimensional array).

  1. Double-click the Data Exchanger component icon .

    The Data Exchanger Component Editor appears.

  2. From the Data Exchanger Component Editor, select a Table section.

  3. In the Parameter list, enter a new parameter or select an existing parameter.

  4. In the Details Swipe area, set the table swipe coordinates.

    The first two text boxes represent the starting point for the swipe. The second two text boxes represent the ending point for the swipe. The end is left empty to indicate the swipe has a length of one in that dimension.

    Consider the following information when using the Table format:

    • Leaving the column field blank in the Start coordinates highlights the entire referenced row. Similarly, leaving the Start row blank selects the entire column.

    • Blank rows are not highlighted, if selected using the table swipe coordinates.

  5. Click the Read button or Write button, as desired.

    If your selection covers more than one cell in a table and you add a new parameter, the parameter is created as an array as big as the swipe. Click a cell to select it. Triple-clicking selects a whole row. You can select a row, column, or sub-table by dragging the mouse cursor from one end to the other (for a sub-table, drag from one corner to another).

    Note: When selecting a column by dragging your mouse cursor, you must be careful where you start and end the line. If the widths of the columns vary a great deal, it can be difficult to end the drag in the same relative column in which you started. When you release the mouse button after dragging a column, the blue selection highlight shrinks to the selected column. If too many columns are selected, adjust the selection using the Table Swipe area.

    Row and column numbers may be integer constants or Java expressions (including parameter values). There are some additional constants that can be used:

    • Last. Last row in the table or last column in the row.

    • End (Last + 1). The row or column after the current end. You can manipulate the End constant (e.g., Last – 1 is the row before the last row).

  6. Click OK to save your changes and to close the Data Exchanger Component Editor.