Skip to main content
Version: 5.3

Filling the Objects List

Objects can be filled in two ways:

  • Manual object creation and editing
  • Automatic object fill using a scheduled configuration

Manual Object Fill

Manual configuration allows you to create or edit an object by filling object fields.

Manual Object Creation

To create a new object:

  1. Select Objects in the User Behavior Analytics section of the navigation menu.
  2. Select the required object type in the Select type dropdown above the table.
  3. Click Create at the top of the page, to the right of the search field.
  4. In the modal window, fill the form and click Create.

Object creation modal

  1. The created object appears in the objects list.

To edit an object:

  1. Select Objects in the User Behavior Analytics section of the navigation menu.
  2. Find the object in the table.
  3. Click the pencil icon in the rightmost column (if the object is editable).
  4. In the edit modal, update the required fields.

Object edit modal

  1. Click Save in the modal to apply changes.
  2. The object is saved.
note

Only manually created objects are editable. Generated objects are updated automatically and cannot be edited.

When creating and editing objects, each base and additional field supports two field modes:

  • Text
  • Array

Switch field modes with the toggle to the left of the field name. For Text mode (left toggle position), the field looks as follows:

Text mode for object field editing

For Array mode (right toggle position), the field looks as follows:

Array mode for object field editing

note

Switching from Array mode to Text mode is available only when the array has no more than one element.

warning

Avoid duplicates when creating or editing objects. Duplicates are not added to the objects list.


Automatic Object Fill

Automatic fill lets you avoid manual object creation. Objects are filled automatically according to a configured job, which can run once or on schedule.

Configurations List

The configurations page contains a list of created configurations and supports filtering via the Search field.

To open the configurations list page, select Object Fill Configurations in the User Behavior Analytics section of the navigation menu. The configurations list is a table with:

  • Configuration name
  • Configuration object type
  • Index used by the configuration
  • Run schedule

For each configuration, an actions menu is available (rightmost column), including:

  • Edit (opens configuration settings page)
  • Configure permissions
  • Clone configuration
  • Enable/Disable configuration
  • Delete configuration

For selected configurations (checkbox-selected), bulk actions are available (Edit selected dropdown and Delete <n> configurations button), including:

  • Edit permissions for all selected configurations
  • Enable all selected configurations
  • Disable all selected configurations
  • Delete all selected configurations (the bulk delete button appears only when there are selected configurations)

Object fill configurations list

To create a new configuration, click Create to the right of the Search field. To open edit mode, click the configuration name or the corresponding action in the table actions menu.

Configuration Settings

The configuration settings page is used to create and edit object fill parameters. It contains a form panel with the following sections:

  • General
  • Schedule
  • Filtering
  • Object settings
  • Advanced settings

Object fill configuration settings page

General

The General section contains:

  1. Name: configuration name
  2. Description: detailed configuration description

Schedule

The Schedule section defines how often the configuration runs. You can use:

  1. Interval
  2. Cron expression

Filtering

This section filters source data for object list generation and contains:

  1. Index to collect data from
  2. Time interval for time-based filtering
  3. Field containing the timestamp
  4. Filter expression used for filtering

Object Settings

This section contains output object settings:

  1. UBA object type: defines object type association
  2. Object identifier field: field used to determine object uniqueness
  3. Base and additional fields: fields written to the output object

Advanced Settings

This section contains:

  1. Maximum number of objects: limit for objects written
  2. Lock duration
  3. Configuration run: enable/disable execution

Automatic Object Fill Algorithm

After filling the configuration form, click Save to save the configuration and run it on schedule.

Click Preview to see a preliminary object fill result. The settings panel is hidden and an objects table appears. The page includes:

  1. Filtering found objects using the Search field
  2. Information about found objects (above the table)
  3. Objects table

Object fill preview page

If you need to change settings, click the arrow icon to the right of the Search filter field. After preview, click Fill to populate the objects list. On success, a notification appears, and the following buttons become available: Save to save the configuration, Cancel to discard settings and return to the configurations list, and Go to objects list.

warning

Automatic fill can detect duplicates. Duplicates are not included in the objects list, and you receive a notification.