RSS FEED with WEBPAC PRO

1
RSS FEED withWEBPAC PRO

• JEERAPOL KUMKEAM
• KMUTNB
• IUG 14 3-4 DEC. 2009
• MAHIDOL UNIVERSITY

2
FEED BUILDER

• Libraries with WebPAC Pro and the Feed Builder
  product can construct their own outgoing feeds
  containing information specified in saved boolean
  lists or review files. The content of these feeds
  is controlled by library-created configuration
  files. Using these files, Feed Builder creates
  XML files nightly with the feed information
  stored in the /live/feeds directory.

3
FEED BUILDER

• Feed readers access the XML output from a URL
  based on the configuration file name. The URL
  format is
• http//catalog address/feeds/configuration
  file.xml
• Where catalog address is the name or IP address
  of your WebPAC and configuration file is the
  name of your configuration file without the .conf
  extension. For example
• http//lib.cat.edu/feeds/newdvds.xml

4
Configuration FEED BUILDER

• create configuration files for each feed you
  want.
• Using Web Master mode, upload your configuration
  files to the /live/config/feeds directory.
• Using Web Master mode, to edit and delete your
  configuration files in the /live/config/feeds
  directory.

5
Creating Configuration Files

• Using a text editor of your choice, create a
  configuration file for each feed you require.
  Each configuration file must have a .conf
  extension (for example, newdvds.conf) and must
  have elements that are case-sensitive and can
  appear in any order in the file.

6
FEED .conf Element

• formatformat
• hostnamehost name
• query_typequery type
• queryquery
• max_itemsmax items
• titletitle
• descdescription
• langlanguage
• item_titleitem title
• item_descitem description
• record_typerectype
• date_adjdate
• rangerange
• cover_imagecover image

7
Value Description

• format
• This value is the format of the feed. Feed
  Builder supports RSS 2.0
• host name
• This value is the qualified host name (e.g.,
  lib.catalog.edu) for the Millennium server. This
  value is used when generating the feed URL.
• query type
• This value specifies the type of query Feed
  Reader can expect. Feed Reader currently accepts
  queries from a "saved query" or a review file.
  Valid values are b for "saved query" or r for
  review file.

8
Value Description (cont.)

• query
• This value is the query used by the
  configuration file. If the query type is b,
  this value is the name of the "saved query"
  created in Create Lists. If the query type is
  r, this value is the name of the review file.
• max items
• This value is the maximum number of items
  included in feed regardless of query results. The
  default for this value is 500. Values higher than
  500 are ignored.
• title
• This value is the title label for the feed.
• description
• This value is the descriptive label for the
  feed.

9
Value Description (cont.)

• language
• This value is the three-character language code
  for the language in which WebPAC displays the
  feed.
• item title
• This value is the field specification defining
  the title to display and the record to use to
  obtain the title.
• item description
• This required value is the field specification
  defining additional record information to
  display, such as author or subject.This value
  must be defined for the item's associated image
  to display.

10
Value Description (cont.)

• rectype
• This value is the record type to match against.
• date
• This value is the number of hours to subtract
  from the current date and time to replace all
  dates in the query. The final value is matched
  against the CAT DATE in the target record. For
  example, if the current time is Aug 28, 1100
  A.M. and the date_adj element is set to 72, the
  record passes the test if the CAT_DATE is greater
  than Aug 25, 1100 A.M.
• range
• This value is the number of records to include
  in the range, starting from the last record in
  the catalog or the last record in your query.

11
Value Description (cont.)

• cover image
• This value is the URL for the book jacket image
  associated with the bibliographic record. This
  value accepts the following special variable s.
  The WebPAC replaces the s variable with the ISBN
  of the bibliographic record. For example
• cover_imagehttp//lib.syndetics.com/randomaccount
  .pl?isbns/SC.GIF
• The URL format should match the URL settings used
  in the BIBIMAGE Web option (if used).

12
Field Specification Element Description

• V
• The character 'V' signifies that the field being
  selected is a variable-length field. This is a
  required element and must have a colon ()
  preceding it.
• r
• The record type indicator for the record from
  which to take the selected field. This is a
  required element.
• t
• The variable-length field group tag for the
  selected field. This is a required element.

13
Field Specification Element Description (cont.)

• 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, and can be included
  only if a MARC tag has been defined.
• s
• The subfield for the MARC tag specified above.
  This is an optional field, and can be included
  only if a MARC tag and indicator have been
  defined.

14
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 will be
  taken from or written to 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.

15
For example

• An item_title or item_desc can contain only one
  field specification for each record type. For
  example, these elements and values are allowed
• item_titleVitVbt
• item_descViaVba

16

• These elements and values are not allowed,
  because they contain more than one field
  specification for a record type
• item_titleVbtVbeVbp
• item_descFb028Fb084Fb081Fb083

17
For example

• formatRSS2.0
• hostnamelib.cat.edu
• query_typeb
• querykwtest
• max_items10
• titleNew DVDs
• descNew Additions to the Library Collection
• langeng
• item_titleVitVbt
• item_descViaVba
• record_typei
• date_adj12
• range10000
• cover_imagehttp//lib.syndetics.com/randomaccount
  .pl?isbns/SC.GIF