Functionality Library-customizable forms and pages Standard Pages webpub.defPrint this Page  Functionality
webpub.def
Record Display Definition, webpub.def file allows your library to define which fields will display in your WebPAC bibliographic record and attached records display, in what order, and with which labels. It also controls the size of the columns, which MARC tags, indicators, and subfields will display.

The webpub.def file is fully customizable. You can customize the bibliographic record display definition to suppress a line from public view or you can define a field that you do want to display to the public. You can also rename the labels for the fields.

When your library's WebPAC Pro is installed, a webpub.def file will be created in your system. You can modify this file by using any text editor, or you can edit it in Millennium Administration Web Master Mode.

Below is a snapshot of the webpub.def file, where you can see some of the elements used in a line. The first element defines the record type, b for bibliographic record, i for item record, c for holdings record, e for resource record, g for program record, and l for license record.

Fields display order

The second element in the line is the field tag. You can use any valid field tags (t, a, p, e, n, d, u, etc.). Fields with the same tag will display together and cannot be displayed separately. For example all the t tagged fields will display one after another, and all the a tagged fields and the n tagged fields will appear in their respective field tag groups.

The third element is the MARC tag and indicators. Specifying MARC tags and indicators is optional.

The fourth element (also optional) contains the subfields, which will always appear in the order they were stored within the record. It is not possible to control the order in which subfields appear in the webpub.def file.

The fifth element is the label. It is possible to define labels for the different MARC fields in the file.

Suppressing a Line from display

To suppress a defined tagged field from displaying in the WebPAC you can place a pound sign "#" in front of the line you want to suppress, and you need to add a line under the tagged line leaving the MARC field definition and the label definition blank.

For example, if you have two i tagged fields and you want to suppress one of them, the other i tagged line needs to read:
#b|i|020|&|ISBN||b|
b|i||&|||

Adding a Line to Display a New Field

To add a line to display a field that currently is not displaying in your library records is very simple. To add the barcode field to display to the public, follow these steps:

  1. In Millennium Administration Web Master mode choose to Edit the webpub.def file.
  2. Go to the part of the file that you wish to change.
  3. To obtain a blank line, go to end of the line preceding the line you want to create and hit the enter key. A blank line will be created.

  4. Type the line definition to create a line that will display the barcode: i|b|||Barcode|b|

  5. Save and close the webpub.def file.

Before adding the Barcode field to display in the item record, the display of the record looked as follows:

After adding the Barcode field to display, the record looks as follows:

Troubleshooting Tips

Possible Problem: You see a line with a field tag and a MARC tag in the webpub.def file but the field does not display in WebPAC Pro.

Possible Solution: Look for bad line construction with odd characters or missing characters. For example, a commented-out line will cause the system to ignore lines in the file.

Possible Problem: You make a change such as adding a label and you don't see the change displayed.

Possible Solution: This particular example happens when ^M characters are added at the time the file is uploaded from Windows to Unix as binary rather than as ASCII file. If you have these characters, check that the webpub.def is being uploaded as ASCII.

Possible Problem: Your webpub.def is full of control characters that are interfering with the system interpreting the file.

Possible Solution: This can happen if the file is opened or edited using a word processor or HTML editor. To fix this problem, remove the control characters. We recommend editing the file in a text editor such as notepad or vi or using the Web Master function in Millennium Administration to edit webpub.def in place on the server.

Languages and Webpub.def

You can create separate bibliographic and holdings record display files for each combination of language, scope, and patron type by using the following naming convention:
webpub_lang.def = webpub_spi_def or webpub_frc.def

For additional information, refer to the Innovative Guide & Reference, Page # (106853): Record Display Definition.