Welcome to ILL Wizard for Java, version 1.0 Technology Preview (OCLC Direct Request Edition). ILL Wizard is a web-client program that allows library users to request interlibrary loan (ILL) materials through its ILL service provider (in this case OCLC) directly without needing to fill out a paper form or consult a librarian. This increases the efficiency of the library staff and allows patrons to feel more in control of their library experience. The program takes advantage of a new OCLC technology called Direct Request, which uses the international interlibrary loan standard designated ISO-10161, and lets libraries choose the method used to handle interlibrary loan requests: 1) to send the output directly to OCLC's Review File; 2) to send the output directly to the first lender in a string of five which is generated automatically based on priorities created by library staff; or 3) to send the output to a predetermined list of OCLC ILL lenders.
The term wizard is a Windows standard that means "a sequence of dialog boxes that present specific questions about what you want to create. Once you answer the questions, the wizard completes the task. (MSDN Library Visual Studio 6.0 Release)" This is precisely what ILL Wizard does. Although the individual pages of the applet are not literally dialog boxes, they are representative of information retrieved in a dialog format. Each page gets part of the information required for the entire request, and when the user is ready to submit the request the applet takes all the information entered by the user and constructs a complete, formatted request.
Contents
Distribution
Installation
Applet Parameters
Operation
Known Issues
Contacts and Credits
ILL Wizard 1.0 is distributed in ZIP archive format at http://www.bwilhelm.org/illwizard/illwizard-current.zip and also at http://www.olivet.edu/departments/Library/ILL/ill.html. It contains the following files:
matrixgen
matrixgen.exe
README.txt
readme
binary.xbm
dir.xbm
icon_error.png
icon_information.png
icon_warning.png
illwizard.png
image.xbm
README.html (This document)
security_microsoft.png
security_netscape.png
text.xbm
xbm.xbm
icon_error.png
icon_information.png
icon_warning.png
illwizard.cab
illwizard.png
illwizard.html
illwizard.jar
The matrixgen directory contains the utility for encoding the authorization and password for the applet parameter list. The readme directory contains all the files necessary for this document. The Root directory contains the files for the ILL Wizard Java applet program.
Server System Requirements: Any web server platform will handle this program correctly.
Client System Requirements: Minimum: Microsoft Internet Explorer 4.01 or Netscape Navigator 4.51. Recommended: Microsoft Internet Explorer 5.0.
IMPORTANT NOTICE:
This applet will function properly as is if the output is sent to the Review File. The applet will not function properly if the output is sent Direct to Vender or Direct to Profile until the OCLC Direct Request planning guide has been completed.
The final two applet parameters in the illwizard.html file will send the output to OCLC's test environment server. You must call OCLC at 800-848-5800 to verify that your test requests have processed correctly. OCLC will supply the address and port for their interlibrary loan production server. Note that the corresponding applet parameters will need to be changed to the new target when this occurs.
The URL of the planning guide is: http://www.oclc.org/oclc/man/9921dill/
Side Notes
Those familiar with ONU-ILL 3.2 will recall the server dæmon, redir, which is conspicuously absent from the distribution and installation directions. This applet gets permission from Java applet security to use the client system network facilities, allowing the applet to connect directly with OCLC rather than indirectly through the host server. This eliminates the burden on the web server and streamlines the installation process.
Another major improvement over the previous product is that no source code modification or recompilation is required. This is because all modifications and customizations can be made through the applet parameters. This means that there is no need to download additional products and utilities, dig through pages of source code, or worry about the Java or command line syntaxes.
The applet is configured entirely through the parameters passed to the applet. These parameters can be seen below, and take the form
In the current implementation, the parameters are generated by JavaScript from parameter variables which take the form
The parameters used by this applet are:
| ALICEBLUE (#F0F8FF) |
ANTIQUEWHITE (#FAEBD7) |
AQUA (#00FFFF) |
AQUAMARINE (#7FFFD4) |
| AZURE (#F0FFFF) |
BEIGE (#F5F5DC) |
BISQUE (#FFE4C4) |
BLACK (#000000) |
| BLANCHEDALMOND (#FFEBCD) |
BLUE (#0000FF) |
BLUEVIOLET (#8A2BE2) |
BROWN (#A52A2A) |
| BURLYWOOD (#DEB887) |
CADETBLUE (#5F9EA0) |
CHARTREUSE (#7FFF00) |
CHOCOLATE (#D2691E) |
| CORAL (#FF7F50) |
CORNFLOWER (#6495ED) |
CORNSILK (#FFF8DC) |
CRIMSON (#DC143C) |
| CYAN (#00FFFF) |
DARKBLUE (#00008B) |
DARKCYAN (#008B8B) |
DARKGOLDENROD (#B8860B) |
| DARKGRAY (#A9A9A9) |
DARKGREEN (#006400) |
DARKKHAKI (#BDB76B) |
DARKMAGENTA (#8B008B) |
| DARKOLIVEGREEN (#556B2F) |
DARKORANGE (#FF8C00) |
DARKORCHID (#9932CC) |
DARKRED (#8B0000) |
| DARKSALMON (#E9967A) |
DARKSEAGREEN (#8FBC8B) |
DARKSLATEBLUE (#483D8B) |
DARKSLATEGRAY (#2F4F4F) |
| DARKTURQUOISE (#00CED1) |
DARKVIOLET (#9400D3) |
DEEPPINK (#FF1493) |
DEEPSKYBLUE (#00BFFF) |
| DIMGRAY (#696969) |
DODGERBLUE (#1E90FF) |
FIREBRICK (#B22222) |
FLORALWHITE (#FFFAF0) |
| FORESTGREEN (#228B22) |
FUCHIA (#FF00FF) |
GAINSBORO (#DCDCDC) |
GHOSTWHITE (#F8F8FF) |
| GOLD (#FFD700) |
GOLDENROD (#DAA520) |
GRAY (#808080) |
GREEN (#008000) |
| GREENYELLOW (#ADFF2F) |
HONEYDEW (#F0FFF0) |
HOTPINK (#FF69B4) |
INDIANRED (#CD5C5C) |
| INDIGO (#4B0082) |
IVORY (#FFFFF0) |
KHAKI (#F0E68C) |
LAVENDER (#E6E6FA) |
| LAVENDERBLUSH (#FFF0F5) |
LAWNGREEN (#7CFC00) |
LEMONCHIFFON (#FFFACD) |
LIGHTBLUE (#ADD8E6) |
| LIGHTCORAL (#F08080) |
LIGHTCYAN (#E0FFFF) |
LIGHTGOLDENRODYELLOW (#FAFAD2) |
LIGHTGREEN (#90EE90) |
| LIGHTGREY (#D3D3D3) |
LIGHTPINK (#FFB6C1) |
LIGHTSALMON (#FFA07A) |
LIGHTSEAGREEN (#20B2AA) |
| LIGHTSKYBLUE (#87CEFA) |
LIGHTSLATEGRAY (#778899) |
LIGHTSTEELBLUE (#B0C4DE) |
LIGHTYELLOW (#FFFFE0) |
| LIME (#00FF00) |
LIMEGREEN (#32CD32) |
LINEN (#FAF0E6) |
MAGENTA (#FF00FF) |
| MAROON (#800000) |
MEDIUMAQUAMARINE (#66CDAA) |
MEDIUMBLUE (#0000CD) |
MEDIUMORCHID (#BA55D3) |
| MEDIUMPURPLE (#9370DB) |
MEDIUMSEAGREEN (#3CB371) |
MEDIUMSLATEBLUE (#7B68EE) |
MEDIUMSPRINGGREEN (#00FA9A) |
| MEDIUMTURQUOISE (#48D1CC) |
MEDIUMVIOLETRED (#C71585) |
MIDNIGHTBLUE (#191970) |
MINTCREAM (#F5FFFA) |
| MISTYROSE (#FFE4E1) |
MOCCASIN (#FFE4B5) |
NAVAJOWHITE (#FFDEAD) |
NAVY (#000080) |
| OLDLACE (#FDF5E6) |
OLIVE (#808000) |
OLIVEDRAB (#6B8E23) |
ORANGE (#FFA500) |
| ORANGERED (#FF4500) |
ORCHID (#DA70D6) |
PALEGOLDENROD (#EEE8AA) |
PALEGREEN (#98FB98) |
| PALETURQUOISE (#AFEEEE) |
PALEVIOLETRED (#DB7093) |
PAPAYAWHIP (#FFEFD5) |
PEACHPUFF (#FFDAB9) |
| PERU (#CD853F) |
PINK (#FFC0CB) |
PLUM (#DDA0DD) |
POWDERBLUE (#B0E0E6) |
| PURPLE (#800080) |
RED (#FF0000) |
ROSYBROWN (#BC8F8F) |
ROYALBLUE (#4169E1) |
| SADDLEBROWN (#8B4513) |
SALMON (#FA8072) |
SANDYBROWN (#F4A460) |
SEAGREEN (#2E8B57) |
| SEASHELL (#FFF5EE) |
SIENNA (#A0522D) |
SILVER (#C0C0C0) |
SKYBLUE (#87CEEB) |
| SLATEBLUE (#6A5ACD) |
SLATEGRAY (#708090) |
SNOW (#FFFAFA) |
SPRINGGREEN (#00FF7F) |
| STEELBLUE (#4682B4) |
TAN (#D2B48C) |
TEAL (#008080) |
THISTLE (#D8BFD8) |
| TOMATO (#FF6347) |
TURQUOISE (#40E0D0) |
VIOLET (#EE82EE) |
WHEAT (#F5DEB3) |
| WHITE (#FFFFFF) |
WHITESMOKE (#F5F5F5) |
YELLOW (#FFFF00) |
YELLOWGREEN (#9ACD32) |
| Delivery-Name (*) | REQUIRED |
| Delivery-Extension | NOT REQUIRED |
| Delivery-Street (*) | REQUIRED (only if Delivery-POBox is empty) |
| Delivery-POBox (*) | REQUIRED (only if Delivery-Street is empty) |
| Delivery-City (*) | REQUIRED |
| Delivery-State (*) | REQUIRED |
| Delivery-Country | NOT REQUIRED (default value is "USA") |
| Delivery-ZIP-Code (*) | REQUIRED |
Important Defaults To Note
The current implementation of ILL Wizard provides ample customization through the applet parameters; however, there are
several important default settings that libraries should be aware of.
* Indicates a required parameter.
** Lender-List is required only when ILL-Service-Type is set to LENDER.
In order for the applet to load, it will require certain permissions that are not granted to Java applets by default. For this to happen, the applet has been signed with a digital certificate from Thawte Consulting. Before the browser loads the applet it will ask the user if they accept the certificate. Once this is done, the applet will be trusted by that browser on that computer. Due to differences in signature protocols, Microsoft Internet Explorer and Netscape Navigator require separately signed applet archives and will display different dialogs to the user for acceptance of the applet. These dialogs will appear similar to those below.
Figure 1 A Microsoft Internet Explorer Certificate Acceptance Dialog
Figure 2 A Netscape Navigator Certificate Acceptance Dialog
These dialogs will only be displayed once if the "Always trust content from Bryan Wilhelm" (Microsoft Internet Explorer) or "Remember this decision" (Netscape Navigator) is checked.
Operation of this applet program is relatively straight-forward. The interface helps users create a complete interlibrary loan request by allowing only the actions for which prerequisite information has been supplied. When the applet is first loaded, the proper behavior of the program is to allow the user to fill in only the user profile information. The program must have this in order to associate the request with the individual who submits it, therefore all other options on the applet menu are disabled (except "About" and "Cancel"). The program will not allow the user to continue without filling in all required fields of the user profile. The required fields are labeled with bold text. When the profile has been completed and saved the "Book Request" and "Article Request" options are enabled, but the "View Requests" and "Submit Requests" remain disabled until an item has been successfully completed and saved.
After the user has completed a request, or set of requests, they can submit them by pressed the "Submit Requests" button on the menu bar. All requested items will be submitted at once, and the OCLC server response will be posted. The condition of the submission can be plainly seen by the informational icon directly to the left of the text area.
| The Meaning of the Icons on the Request Submission Page | |
|---|---|
 |
Indicates that the request, or request set, was submitted completely and received a favorable response from the ILL host server. |
 |
Indicates that the request, or request set, was submitted completely but received a warning from the ILL host server. |
 |
Indicates that a fatal error occurred during submission of the request, or request set, and either some or all of the requests could not be submitted to the ILL host server. |
Warnings typically result in the request being sent to the review file where library personnel can handle it. If a fatal error occurs, the message will indicate the problem. In most cases these can be resolved by computer professionals at the library. A few may require support from the developer, in which case the message displayed in the text area should be submitted along with a request for support.
NOTE ABOUT DUPLICATES: Duplicate requests are not handled by ILL Wizard. ILL Direct Request creates a duplicate detection key for each request using the patron name, title, and article information. If ILL Direct Request finds an ILL or Review file record with the same duplicate detection key, the request is considered a potential duplicate. Only Direct-to-Profile processing can be affected by the identification of a potential duplicate. If the Direct-to-Profile service is used, it is recommended that the profile specify that duplicates be send to the review file.
If you have tested any other platforms not mentioned in this list, submit your results to Bryan Wilhelm.