Data Observability platform Help

Estonian Data Portal (ATV)

Estonian Data Portal (ATV) allows user to sync data directly from SelectZero data catalog to ATV with few simple clicks.

Enabling ATV feature

To enable ATV feature, following environment variable needs to be passed to the container:

VARIABLE NAME

VARIABLE VALUE

ATV_ENABLED

true

Setting up connection to ATV

When ATV is enabled, new tab can be found under settings called "ATV"

Initially we need to set up credentials to connect with atv

Generating ATV Api key

  1. Log in to ATV portal

  2. Choose your organization

    atv_org_selection.png

  3. Copy your organization id from URL https://andmed-test.eesti.ee/organization/my-organization/XXXXXXX-XXXX-XXXX-XXXX-XXXXXXX

  4. Press "API settings"

    atv_api_settings_button.png

  5. Press "Create new key"

    atv_create_new_api_key_button.png

  6. Write down the API key and API key ID from the opened prompt (these will be needed later for the integration)

Adding ATV connection to SelectZero

  1. Navigate to "Settings" -> "ATV"

  2. Press "Credentials"

    atv_credentials_button.png

  3. Fill out ATV credentials

    atv_credentials.png

    • Service URL - ATV service url, can be used against TEST environment if needed

    • Organisation id - Taken from step 3

    • API key id - Taken from step 6

    • API key secret - Taken from step 6

  4. Press save

Preloading ATV custom fields

  1. Press "Sync custom fields"

    atv_sync_custom_fields_button.png

  2. Confirm the prompt

  3. ATV custom fields will be loaded with options

NB! In case the connection is poorly set up, this process will fail

Creating an ATV mirroring

Dataset (with data elements)

For setting up a dataset to be synced, you need to do the following steps:

  1. In "Catalog → Objects" create a new dataset

  2. Fill in the ATV custom fields which have been generated by sync

  3. Assign Data objects to the dataset

  4. Pick out fields that need to be sent to ATV

    • You can add ATV publish flag to the columns directly from object view

    • You can also add ATV publish flag to columns from "Attributes" tab with mass action

  5. After data is prepared, admin can create an ATV "Dataset" mirroring from "Settings → ATV"

    Dataset mirroring

  • Name - Alias for given mirroring (Only for inner usage)

  • Mirroring type - Dataset

  • Dataset - Created dataset from step 1

  • Data glossary - (Optional) data glossary which will be connected with the dataset

Data glossary

For setting up a data glossary to be synced, you need to do the following steps:

  1. In "Catalog → Glossary" create a new data glossary

  2. Fill in the ATV custom fields which have been generated by sync

  3. Assign Terms to the glossary

  4. Connect data glossary terms to attributes

  5. After glossary is ready, admin can create an ATV "Dataset" mirroring from "Settings → ATV"

    Data glossary mirroring

  • Name - Alias for given mirroring (Only for inner usage)

  • Mirroring type - Data glossary

  • Dataset - (Required) Existing dataset mirroring

  • Business glossary - (Optional) business glossary connected with the data glossary

Business glossary

For setting up a business glossary to be synced, you need to do the following steps:

  1. In "Catalog → Glossary" create a new business glossary

  2. Fill in the ATV custom fields which have been generated by sync

  3. Assign Terms to the glossary

  4. Create relations between terms if needed. ATV supports relations:

    • Synonym

    • Wider

    • Narrower

    • Groups

    • In group

  5. After glossary is ready, admin can create an ATV "Dataset" mirroring from "Settings → ATV"

    Business glossary mirroring

  • Name - Alias for given mirroring (Only for inner usage)

  • Mirroring type - Business glossary

  • Glossary - (Required) Glossary created in step 1

Syncing mirroring with ATV

  1. Open mirroring object by clicking on the row

  2. Press "Sync"

  3. After sync fields will be available under ATV dataset

  1. Open mirroring object by clicking on the row

  2. You can navigate to dataset by clicking on its id link

    atv_dataset_id_link.png

  3. This will open ATV in a new window

26 December 2025
Custom fieldsCommon actions