Applies to:
Foxtrot — All Editions

Summary:
Foxtrot’s Action Builder contains various settings for Timing, Errors, and Advanced options. Chapter 18 of the Foxtrot Training Guide does a great job in explaining the Timing and Error options, while outlining the Advanced options. By default, the Advanced settings are set automatically when creating an action. They should only be modified by experienced users. You can always revert back to the automatic settings by clicking ‘Reset’ in the Advanced Tab.

You may wish to explore the parameters of the Advanced tab when:

  • An action works for one record and does not work for the next
  • An action causes an error in which The target could not be found
  • Handling Warning Messages in Navigator

The following are options that may be available in the Advanced Tab. Note that you may see all, or none of these options, depending on the target (for example, there are no Advanced options when targeting Excel).

  • Target Caption
  • Target Element ID
  • Target Element Name
  • Caption for Parent Table

For each option above, the following parameters may be customized:

  • Use an Exact Match to locate the target
  • Use a Best Match to locate the target
  • Use leading characters to locate the target
  • Do not use this method to locate the target

 

Consider the table below:

Foxtrot’s Advanced Options

Caption for Parent Table # 2The column headers for the next inner most table.Targeting this cell will display the column headers for this table: Name, Description, Example, Use under Caption for Parent Table #1. In addition, Caption for Parent Table # 2 will also be displayed as Foxtrot’s Advanced Options. This is because this table in particular is two tables; one which has dimensions 5×5 is actually inside the table with dimensions 1×1.Assist Foxtrot in locating a target within multiple web tablesProfessional and Enterprise Editions — Only available when targeting a web table.

Name Description Example Use Availability
Target Caption The text displayed on a targeted item. When targeting a button that reads Go, the Target Caption is Go. Assists Foxtrot in locating a target. Web, Windows
Target Element ID A unique ID assigned to the targeted element. This ID is assigned by the author of the application or web page. A developer may assign the ID 123456789 to an element (button, link, image, etc…) in order to define it’s uniqueness. Additional information Foxtrot uses to better locate a target. Web, Windows
Target Element Name A unique name assigned to the targeted element. This is assigned by the author of the application or web page. A developer may assign the name ‘button123’ to an element (button, link, image, etc…) in order to define it’s uniqueness. Additional information Foxtrot uses to better locate a target. Web, Windows
Caption for Parent Table # 1 The column headers for the inner most table. Targeting the table header Foxtrot’s Advanced Options will display the only table header for the particular table; that being Foxtrot’s Advanced Options. Assist Foxtrot in locating a target a web table Professional and Enterprise Editions — Only available when targeting a web table.

 

Toggle to the Advanced tab of the Action Builder. When targeting the table above, you will see all available options:

    • Target Caption: Is the first option that may be visible and therefore configurable. The Target Caption displays the actual text of the object that has been targeted. When Targeting the cell ‘Name’ above, Foxtrot will use the literal text of the target, Name, to assist in locating the target. If this value were to change on a record-to-record basis, it may be helpful to uncheck the checkbox to Require matching caption to locate the target.

      For example, when clicking a “Submit” button, it may not be neccessary to alter the Target Caption, as this text will not likely change. However, when clicking or copying something unique like a birthdate, a SSN, or a phone number, it may be neccessary to ignore the Target Caption by unchecking the checkbox labled Require matching caption to locate target, as we do not want to match a Target Caption that could be dynamic.

      Additionally, you can use Tokens as your Target Caption by clicking the magic wand along the right.
      Target Caption

    • Target Element ID & Target Element Name:The Target Element ID and Target Element Name is a unique ID & name assigned to an object. This value typically does not need to be changed

 

  • Caption for Parent Table: When targeting a web table, you may see options for Parent Tables. In this example, targeting the cell ‘Name’, will display options for Parent Table # 1 and Parent Table # 2. Targeting the cell ‘Foxtrot’s Advanced Options’, will only display options for Parent Table # 1. When targeting your browser, you may see 3, 4, even 10 Parent Tables. When this happens, it is attributed to the fact that you have targeted a table that is a child of another table; or a table within a table.This option will display any table headers associated with the target table and its parents. If the target is not within a table, these options will not be visible. The table above, for example, is actually two tables or, a table within a table:
    • The outmost table is that with the header Foxtrot’s Advanced Options
    • Inside this table is a new table with the headers Name, Description, Example, Use, Availability

    Depending on the structure of the table, it may be neccessary to adjust the Column Captions. In this example, you may notice the Column Captions, or headers: Name, Description, Example, Use, Availability – just as they appear in the table above. In some cases however, there may be unique information present. To clear anything that may be unique – something present in the current record but may not be visible in a future record – simply set the Length of the respective field to ‘0’.
    (When clearing Warning Messages in Navigator, it is neccessary to clear the information in Parent Table # 1 as the actual message may differ).

    Caption for Parent Table # 1
    Caption for Parent Table # 2

Last Modified 10/23/2014