Help Centre › Building Processes
Description
These actions read data from the terminal screen, including full screen dumps, text at specific positions, field values, and text search.
Screen Reading
- terminal-read-screen – Read the full screen as a list of strings (one per row)
- terminal-read-text – Read text at a specific position (row, column, length)
- terminal-read-area – Read a rectangular area of the screen
Field Reading
Terminal screens are composed of fields (input areas and protected labels). Fields are identified by a 0-based index.
- terminal-read-field – Read a single field value by index
- terminal-read-all-fields – Return all fields with positions, values, and attributes (protected, numeric, hidden)
Find & Verify
- terminal-find-text – Find text anywhere on screen, returns row and column position (or null)
- terminal-screen-matches – Check if specific text exists at a given screen position (returns true/false)
- terminal-identify-screen – Match the current screen against named patterns to identify which screen is displayed