Post date: Mar 24, 2012 2:54:7 AM
Background
The Smart Worklist Member panel requires functionality to:
Change the priority of items
Assign items manually (both Team and User)
Put items back into the queue for re-work (uncomplete, unassign)
Complete items (only if the user has permissions)
Implementing these changes included:
Modifying SmartWorklistMember.Search.xslt to include options for each of these functions
Adding Statements to SmartWorklistMember.config to handle these functions
Creating a SmartWorklistMember.Popup.xslt to handle prompting the user for information
SmartWorklistMember.Search.xslt Options: Using Popups
These functions are powerful, so I wanted to ensure the user has permissions to execute them, and indeed intends to execute them. To check permissions, I simply wrap the options in the XSLT with a permissions check:
<xsl:if test="security:hasPermission('SmartWorklistMemberReassign')">
<li class="menu-complete" onclick="qbo3.getObject(this).popup('SWLM_Assign', {{ addIds: true, method: 'Reassign' }});">Assign Items</li>
</xsl:if>
The security:hasPermission is an Xslt Extension call defined in the qbo.Security.Utilities.XsltSecurity class, made available to all QBO 3 XSLTs via the XsltExtension.config with the namespace urn:qbo3-security.
Each option, rather than invoking a statement directly, calls a popup. The qbo.AbstractObject and qbo.Popup javascript classes work closely together, but boil down to this:
if a Save button is clicked, a class method is invoked
if a Cancel button is clicked, no method is invoked
any checkbox values checked in a list of items will be merged with form data from the popup, and passed as data to the class method
For reasinging work, the user needs to select one or more Smart Worklist Member items, and then choose a Team and a User in a popup. Breaking down the snippet of javascript:
qbo3.getObject(this).popup('SWLM_Assign', {{ addIds: true, method: 'Reassign' }})
qbo3.AbstractObject.popup method is being called with two parameters: a popup name, and JSON data
the key parameter can either be a relative URL to the popup, or (in this case) a shortcut key
the shortcut key is defined in Decision.js, and is simply to make coding a popup easier
the addIns JSON property is "special", and is used by qbo3.AbstractObject to mesh the IDs a user has checked with the form data being returned by the popup
In the Decision.js, Decision-specific popup shortcuts are defined as follows:
// Define commonly used popups.
if (qbo3 && qbo3.Popups) {
qbo3.Popups.define({
'SWLM_Priority': 'Theme.ashx/Render?Transform=Templates/Decision/SmartWorklistMember.Popup.xslt&Mode=Priority&cache=12000',
'SWLM_Assign': 'Theme.ashx/Render?Transform=Templates/Decision/SmartWorklistMember.Popup.xslt&Mode=Assign&cache=12000'
});
}
SmartWorklistMember.config Statements
All of the Smart Worklist Member functionality described here can be achieved using Abstract.config's BulkUpdate, so technically, we don't need any new statements as far as SQL is concerned. However, these are powerful functions, so I created custom statements for three reasons:
Each Statement includes a Permission attribute, so we can restrict these specific permissions to specific roles,
Each Statement includes some default Parameters, so we do not need to pass extra information over the wire for most use cases, and
Having custom Statement names makes reading the Javascript code easier and clearer to other developers
SmartWorklistMember.Popup.xslt Prompting
There is a standard "Confirmation" XSLT that is reused for options that don't need extra data, like BulkComplete. This is called as follows:
<li class="menu-complete" onclick="qbo3.getObject(this).popup('Confirm', {{ addIds: true, method: 'BulkComplete', Title: 'Are you sure?' }});">Complete Items</li>
The 'Confirm' popup key is defined in qbo.Popups.js, and just renders Templates/Application/Confirm.Popup.xslt.
The Change Priority and Assign options require more user input than a simple confirmation. I could have created two XSLTs, but chose one because the content is short and easily handled (and readable) with an xsl:choose statement. Thus:
Priority: Theme.ashx/Render?Transform=Templates/Decision/SmartWorklistMember.Popup.xslt&Mode=Priority&cache=12000
Assign: Theme.ashx/Render?Transform=Templates/Decision/SmartWorklistMember.Popup.xslt&Mode=Assign&cache=12000
Note that when assigning users to a Smart Worklist Item, it's generally a bad idea to display all Person rows; BPO systems have many thousands of active users. Instead, I present the user with a dropdown list of Teams (Collections where SourceObject = 'Person'), and then based on the Team select, a dropdown of Persons (CollectionMembers for the chosen Collection). The dropdown dependency is handled by:
<select id="PersonCollectionID" name="PersonCollectionID" data-behavior="Dropdown" data-dropdown-options="{{
'url': 'Contact/Collection.ashx/TeamList?output=Json',
'jsonEval': 'CollectionCollection.CollectionItem',
'value': 'CollectionID',
'text': 'Collection' }}"
onchange="document.id('AssignedPersonID').retrieve('qbo.Dropdown').refresh({{CollectionID: this.value}})
">
<option value="">-- Team --</option>
</select>
...
<select id="AssignedPersonID" name="AssignedPersonID" data-behavior="Dropdown" data-dropdown-options="{{
'url': 'Contact/Collection.ashx/MemberList?output=Json',
'jsonEval': 'CollectionMemberCollection.CollectionMemberItem',
'value': 'SourceObjectID',
'text': 'CollectionMember',
'refreshOnLoad': false }}">
<option value="">-- User --</option>
</select>
Note that:
the Team dropdown has an onchange handler to refresh the User dropdown, and
the User dropdown has a refreshOnLoad: false option set so that it "waits" to load content until told to do so by the Team dropdown