Attributes#

Attributes allow you to define and designate areas of the document from which data will be recognized by the Robot and imported into the Results table.

The main tools for working with Attributes:

No.ToolDescription
1.button Allows you to add a new Attribute.
2.button Allows you to move the Attribute up.
3.button Allows you to move the Attribute down.
4.button Allows you to copy the selected Attribute.
5.button Allows you to delete the selected Attribute.
6.button Allows you to add a new binding to the selected Attribute.
7.button Allows you to delete the selected binding.
8.button Allows you to move the binding up.
9.button Allows you to move the binding down.

Properties of Attributes#

When creating a new Attribute, a list of properties and tools for working with the Attribute opens on the workspace panel.

Properties and tools for working with the Attribute:

No.Property/ToolDescription
1. NameThe name of the Attribute that will be reflected in the results.
2.Anchor BindingsA list of anchor bindings for the Attribute.
3.Line Restrictions

When this setting is enabled, line restrictions are searched for.

The Attribute can be restricted from any side relative to the lines recognized by the OCR module. These lines are displayed when the “OCR Lines” button is pressed. Possible values:

  • None – disabled;
  • UpDown – from the top and bottom;
  • Up – from the top;
  • Down – from the bottom.
4.Adjust Angle

When this setting is enabled, the angle of the area is adjusted.

The area is adjusted if it touches the borders of the table.

When the “Auto Align” value is enabled, angle adjustment is not needed.

5.Area Binding

The binding to the area is done by 4 parameters:

  • X coordinate,
  • Y coordinate,
  • width,
  • height of the area.

The origin point of the area is at the top left.

6.AreaThe rectangle of the Attribute area on the page.
7.Min Number of Characters

The minimum number of characters contained in the Attribute.

The default value is set to 0.

This setting is used if the Attribute must contain a certain number of characters, for example, the “Tax ID” Attribute. If the computed value is less than specified, an error will be generated.

8.Data Type

The data type for the Attribute.

Possible values:

  • Text – text;
  • Int – integer;
  • Float – floating-point number;
  • Date Time – date and time;
  • Chars – only letters (digits and other characters are excluded);
  • CountColorHSV – the number of points in a specified color range.

    The value must be specified in the format “H1-H2;S1-S2;V1-V2”,
    where H1, S1, V1 – are the minimum values, and H2, S2, V2 – are the maximum values;
  • Regex – regular expression.
9.Value Format

The format of the Attribute value. Specifies the formatting of the value.

For example:

  • If the value type is date and time, to get only the date, you need to specify “dd.MM.yyyy”;
  • If the value type is CountColorHSV, you need to specify the color range in the format “H1-H2;S1-S2;V1-V2”. The format is specified without quotes;
  • If the value type is Regex, you need to specify the regular expression.
10.Error if Value is EmptyIf the Attribute value is empty during template processing, a recognition error will be generated.
11.Check Anchor BindingsCheck the anchor bindings of the Attribute. When this setting is enabled, the anchor bindings will be checked. If any of the bindings are not found, the Attribute will also not be found.
12.Operating Mode

The operating mode of the Attribute. Possible values:

  • Default - standard operation of the Attribute (its value will be filled in upon the first successful identification of Anchors);
  • Append - adding a value to the Attribute upon each successful identification of Anchors on subsequent pages;
  • Overwrite - overwriting, rather than adding, the value of the Attribute.
13.DescriptionUser description of the Attribute.