How to generate Vlocity Global Keys

Global Keys are necessary for Vlocity to identify and match elements in DataPacks. This is specially important when migrating Vlocity Products and other elements from one org to another.

There are two ways to generate them:

Generate Global Keys from Salesforce

  1. Go to app launcher, type in “CMT admin” and open the Vlocity CMT Administration
  2. In the Admin Tools column, click on EPC jobs
  3. At the bottom of the list, find Generate Global Keys job and click Start
generate vlocity global keys cmt administration
vlocity epc jobs generate global keys vlocity cmt administration information
For more information, consult the Vlocity system administration documentation

Otherwise, if you have newly created Vlocity Products, Attributes, Price Lists, Object Types that don’t yet have a Global Key, then you might run into this error, say for example, when you’re trying to migrate Vlocity Products from one org to another.

missing global key vlocity product. Error message -- no match found for Product2.%vlocity_namespace%__objecttypeId__c - %vlocity_namespace%__globalkey__c=null (system code)
Error message — no match found for Product2.%vlocity_namespace%__objecttypeId__c – %vlocity_namespace%__globalkey__c=null (system code)

As you can see, in the highlighted section, the GlobalKey of the Object Type this Product belongs to is null. This will throw back an error.

vlocity product migration idx workbench missing globalkey

Update Global Keys from IDX Workbench

  1. From IDX Workbench, on the top menu, click Jobs
  2. Click Ensure Global Keys in Source

This Job will generate any missing Global Keys in both, Source and Target orgs.

vlocity global keys update global keys in source and targe in idx workbench
  1. Wait until its done and you’re good to go.
Was this article helpful?
YesNo