Brief Citation Form

Command link:     None
HTML document:  briefcit.html

This form controls the display of a brief citation (bibliographic record information that displays on a record browse). If this file exists, and if the TABLEPARAM_BRIEFCIT Web option has been properly defined, the system uses this form rather than the default display. This form uses the following tokens:

NOTE

The content of this form is inserted in a table. All content and tokens must appear between opening <TR> and <TD> tags and closing </TD> and </TR> tags.

Token Description
<!--{fieldspec:[fieldspec]}-->
or
<!--{linkfieldspec:[fieldspec]}-->

Both versions of this token replace the [fieldspec] value with data located in the specified fields. The <!--{fieldspec:[fieldspec]}--> displays the fields as text, whereas the <!--{linkfieldspec:[fieldspec]}--> displays fields as a HTML hyperlink to the full record display for the bibliographic record associated with the full citation.

The [fieldspec] can be specified with both fixed-length fields and variable-length fields.

  • If fixed-length field tags are used in this token, the meaning of the tag is displayed, replacing the token. Labels are not included in this display.
  • Variable-length fields are specified using their field tag and optionally a MARC tag, subfields, and indicators. If a variable-length field is specified by the field spec token, only the data from the defined field is displayed in place of the token. Labels are not included in this display. For example:     

<!--{fieldspec:Vbp260:a}-->

This will cause only subfield 'a' of the p260 field to display. If the variable-length field specified does not exist in the record, no data displays to the user.

To specify fields, see Field Specification Formatting.

There are four special variable-length field spec tags used to control which fields are included in the display:

d Displays only the first d-tagged field in the bibliographic record
D Displays every d-tagged field in the bibliographic record, each on its own line in the brief citation. This is valid in <!--{fieldspec[fieldspec]}--> only!
t Selects the first t-tagged field in the bibliographic record
T

Selects the "best" t-tagged field from a search of a phrase search of the title index based on the following criteria:

  • If the DISPLAY_245 Web option is set, the WebPAC uses the 245 field instead of the t-tagged field.
  • If the DISPLAY_T880 Web option is set, the WebPAC displays the matching 880 field with the "best" title. For more information, see Displaying the 880 Field in Record Browse Results.
  • If there is no 245 field, the system uses the first t-tagged field instead.
  • The system displays the t-tagged field as the indexed title and displays the "best" title from a phrase search of the title index as the hyperlinked title.

For example:

<!--{linkfieldspec:VbT}-->

In some record browse entries the indexed title differs from the "best" title. The T option enables the Brief Citation to include both the indexed t-tagged field enclosed in quotes and the "best" title as a hyperlink to the full record display

<!--{entrynum}--> Displays the number of the entry in the result set. This is always a numeric value. For "no hit" or "close by" browses, the entry number will not display.
<!--{mark}-->

If the ICON_BOOKCART Web option is defined, the system wraps each brief citation in <FORM> tags and this token displays the text or image defined in the ICON_BOOKCART Web option. Clicking on the image or text set in the Web option submits the form and adds the bibliographic record to the user's list of saved records
If the ICON_BOOKCART Web option is not defined, this token displays a form input checkbox. The entire brief citation table (containing all the brief citations on that page), including the Save Marked Records and Save All on Page buttons, are wrapped in <FORM> tags. Users can save marked records by using one of the three following methods:

  • The user must mark the checkbox and click the Save Marked Records button to save a record to the list of saved records.
  • If an image is offered for the record, the user can click the image to save the record to a list of saved records.
  • If the user wants to save all records on the page, click the Save All on Page button.
<--{ifmarked}-->

If this token is present, the system checks whether or not the user has saved the indicated record. If so, the system interprets markup between this token and the associated <--{else}--> token. If not, the system interprets markup between the <--{else}--> token and the associated <!--{xif}--> token. The system can mark items in a book cart by using a setup similar to the following:

<tr class="marked">
<!--{else}-->
<tr>
<!--{xif}-->

See Browse Display Classes for information on the .marked style class.

<--{else}--> Closes the logic for the <--{ifmarked}--> token if an item is in the Book Cart.
<--{xif}--> Closes the logic for the <--{ifmarked}--> token if an item is not in the Book Cart.
<!--{bibloc}--> The system replaces this token with the individual locations associated with the bibliographic record entry.
<!--{itemcallno}--> Displays the item call number.
<!--{holdingsmsg}-->

Displays the brief holdings message for the bibliographic record. The message varies depending upon the number of copies available and the number of locations with available copies. The message conditions are:

Criteria Message
No copies available "No copies available"
You can customize display of this message with the NO_COPIES Web option.
Copies available at one to four locations "<x> copies available at <loc1>, <loc2>, <loc3> and <loc4>" Where <x> is the total number of copies available for all listed locations and where <loc1>, <loc2>, <loc3> and <loc4> are the meanings of the location codes for the available copies. Only as many locations will be listed as have copies available.
Copies available at more than four locations "<x> copies available at <loc1>, <loc2>, <loc3> and <n> other locations" Where <x> is the total number of copies available at all locations, <loc1>, <loc2>, and <loc3> are the meaning of the location codes for the first three locations with copies available and <n> is the number of other locations (total minus three) with available copies.
<!--{items}--> Displays the summary table for items or volumes.
<!--{holds}-->

Displays a hold message depending on the following conditions:

Condition Message
One hold in the queue and multiple copies of the item exist. 1 hold on first copy returned of <number> copies
One hold in the queue and one copy of the item exists. 1 hold on first copy returned of 1 copy
Multiple holds in the queue and one copy of the item exists. <number> holds on first copy returned of 1 copy
Multiple holds in the queue and multiple copies of the item exists. <number> holds on first copy returned of <number> copies

Sierra includes items on order when counting the number of copies.

<!--{ifbookable}--> If your library has acquired Materials Booking, this token allows the behavior in the <!--{bookingmsg}--> to work.
<!--{bookingmsg}--> If your library has acquired Materials Booking, the system verifies that the bibliographic record has bookable copies. If so, the message "<x> copies bookable" appears, where <x> is the number of bookable copies.
<!--{xif}--> Closes the <!--{ifbookable}--> block.
<!--{media}--> Displays the material type as defined in the MEDIA Web option or, if it is defined, by the IMAGE_MATTYPEx image associated with that material type. If no material type is set in the MEDIA Web option, this token displays a &nbsp; (non-breaking space).
<!--{ifhasbookjacket}--> If you have a book jacket image associated with a bibliographic record, this token allows the behavior in the <!--{bookjacket}--> to work.
<!--{bookjacket}--> Displays the image located at the URL defined in the second element of the BIBIMAGE Web option.
<!--{xif}--> Closes the <!--{ifhasbookjacket}--> block.
<--{mylists}--> The system replaces this token with a link that uses the display properties defined by the value of the ICON_MYLISTS_BRIEF Web option. Clicking this link allows a user to add the record to a list using the My Lists functionality.

<!--{reslink}-->

If your library has acquired the Pathfinder Pro or WebBridge products,the system replaces this token with the value of the ICON_BUT_RESOURCELINK Web option. Clicking on this link takes the user to bibliographic level resource links.
If you have not acquired Pathfinder Pro or WebBridge, the system replaces this token with the image defined in the WEBADDRESS Web option. Clicking on this image takes the user to the URL defined in the appropriate element of the WEBADDRESS Web option. If this Web option is not defined, the system replaces this token with a non-breaking space (&nbsp;).
<!--{request}--> If the REQUEST Web option is defined, the system displays the image or text defined in the ICON_REQUEST Web option. If the ICON_REQUEST Web option is not defined, the text link "Request" appears instead. Clicking on either the image or the text link initiates a request for the bibliographic record associated with the brief citation.
<!--{year}--> The system replaces this token with the publication year in the bibliographic record. The source of the publication year depends on your system setup (for example, the MARC 260 field).
<!--{tofullrecord}--> Displays the image or text defined in the ICON_FULLRECORD Web option. If this Web option is not defined, the text link "Full Record" displays instead. Clicking on either the image or the text link takes the user to the full record display of the bibliographic record associated with the brief citation.
<!--{856link}-->

The system replaces this token with the value of the link to any associated electronic resources, based on the following criteria:

  • If the ICON_856LINK Web option is defined, the system replaces the token with the value of the Web option.
  • ICON_856LINK Web option iss not defined, the system replaces the token with an "Electronic Resources" text link.

Clicking on either the image or the text link takes the user to the URL defined in the u subfield in the first 865 MARC field found in the associated bibliographic record or a different MARC field URL source specified in the LOCALLINK_TAG Web option. If there are no 856 fields in the bibliographic record, the system displays a &nbsp; (non-breaking space).

<!--{ifmulti856}--> If this token is present, the system checks whether or not a bibliographic record contains multiple 856 fields or if a bibliographic record has fields defined in the LOCALLINK_TAG Web option. If so, the system interprets tokens and markup between this token and its closing <!--{xif}--> token.
<!--{more856}--> Displays the text link "More...". This hyperlink takes the user to the full record display of the bibliographic record associated with the brief citation. If the record does not contain multiple 856 fields, the WebPAC displays a &nbsp; (non-breaking space).
<!--{xif}--> Closes the <!--{ifmulti856}--> block.
<!--{962link}--> Displays the image or text defined in the ICON_962LINK Web option. If this Web option is not defined, the text link "Image" displays instead. Clicking on either the image or the text link takes the user to the URL defined in the first 962 MARC field found in the associated bibliographic record. If there are no 962 fields in the bibliographic record, the WebPAC displays a &nbsp; (non-breaking space).
<!--{ifmulti962}--> Checks the associated bibliographic record to determine whether it contains multiple 962 fields. If so, enables the <!--{more962}--> token.
<!--{more962}--> If the associated bibliographic record contains multiple 962 fields, displays the text link "More...". Clicking on this text link takes the user to the full record display of the bibliographic record associated with the brief citation. If the record does not contain multiple 962 fields, the WebPAC displays a &nbsp; (non-breaking space).
<!--{xif}--> Closes the <!--{ifmulti962}--> block.
<!--{rating}--> If your organization uses Patron Material Ratings, this token is replaced with the material ratings tool.
<!--{webaddress}--> If the WEBADDRESS is defined, the system replaces this token with the fifth element of the WEBADDRESS Web option.
 

Field Specification Formatting

Field Type Formatting
Fixed-length fields

Fbnnn

F The character 'F', to signify that the field being selected is a fixed field. This is a required element.
b The record type indicator for the bibliographic record from which to take the selected field. This is a required element. b is the only valid entry.
nnn

The three-digit (including any leading zeros) fixed-length field number for the selected field. Valid field numbers are as follows:

024 LANG
025 SKIP
026 LOCATION
027 COPIES
028 CAT DATE
029 BIB LVL
030 MAT TYPE
031 BCODE3
089 COUNTRY

For example:

Fb026

Defines the LOCATION field (field number 026) in the bibliographic record.

Variable-length fields

Vbtmmmiis

V The character 'V', to signify that the field being selected is a variable-length field. This is a required element.
b The record type indicator for the bibliographic record from which to take the selected field. This is a required element. b is the only valid entry.
t The variable-length field group tag for the selected field. This is a required element.
mmm The three-character MARC tag (including any leading zeros) for the selected field. This is an optional element.
ii The indicator for the MARC tag specified above. This is an optional field, but can only be included if a MARC tag has been defined.
s The subfield for the MARC tag specified above. This is an optional field, but can only be included if a MARC tag and indicator have been defined.

For example:

Vbt24510a

Defines a TITLE field from a bibliographic record, having a MARC tag of 245 with an indicator of 10 and a subfield a. Data is taken from or written to only a field (the first field found that matches, not every field that matches) that matches this pattern. If a subfield is included, only that subfield is affected. If no subfield is included, the entire field is affected.

Varying by Language, Scope, and Patron Type

You can create separate custom forms for each combination of language, scope, and patron type by using the following naming convention:

briefcit_LANG_s#_p#.html

LANG The language code (e.g., spi for Spanish, frc for French)
s# The number of the scope (e.g., s1, s2, s3)
p# The patron type or PTYPE (e.g., p0 or p243)

For a current example of this form, see the appropriate example set in WebPAC Example Sets and Photoshop Files on CSDirect.