TaggedTextColumns

Note: This option has not been completely described yet. Should you have any questions, feel free to contact us.

When rule groups are created, specially selected text sections from the rule group condition text (usually condition C01) and from the rule group value texts (C01/01, C01/02 etc.) can be presented in additional columns and marked in colour.

In the case of the first rule group value (C01/01) the text of the rule group condition is additionally analysed, first of all, whereas for all other rule group values (C01/02, C01/03, etc.) only the corresponding text is analysed.

Tagging of a text starts with a special character (square brackets are used in this case), followed directly by a keyword determining the text section.

An example:

-TaggedTextColumns "[Status [Handling status-FB [Handling status-IT"

Three extra columns are thus created with the keywords used as column headers. Keywords are placed in single or double quotation marks, separated by blank spaces.

The logically leading keyword is always the first keyword, “Status” in this example. All other text sections that appear between two “Status” sections are logically assigned to the first “Status” section and presented along with it in the same table row.

In addition, an extra Excel sheet is created in which only the rows with text sections filled out are presented in detail.

Marking of text sections in texts for rule groups

A marked text section always consists of whole rows only.

Marking of text section (tagging) is used for the following purposes:

  • To mark the beginning, i.e. the first row of a text section

  • To determine the type, i.e. column assignment of a text section via a keyword

Beginning, the first row of a text section:

  • The first row of a text section must contain one of the specified tags “anywhere”

  • Tags are not case-sensitive.

  • The tag does not have to be placed at the beginning of the row.

End, the last row of a text section:

  • In addition to actual end of a text, each row which contains the selected special character (square bracket in this case) is also regarded as the beginning of a new text section

  • This means that the last row of a text section is the last non-empty row preceding the row containing the selected special character.

Optional: Determining background colors

The background color for representing a text section can be managed “centrally” for a project via keywords contained in the section; below an example of corresponding entries in the configuration file Project.ini

A new key is entered for it in the project configuration file Project.ini (being case-insensitive): Tagged.Text.<No>:

<No> is a consecutive number

  • It determines the sequence of preprocessing and the first entry matching a text section is used (i.e. a TODO still contained in it overrides simultaneously contained OKs, if any)

  • The numbers must not be exactly consecutive, however, the gap between numbers may not exceed 10.

  • Leading zeros cannot (yet) be used

Each key Tagged.Text.<No>: is then followed by further entries in the row, separated with a semicolon (upper/lower case being irrelevant). Terms not listed between semicolons are ignored here and can be used e.g. as a comment. See as an example explanations for the colors orange, red, blue and green in the example above.

Color=…

  • Colour entries

  • Three digit values separated with a comma (0-255) for the colors: red, green and blue

  • Or a six-digit hexadecimal value, such as e.g. FF7450

IncludeTags=…

  • A list of keywords separated with a comma; keywords are case-insensitive

  • If a text contains a keyword, this configuration, i.e. the color is used.

ExcludeTags=…

  • A list of keywords separated with a comma; keywords are case-insensitive

  • If a text contains keywords, this configuration is not used even if one of the IncludeTags would match.

An interesting website for color selection can be found here: https://paletton.com