Creating an entitlement using OIM API - what is lookupkey for?

Question

Hi
I am trying this code
ApplicationInstanceService appService = oimClient.getService(ApplicationInstanceService.class);
ApplicationInstance appInstance = appService.findApplicationInstanceByName("MyAppInstance");
EntitlementService entSvc = oimClient.getService(EntitlementService.class);
Entitlement ent = new Entitlement();
ent.setObjectKey(appInstance.getObjectKey());
ent.setFormKey(appInstance.getChildForms().get(0).getFormKey());
ent.setFormFieldKey(appInstance.getChildForms().get(0).getFormFields().get(0).getFldKey());
ent.setItResourceKey(appInstance.getItResourceKey());
ent.setEntitlementCode("MNEC2");
ent.setEntitlementValue("MyNewEntitlementValue2");
ent.setDisplayName("MyNewEntitlementName2");
ent.setDescription("MyNewEntitlementDesc2");
ent.setLookupValueKey(1);//have no idea what is this for
ent.setValid(true);
entSvc.addEntitlement(ent);
code works great, but what should be the lookupValueKey and what is it for?

Answer 1

The overall process that is supposed to happen OOTB is this:
1.  On a child table form, one of the fields is marked as Entitlement = True
2.  Populate your lookup with Entitlement Values (example is the Active Directory Group Recon Lookup scheduled task)
3.  Run the Entitlement List scheduled task.  This will check all form entries that have entitlement = true to retrieve the list of values and populate the ENT_LIST table with this values (or update any new or set IS_VALID=0 for any that were removed)
4.  Catalog Synchronization scheduled task will populate the values into the Catalog
The lookup value key is the LKV_KEY value that is tied to an entry in the lookup.  This is what ties the ENT_LIST table to the LKV table.
-Kevin