NAME

Biblio::ILL::ISO::SupplyDetails

VERSION

Version 0.01

DESCRIPTION

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

USES

 Biblio::ILL::ISO::ILLString
 Biblio::ILL::ISO::DateDue
 Biblio::ILL::ISO::Amount
 Biblio::ILL::ISO::ShippedConditions
 Biblio::ILL::ISO::ShippedVia
 Biblio::ILL::ISO::UnitsPerMediumTypeSequence

USED IN

 Biblio::ILL::ISO::Shipped

FROM THE ASN DEFINITION

 Supply-Details ::= EXPLICIT SEQUENCE {
        date-shipped              [0]   IMPLICIT ISO-Date OPTIONAL,
        date-due                  [1]   IMPLICIT Date-Due OPTIONAL,
        chargeable-units          [2]   IMPLICIT INTEGER OPTIONAL, -- (1..9999)
        cost                      [3]   IMPLICIT Amount OPTIONAL,
        shipped-conditions        [4]   IMPLICIT Shipped-Conditions OPTIONAL,
        shipped-via             Shipped-Via OPTIONAL,
                -- electronic-delivery may only be present in APDUs with a
                -- protocol-version-num value of 2 or greater
        insured-for               [6]   IMPLICIT Amount OPTIONAL,
        return-insurance-require  [7]   IMPLICIT Amount OPTIONAL,
        no-of-units-per-medium    [8]   IMPLICIT SEQUENCE OF Units-Per-Medium-Type OPTIONAL
        }

METHODS

new( $date_shipped,$date_due, $chargeable_units, $cost, $shipped_conditions, $shipped_via, $insured_for, $return_insurance_require, $no_of_units_per_medium )

 Creates a new SupplyDetails object. 
 Expects (optionally) date-shipped (Biblio::ILL::ISO::ISODate or text string YYYYMMDD),
 (optionally) date-due (Biblio::ILL::ISO::ISODate or text string YYYYMMDD), 
 (optionally) chargeable-units (integer), 
 (optionally) cost (Biblio::ILL::ISO::Amount or text string),
 (optionally) shipped-conditions (Biblio::ILL::ISO::ShippedConditions),
 (optionally) shipped-via (Biblio::ILL::ISO::ShippedVia),
 (optionally) insured-for (Biblio::ILL::ISO::Amount or text string),
 (optionally) return-insurance-require (Biblio::ILL::ISO::Amount or text string),
 (optionally) no-of-units-per-medium (Biblio::ILL::ISO::UnitsPerMediumTypeSequence).

 Pass empty strings ("") as placeholders.

set( $date_shipped, $date_due, $chargeable_units, $cost, $shipped_conditions, $shipped_via, $insured_for, $return_insurance_require, $no_of_units_per_medium )

 Sets the object's fields:
 (optionally) date-shipped (Biblio::ILL::ISO::ISODate or text string YYYYMMDD),
 (optionally) date-due (Biblio::ILL::ISO::ISODate or text string YYYYMMDD), 
 (optionally) chargeable-units (integer), 
 (optionally) cost (Biblio::ILL::ISO::Amount or text string),
 (optionally) shipped-conditions (Biblio::ILL::ISO::ShippedConditions),
 (optionally) shipped-via (Biblio::ILL::ISO::ShippedVia),
 (optionally) insured-for (Biblio::ILL::ISO::Amount or text string),
 (optionally) return-insurance-require (Biblio::ILL::ISO::Amount or text string),
 (optionally) no-of-units-per-medium (Biblio::ILL::ISO::UnitsPerMediumTypeSequence).

 Pass empty strings ("") as placeholders.

from_asn($href)

Given a properly formatted hash, builds the object.

set_date_shipped( $dt )

 Sets the object's date-shipped.
 Expects a valid Biblio::ILL::ISO::ISODate or a properly formattted text string (YYYYMMDD).

set_date_due( $dt )

 Sets the object's date-due.
 Expects a valid Biblio::ILL::ISO::ISODate or a properly formattted text string (YYYYMMDD).

set_chargeable_units( $cu )

 Sets the object's chargeable-units.
 Expects an integer (1-9999).

set_cost( $cost )

 Sets the object's cost.
 Expects a valid Biblio::ILL::ISO::Amount or a text string.

set_shipped_conditions( $sc )

 Sets the object's shipped-conditions.
 Expects a valid Biblio::ILL::ISO::ShippedConditions.

set_shipped_via( $sv )

 Sets the object's shipped-via.
 Expects a valid Biblio::ILL::ISO::ShippedVia.

set_insured_for( $insured_amount )

 Sets the object's insured-for.
 Expects a valid Biblio::ILL::ISO::Amount or a text string.

set_return_insurance_require( $insurance_required_amount )

 Sets the object's return-insurance-require.
 Expects a valid Biblio::ILL::ISO::Amount or a text string.

set_no_of_units_per_medium( $units )

 Sets the object's no-of-units-per-medium.
 Expects a valid Biblio::ILL::ISO::UnitsPerMediumType.

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.

cpanm Biblio::ILL::ISO::asn

perl -MCPAN -e shell
install Biblio::ILL::ISO::asn