Rocket BlueZone emulator methods

  • Release version: Zurich
  • Updated July 31, 2025
  • 7 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Rocket BlueZone Emulator Methods

    Rocket BlueZone emulator methods enable ServiceNow customers to automate tasks on the Rocket BlueZone terminal emulator screen effectively. These methods are divided into two categories: screen-level methods that interact with the emulator screen as a whole, and element-level methods that operate on specific screen elements such as fields or tables. Understanding and using these methods allow automation of data retrieval, input simulation, and screen state verification within terminal emulator sessions.

    Show full answer Show less

    Screen-level Methods

    • GetFieldText: Retrieves text from a specific field identified by its starting row and column coordinates.
    • GetTextFromRect: Extracts text from all fields within a defined rectangular area on the screen using start and end row/column boundaries.
    • IsCreated: Checks whether the emulator screen exists and is ready for input, with an option to match all child elements for more precise verification (may impact performance).
    • SearchText: Finds the first occurrence of specified text within the screen and returns its row and column location; supports only text within a single field.
    • SendKeys / SendKeysSecure: Simulates keyboard input at the current mouse position on the emulator screen, including secure input for sensitive data.
    • SetCursorPosition: Moves the mouse pointer to a specified row and column on the screen, within screen size limits.
    • WaitForCreate: Waits for a specified timeout duration to detect if the emulator screen appears based on screen matching rules, optionally matching all child elements.

    Element-level Methods

    • GetAsTable: Returns captured screen data as a data table object, useful when screen data is captured in table format.
    • GetText: Retrieves text from a captured field; when used on a table, returns the text from the first field.
    • IsCreated: Verifies the existence and activity of a captured screen element, returning a Boolean result.
    • SetText: Attempts to set specified text into a captured field; not applicable on protected screens.
    • WaitForCreate: Waits for a specified time to detect the presence of a captured screen element based on matching rules.

    Practical Benefits for ServiceNow Customers

    These methods provide precise control and interaction with terminal emulator screens, enabling:

    • Automated data extraction from legacy systems accessed via terminal emulators.
    • Simulation of user input to automate workflows involving mainframe or terminal-based applications.
    • Verification of screen and element presence to ensure reliable automation sequences.
    • Secure handling of sensitive input through secured keystroke simulation.

    By leveraging these methods, ServiceNow customers can integrate terminal emulator interactions into their automation processes, increasing efficiency and reducing manual effort when working with legacy systems.

    Use the Rocket BlueZone emulator methods to perform various automation tasks on the Rocket BlueZone emulator.

    Screen-level methods

    Use screen-level methods to perform the automation tasks on the emulator screen. For example, you can use simulate a command on the screen or get text from the screen.

    GetFieldText

    Returns the text that a field contains after it identifies the field by the row and column number that you specify. The row and column that you specify are the starting point of the field. The method identifies the whole field and then returns the text in the field. In the following example, H is the first letter and the starting point in the field and Host OS : is the complete text in the field.

    Screen that shows the first letter in the field and the complete text in the field.

    The GetFieldText method with its parameters.

    Table 1. GetFieldText method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    Row Field row number that identifies the field. Data In Integer NA Yes
    Column Field column number that identifies the field. Data In Integer NA Yes
    Return Returns the text in the field. Data Out String NA NA

    GetTextFromRect

    Returns the text in all the fields of a rectangular area that you define on the screen. You define an area by providing the starting and ending rows and column numbers. The method locates and identifies the first and the last fields and returns all the text in all the fields within that area. The following example shows the area that you defined.

    Area that you defined to show the first cell of the first field and the last cell of the last field.

    GetTextFromRect method image.

    Table 2. GetTextFromRect method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    StartRow Row number that indicates the first character of the first field in the rectangular area. Data In Integer NA Yes
    StartCol Column number that contains the first character of the first field in the rectangular area. Data In Integer NA Yes
    EndRow Row number that contains the last character of the last field in the rectangular area. Data In Integer NA Yes
    EndCol Column number that contains the last character of the last field in the rectangular area. Data In Integer NA Yes
    Return Returns the text from all the fields within the rectangular area. Data Out String NA NA

    IsCreated

    Verifies whether the emulator screen exists based on the screen match rule and can accept inputs from the user. After verification, the method returns the appropriate Boolean value.

    IsCreated method.

    Table 3. IsCreated method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    MatchAllChildren Option to find the emulator screen by matching the child elements that you have captured. Data In Boolean False Yes
    Warning:
    Using this option may slow down the method.
    Return Returns the Boolean value depending on whether emulator screen exists based on the screen match rule and can accept inputs from the user. Data Out Boolean NA NA

    SearchText

    Returns the numbers of the row and column that holds the first character of the text that you specify. For example, if you specify the string emulator, the method returns the row and column numbers of the starting point of the word emulator which is e.
    Note:
    If you provide the text that spans multiple fields, the Row and Col ports return 0 because the method supports the text only from a single field.
    SearchText method.
    Table 4. SearchText method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    Text Text that the method searches. Data In String NA Yes The text you specify may be case-sensitive depending on the emulator you use.
    Row Row number that has the first character of the text you specify. Data Out Integer NA NA If the text that you specify occurs at multiple rows and columns, the method returns the first row and column that contains the text.
    Col Column number that has the first character of the text that you specify. Data Out Integer NA NA If the text that you specify occurs at multiple rows and columns, the method returns the first row and column that contains the text.

    SendKeys

    Simulates the keystrokes that you enter from the keyboard at the mouse device position on the emulator screen. For example, you can simulate the <enter> keystroke on the screen.

    SendKeys method.

    Table 5. SendKeys method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    Keys Keystrokes that you enter from your keyboard. Data In String None Yes
    Tip:
    To learn about the keystrokes, refer the respective terminal emulator documentation.

    SendKeysSecure

    Simulates the keystrokes that is a secured string at the mouse device position on the emulator screen.

    SendKeysSecure method.

    Table 6. SendKeysSecure method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    Keys Keystrokes that you enter as a secured string. Data In Secured String None Yes
    Tip:
    To learn about the keystrokes, refer to the respective terminal emulator documentation.

    SetCursorPosition

    Attempts to set the mouse device at the row and column number that you specify.

    SetCursorPosition method.

    Table 7. SetCursorPosition method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    Row Option to provide the number of the row based on which the method attempts to set the mouse device on the screen. Data In Integer NA NA The row number must be positive and within the size of the emulator screen. For example, if the screen size is 24X80, the maximum value that you can provide for a row is 24.
    Col Option to provide the number of the row based on which the method attempts to set the mouse device on the screen. Data In Integer NA NA The column number must be positive and within the size of the emulator screen. For example, if the screen size is 24X80, the maximum value that you can provide for a column is 80.

    WaitForCreate

    Waits for the duration that you specify while the connector uses the screen match rule to find whether the screen exists.

    WaitForCreate method.

    Table 8. WaitForCreate method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    timeoutinSeconds Option to provide the number of seconds for which the method waits while the connector uses the screen match rule to find if the screen exists. Data In Integer 30 Yes
    MatchAllChildren Option to match all screen elements that you had captured to find if the screen exists. Data In Boolean False Yes
    Warning:
    Using this option may delay the execution of the method.
    Return Returns the Boolean value based on whether the emulator screen was found. Data Out Boolean NA NA

    Element-level methods

    Element-level methods perform automation tasks on the emulator screen elements that you add from the Terminal Connector screen. You can add a screen element as a field or a table.

    GetAsTable

    Returns the text that you captured as a data table object. Use this method when you capture the data from a screen as a table. However, you can also use the method for the data that you capture as a field. To learn how to capture the data as a table, see Configure the IBM Personal Communications emulator.

    GetAsTable method.

    Table 9. GetAsTable method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    Return Returns the captured text from the terminal screen as a data table object. Data Out Data Table NA NA To view the table, right-click the parameter and select Preview Data.

    GetText

    Returns the text in the field that you captured from the emulator screen. If you use this method for a table that you captured, it returns the text in the first field of the rectangle.

    GetText method.

    Table 10. GetText method parameters
    Parameter Description Data port entry type Data type Default value Mandatory? Notes
    Return Returns the text from the captured field. Data Out String NA NA

    IsCreated

    Matches the rules and verifies whether the captured element exists.

    IsCreated method.

    Table 11. IsCreated method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    Return Returns the Boolean value based on whether the element is active. Data Out Boolean NA NA

    SetText

    Attempts to set the text to the field.

    SetText method.

    Table 12. SetText method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    Text Option to specify the text that the method attempts to set in the field. Data In String NA Yes You can't use this method on protected emulator screens.

    WaitForCreate

    Waits for the duration that you specify while the connector uses the match rule to find whether the element exists.

    WaitForCreate method.

    Table 13. WaitForCreate method parameters
    Parameter Description Data port entry type Data type Default value Mandatory Notes
    timeoutinSeconds Option to provide the number of seconds for which the method waits while the connector uses the match rule to find whether the element exists. Data In Integer 30 Yes
    Return Returns the Boolean value depending on whether the element was found. Data Out Boolean NA NA