NAME

PICA::Webcat - Access to the CBS webcat interface (experimental)

SYNOPSIS

use PICA::Webcat;

$server = PICA::Webcat->new( $baseurl, $userkey, $password, $dbsid ); %result = $server->retrieve( $ppn ); %result = $server->insert( $record ); %result = $server->update( $ppn, $record, $version ); %result = $server->delete( $ppn );

METHODS

new ( $baseurl, $userkey, $password, $dbsid [, $language ] )

Create a new Server. You must specify a base URL, userkey, password, and database id. The optional language (default: "en") can be one of "de", "en", "fr" or "ne".

There is no error handling on failure yet!

retrieve ( $ppn )

Retrieve a record by PPN.

Returns a hash with either 'errorcode' and 'errormessage' or a hash with 'ppn', 'record', and 'version'. The 'record' element contains a PICA::Record object.

insert ( $record )

Insert a new record. The parameter must be a PICA::Record object.

Returns a hash with either 'errorcode' and 'errormessage' or a hash with 'ppn', 'record', and 'version'.

update ( $ppn, $record, $version )

Update a record by PPN, updated record (of type PICA::Record), and version (of a previous retrieve, insert, or update command).

Returns a hash with either 'errorcode' and 'errormessage' or a hash with 'ppn', 'record', and 'version'.

delete ( $ppn )

Deletes a record by PPN.

Returns a hash with either 'errorcode' and 'errormessage' or a hash with 'ppn'.

_soap_query

Internal method to prepare, perform and evaluate a SOAP request. Returns a hash with 'errorcode' and 'errormessage' or a hash with 'dbsid', 'ppn', 'record', and 'version' depending on the type of query. Do not directly call this method!