API EPrints/DataObj - Revision history

https://wiki.ext-9.eprints-hosting.org/w/index.php?action=history&feed=atom&title=API_EPrints%2FDataObj API EPrints/DataObj - Revision history 2026-05-10T00:43:20Z Revision history for this page on the wiki MediaWiki 1.43.6 https://wiki.ext-9.eprints-hosting.org/w/index.php?title=API_EPrints/DataObj&diff=6628&oldid=prev Tdb01r: Removing all content from page 2009-08-10T16:29:58Z

<p>Removing all content from page</p> <a href="https://wiki.ext-9.eprints-hosting.org/w/index.php?title=API_EPrints/DataObj&diff=6628&oldid=6621">Show changes</a>

Tdb01r https://wiki.ext-9.eprints-hosting.org/w/index.php?title=API_EPrints/DataObj&diff=6621&oldid=prev Tdb01r: New page: <!-- Pod2Wiki=_preamble_ This page has been automatically generated from the EPrints source. Any wiki changes made between the 'Pod2Wiki=*' and 'End of Pod2Wiki' comments will be lost. -... 2009-08-10T16:24:22Z

<p>New page: [[Category:API]]<br /> =NAME=<br /> '''EPrints::DataObj''' - Base class for records in EPrints.<br /> <br /> =DESCRIPTION=<br /> This module is a base class which is inherited by [[API_EPrints/DataObj/EPrint]],[[API_EPrints/User]], [[API_EPrints/DataObj/Subject]] and[[API_EPrints/DataObj/Document]] and several other classes.<br /> It is ABSTRACT - its methods should not be called directly.<br /> <br /> ==get_system_field_info==<br /> <br /> $sys_fields = EPrints::DataObj-&gt;get_system_field_info<br /> <br /> Return an array describing the system metadata of the this dataset.<br /> <br /> ==new==<br /> <br /> $dataobj = EPrints::DataObj-&gt;new( $session, $id [, $dataset] )<br /> <br /> Return new data object, created by loading it from the database.<br /> If $dataset is not defined uses the default dataset for this object.<br /> <br /> ==new_from_data==<br /> <br /> $dataobj = EPrints::DataObj-&gt;new_from_data( $session, $data [, $dataset ] )<br /> <br /> Construct a new EPrints::DataObj object based on the $data hash reference of metadata.<br /> Used to create an object from the data retrieved from the database.<br /> <br /> ==get_defaults==<br /> <br /> $defaults = EPrints::User-&gt;get_defaults( $session, $data, $dataset )<br /> <br /> Return default values for this object based on the starting data.<br /> Should be subclassed.<br /> <br /> ==remove==<br /> <br /> $success = $dataobj-&gt;remove<br /> <br /> Remove this data object from the database and any sub-objects or related files. <br /> Return true if successful.<br /> <br /> ==clear_changed==<br /> <br /> $dataobj-&gt;clear_changed( )<br /> <br /> Clear any changed fields, which will result in them not being committed unlessforce is used.<br /> This method is used by the Database to avoid unnecessary commits.<br /> <br /> ==commit==<br /> <br /> $success = $dataobj-&gt;commit( [$force] )<br /> <br /> Write this object to the database and reset the changed fields.<br /> If $force isn't true then it only actually modifies the databaseif one or more fields have been changed.<br /> Commit may also queue indexer jobs or log changes, depending on the object.<br /> <br /> ==get_value==<br /> <br /> $value = $dataobj-&gt;get_value( $fieldname )<br /> <br /> Get a the value of a metadata field. If the field is not set then it returnsundef unless the field has the property multiple set, in which case it returns [] (a reference to an empty array).<br /> <br /> ==set_value==<br /> <br /> $dataobj-&gt;set_value( $fieldname, $value )<br /> <br /> Set the value of the named metadata field in this record.<br /> <br /> ==get_values==<br /> <br /> @values = $dataobj-&gt;get_values( $fieldnames )<br /> <br /> Returns a list of all the values in this record of all the fields specifiedby $fieldnames. $fieldnames should be in the format used by browse views - slashseperated fieldnames with an optional .id suffix to indicate the id part ratherthan the main part. <br /> For example "author.id/editor.id" would return a list of all author and editorids from this record.<br /> <br /> ==get_session==<br /> <br /> $session = $dataobj-&gt;get_session<br /> <br /> Returns the EPrints::Session object to which this record belongs.<br /> <br /> ==get_data==<br /> <br /> $data = $dataobj-&gt;get_data<br /> <br /> Returns a reference to the hash table of all the metadata for this record keyed by fieldname.<br /> <br /> ==get_dataset_id==<br /> <br /> $dataset = EPrints::DataObj-&gt;get_dataset_id<br /> <br /> Returns the id of the [[API_EPrints/DataSet]] object to which this record belongs.<br /> <br /> ==get_dataset==<br /> <br /> $dataset = $dataobj-&gt;get_dataset<br /> <br /> Returns the [[API_EPrints/DataSet]] object to which this record belongs.<br /> <br /> ==is_set==<br /> <br /> $bool = $dataobj-&gt;is_set( $fieldname )<br /> <br /> Returns true if the named field is set in this record, otherwise false.<br /> Warns if the field does not exist.<br /> <br /> ==exists_and_set==<br /> <br /> $bool = $dataobj-&gt;exists_and_set( $fieldname )<br /> <br /> Returns true if the named field is set in this record, otherwise false.<br /> If the field does not exist, just return false.<br /> This method is useful for plugins which may operate on multiple repositories, and the fact a field does not exist is not an issue.<br /> <br /> ==get_id==<br /> <br /> $id = $dataobj-&gt;get_id<br /> <br /> Returns the value of the primary key of this record.<br /> <br /> ==get_gid==<br /> <br /> $id = $dataobj-&gt;get_gid<br /> <br /> DEPRECATED (see uri())<br /> Returns the globally referential fully-qualified identifier for this object orundef if this object can not be externally referenced.<br /> <br /> ==get_datestamp==<br /> <br /> $datestamp = $dataobj-&gt;get_datestamp<br /> <br /> Returns the datestamp of this object in "YYYY-MM-DD hh:mm:ss" format.<br /> <br /> ==render_value==<br /> <br /> $xhtml = $dataobj-&gt;render_value( $fieldname, [$showall] )<br /> <br /> Returns the rendered version of the value of the given field, as appropriatefor the current session. If $showall is true then all values are rendered - this is usually used for staff viewing data.<br /> <br /> ==render_citation==<br /> <br /> $xhtml = $dataobj-&gt;render_citation( [$style], [%params] )<br /> <br /> Renders the record as a citation. If $style is set then it uses that citationstyle from the citations config file. Otherwise $style defaults to the typeof this record. If $params{url} is set then the citiation will link to the specifiedURL.<br /> <br /> ==render_citation_link==<br /> <br /> $xhtml = $dataobj-&gt;render_citation_link( [$style], %params )<br /> <br /> Renders a citation (as above) but as a link to the URL for this item. Forexample - the abstract page of an eprint. <br /> <br /> ==render_description==<br /> <br /> $xhtml = $dataobj-&gt;render_description<br /> <br /> Returns a short description of this object using the default citation stylefor this dataset.<br /> <br /> ==render==<br /> <br /> ($xhtml, $title ) = $dataobj-&gt;render<br /> <br /> Return a chunk of XHTML DOM describing this object in the normal way.This is the public view of the record, not the staff view.<br /> <br /> ==render_full==<br /> <br /> ($xhtml, $title ) = $dataobj-&gt;render_full<br /> <br /> Return an XHTML table in DOM describing this record. All values ofall fields are listed. This is the staff view.<br /> <br /> ==uri==<br /> <br /> $url = $dataobj-&gt;uri<br /> <br /> Returns a unique URI for this object. Not certain to resolve as a URL.<br /> If $c-&gt;{dataobj_uri}-&gt;{eprint} is a function, call that to work it out.<br /> <br /> ==internal_uri==<br /> <br /> $uri = $dataobj-&gt;internal_uri()<br /> <br /> Return an internal URI for this object (independent of repository hostname).<br /> To retrieve an object by internal URI use [[API_EPrints/DataSet]]::get_object_from_uri().<br /> <br /> ==get_url==<br /> <br /> $url = $dataobj-&gt;get_url<br /> <br /> Returns the URL for this record, for example the URL of the abstract pageof an eprint.<br /> <br /> ==get_control_url==<br /> <br /> $url = $dataobj-&gt;get_control_url<br /> <br /> Returns the URL for the control page for this object. <br /> <br /> ==get_type==<br /> <br /> $type = $dataobj-&gt;get_type<br /> <br /> Returns the type of this record - type of user, type of eprint etc.<br /> <br /> ==to_xml==<br /> <br /> $xmlfragment = $dataobj-&gt;to_xml( %opts )<br /> <br /> Convert this object into an XML fragment. <br /> %opts are:<br /> no_xmlns=&gt;1 : do not include a xmlns attribute in the outer element. (This assumes this chunk appears in a larger tree where the xmlns is already set correctly.<br /> showempty=&gt;1 : fields with no value are shown.<br /> version=&gt;"code" : pick what version of the EPrints XML formatto use "1" or "2"<br /> embed=&gt;1 : include the data of a file, not just it's URL.<br /> <br /> ==xml_to_epdata==<br /> <br /> $epdata = EPrints::DataObj-&gt;xml_to_epdata( $session, $xml, %opts )<br /> <br /> Populates $epdata based on $xml. This is the inverse of to_xml() but doesn't create a new object.<br /> <br /> ==export==<br /> <br /> $plugin_output = $detaobj-&gt;export( $plugin_id, %params )<br /> <br /> Apply an output plugin to this items. Return the results.<br /> <br /> ==queue_changes==<br /> <br /> $dataobj-&gt;queue_changes<br /> <br /> Add all the changed fields into the indexers todo queue.<br /> <br /> ==queue_all==<br /> <br /> $dataobj-&gt;queue_all<br /> <br /> Add all the fields into the indexers todo queue.<br /> <br /> ==queue_fulltext==<br /> <br /> $dataobj-&gt;queue_fulltext<br /> <br /> Add a fulltext index into the indexers todo queue.<br /> <br /> ==has_owner==<br /> <br /> $boolean = $dataobj-&gt;has_owner( $user )<br /> <br /> Return true if $user owns this record. Normally this means they created it, but a group of users could count as owners of the samerecord if you wanted.<br /> It's false on most dataobjs, except those which override this method.<br /> <br /> ==in_editorial_scope_of==<br /> <br /> $boolean = $dataobj-&gt;in_editorial_scope_of( $user )<br /> <br /> As for has_owner, but if the user is identified as someone with aneditorial scope which includes this record.<br /> Defaults to true. Which doesn't mean that they have the right to edit it, just that their scope matches. You also need editor rightsto use this. It's currently used just to filter eprint editors sothat only ones with a scope AND a priv can edit.<br /> <br /> ==validate==<br /> <br /> $problems = $dataobj-&gt;validate( [ $for_archive ], $workflow_id )<br /> <br /> Return a reference to an array of XHTML DOM objects describingvalidation problems with the entire $dataobj based on $workflow_id.<br /> If $workflow_id is undefined defaults to "default".<br /> A reference to an empty array indicates no problems.<br /> <br /> ==get_warnings==<br /> <br /> $warnings = $dataobj-&gt;get_warnings( )<br /> <br /> Return a reference to an array of XHTML DOM objects describingproblems with the entire $dataobj.<br /> A reference to an empty array indicates no problems.<br /> <br /> ==add_stored_file==<br /> <br /> $file = $dataobj-&gt;add_stored_file( $filename, $filehandle [, $filesize ] )<br /> <br /> Convenience method to add the file record for $filename to this object. Reads data from $filehandle. If $filesize is defined it may used to determine where the file should be stored.<br /> Returns the file object or undef if the storage failed.<br /> <br /> ==get_stored_file==<br /> <br /> $file = $dataobj-&gt;get_stored_file( $filename )<br /> <br /> Get the file object for $filename.<br /> Returns the file object or undef if the file doesn't exist.<br /> <br /> ==Related Objects==<br /> <br /> ===add_object_relations===<br /> <br /> $dataobj-&gt;add_object_relations( $target, $has =&gt; $is [, $has =&gt; $is ] )<br /> <br /> Add a relation between this object and $target of type $has. If $is is defined will also add the reciprocal relationship $is from $target to this object. May be repeated to add multiple relationships.<br /> You must commit $target after calling this method.<br /> <br /> ===has_object_relations===<br /> <br /> $bool = $dataobj-&gt;has_object_relations( $target, @types )<br /> <br /> Returns true if this object is related to $target by all @types.<br /> If @types is empty will return true if any relationships exist.<br /> <br /> ===has_related_objects===<br /> <br /> $bool = $dataobj-&gt;has_related_objects( @types )<br /> <br /> Returns true if get_related_objects() would return some objects, but without actually retrieving the related objects from the database.<br /> <br /> ===get_related_objects===<br /> <br /> $dataobjs = $dataobj-&gt;get_related_objects( @types )<br /> <br /> Returns a list of objects related to this object by @types.<br /> <br /> ===remove_object_relations===<br /> <br /> $dataobj-&gt;remove_object_relations( $target [, $has =&gt; $is [, $has =&gt; $is ] )<br /> <br /> Remove relations between this object and $target. If $has =&gt; $is pairs are defined will only remove those relationships given.<br /> You must commit $target after calling this method.<br /> <br /> </div>

Tdb01r