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
- Click Settingsin the left navigation bar of the Disclosure Management website.
- Click Angles Admin Config in the SETTINGS bar. The Angles Admin Config page displays.
- Click the Add New Token button. The Add New Token dialog appears.
- 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.
- 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.
- 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:
- Create the admin token in the Lineos platform. Use an Angles Professional account that has access to all business views in your organization.
- Save the token in Disclosure Management as a tenant-level setting.
- 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.