Enhancing Existing CML Web Pages

Several of the existing CML application Web pages require modifications to display information from critiques submitted from the Web or Outlook applications. The overall rating of titles is collected in all critiques and the CML displays this rating on the Search Results and Search Details Web pages. Several Web pages need buttons to provide convenient navigation to the new critique Web pages. A number of new settings fields need to be added to the Application Settings Web page to manage the critique features of the Outlook and Web applications.

Search Details Web Page

• Add average overall rating label and field. The average overall rating for a title is calculated from the overall ratings of all critiques for the title in the FmLib database and is displayed as a number of stars. The overall average can contain a fraction, and the calculated result is rounded to the nearest half-star. When a title has no critiques the words "Not rated" appear instead of an Avg. Overall Rating.
• Add the View Critique button. When the Search Details Web page displays a title that has no critiques, the View Critique button must be hidden and disabled. If the LitCrit Outlook application is not available this button never appears.
• Add the Add Critique button. If the LitCrit Outlook application is not available this button never appears.
• Add Star Legend pop-up window. When the mouse moves over the Avg. Overall Rating a small form appears that further explains the meaning of the star ratings. When the mouse moves off the pop-up window, the window closes. Displaying the Rating Legend describes this pop-up window in detail.

Search Results Web Page

• Add average overall rating label and field. The average overall rating for a title is calculated from the overall ratings of all critiques for the title in the FmLib database and is displayed as a number of stars. The overall average can contain a fraction, and the calculated result is rounded to the nearest half-star. When a title has no critiques the words "Not rated" appear instead of an Avg. Overall Rating.
• Add Star Legend pop-up window. When the mouse moves over the Avg. Overall Rating a small form appears that further explains the meaning of the star ratings. When the mouse moves off the pop-up window, the window closes. Displaying the Rating Legend describes this pop-up window in detail.

Application Settings Web Page

• Add Approval Required to allow administrators to set a switch that turns required approval on and off for all critiques available to the CML Web application. The selection is made by choosing between the On and Off options. The default is Off.
• Add Approver Email Address to provide the e-mail address of the person to whom the critiques will be sent when approval is required.
• Add Maximum Choose Title Results to manage the number of entries returned to the Choose Title dialog box in the Outlook application. The default is 600 entries.

Displaying the Rating Legend

To provide additional information about the meaning of the star ( ) representation of the overall rating and the average overall rating in critiques, a legend showing the four star ratings and their associated meanings needs to appear on the Search Details, Search Results, and Choose Critique Web pages. When you move the mouse pointer over the star graphic the legend appears. The position of the legend is dynamic and the legend always appears below the star graphic and left-aligns the legend with the star you point to. The legend also appears when you move the mouse over the words "Not reviewed", which replace the rating when a title has no critiques. The updated version of DSearch.asp and the new critiques.asp show you the lines of HTML, enclosed in DIV tags, that create and display the legend.