Main -> Documentation -> Product Updates -> Description of the Open SiteSearch 4.0.1 Release

Description of the Open SiteSearch 4.0.1 Release

This document provides a detailed list of the bug fixes, software enhancements, and new functionality included with the Open SiteSearch suite 4.0.1 release. Read this document before installing the Open SiteSearch 4.0.1 software. SiteSearch 4.0.1 includes the functionality of versions 4.0.0 and 4.0.0a, as well as new software features, enhancements, and bug fixes. The following topics are discussed in this document:

Important Note: Read these sections carefully. Extensive changes were made to the all of the WebZ Out-of the-Box Interface (OBI) HTML files and some formatting classes to allow you to more easily create frameless interfaces.

After you have carefully reviewed this document, refer to the Upgrading to Open SiteSearch 4.0.1 document for specific instructions on how to upgrade your current SiteSearch environment to version 4.0.1.

New Functionality and Software Enhancements

Important Note: The SS4_0_1.jar file contains the software byte code and replaces the jar file(s) included in previous versions of the Open SiteSearch suite.

Description

SiteSearch Component

Affected Files

NT Support (New)

The Open SiteSearch 4.0.1 suite software is now available for the Windows NT platform. The following NT documents are available to support specific procedures associated with this version of the software:

WebZ

Database Builder

User Interface Authorization Options Enhanced

The WebZ Out-of-the-Box Interface (OBI) now includes the ability to configure authentication at any point during a user session (referred to as "Login anywhere"). The Resource Sharing Style (see below) serves as an example of how authorization can occur for ILL requests. After authentication occurs, patrons may be presented with additional resources available to the "user type" specified in the SQL database.

The following enhancements were made for "Login anywhere":

  • If the patron is already logged on, an informative message is displayed from authorize.html.
  • JavaPage is executed as part of initialize for a successful authentication.

WebZ

<WebZ_root>/htdocs/html/authorize.html

ORG.oclc.obi.Authorize
ORG.oclc.obi.currentstate
ORG.oclc.obi.initialize

ILL Functionality Enhanced

Open SiteSearch 4.0.1 includes the following InterLibrary Loan features and enhancements:

  • Local ILL services (via e-mail) (WebZ verb: ILLEmail)
  • ILL data preparation improved (WebZ verb: ISOILL)
  • New HTML files for ILL forms
  • ILL request form can display a copyright compliance notice
  • A database can be defined as a "local" database
  • Locations functionality that provides mapping of OCLC locations symbols to lendor strings

As part of this implementation, the OclcILL.ini file was renamed IllService.ini, and the ORG.oclc.obi.isoillscreen class became a deprecated class. ORG.oclc.obi.illformscreen replaces this class in SiteSearch 4.0.1.

WebZ

SS4_0_1.jar

<WebZ_root>/htdocs/html/

    illconfirm.html
    illform.html
    blankillform.html

<WebZ_root>/ini/

    JaSSIServer.ini
    locations.ini

<WebZ_root>/ini/loc/ (new directory)

<WebZ_root>/ini/servers/IllService.ini

ORG.oclc.fmts.obi.LenderString
ORG.oclc.fmts.obi.MarcISOILLFmt
ORG.oclc.gadgets.IllConfirm
ORG.oclc.obi.currentstate
ORG.oclc.obi.extverb.MyISOILL
ORG.oclc.obi.illconfirmscreen
ORG.oclc.obi.illformscreen
ORG.oclc.obi.recordscreen

Expand Query (New)

You can now configure an individual database that is a member of a Topic Area to "expand" the same query string against an entire Topic Area or a subset of the databases. This functionality is implemented in the Resource Sharing Style.

WebZ

<WebZ_root>/htdocs/html/

    expand.html
    resultsnav.html

ORG.oclc.gadgets.ExpandHeader
ORG.oclc.obi.extverb.TopicQuery
ORG.oclc.obi.resultsnavscreen
ORG.oclc.obi.util.Topics.relatedTopics

Rotating Database Lists (New)

This feature allows you to configure WebZ to vary the list of databases that are displayed in the results list. By default, databases in the results list are displayed alphabetically by database name. Because patrons tend to select the first database in the results list, this feature allows you to balance patrons requests for individual remote database results sets. Local databases will remain on top of the list. The list can also be ordered by Topic according to the configuration set in Topics.ini.

WebZ

SS4_0_1.jar

<WebZ_root>/htdocs/html/resultsframe.html

ORG.oclc.obi.resultsnavscreen
ORG.oclc.gadgets.SearchResultsDbList
ORG.oclc.obi.resultslist

Interface Style - Resource Sharing Style (New)

The Resource Sharing Style (RSS) serves as an example of how ILL, "Login anywhere," the Expand query, and rotating database lists have been implemented in the SiteSearch 4.0.1 software.

WebZ

<WebZ_root>/ini/interface/rssStyle.ini

<WebZ_root>/htdocs/html/

    rsstoolbar.html
    topicsearch.html

ORG.oclc.gadgets.rssSearchHeader
ORG.oclc.obi.util.Databases

Phrase Indexing Routine and Parameter for Indexing URLs (New)

  1. Added a new phrase indexing routine to the database building tools. With this routine, a URL string will be indexed as a phrase, retaining all punctuation.
  2. Added a new parameter=1 to the words(1) and phrase(2) index routines so that pippin can use the characters specified in the character table file -z parm as the collapse and delimiter tables. Without this parameter in the words(1) and phrase(2) routines, pippin will use the default tables. To use these input tables for words(1) and phrase(2), run initdb with the update parameter and change the database .dsc file to add the parameter.

Database Builder

pippin
pipreorg

ZBroker Operations Enhancement

  1. Enhanced ZBroker to allow you to specify the number of connections to the remote Z39..50 server. In 4.0.0 and 4.0.0a, when ZBroker's maximum connection count is reached, a new ZBroker is spawned to listen at the port specified in the ZBrokerServer.ini configuration file. The ZBroker now stops listening at the port when the maximum connection is reached and does NOT spawn new servers. ZBroker now waits until the number of users is below the maximum and then starts listening to the port again.
  2. Added a new variable to the configuration file to support this functionality. The new variable is called "StartNewServer" and is defined in the [section] of the file. The value of StartNewServer can be true or false, where false initiates the new functionality described above and true maintains the 4.0.0/4.0.0a functionality.

WebZ

<WebZ_root>/ini/ZBrokerServer.ini

HTML Non-frames Interface Support

  1. Updated the WebZ OBI HTML files, formatting classes, and StyleTable initialization files to allow for easier creation of a non-frames style to the interface. Removed all hard-coded references to HTML pages and HTML frame targets and made them style table entries. All styles that use frames have a new [targets] section defining frame targets.
  2. Changed the call in the addBookMark() method in the database formats to include the next= widget for the URL to indicate what HTML page to present after the bookmarking is complete.
  3. Added a parameter to the addBookMark() method for the full record displays to indicate that the bookmarked record does NOT have to be re-fetched from the server since it is in memory already - performance enhancement.

  4. Removed HTML-coded target references and added a [targets] section to the interface style configuration files. Targets are now reference in the HTML files as entities. If you are interested in a frameless interface, you can remove targets from the HTML by commenting out the [targets] section of the interface style configuration file.

WebZ

Refer to Upgrading to Open SiteSearch 4.0.1.

DRA Holdings Support

Open SiteSearch 4.0.0/4.0.0a does not support retrieval of DRA Holdings via Z39.50. This release adds support for a new Z39.50 record syntax called "DRA_HOLDINGS." The new syntax allows patrons to search the DRA Holdings database and retrieve holdings records using DRA's proprietary record syntax. To use this syntax, you will need to edit your DisplayGadgets.ini configuration file to use the Gadget FormatRecordsAndAttachHoldings rather than the FormatRecords gadget.

WebZ

SS4_0_1.jar

<WebZ_root>/ini/dbs/

  • DRA.ini
  • DRAHoldings.ini (new)

<WebZ_root>ini/servers/DRA.ini

Access Component Performance Enhanced

In 4.0.0 and 4.0.0a, WebZ makes connections to the Access component even when no authorization is required. In 4.0.1, WebZ will not connect to the Access component unless an authorization is required. The Access component performance was also improved with additional housekeeping methods, user session logging, and memory usage.

WebZ

SS4_0_1.jar

Rome Utility's Memory Capacity Increased for Sparse Nips

The rome utility's memory block was increased to handle more sparse nips associated with local databases.

Database Builder

rome
romemerg

Formatting Records from a Temporary Database

In 4.0.1, the FormatRecords gadget has the capability to format records stored in a temporary database (e.g., holdings). This capability can be used for information stored in a temporary database ("tdbname") where the records are held in "tUnformattedRecordData". To use this enhancement, add the variable "tempDb" to the appropriate section in the DisplayGadgets.ini. By default tempDb has the value of false unless otherwise defined in the DisplayGadgets.ini file.

WebZ

ORG.oclc.gadgets.FormatRecords
ORG.oclc.gadgets.FormatRecordsAndAttachHoldings

Response to Z39.50 Servers Enhanced

Updated several server configuration files to include the new timeout values for InitWaitTimeout and ReadTimeout variables. This update allows WebZ to close a connection to the remote Z39.50 request if the remote server fails to respond to an Init request or takes too long to process another Z39.50 request. Each server configuration file now contains the following value for these variables:

InitWaitTimeout = 15

ReadTimeout = 90

WebZ

<WebZ_root>/ini/servers

    DRA.ini
    EBSCO.ini
    ERL.ini
    Endeavor.ini
    FirstSearch.ini
    GEAC_Advance.ini
    Horizon.ini
    IAC.ini
    III.ini
    MultiLIS.ini
    Notis.ini
    Ovid.ini
    Sirsi.ini

Bug Fixes

Description

SiteSearch Component

Affected File(s)

BR026: WebZ Does Not Return Results from Newton Database Searches When Stopwords are Included in the Search Term

Database Builder

SS4_0_1.jar

BR025: Patrons are Unable to Select the Number of Records for Display on the Advanced Search Screen

WebZ

SS4_0_1.jar

<WebZ_root>/htdocs/html/

BR024: Patrons are Authorized by Access Component After Entering Two Bad Authorizations in a Row

WebZ

SS4_0_1.jar

BR023: Jumpbar is Linked Incorrectly

WebZ

ORG.oclc.gadgets.JumpBar.java

BR022: Remote Z39.50 Server Configuration InitWait Timeout Value is Not Enforced Unless Specifically Set

WebZ

SS4_0_1.jar

BR021: WebZ Does Not Set the Correct Search Page When Browse is Not Supported

WebZ

<WebZ_root>/ini/interface/defaultStyle.ini

ORG.oclc.gadgets.SearchTabbar

BR020: The Access Component Does Not Authorize Patrons Correctly/Access Component Log File Includes the "java.sql.SQLException: :Too many fields in condition" Error Message

WebZ

SS4_0_1.jar

BR018: Proximity Searching Using the Near and With Operators Does Not Return the Expected Results

WebZ

SS4_0_1.jar

BR016: WebZ is Unable to Return SUTRS Records/WebZ Returns SUTRS Records Containing Incorrect Data

WebZ

SS4_0_1.jar

BR015: The Search Screen Tabbar Labels Are Not Correctly Displayed/Linked After Editing a Database Configuration File or a Database Group Definition File

WebZ

SS4_0_1.jar

BR014: Access Component Utilities (msqlconvert, msqlexport, msqlimport) Return Error Messages When Executed

WebZ

SS4_0_1.jar

BR012: The Netscape Server Does Not Recognize the WebZ Extension/ The Netscape Server Can Not Access the WebZ System

WebZ

SS4_0_1.jar

BR011: Fully Qualified IP Addresses are Not Authorized Correctly

WebZ

SS4_0_1.jar

BR010: "No Title Provided" Appears in MARC Full Record Even If Title Exists

WebZ

ORG.oclc.fmts.FormatBerUtil

BR009: Database Images Do Not Display/ Installation Error Message: Unable to Move sscgi Directory

WebZ

SS4_0_1.jar

See Also

Upgrading to Open SiteSearch 4.0.1
Description of the Open SiteSearch 4.0.0a Patch
Open SiteSearch Suite Known Bug List (by Category)



[Main][Documentation][Support][Technical Reference][Community][Glossary][Search]

Last Modified: