Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Stardust/Knowledge Base/Customization/Portal/Bulk Completing Custom Worklist View
< Stardust | Knowledge Base | Customization | Portal
a) Introduction
Based on certain requirements, there are instances when a user with a specific role needs to complete activities in bulk/ multi select, example below does the following:
- Add Custom perspective within the Stardust portal
- Loads a Custom Activity View within the custom perspective, user with a certain role can only access this view
- Allows multiple selection of these activities, and complete them.
Note: This example can be extended to display only the manual activities in the activity table.
b) Custom Activity View - Completion of Bulk Activities
Download the complete example project.
Steps:
- The above example project ipp-ao-plugin has a structure that includes all the markups(xhtml,images..etc), and source. Nothing else needs to be stored at the dynamic web application level.
- Compile the attached project plugin and add the same in the WEB-INF\lib folder of your dynamic web project
- Above Plugin will add a new Perspective - "Custom Perspective" this will be visible only to the user with Role "External" So please make sure that you have this role defined in your process model.
- An "Activity View" will be added to this perspective.
- All the activities will be displayed as below.
- Note: Currently the goal of this example is to select multiple activities and complete it.
- You can always drill down the activities per user/role, and check for the implementation type is "Manual" or "Application", this would not be recommended unless absolutely required and authorized by the design/architecture team.
Result:
A new perspective with id "Custom Perspective" will be added.
- If you login to the portal with the user having "External" role, Custom Perspective and then Activity View will be displayed.
- Select the Required Activities and Click "Complete".
Implementation:
- Attached jar contains an "customactivityView.xhtml" view, that displays all the activities, with a "Complete All" button on top of the activity table.
- "CustomActivityViewBean" is the backing bean for this activity view table.
- Above bean has a function "createQuery()" within inner class "ActivitySearchHandler" that has the activity query. ActivityInstanceQuery that will be passed in to the QueryResult for fetching the activities.
- Selecting the activities and clicking on the "Complete All" button will invoke "completeAllActivities()" from the backing bean, and refresh the activity table.
Note:
For 6.x version we need to modify existing project under Stardust_Bulk-Activities-files.zip
- "PortalUiInitialization" bean need additional line of code to initialize Perspective before assigning any role to it
PerspectiveDefinition perspective = (PerspectiveDefinition) bean; Add below line of code after type casting bean to PerspectiveDefinition and then assign any role Set<String> roleset = perspective.getRequiredRolesSet();
- For "completeAllActivities()" from CustomActivityViewBean backing bean we need to change call from
PPUtils.activate(ai); to com.infinity.bpm.ui.web.viewscommon.utils.ActivityInstanceUtils.activate(ai);
- Packaging changed for following classes in Stardust 6.x version from icom.infinity.bpm.portal.adminPortal to com.infinity.bpm.portal.admin
AdminportalConstants.java ResourcePaths.java WorkflowFacade.java So import statement's need to be changed in CustomActivityViewBean
- Checkbox selection for activity list table is removed in 6.x version. For multi select you need to use ctrl select or shift select button option.