Kuali Bootcamp for Interested Technologists

1. Kuali Bootcampfor Interested Technologists Bryan Hutchinson - Cornell University (Development Manager) Jack Frosch – Kuali Foundation (Lead Developer)

2. Agenda • Day 4 • Kuali Coeus Research Administration (KCRA) / Coeus topics • How KCRA uses Rice • Look at some Code • Exercises

3. KCRA/Coeus Technical Topics • Background • Coeus and KCRA compared/contrasted • How we identified gaps • How we are filling gaps • Convergence / Divergence • Q & A

4. Background The vision statement from the KCRA project’s successful proposal to the Andrew W. Mellon Foundation asks: “What if any and every college and university could use, without fee, an outstanding research administration system that embodies the ‘best of’ techniques and processes for research administration, while maintaining the flexibility to fit disparate institutional structures and needs? “This is entirely possible via a community source partnership to pool resources, requirements, and execution of an efficient development process. The software and community developed through this process could meet college and university needs while providing an economically sustainable path for the future.” The KCRA project is the instrument to develop this software and its community. - Kuali Foundation web site (http://www.kuali.org/communities/kcra/)

5. Background A significant part of this model is the wholesale adoption of the functionality in a proven system, thereby avoiding the inertia of a “clean sheet” design. The KCRA partner institutions have therefore agreed, from the outset, on the functional components that the project will deliver. The project has chosen MIT’s existing Coeus system as its baseline design. KCRA will then fill in functionality missing from Coeus, update its technical architecture for easier integration with other administrative systems, and release open source software backed by the Kuali Foundation. - Kuali Foundation web site (http://www.kuali.org/communities/kcra/)

6. Coeus Participation on KCRA • KCRA Board • Steve Dowdy MIT Voting Member • Terri-Lynn Thayer Coeus/Brown Voting Member • Tim Schleicher Johns Hopkins Ex-Officio Member • Jen Flach Coeus Ex-Officio Member • KCRA Functional Council • Steve Dowdy MIT Voting Member • Tim Schleicher Johns Hopkins Member • Jen Flach Coeus Member • KCRA Technical Council • Sabari Nair Coeus Voting Member • KCRA Development Team • Rajeev Mancheril Former Coeus Developer • Geo Thomas Former Coeus Developer • KCRA Subject Matter Expert Teams

7. Functionality and Features • The KCRA mandate is to provide all of the Functionality of Coeus in KCRA. • When providing COEUS functionality we are seeking Functional Equivalence not an exact copy of COEUS functionality. For example KCRA screens are functionally equivalent though their appearance and flow is different. • The focus has been how to bring the Features of a rich-client system to the Web.

8. Coeus and KCRA Compared/Contrasted • History • Architecture • Look & Feel

9. Coeus and KCRA - History • Coeus • 13+ years of development • 46 members in the Coeus Consortium • KCRA • Part of the Kuali Foundation • New Development (Startup Q1/2007 Development started July 2007) • Release 1.0 - July 2008 • 8 Partner Schools Currently

10. Coeus and KCRA - Architecture • Coeus • Java on top of Oracle Stored Procedures • Not Service Oriented Architecture (SOA) • KCRA • Kuali Architecture and Rice • Database Agnostic (R2 and beyond) • SOA

11. Coeus and KCRA - Look & Feel • Coeus • Coeus Premium: Swing desktop application • Coeus Lite: Web Application with functionality subset • KCRA • One Web Application • Standard Kuali Look & Feel

12. Coeus Premium Look & Feel

13. Coeus Lite - Look & Feel

14. Coeus Lite - Look & Feel

15. Kuali - Look & Feel

16. Kuali - Look & Feel

17. Approach to Incorporating Coeus Functionality in KCRA • Functional/Technical analysis of Coeus (lite and premium) in light of KCRA/Kuali • KCRA Functional and technical team trips to MIT • Regular involvement of Steve Dowdy, Sabari Nair, Jen Flach, Tim Schleicher, Rob Yetter and other Coeus Subject Matter Experts (SMEs).

18. Gap Analysis - Technical • Technical Gaps: things that Coeus does that Kuali (Rice) cannot currently do technically • Technical Gap Proposals in Confluence • Examples: • Workflow • Custom Attributes

19. Gap Analysis - Functional • Functional Gaps: Functionality that Kuali won't support regardless of technology • Functionality vs. Features • Rollup of Functional Decisions in Confluence • Examples: • Lookup Framework • Custom Attributes • Complex UI

20. How we are filling gaps • Process • Documentation • Development

21. Filling Gaps - Process • Technical Gaps • Proposals are documented in Confluence and JIRA; the Enhancement Proposal pages in Confluence include: • Technical Guide (how the enhancement will be implemented in Rice) • Client Developer Guide (how a developer of an application built on Rice would make use of the enhancement). • User Guide (how and end user would use the enhancement if applicable). • Presented at weekly Kuali Technical Integration meetings • Approved Proposals are scheduled for a Rice release

22. Filling Gaps - Process • Functional Gaps • Regular review with Lead SME's • Decisions/Recommendations are presented to the Functional Council • Decisions that require technical implementation are taken back to the KCRA development team

23. Filling Gaps - Development • Technical Gaps • Upon Approval are assigned • Work is being done by both the Rice team and the KCRA Team • Functional Gaps • Any Functional Gap decisions that require development work are assigned to a KCRA developer

24. Example - Workflow • Workflow was discussed in depth at the KCRA-Coeus Technical Task Team meeting in Boston 2/28 - 3/2/07 • Following this meeting, a Gap Analysis document was developed • Both Coeus and KCRA (through KEW) support workflow functionality. However they do it in different ways. • As a result of the Gap Analysis, several Technical Gaps were identified, and several Functional Questions were raised.

25. Example - Workflow • Rice Enhancement Proposals were written for the technical gaps and presented at the Rice Integration Team meeting where they were approved. • JIRA Tasks to implement the proposals were assigned. Some have been completed and some are still in progress. • Functional Questions were presented to the Lead SMEs who provided answers and shared information back with the larger Functional team.

26. Example - Workflow • Technical Gap: 'Meta-Rules', 'Rules', and 'Conditions' • Context: Coeus Rules can have multiple conditions combined with boolean logic, and each condition can be based on a database column, YNQ answer or a database function. Coeus has the concept of Meta Rules where individual rules are combined with ordering and if/then logic. • Proposal: We can model Coeus conditions and routing rules as KEW rules if we make some modifications to the framework.

27. Example - Workflow • Technical Gap: 'Multiple Approvals' • Context: Coeus prompts the user, when they get their first approval request, if they are going to get future approval requests and allows them to choose to receive these requests or bypass them (opposite of ignorePrevious KEW configuration where system determines if user gets future requests based on static configuration.) • Proposal: We could do routing report and look for user in those, then prompt if necessary & pass flag to KEW if this action should stand in for future action requests (the flag to KEW is the enhancement).

28. Example - Workflow • Technical Gap: 'Inbox - View Resolved Gap' • Context: Coeus shows users both pending and resolved items in their Inbox (Action List equivalent) • Proposal: Enhancement Show Resolved items in action list, perhaps as a separate tab (this is the same thing as the My Outbox enhancement request described in Workflow Document Search Enhancement Request.)

29. Example - Workflow • Functional Questions • Context:Coeus contains a nice UI to maintain Routing and Notification Rules and Meta Rules, while most of the workflow configuration for KEW is done in XML. Rules can be maintained via a web UI in KEW, but it is not as nice or full-featured as Coeus. • Question: How much of the existing Routing Maintenance UI In Coeus Premium should be kept?

30. Example - Workflow • Question: Can we deliver version 1 of KCRA without the fancy UI and depend on the XML configuration in KEW, and then include the Rule Maintenance UI improvements in a later release? • Proposal: Stick with the existing KEW XML configuration for Release 1 of KCRA, and then deliver a more full-featured UI that is similar to Coeus Premium (allowing for differences between desktop and web clients) in Release 2. This will allow us to concentrate on functionality first and features later.

31. Example - Workflow • Implications: • If we stick with existing KEW XML configuration for Release 1 of KCRA, there will be more technical expertise and possibly more training/documentation required for implementing schools, however, it reduces the demand on the development team and allows them to concentrate on replicating Coeus Functionality. • If we need to implement a more complex UI in Release 1, this will take developer resources away from replicating other Coeus functionality (Reality Triangle). • Decision: We will move ahead using the KEW XML based configuration for Release 1. A more advanced Workflow configuration UI (similar to Coeus) will be deferred until Release 2.

32. Filling Gaps • Rice Enhancements for KCRA Release 1.0 • 19 Enhancements Proposed • 17 Approved, 1 Deferred for KIM, 1 Not needed based on existing KEW functionality • 15 Development Complete, 2 In Process • Functional Questions • 18 Decisions based on initial gap analysis, some of which led directly to Rice Enhancements • Continuing dialog via Lead SME/LBA/DM meetings

33. Convergence / Divergence • Long-term proposal: Coeus and KCRA products merge into one. • What is our upgrade path? • Until the product merge, how do we keep KCRA and Coeus from diverging? • How can we pro-actively help these two products converge?

34. Managing Divergence • Coeus has regular releases, and these aren't slowing down, nor should they at least for now • KCRA needs to have a complete functional release that can be implemented to show we're legitimate • We need to keep track of new Coeus releases and manage which features get put into KCRA • Future • Joint design • KCRA team members actively monitor Coeus enhancement requests

35. Proactive Convergence • Proposal: KCRA as a replacement for Coeus Lite • Maintain shared db to make sure both KCRA and Coeus can run on top of any database changes KCRA makes • Develop future Coeus modules using Kuali architecture / Rice framework • Coeus’ offshore team helping port grants.gov to KCRA / Kuali architecture / database agnostic code

36. Upgrade Path Strategy • Keep the Coeus database structure largely intact • Minimize table changes • Create views to help maintain backwards compatibility • Develop scripts to enable a seamless upgrade for Coeus Institutions to KCRA

38. Questions?

39. How KCRA Uses Rice • How KCRA uses Rice • Moving Rice Functionality Forward • KCRA Development Process

40. How KCRA Uses Rice • Kuali Rice is the basic development framework used by KCRA, but… • KCRA is Functionally different from other Kuali Applications • KCRA is Technically different from other Kuali Applications

41. Functionally different from other Kuali Applications • Analysis of Functional Differences • Differences provide basis for Rice enhancements • Extend and customize functionality where possible • Focus on Extension, not Disruption • Add new tools to the Rice toolbox

42. Technically different from other Kuali Applications • Same basic building blocks (Kuali stack) • Rice allows us to make our own choices about development • Maven, not Ant • Jetty, not Tomcat (Development) • HTMLUnit Tests • Bamboo, then Continuum, not Anthill for CI

43. Documents - Size • KCRA: Few, large, complex • KFS: Many, small, still complex • KNS • Data Dictionary - Specify multiple pages • Web Flow - Allow consistent behavior while navigating between multiple pages in arbitrary order • Document interaction - Document is saved/loaded • Rules - Events/Rules can be specified in code and extended

44. Documents - Size

45. Documents - Size

46. Documents - Size <headerNavigation> <headerNavigationTab> <navigateTo>proposal</navigateTo> <displayName>Proposal</displayName> </headerNavigationTab> <headerNavigationTab> <navigateTo>budgetVersions</navigateTo> <displayName>Budget Versions</displayName> </headerNavigationTab> …snip… <headerNavigationTab> <navigateTo>grantsGov</navigateTo> <displayName>Grants.gov</displayName> </headerNavigationTab> <headerNavigationTab> <navigateTo>actions</navigateTo> <displayName>Proposal Actions</displayName> </headerNavigationTab> </headerNavigation>

47. Documents - Web Scope • KCRA: Large Documents, Session based • KFS: Currently Request based • KNS • Mitigate issues with Session based persistence (multiple browsers, etc…) • Eases development/maintenance (hiddens, load-save-load anti-pattern)

48. <action path="/proposalDevelopment*" name="ProposalDevelopmentForm" validate="true” attribute="KualiForm" input="/WEB-INF/jsp/ProposalDevelopment{1}.jsp" scope="request" parameter="methodToCall" type="org.kuali.kra.proposaldevelopment.web.struts.action.ProposalDevelopment{1}Action"> <forward name="basic" path="/WEB-INF/jsp/ProposalDevelopment{1}.jsp" /> <forward name=”budgetVersions" path="/WEB-INF/jsp/ProposalDevelopmentBudgetVersions.jsp" /> <forward name="keyPersonnel" path="/WEB-INF/jsp/ProposalDevelopmentKeyPersonnel.jsp" /> <forward name="proposal" path="/WEB-INF/jsp/ProposalDevelopmentProposal.jsp" /> ... </action> publicclass ProposalDevelopmentDocument extends ResearchDocumentBase implements Copyable, SessionDocument { ... } Documents - Web Scope

49. Documents - Locking • KCRA: Pessimistic Locking, Long lasting docs, Session Based, Functional Areas • KFS: Optimistic Locking, short lived docs • KNS (Rice Enhancement) • Centralized locking mechanism • Document Authorizer classes • Provide two layers of locking if desired

50. Documents - Versioning • KCRA: Many documents require versioning • KFS: Versioning not required in general (PurAp docs do version) • KNS (enhancement pending - KCRA Release 2.0) • Support optional versioning of documents • Configuration option • Little additional code required • New Version created by user request or programmatically