How do I Update a Tenant or Internal User Store Name in AXA?

Document ID : KB000074292
Last Modified Date : 20/03/2018
Show Technical Document Details
Introduction:
  How do I Update a Tenant or Internal User Store Name in AXA?
Environment:
  AXA 17.3 On Premise Environment
Instructions:

Update the Tenant Name
 

1.) Login into AXA as a Global Administrator (using tenant "defaultorg")

2.) Select the "Admin UI"

User-added image

3.) Select "Manage Tenants", then the name of the Tenant that is being updated.

User-added image

4.) Enter the new name for this Tenant and click Save. The Tenant name will now be updated.

User-added image


The user store name will not be updated however.

 
User-added image

 

Update the User Store Name



 
To update the user store name, the AXA Rest API must be used. To use this API, you must first authenticate with the API and then "put" an updated user store name. To authenticate to the API, please follow the steps documented here: https://docops.ca.com/ca-app-experience-analytics/17-3/en/using/using-apis/rest-apis-best-practices/rest-apis#RESTAPIs-AuthenticatetotheRESTAPIs

For the purposes of updating the user store name, note both the "tkn" and "userCohort" values and these will be used in subsequent steps.

Here is an example output:
{
    "userCohort": "24D3D75F-FD3A-4CB6-2B4D-9194B28003D9",
    "tkn": "<tkn>",
    "tt": "Bearer",
    "v": 1800,
    "rtkn": "<rtkn>",
    "lc": "en_US",
    "rt": 0,
    "userRefID": 41
}

Once authenticated, you will need to create an authorization token as described here: https://docops.ca.com/ca-app-experience-analytics/17-3/en/using/using-apis/rest-apis-best-practices/rest-apis#RESTAPIs-PassAuthorizationDetails

At this point, we are ready to update the user store. For this example Postman was used, though curl or many other utilities will work as well.

Create a "Put" request to http://<FQDN>:<Port>/ess/tenants/v1/cohorts/<userCohort> where userCohort was obtained from the previous step. This request should include the following headers:
authorization: Bearer <Bearer Token Created in the last step>
cache-control: no-cache
content-type: application/json

For example:

User-added image

The Body should include the following data: {"cohort":"<userCohort>","displayName":"<New Name>"}

User-added image

A 204 response should be returned:

User-added image

The final results can then be verified by reviewing the Tenant information once again in the AXA UI:

User-added image


 
Additional Information:
As always, contact CA Support if you have further questions.