» Home › Connector Developer's Guide › Connector Functions ›

scrape_bib()

» Submitted by jblyberg on Sun, 09/27/2009 - 10:43pm

Function:
scrape_bib ($bnum, $skip_cover = FALSE)

Purpose:
scrape_bib() needs to return an array of information about a particular bibliographic record. Locum's server class (locum_server) uses this function for harvesting and keeping the database up-to-date.

Arguments:
$bnum : (string) required An item's bibliographic number or unique identifier.
$skip_cover : (boolean) optional Tells the connector function to return a cover image URL in the result set.

Expected Result:

Array
(
    [bnum] => (string) Bib number of record returned
    [bib_created] => (date - YYYY-MM-DD) Date bib record was created
    [bib_lastupdate] => (date) Date of last update to the record
    [bib_prevupdate] => (date) (optional) Date of next-to-last update to the record
    [bib_revs] => (int) (optional) Number of revisions to the record
    [lang] => (string) Language code
    [loc_code] => (string) Bib-level location or branch code
    [mat_code] => (string) Material code
    [suppress] => (int) 1 = Item should be suppressed, 0 = Not suppressed
    [author] => (string) Author: lastname, firstname birth year-death year
    [addl_author] => (string) Array of additional authors: lastname, firstname birth year-death year [serialized]
    [title] => (string) Title of work
    [title_medium] => (string) Media format description
    [edition] => (string) Edition information (MARC 250a)
    [series] => (string) Series name
    [callnum] => (string) Call number (MARC 099a)
    [pub_info] => (string) Publisher/publication information (MARC 260abc)
    [pub_year] => (int) Year of publication (MARC 300c)
    [stdnum] => (string) Standard number (ie ISBN) (MARC 020a)
    [upc] => (int) UPC symbol number (MARC 024a)
    [cover_img] => (string) URL of cover image
    [lccn] => (string) Library of Congress Catalog number (MARC 010)
    [descr] => (string) Physical Description (MARC 300abc)
    [notes] => (string) Array of record notes [serialized] (MARC 500,505,511,520)
    [subjects] => Array of subject headings
        (
            [] => (string) Subject heading
        )
 
)

Example:

Array
(
    [bnum] => 1279429
    [bib_created] => 2008-01-15
    [bib_lastupdate] => 2008-02-11
    [bib_prevupdate] => 2008-01-22
    [bib_revs] => 3
    [lang] => eng
    [loc_code] => a
    [mat_code] => b
    [suppress] => 0
    [author] => O'Brian, Patrick, 1914-2000
    [addl_author] => a:1:{i:0;s:13:"Tull, Patrick";}
    [title] => The thirteen gun salute
    [title_medium] => sound recording
    [edition] => 
    [series] => Aubrey/Maturin series ; 13
    [callnum] => ACD Fic OBRIAN
    [pub_info] => Prince Frederick, Md. : Recorded Books, p1995, c1989
    [pub_year] => 1989
    [stdnum] => 1402588992
    [upc] => 000000000000
    [cover_img] => 
    [lccn] => 
    [descr] => 11 sound discs (13.25 hr.) : digital ; 4 3/4 in
    [notes] => a:4:{i:0;s:13:"Compact discs";i:1;s:10:"Unabridged";i:2;s:24:"Narrated by Patrick Tull";i:3;s:206:"Captain Jack Aubrey and
 Stephen Maturin set sail for the South China Sea. At the barbaric court of Pulo Prabang, the stage is set for a duel of intelligence age
nts, pitting Stephen against the French envoys";}
    [subjects] => Array
        (
            [0] => Aubrey, Jack (Fictitious character) -- Fiction
            [1] => Maturin, Stephen (Fictitious character) -- Fiction
            [2] => Great Britain -- Fiction -- History, Naval -- 19th century
            [3] => South China Sea -- Fiction -- History, Naval -- 19th century
            [4] => Historical fiction.
            [5] => Sea stories.
            [6] => Audiobooks
        )
 
)