Jump to: navigation, search

Configuring Business Attributes

CSAPIProxyGMS.png This page describes how to map Context Service keys to Business Attribute key-value pairs.

Procedure: Mapping Context Services with Business Attributes

Purpose: To define the mapping between Context Services and the Business Attributes configured in the Genesys Configuration Server. The Business Attribute values are defined in the Tenant. Check the options reference for additional details.


  1. Open the Configuration Manager and edit your GMS application.
  2. Select the Options tab.
  3. Select the business-attributes section or the business-attributes.<TenantID> section if you are in a multi-tenant configuration. (Tell me why.)
  4. Click Add to create a Business Attribute key for Service, State, and Task as follows.
    • Enter ${resource name}.${field name} for the Name such as, for instance: Service.service_type, Task.disposition, State.media_type.
      Possible ${resource name} values are:
      • Service
      • State
      • Task
    • Possible ${field name} values to map are:
      • type (for service type)
      • disposition
      • application_type
      • resource_type
      • media_type
    • For the Value, enter the name of the Business Attribute configured in the proper tenant.
      A Business Attribute can be mapped to several resource fields. For instance, the Service.media_type and Task.media_type string can both point to MediaType Business Attributes.
  5. Click Add to create a map-names option.
    • Enter map-names for the Name.
    • For the Value, enter:
      • true to return the Names of Business Attribute Values instead of DB IDs in the responses for GET operations.
      • false (default) to return the DB IDs of Business Attribute Values in the responses for GET operations.

Mapping Example

This first screenshot shows the section in UCS options, with the list of mapped keys, such as, for instance: Service.service_type, Task.disposition, State.media_type.

UCS options ba1.jpg

The following screenshot shows one of the mapped business attributes, the key and the associated values, which your application can retrieve in the result of GET operations by setting to true the map-names UCS options, as stated above.

UCS options ba2.jpg

This page was last modified on January 29, 2015, at 15:26.


Comment on this article:

blog comments powered by Disqus