NAME

Biblio::ILL::ISO::ItemId

VERSION

Version 0.01

DESCRIPTION

Biblio::ILL::ISO::ItemId is a derivation of Biblio::ILL::ISO::ILLASNtype.

USES

 Biblio::ILL::ISO::ILLString
 Biblio::ILL::ISO::ItemType
 Biblio::ILL::ISO::MediumType

USED IN

 Biblio::ILL::ISO::Request

FROM THE ASN DEFINITION

 Item-Id ::= SEQUENCE {
        item-type       [0]     IMPLICIT Item-Type OPTIONAL,
        held-medium-type        [1]     IMPLICIT Medium-Type OPTIONAL,
        call-number     [2]     ILL-String OPTIONAL,
        author  [3]     ILL-String OPTIONAL,
        title   [4]     ILL-String OPTIONAL,
        sub-title       [5]     ILL-String OPTIONAL,
        sponsoring-body [6]     ILL-String OPTIONAL,
        place-of-publication    [7]     ILL-String OPTIONAL,
        publisher       [8]     ILL-String OPTIONAL,
        series-title-number     [9]     ILL-String OPTIONAL,
        volume-issue    [10]    ILL-String OPTIONAL,
        edition [11]    ILL-String OPTIONAL,
        publication-date        [12]    ILL-String OPTIONAL,
        publication-date-of-component   [13] ILL-String OPTIONAL,
        author-of-article       [14]    ILL-String OPTIONAL,
        title-of-article        [15]    ILL-String OPTIONAL,
        pagination      [16]    ILL-String OPTIONAL,
 -- DC - 'EXTERNAL' is not currently supported
 --     national-bibliography-no        [17]    EXTERNAL OPTIONAL,
        iSBN    [18]    ILL-String OPTIONAL, -- (SIZE (10))
                -- must conform to ISO 2108-1978
        iSSN    [19]    ILL-String OPTIONAL, -- (SIZE (8))
                -- must conform to ISO 3297-1986
 -- DC - 'EXTERNAL' is not currently supported
 --     system-no       [20]    EXTERNAL OPTIONAL,
        additional-no-letters   [21] ILL-String OPTIONAL,
        verification-reference-source   [22] ILL-String OPTIONAL
        }

METHODS

new( [$title [, $author [, $call-number]]] )

Creates a new ItemId object. Expects either no paramaters, or a title (text string), author (text string), and/or call number (text string).

 These tend to be the most common / minimalist Item identifiers.

 Example:
 my $iid = new Biblio::ILL::ISO::ItemId("My Book","David Christensen","CHR001.1");
 $iid->set_item_type("monograph");
 $iid->set_medium_type("printed");
 $iid->set_pagination("456");
 $iid->set_publication_date("2003");

from_asn($href)

Given a properly formatted hash, builds the object.

set_item_type( $itemtype )

 Sets the item's item-type.  
 Expects a valid Biblio::ILL::ISO::ItemType.

set_medium_type( $mt )

 Sets the item's held-medium-type.
 Expects a valid Biblio::ILL::ISO::MediumType.

set_call_number( $s )

 Sets the item's call-number.
 Expects a text string.

set_author( $s )

 Sets the item's author.
 Expects a text string.

set_title( $s )

 Sets the item's title.
 Expects a text string.

set_subtitle( $s )

 Sets the item's sub-title.
 Expects a text string.

set_sponsoring_body( $s )

 Sets the item's sponsoring-body.
 Expects a text string.

set_place_of_publication( $s )

 Sets the item's place-of-publication.
 Expects a text string.

set_publisher( $s )

 Sets the item's publisher.
 Expects a text string.

set_series_title_number( $s )

 Sets the item's series-title-number.
 Expects a text string.

set_volume_issue( $s )

 Sets the item's volume-issue.
 Expects a text string.

set_edition( $s )

 Sets the item's edition.
 Expects a text string.

set_publication_date( $s )

 Sets the item's publication-date.
 Expects a text string.

set_publication_date_of_component( $s )

 Sets the item's publication-date-of-component.
 Expects a text string.

set_author_of_article( $s )

 Sets the item's author-of-article.
 Expects a text string.

set_title_of_article( $s )

 Sets the item's title-of-article.
 Expects a text string.

set_pagination( $s )

 Sets the item's pagination (page count).
 Expects a text string.

set_isbn( $s )

 Sets the item's iSBN.
 Expects a text string.

set_issn( $s )

 Sets the item's iSSN.
 Expects a text string.

set_additional_no_letters( $s )

 Sets the item's additional-no-letters.
 Expects a text string.

set_verification_reference_source( $s )

 Sets the item's verification-reference-source.
 Expects a text string.

 Ie - where did this ItemId information come from?

SEE ALSO

See the README for system design notes. See the parent class(es) for other available methods.

For more information on Interlibrary Loan standards (ISO 10160/10161), a good place to start is:

http://www.nlc-bnc.ca/iso/ill/main.htm

AUTHOR

David Christensen, <DChristensenSPAMLESS@westman.wave.ca>

COPYRIGHT AND LICENSE

Copyright 2003 by David Christensen

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.