Mike, Our Asset Manager Lisa asked me to share our solution to this problem.
We created a UI Action on the alm_license to move allocations to a new entitlement. This UI Action calls a UI Page into a dialog window for you to select the new entitlement to move the allocations to. The UI page then uses AJAX to call a script include to do the work of moving the allocations from one entitlement to the new one.
UI Action:
Name: Move allocations
Client: true (checked)
Onclick: allocationDialog()
Script:
function allocationDialog() {
//Get the values to pass into the dialog
var entitlement = g_form.getUniqueValue();
//Initialize and open the Dialog Window
var dialog = new GlideDialogWindow("pick_new_entitlement"); //Render the dialog containing the UI Page 'pick_new_entitlement'
dialog.setTitle("Pick entitlement you want to move users to"); //Set the dialog title
dialog.setPreference("current_entitlement", entitlement); //Pass in entitlement record for use in the dialog
dialog.setSize(500, 900);
dialog.removeCloseDecoration();
dialog.render(); //Open the dialog
}
UI Page:
Name: pick_new_entitlement
HTML/XML:
<?xml version="1.0" encoding="utf-8" ?>
<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
<g:ui_form>
<g:evaluate var="jvar_current_entitlement" expression="RP.getWindowProperties().get('current_entitlement')" />
<input type="hidden" id="cancelled" name="cancelled" value="false" />
<input type="hidden" id="oldEntitlement" name="oldEntitlement" value="${jvar_current_entitlement}" />
<table style="padding-top:20px;">
<tr>
<td id="label.entitlement" class="label" nowrap="true" height="23px" type="string" choice="0"><span
id="status." class="mandatory label_description" mandatory="true"
oclass="mandatory">$[SP]</span><label for="newEntitlement" onclick=""
dir="">Entitlement:</label></td>
<td nowrap="true">
<g:ui_reference name="newEntitlement" id="newEntitlement" table="alm_license" query="active=true"
completer="AJAXTableCompleter" columns="install_status;allocations_available;purchase_date" />
</td>
</tr>
</table>
<table width="100%" cellpadding="0" cellspacing="0">
<tr>
<td align="left" nowrap="true"><br />
<g:dialog_buttons_ok_cancel ok="return validateForm();" cancel="return onCancel();" />
</td>
</tr>
</table>
</g:ui_form>
</j:jelly>
Client script:
function onCancel() {
var c = gel('cancelled');
c.value = "true";
GlideDialogWindow.get().destroy();
return false;
}
function validateForm() {
if (gel('newEntitlement').value == '') {
alert("${JS:gs.getMessage('Please select an entitlement')}");
return false;
} else {
var ga = new GlideAjax('MoveUserAllocations');
ga.addParam('sysparm_name', 'moveAll');
ga.addParam('sysparm_olde', gel('oldEntitlement').value);
ga.addParam('sysparm_newe', gel('newEntitlement').value);
ga.getXML(getMoveAnswer);
return true;
}
}
function getMoveAnswer(response) {
var answer = response.responseXML.documentElement.getAttribute("answer");
//alert(answer.toString());
GlideDialogWindow.get().destroy();
}
Processing script:
response.sendRedirect("alm_license.do?sys_id=" + oldEntitlement);
Script Include:
Name: MoveUserAllocations
Client callable: true (checked)
Script:
var MoveUserAllocations = Class.create();
MoveUserAllocations.prototype = Object.extendsObject(AbstractAjaxProcessor, {
moveAll: function() {
var olde = this.getParameter('sysparm_olde');
//gs.log('olde:' + olde,'Entitlement Allocation Move');
var newe = this.getParameter('sysparm_newe');
//gs.log('newe:' + newe,'Entitlement Allocation Move');
var users = [];
var nl = new GlideRecord('alm_license');
nl.get(newe);
var ol = new GlideRecord('alm_license');
ol.get(olde);
var newesm = nl.software_model.toString();
var eu = new GlideRecord('alm_entitlement_user');
eu.addQuery('licensed_by',olde.toString());
eu.query();
while(eu.next()){
eu.licensed_by = newe;
eu.license_key = '';
eu.allocated_model = newesm;
eu.update();
users.push(eu.assigned_to.name);
//msg += '' + eu.getValue('assigned_to') + ' added\n';
}
var obj = {
from:ol.display_name.toString(),
to:nl.display_name.toString(),
users:users.toString()
};
var msg = '';
msg += 'All user allocations have been moved from (' + ol.display_name.toString() + ') to (' + nl.display_name.toString() + ')';
msg += '\n\nUsers moved: ' + users.toString();
ol.work_notes = msg;
ol.update();
return JSON.stringify(obj);
}
});
