Difference between revisions of "API:EPrints/DataObj/CitationCache"

From EPrints Documentation
Jump to: navigation, search
(Created page with "<!-- Pod2Wiki=_preamble_ This page has been automatically generated from the EPrints 3.4 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment'...")
 
Line 30: Line 30:
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
 
</div>
 
</div>
<!-- Pod2Wiki=head_metadata -->
+
<!-- Pod2Wiki=head_core_metadata_fields -->
==METADATA==
+
==CORE METADATA FIELDS==
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<span style='display:none'>User Comments</span>

Revision as of 10:30, 27 December 2021

EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects


API: Core API

Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki


NAME

EPrints::DataObj::CitationCache - A cached citation for a data object.

User Comments


DESCRIPTION

This class describes a single item in the citationcache dataset. A citationcache object describes a formatted citation for a single item in another dataset.

To enable citation caching edit the archive's cfg/cfg.d/citationcaches.pl and change the appropriate line to:

$c->{citation_caching}->{enabled} = 1;
 

User Comments


CORE METADATA FIELDS

User Comments


citationcacheid (int)

The unique numerical ID of this citation cache event.

User Comments


datasetid (text)

The name of the dataset to which the item that has a citation cache belongs. "eprint" is used for eprints, rather than the inbox, buffer etc.

User Comments


objectid (int)

The numerical ID of the object in the dataset.

User Comments


style (text)

The style of citation for a particular item. Each DataObj may have nany different citation styles and defined in citations/<DataObject>

User Comments


citation_text (text)

The actually text generated for the citation cache by render_citation.

User Comments


timestamp (time)

The moment at which this citation cache was generated.

User Comments


METHODS

User Comments


get_system_field_info

$field_info = EPrints::DataObj::CitationCache->get_system_field_info

Return the metadata field configuration for this object.

User Comments


get_dataset_id

$dataset = EPrints::DataObj::CitationCache->get_dataset_id

Returns the id of the EPrints::DataSet object to which this record belongs.

User Comments


commit

$citationcache->commit 

Commit the formatted text generated for a citationcache

User Comments


create

EPrints::DataObj::CitationCache::create( $session, $data ); 

Create a new citationcache object from supplied $data. Unlike other create methods this one does not return the new object as it's never needed, and would increase the load on modifying items.

Also, this does not queue the fields for indexing.

User Comments


get_defaults

$defaults = EPrints::DataObj::CitationCache->get_defaults( $session, $data )

Return default values for this object based on the starting $data.

User Comments


render

$xhtml = $citationcache->render

A citationcache cannot have a rendering of itself.

User Comments


get_dataobj

$object = $citationcache->get_dataobj

Returns the object to which this citationcache relates.

User Comments


COPYRIGHT

© Copyright 2022 University of Southampton.

EPrints 3.4 is supplied by EPrints Services.

http://www.eprints.org/eprints-3.4/

LICENSE

This file is part of EPrints 3.4 http://www.eprints.org/.

EPrints 3.4 and this file are released under the terms of the GNU Lesser General Public License version 3 as published by the Free Software Foundation unless otherwise stated.

EPrints 3.4 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with EPrints 3.4. If not, see http://www.gnu.org/licenses/.

User Comments