Adding a Critique from the CML

These are the steps for adding a LitCrit critique from the Web interface of the CML application.

To submit a critique from the CML

1. Start the CML application. To do this, type the URL of the CML's application root folder, which was set during installation in the step Setting Up an Application Root. If the application was installed as described in the installation procedure, you can start it at the site <Default Web Site>/FmLib on your Web server.
2. Click Search for Library Materials.
3. Search for library materials by title, author, or subject using media types to filter your results.
4. A list of titles is displayed on the CML Search Results Web page. The average of the overall ratings, the avg_rating, is read from the title table in the FmLib database and displayed for each title. When no critiques are available, "Not Reviewed" is displayed.

   CML Search Results page

   

5. Click a title to display the CML Search Details Web page. The average overall rating appears on this page for the chosen title.

   CML Search Details page

   

6. Click Add Critique to display the Submit Critique Web page. The UserInfo.Logon method is called to find the user's logon name, which in turn is used in the borrower table to find the borrower#, which will be used in step 7.

   CML Submit Critique page

   

7. The SQL Server™ Critique table is searched for a previously submitted critique for this title (bib#) by this user (borrower#). If a critique record is found, go to step 9; if not, go to step 8.
8. No critique by this borrower is found, so a blank Submit Critique Web page appears in a new window. Fill out the critique form. Select ratings: Only the overall rating is required; selecting ratings in the other three categories is optional. Optionally enter a critique title to replace the default critique title, which is the title of the library item. Optionally enter critique text. Go to step 11.
9. The record of a critique by this borrower is found, and the isApproved field in the critique record is examined. When the value is 0 or False the critique is in the approval process and you cannot edit the critique at this time. The following alert appears.

   

   Click OK and then exit the Submit Critique Web page. In doing so, you also leave this procedure.

   When the isApproved value is 1 or True the objectId of the critique record (used to identify the critique in the LitCrit public folder) is retrieved. The critique text and evaluation values are retrieved from the posting in the LitCrit public folder.

10. The CML Submit Critique Web page displays your previously submitted critique in a new window. Critique and evaluation fields are available for edit. Reselect ratings: Only the overall rating is required; selecting ratings in the other three categories is optional. Edit critique title and critique text. Critique title is required; critique text is optional.
11. Click Submit on the Web form. This does the following:
    • Validates data. Mandatory data is validated (an overall rating must be selected and the critique title cannot be blank). You are prompted to provide missing information. Depending on what field is missing information, one of the following alerts appears:

      When the critique title is missing:

      

      When the overall rating is missing:

      

      Data validation is performed on the client, and when all required data is present, the form's data is sent to the Web server.

    • Checks for automatic approval. The CML application checks the application setting that tells whether automatic approval of critiques is in effect. If so, the critique's data is added to the Critique table in the FmLib SQL Server database and, using CDO, posted to the LitCrit public folder. The isApproved field in the Critique table is set to True and the critique is immediately available for display in the CML application.

      If automatic approval is not currently in effect, the critique's data is added to the Critique table in the FmLib SQL Server database, the isApproved field in the Critique table is set to False, and the CML application uses CDO to post the critique to the LitCrit public folder. An administrator must then evaluate the critique as described in Approving or Rejecting a Critique.