Perl extension for talking to a refdb server
use RefDB::Client;
RefDB::Client provides functions to talk to a refdbd process like the RefDB C clients do. This module isn't a wrapper for the C clients but uses native Perl code to talk to the server.
Send bug reports, questions, and comments to the refdb-users mailing list at:
For list information and archives, please visit:
http://lists.sourceforge.net/lists/listinfo/refdb-users
Markus Hoenicka, [email protected]
This module is part of the RefDB package, a reference manager and bibliography tool for markup languages. Please visit http://refdb.sourceforge.net for further information.
Title : new
Usage : new RefDB::Risdata();
Function: Creates a new Risdata object
Title : read_ris
Usage : $data->read_ris($file);
Function: loads \s-1RIS\s0 data from a file
Parameter: $file: path of file
Title : get_ris
Usage : $data->get_ris();
Function: returns previously loaded \s-1RIS\s0 data
Title : new
Usage : new RefDB::Simplelist;
Function: creates a new Simplelist element
Title : new
Usage : new RefDB::Enigma;
Function: creates a new Enigma element
Title : new
Usage : new RefDB::Client;
Function: creates a new Client element
Title : set_conninfo
Usage : $client->set_conninfo($server_ip, $port_address, $username, $password, $database, $pdf_root, $css_url, $timeout);
Function: sets the initial connection parameters of a Client object
Parameter: $server_ip: \s-1IP\s0 address or hostname of the server that runs refdbd
Parameter: $port_address: Port address at which refdbd listens
Parameter: $username: Username for database password authentication
Parameter: $password: Password for database password authentication
Parameter: $database: Name of the reference database
Parameter: $pdf_root: Path of the root directory of all electronic offprints
Parameter: $css_url: \s-1URL\s0 of a Cascading Stylesheets file for (X)HTML output
Parameter: $timeout: time in seconds after which a stale connection is dropped
Title : get_status
Usage : $client->get_status();
Function: returns the numerical server status
Title : get_status_msg
Usage : $client->get_status_msg();
Function: returns the server status message
Title : translate_status
Usage : $client->translate_status($status);
Function: translates a given server status into a human readable message
Title : get_data
Usage : $client->get_data();
Function: returns the data of the most recent command
Title : get_summary
Usage : $client->get_summary();
Function: returns the summary of the most recent command
Title : refdb_addstyle
Usage : $client->refdb_addstyle($styledata);
Function: adds a citation/bibliography style to the database
Parameter: $styledata: \s-1XML\s0 data representing the bibliography style
Title : refdb_adduser
Usage : $client->refdb_adduser($host, $database, $newuserpassword, $username);
Function: adds new users to the database
Parameter: $host: host specification from which the user is allowed to connect
Parameter: $database: name of the reference database
Parameter: $newuserpassword: password (required only for new users)
Parameter: $username: name of the user, as used to authenticate at the database engine
Title : refdb_deleteuser
Usage : $client->refdb_deleteuser($host, $database, $username);
Function: deletes users from the database
Parameter: $host: host specification from which the user is allowed to connect
Parameter: $database: name of the reference database
Parameter: $username: name of the user, as used to authenticate at the database engine
Title : refdb_addword
Usage : $client->refdb_addword($words);
Function: adds reserved words to the main database
Parameter: $words: space-separated list of words
Title : refdb_deleteword
Usage : $summary = $client->refdb_deleteword($words);
Function: removes reserved words from the main database
Parameter: $words: space-separated list of words
Title : refdb_confserv
Usage : $client->refdb_confserv($command);
Function: sends a configuration command to the server
Parameter: $command: the command proper, optionally followed by an argument
Title : refdb_createdb
Usage : $client->refdb_createdb($dbname, $encoding);
Function: creates a new database
Parameter: $dbname: name of the reference database
Parameter: $encoding: character encoding
Title : refdb_deletedb
Usage : $client->refdb_deletedb($databasename);
Function: deletes a reference database
Parameter: $dbname: name of the database
Title : refdb_deletestyle
Usage : $client->refdb_deletestyle($stylename_regexp);
Function: deletes citation/bibliography styles
Parameter: $stylename_regexp: regular expression describing the names of the styles to be deleted
Title : refdb_getstyle
Usage : $client->refdb_getstyle($stylename);
Function: retrieves a citation/bibliography style as a citestylex doc
Parameter: $stylename: name of the style
Title : refdb_listdb
Usage : $client->refdb_listdb($dbname_regexp);
Function: lists matching databases
Parameter: $dbname_regexp: regular expression describing the database names
Title : refdb_listuser
Usage : $client->refdb_listuser($dbname, $username_regexp);
Function: lists matching user names
Parameter: $username_regexp: regular expression describing the user names
Title : refdb_listword
Usage : $client->refdb_listword($word_regexp);
Function: lists matching journal name words
Parameter: $wordname_regexp: regular expression describing the word names
Title : refdb_liststyle
Usage : $client->refdb_liststyle($stylename_regexp);
Function: lists matching citation/bibliography styles
Parameter: $stylename_regexp: regular expression describing the style names
Title : refdb_viewstat
Usage : $client->refdb_viewstat();
Function: requests version/connection info from the server
Title : refdb_scankw
Usage : $client->refdb_scankw($dbname);
Function: runs a thorough keyword scan in the given database
Parameter: $dbname: name of the reference database
Title : refdb_addref
Usage : $client->refdb_addref($owner, $refdata, $type, $encoding);
Function: adds references to the database
Parameter: $owner: name of the dataset owner, if different from current user
Parameter: $refdata: string containing the reference data
Parameter: $type: data type, must be one of 'ris' or 'risx'
Parameter: $encoding: character encoding of the input data (only for \s-1RIS\s0 data)
Title : refdb_updateref
Usage : $client->refdb_updateref($owner, $is_personal, $risdata, $type, $encoding);
Function: updates references in the database
Parameter: $owner: name of the dataset owner, if different from current user
Parameter: $is_personal: set to 't' if only the personal information shall be updated
Parameter: $refdata: string containing the reference data
Parameter: $type: data type, must be one of 'ris' or 'risx'
Parameter: $encoding: character encoding of the input data (only for \s-1RIS\s0 data)
Title : refdb_checkref
Usage : $client->refdb_checkref($risdata, $type, $encoding, $outtype);
Function: checks references for duplicates in the database
Parameter: $refdata: string containing the reference data
Parameter: $type: data type, must be one of 'ris' or 'risx'
Parameter: $encoding: character encoding of the input data (only for \s-1RIS\s0 data)
Parameter: $outtype: output type (scrn|xhtml)
Title : refdb_deleteref
Usage : $client->refdb_deleteref($idlist);
Function: deletes references from the database
Parameter: $idlist: string specifying the IDs of the references to be deleted
Title : refdb_addnote
Usage : $client->refdb_addnote($owner, $xnotedata);
Function: adds notes to the database
Parameter: $owner: owner of the note, if different from the current user
Parameter: $xnotedata: \s-1XML\s0 data specifying the note
Title : refdb_updatenote
Usage : $client->refdb_updatenote($owner, $xnotedata);
Function: updates references in the database
Parameter: $owner: owner of the note, if different from the current user
Parameter: $xnotedata: \s-1XML\s0 data specifying the note
Title : refdb_deletenote
Usage : $client->refdb_deletenote($idlist);
Function: deletes notes from the database
Parameter: $idlist: string specifying the \s-1ID\s0 values of the notes to be deleted
Title : refdb_addlink
Usage : $client->refdb_addlink($linkspec);
Function: links notes to database objects
Parameter: $linkspec: string specifying the link(s) to be created
Title : refdb_deletelink
Usage : $client->refdb_deletelink($linkspec);
Function: unlinks notes from database objects
Parameter: $linkspec: string specifying the link(s) to be deleted
Title : refdb_getas
Usage : $client->refdb_getas($limit_string, $freq, $name_regexp);
Function: retrieves matching series authors
Parameter: $limit_string: specifies limit and offset
Parameter: $freq: requests frequency information ("freq" | "relfreq")
Parameter: $name_regexp: regular expression describing the names to be retrieved
Title : refdb_getau
Usage : $client->refdb_getau($limit_string, $freq, $name_regexp);
Function: retrieves matching part authors
Parameter: $limit_string: specifies limit and offset
Parameter: $freq: requests frequency information (\*(L"freq\*(R" | \*(L"relfreq\*(R")
Parameter: $name_regexp: regular expression describing the names to be retrieved
Title : refdb_getax
Usage : $client->refdb_getax($limit_string, $freq, $name_regexp);
Function: retrieves matching authors/editors (all levels)
Parameter: $limit_string: specifies limit and offset
Parameter: $freq: requests frequency information (\*(L"freq\*(R" | \*(L"relfreq\*(R")
Parameter: $name_regexp: regular expression describing the names to be retrieved
Title : refdb_geted
Usage : $client->refdb_geted($limit_string, $freq, $name_regexp);
Function: retrieves matching publication authors/editors
Parameter: $limit_string: specifies limit and offset
Parameter: $freq: requests frequency information (\*(L"freq\*(R" | \*(L"relfreq\*(R")
Parameter: $name_regexp: regular expression describing the names to be retrieved
Title : refdb_getkw
Usage : $client->refdb_getkw($limit_string, $freq, $keyword_regexp);
Function: retrieves matching keywords
Parameter: $limit_string: specifies limit and offset
Parameter: $freq: requests frequency information (\*(L"freq\*(R" | \*(L"relfreq\*(R")
Parameter: $keyword_regexp: regular expression describing the keywords to be retrieved
Title : refdb_getjf
Usage : $client->refdb_getjf($is_all, $limit_string, $freq, $journal_regexp);
Function: retrieves matching periodicals (full names)
Parameter: $is_all: set to 't' if all synonymous journal names shall be returned
Parameter: $limit_string: specifies limit and offset
Parameter: $freq: requests frequency information (\*(L"freq\*(R" | \*(L"relfreq\*(R")
Parameter: $name_regexp: regular expression describing the names to be retrieved
Title : refdb_getjo
Usage : $client->refdb_getjo($is_all, $limit_string, $freq, $journal_regexp);
Function: retrieves matching periodical names (abbrev)
Parameter: $is_all: set to 't' if all synonymous journal names shall be returned
Parameter: $limit_string: select limit and offset
Parameter: $freq: requests frequency information (\*(L"freq\*(R" | \*(L"relfreq\*(R")
Parameter: $name_regexp: regular expression describing the names to be retrieved
Title : refdb_getj1
Usage : $client->refdb_getj1($is_all, $limit_string, $freq, $journal_regexp);
Function: retrieves matching periodical names (custom abbrev 1)
Parameter: $is_all: set to 't' if all synonymous journal names shall be returned Parameter: $limit_string: select limit and offset
Parameter: $freq: requests frequency information (\*(L"freq\*(R" | \*(L"relfreq\*(R")
Parameter: $name_regexp: regular expression describing the names to be retrieved
Title : refdb_getj2
Usage : $client->refdb_getj2($is_all, $limit_string, $freq, $journal_regexp);
Function: retrieves matching periodical names (custom abbrev 2)
Parameter: $is_all: set to 't' if all synonymous journal names shall be returned
Parameter: $limit_string: select limit and offset
Parameter: $freq: requests frequency information (\*(L"freq\*(R" | \*(L"relfreq\*(R")
Parameter: $name_regexp: regular expression describing the names to be retrieved
Title : refdb_getref
Usage : $client->refdb_getref($type, $format_string, $sort_string, $listname, $encoding, $limit_string, $frequency, $query_string);
Function: retrieves references
Parameter: $type: select output format
Parameter: $format_string: specify additional fields to be retrieved
Parameter: $sort_string: specify sorting key
Parameter: $listname: optional name of a personal reference list
Parameter: $encoding: the character encoding for the output data
Parameter: $limit_string: specifies limit and offset
Parameter: $frequency: if \*(L"t\*(R", include frequency information in output
Parameter: $query_string: the query that describes the datasets to be retrieved
Title : refdb_countref
Usage : $client->refdb_countref($listname, $limit_string, $query_string);
Function: counts references
Parameter: $listname: optional name of a personal reference list
Parameter: $limit_string: specifies limit and offset
Parameter: $query_string: the query that describes the datasets to be retrieved
Title : refdb_pickref
Usage : $client->refdb_pickref($idlist, $listname);
Function: adds references to a personal reference list
Parameters: $idlist: specifies the \s-1ID\s0 values of the references to be picked
$listname: name of the personal reference list. If the string
is empty, use the default personal reference list
Title : refdb_dumpref
Usage : $client->refdb_dumpref($idlist, $listname);
Function: removes references from a personal reference list
Parameters: $idlist: specifies the \s-1ID\s0 values of the references to be dumped
$listname: name of the personal reference list. If the string
is empty, use the default personal reference list
Title : refdb_getnote
Usage : $client->refdb_getnote($type, $format_string, $sort_string, $encoding, $limit_string, $query_string);
Function: retrieves references
Parameter: $type: select output format
Parameter: $format_string: specify additional fields to be retrieved
Parameter: $sort_string: specify sorting key
Parameter: $encoding: the character encoding for the output data
Parameter: $limit_string: specifies limit and offset
Parameter: $query_string: the query that describes the datasets to be retrieved
Title : refdb_countnote
Usage : $client->refdb_countnote($listname, $limit_string, $query_string);
Function: counts extended notes
Parameter: $listname: optional name of a personal reference list
Parameter: $limit_string: specifies limit and offset
Parameter: $query_string: the query that describes the datasets to be retrieved
Title : refdb_selectdb
Usage : $client->refdb_selectdb($dbname);
Function: selects an existing database as the current database
Parameter: $dbname: name of the reference database
Title : refdb_whichdb
Usage : $client->refdb_whichdb();
Function: displays information about the current database
Title : refdb_updatejo
Usage : $client->refdb_updatejo($updaterequest);
Function: updates journal name synonyms
Title : refdb_texbib
Usage : $client->refdb_texbib($style, $cite_data);
Function: retrieves a bibliography in bibtex format based on citationlistx data
Parameter: $style: the name of the citation/bibliography style
Parameter: $cite_data: \s-1XML\s0 data describing the references
Title : refdb_dbib
Usage : $client->refdb_dbib($type, $style, $encoding, $cite_data);
Function: retrieves a cooked \s-1XML/SGML\s0 bibliography based on citationlistx data
Parameter: $type: type of the bibliography output
Parameter: $style: name of the citation/bibliography style
Parameter: $encoding: character encoding of the output data
Parameter: $cite_data: \s-1XML\s0 data specifying the references
Title : refdb_getrefx
Usage : $client->refdb_getrefx($type, $encoding, $cite_data);
Function: retrieves a raw \s-1XML/SGML\s0 bibliography based on citationlistx data
Parameter: $type: type of the bibliography output
Parameter: $encoding: character encoding of the output data
Parameter: $cite_data: \s-1XML\s0 data specifying the references