Subscribe

UiPath Studio

The UiPath Studio Guide

Output or Screen Scraping Methods

Output or screen scraping methods refer to those activities that enable you to extract data from a specified UI element or document, such as a .pdf file.

To understand which one is better for automating your business process, let’s see the differences between them.

Capability MethodSpeedAccuracyBackground ExecutionExtract Text PositionExtract Hidden TextSupport for Citrix
FullText10/10100%yesnoyesno
Native8/10100%noyesnono
OCR3/1098%noyesnoyes

FullText is the default method, it is fast and accurate, yet unlike the Native method, it cannot extract the screen coordinates of the text.

Both these methods work only with desktop applications, but the Native method only works with apps that are built to render text with the Graphics Device Interface (GDI).

OCR is not 100% accurate but can be useful to extract text that the other two methods could not, as it works with all applications including Citrix. Studio uses two OCR engines, by default: Google Tesseract and Microsoft Modi.

Languages can be changed for OCR engines and you can find out how to Install OCR Languages here.

Capability MethodMultiple Languages SupportPreferred Area SizeSupport for Color InversionSet Expected Text FormatFilter Allowed CharactersBest with Microsoft Fonts
Google TesseractCan be addedSmallyesyesyesno
Microsoft MODISupported by defaultLargenononoyes

To start extracting text from various sources, click the Screen Scraping button, in the Wizards group, on the Design ribbon tab.

The screen scraping wizard enables you to point at a UI element and extract text from it, using one of the three output methods described above. Studio automatically chooses a screen scraping method for you, and displays it at the top of the Screen Scraper Wizard window.

1102

To change the method of screen scraping, select another one from the Options panel and then click Refresh.

When you are satisfied with the scraping results, click Copy to Clipboard and then Finish. The latter option copies the extracted text to the Clipboard, and it can be added to a Generate Data Table activity in the Designer panel. Just like desktop recording, screen scraping generates a container (with the selector of the top-level window) which contains activities, and partial selectors for each activity.

1102

Each type of screen scraping comes with different features in the Screen Scraper Wizard, in the Options panel:

  1. FullText
1108
  • Ignore Hidden – when this check box is selected, the hidden text from the selected UI element is not copied.
  1. Native
1101
  • No Formatting – when this checkbox is selected, the copied text does not extract formatting information from the text. Otherwise, the extracted text’s relative position is retained.
  • Get Words Info – when this checkbox is selected, Studio also extracts the screen coordinates of each word. Additionally, the Custom Separators field is displayed, which enables you to specify the characters used as separators. If the field is empty, all known text separators are used.
  1. Google OCR
1103
  • Languages – only English is available by default.
  • Characters – enables you to select which types of characters to be extracted. The following options are available: Any character, Numbers only, Letters, Uppercase, Lowercase, Phone numbers, Currency, Date and Custom. If you select Custom, two additional fields, Allowed and Denied, are displayed that enable you to create custom rules on which types of characters to scrape and which to avoid.
  • Invert – when this checkbox is selected, the colors of the UI element are inverted before scraping. This is useful when the background is darker than the text color.
  • Scale – the scaling factor of the selected UI element or image. The higher the number is, the more you enlarge the image. This can provide a better OCR read and it is recommended with small images.
  • Get Words Info – gets the on-screen position of each scraped word.

📘

Note:

In some instances of UiPath Studio, the Google Tesseract engine may have training files (about training files: Wikipedia, GitHub) that do not work for certain non-English languages. Running a project with these corrupted training files may lead to an exception being thrown. To fix this issue, download the training file for the language you wish to use from here and copy it into the tessdata folder from the UiPath installation directory. To check if the training files you downloaded work, you can download this test project.

  1. Microsoft OCR
1100
  • Languages – enables you to change the language of the scraped text. By default, English is selected.
  • Scale – the scaling factor of the selected UI element or image. The higher the number is, the more you enlarge the image. This can provide a better OCR read and it is recommended with small images.
  • Get Words Info - gets the on-screen position of each scraped word.

Besides getting text out of an indicated UI element, you can also extract the value of multiple types of attributes, its exact screen position, and its ancestor.

This type of information can be extracted through dedicated activities that are found in the Activities panel, under UI Automation > Element > Find and UI Automation > Element > Attribute.

These activities are:

  • Get Ancestor – enables you to retrieve an ancestor from a specified UI element. You can indicate at which level of the UI hierarchy to find the ancestor, and store the results in a UiElement variable.
393
  • Get Attribute – retrieves the value of a specified UI element attribute. Once you indicate the UI element on screen, a drop-down list with all available attributes is displayed.
393
  • Get Position – retrieves the bounding rectangle of the specified UiElement, and supports only Rectangle variables.
393

UiPath Studio also features Relative Scraping, a scraping method that identifies the location of the text to be retrieved relative to an anchor. You can find more about it here.

You can also generate tables from unstructured data and store the information in DataTable variables, by using the Screen Scraping Wizard. For more information, see Generating Tables from Unstructured Data.

Updated 2 years ago


Output or Screen Scraping Methods


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.