Skip to main content

Configure Data Access to Business Views

Disclosure Management can connect to your business views in Angles Professional to use them as the data source for your data queries. Before that, admin users need to configure the tenant-level API keys in the Disclosure Management website to get Angles Professional data access.

Configure the API Keys

  1. Click Settingsin the left navigation bar of the Disclosure Management website.
  2. Click Angles Admin Config in the SETTINGS bar. The Angles Admin Config page displays.

    The Angles Admin Config page for configuring Angles Professional data access

  3. Click the Add New Token button. The Add New Token dialog appears.

    The Add New Token dialog for adding API key and setting expiry date

  4. In the API key field, paste the Angles Professional API key that has access to all business views you want to use as data sources in Disclosure Management.
  5. Click the calendar icon to set the expiry date for this tenant's data access. Leave the Expiry date field blank if no expiry if needed.
  6. Click Add Token.

How Disclosure Management Connects to Business Views

Disclosure Management uses two types of API key (access credentials) to work with business views. Each key handles a different task.

  • User token: Controls which business views you can see and select.
  • Admin token: Retrieves the data for business views, including scheduled background refreshes.

Keeping these tasks separate ensures that you see only the business views you have permission to access, while Disclosure Management still refreshes your data efficiently in the background.

The User Token

Disclosure Management creates a user token for you automatically when you work in the website and stores it for you. You do not need to create or enter it.

Disclosure Management uses your user token when you:

  • Browse or search business views while you create a data query.
  • Select a business view and turn it into a data source.

Your user token shows only the business views you have permission to access in Angles Professional.

The Admin Token

An administrator creates the admin token in the Lineos platform and saves it in Disclosure Management as a tenant-level setting. Disclosure Management uses the admin token to retrieve business view data, including filtered data and background refreshes. You do not select the admin token yourself, and it does not determine which business views you can see.

Which Token Is Used for Each Task

Task

What it does

Token used

Browse and search business views

Shows the business views you can choose from when you create a data query.

User token

Create a data source from a business view

Turns the business view you selected into a data source.

User token

Retrieve business view data

Pulls the data for a business view, including previews.

Admin token

Retrieve filtered data and refresh data

Pulls filtered data by using query variables, including background refreshes.

Admin token

Information for Administrators

Follow these steps to keep the admin token working:

  1. Create the admin token in the Lineos platform. Use an Angles Professional account that has access to all business views in your organization.
  2. Save the token in Disclosure Management as a tenant-level setting.
  3. Note that the token is valid for six months. Regenerate it in the platform and save it again in Disclosure Management before it expires.

If the admin token expires, Disclosure Management cannot retrieve business view data or run background refreshes until you replace it.

Troubleshooting

If a business view you expect does not appear when you create a data query, ask your administrator to confirm that your account has access to that business view in Angles Professional.

If your business view data stops refreshing, ask your administrator to check that the admin token is still valid.

Recently Viewed