Adding and Applying Transformations

Transformations complement the Obfuscate user data function and allow you to edit and anonymize information in the recorded data in order to protect sensitive information.

For example, during the logging process, potentially sensitive information may appear in URLs or event names. This data can be viewed in the Task Definition Editor after uploading the logs to ABBYY Timeline. To hide this text from users, you can use transformations.

IMPORTANT NOTE - BE CAREFUL WHEN USING TRANSFORMATIONS

  • Transformations can greatly affect the results of automatic task definition in ABBYY Timeline.
  • Transformations CANNOT BE UNDONE.

Before applying transformations in production environment, complete the following steps:

  1. Record a representative sample of logs for creating and testing regular expressions. To do this:
    1. Go to the Recorders tab.
    2. Select a Recorder instance.
    3. Make sure the correct template is assigned to this instance.
    4. Click Start.
  2. Examine the data that may appear in logs and select texts that should remain confidential. To do this:
    1. Go to the Logs tab.
    2. Select log and click its LogID.
    3. As a result, a window with information about the selected log will open.

      This window displays all events recorded in the current log. The selected event is highlighted in color, and a screenshot is displayed for it, provided that you have enabled screenshot recording. The path to the application name or URL is displayed below the screenshot.

      Inspect all event names and URL text. Sometimes titles, names, addresses, and other fragments of texts that should remain confidential may appear. In the following step you can prepare regular expressions that will be used to find and replace all such occurrences in the detected text and URL's.
  3. Prepare regular expressions and replacement strings.
    Examples:
What to look for Regular expression to replace Replacement string
John (J|j)ohn.* FIRST_NAME

john.smith@abbyy.com

ivan.ivanov@abbyy.ru

\w+.\w+@abbyy\.(com|ru) first.last@abbyy.com
Customer: John Doe Customer:[\s+\w+]+ Customer: Customer's Name
  1. Add transformations and test them out by applying them to one or two logs.
    For details, see How to add a new transformation and Post-recording transformation below.
  2. If you are satisfied with the changes, apply the transformations to all recorded logs or add them to the template to transform data on the fly.

How to add a new transformation

  1. Go to the Transformations tab.
  2. Click Add Transformation.
  3. In the opened windows, specify the following transformation parameters:
    1. Regular expression
      To search for a text string, enter a regular expression using Regex syntax.
    2. Replacement
      To replace instances of the text string in logs with another string, enter the replacement string.
    3. Case insensitive
      By default, the search is case-sensitive. If this option is selected, the search will not be case-sensitive.

Important. If you edit or delete a transformation, the changes will propagate to all the templates that include this transformation.

How to apply transformations

On-the-fly transformation

To apply transformations while recording data to logs, add transformations to a template and assign it to a Recorder instance.

  1. Go to the Templates tab.
  2. Click a template name or create a new one.
  3. Click Transformations and then Add item.
  4. In the window that will open, select transformations and click Add.
  5. Assign transformations to a Recorder instance.
    To do this:
    1. Go to Recorders.
    2. Check the Recorder instance on which you want to set up a template with a new transformation.
    3. Click Set Template.
      In the list that will open, click the template, and then click Select.
    4. The recording runs automatically when the Start recording when assigned to Recorder is enabled in the template. Otherwise, click Start to run the recording.
Post-recording transformation

In the Recording Service you can apply transformations to logs that have already been recorded. To do this, complete the following steps:

  1. Go to the Logs tab.
  2. Select logs.
  3. Click Apply transformation.
  4. In the opened form, select transformation and click Apply to selected logs.

Important. If you cancel a running transformation, the transformed portion will not be undone.

22.09.2023 8:59:47

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.