1 Statistics Tracker Channel Design As part of CSDepot Master’s Project In partial fulfillment of requirements for Master’s Degree Presented by Rebecca Twigg for Dr. Edward Chow Dr. Charlie Shub Dr. Tim Chamillard July 12, 2005

2 CSDepot Statistics Tracking – Design Considerations Data Capture Persistence GUI Changes Reporting Configuration Access Control/Permissions

3 Data Capture What data? –User ID, Channel ID, Event, Date/Time Which events? –Channel registration/subscription –Channel rendered –Channel targeted How? –Implement as StatsRecorder worker thread –Method called as event occurs, e.g. record channel rendered and targeted in ChannelManager, from methods outputChannel() and processRequestChannelParameters(), respectively. –Persist data with UserInstance in HTTP session –Since UserInstance implements HttpSessionBindingListener, will be notified of HttpSessionBindingEvents such as user logging out. Add method inside UserInstance method valueUnbound() to record channel statistics data to database at end of session.

4 Data Persistence Across user session –By associating statistics with UserInstance object in HTTP session Across sessions and users –By adding to portal database

5 Database Changes Add new table to portal database: UP_CHANNEL_USER. Columns include: –UP_CHANNEL (type integer) –UP_USER (type integer) –CHANNEL_ADDED (type date/time) –CHANNEL_LAST_RENDERED (type date/time) –CHANNEL_RENDERED_TOTAL (type long integer) –CHANNEL_LAST_TARGETED (type date/time) –CHANNEL_TARGETED_TOTAL (type long integer) Add new column to portal database table UP_CHANNEL table: –TRACK_STATS (type Boolean)

6 GUI Changes To add statistics tracking to a channel –Add checkbox in Channel Manager titled “Track Statistics” –Checked box indicates statistics will be tracked for that channel –Update code in ChannelRegistryManager to capture new checkbox value To report on channel statistics –Create new “Statistics Tracker” Channel

7 Statistics Tracker Channel - Reporting Drop-down list to select channel of all channels on which to report – List is determined from all channels in UP_CHANNEL with TRACK_STATS column = true Radio buttons indicate columns on which to report Date range – starting and ending dates on which to report Report shows columns for chosen channels, includes both dates and times for events Report query joins to UP_CHANNEL table to retrieve channel name, and to UP_USER to retrieve user name

8 Configuration Set global (application-wide) statistics tracking properties to “on” in portal.properties file –recordChannelAddedToLayout –recordChannelRendered –recordChannelTargeted Set global statistics thread pool settings in portal.properties file –threadPool_initialThreads –threadPool_maxThreads –threadPool_threadPriority

9 Access Control / Permissions In Channel Manager GUI: –Select which groups have access to Channel Manager channel in order to select which channels to track –Select which groups have access to Statistics Tracker channel for viewing channel statistics

10 Project Status - as of 7/12/05 Changed default skin –From Aggregated Tabs & Columns to Tabs & Columns -- personal preference and more stable Created Information Channel –Created new XML and XSLT documents –Implemented as Generic XSLT channel containing text and image Designed Statistics Channel