System Admin


Client Configuration

The creation of a Client Configuration (also known as Parent-Client Configuration) in Studio, allows for configuration data which is repeated across a variety of apps to be contained and maintained in a single space.

This means efficient and unilateral management of updates to Tokens, URLs or Data Sources, etc. Any app which uses the Client Configuration will automatically receive updated data.

This can improve performance speed and caching of requests by reducing app size when loading multiple apps on a page, and makes maintenance of configuration settings more efficient.

Table of Contents

Creating a Client Configuration

  1. With the Client Configurations tab in Studio selected, click + to add a new Client Configuration.
  2. Enter a Name and Description, then use the dropdown to select Configuration Base for Type, and Kurtosys Default for Configuration to Clone, then click Save.
  3. Type in a comment, then click Confirm.

Client Configuration Setup

  1. Click on the configuration.
  2. Click the Settings cog.
  1. There is no need to select a Parent Client Configuration as this is the highest level Client Configuration. If you are creating another Client Configuration in a hierarchical structure, you would select a configuration from this dropdown list.
  2. If you are using the Token for this particular client instance, click Use Default Token. The token will be added for you. If you are using a token belonging to a different instance, type in the token.
  3. Type in the Service Url. Depending on the environment where your client instance is hosted, this could be https: / / api-uk or us or
  4. Click the UI icon, then click Add Element+.
  1. Click Select All, or select the specific elements you would like to set global settings for, e.g. Culture and Data, then click Save. Any selections that are made here will not need to be set in apps that use this configuration as their Parent Client Configuration.
  2. Click Culture (or any of the elements you added in the previous step).
  1. Enter Default for Base*.
  2. Use one of the cultures from your Data Dictionary to be the Default* culture, e.g. en-GB.
  3. Click back to Configuration Base, then click Data.
  1. Click Add Element+.
  2. Select Context, then click Save.
  1. Click Context.
  2. Click Add Element+.
  1. Select Entity By Type, then click Save. Set up the entity to be used for searching for data.
  2. Click Entity By Type.
  1. Click Add Element+.
  2. Select the Entity type or types that will be used for calling data, then click Save.
  1. Click Fund or Share Class (or whichever entity type you have selected).
  2. Click Add Element+.
  1. Select Client Code Property, Include and Input Key, then click Save.
  2. Enter a Client Code Property to reference the Fund entity, e.g. fund_code (this will match the code added for this particular property in the Data Dictionary).
  3. Enter an Input Key, this could be fund_code or clientCode.
  4. Click Include. Here you can choose property types to be included when using the Fund entity identifier.
  1. Click Add Element+.
  2. Select any property types to be used with the fund_code (Client Code Property), then click Save.
  1. If you have included properties like Statistics, Allocations or Timeseries, you can Limit To specific ones to avoid calling all. This will mean a quicker response time for returned data.
  2. Do this by clicking e.g.  Statistics, then Add Element+ on the next screen.
  3. Select Limit To, click Save.
  1. Click Limit To.
  2. Click Add Row+. Type in the (Statistic) Property Codes to be included.
  3. If you have selected multiple Entity types, browse to the next one in the navigation pane and repeats steps 26 to 32.
  1. After setting up all Entity Types, click Save.
  2. Enter a comment, then click Confirm.

Using a Parent-Client Configuration

  1. When creating an app, the parent client configuration can be applied using the Wizard Parent Client Configuration screen, select the appropriate configuration using the dropdown.
  2. Or after creation, with the Configuration tab selected, by clicking the Settings cog, then using the dropdown to select the appropriate configuration.