Difference between revisions of "API:EPrints/DataObj/SavedSearch"
Latest revision as of 17:29, 10 January 2022
- 1 NAME
- 2 DESCRIPTION
- 3 CORE METADATA FIELDS
- 4 REFERENCES AND RELATED OBJECTS
- 5 INSTANCE VARIABLES
- 6 METHODS
- 6.1 Constructor Methods
- 6.2 Class Methods
- 6.3 Object Methods
- 6.4 Utility Methods
- 7 SEE ALSO
- 8 COPYRIGHT
EPrints::DataObj::SavedSearch - Single saved search.
A saved search is a sub class of EPrints::DataObj::SubObject.
Each one belongs to one and only one user, although one user may own multiple saved searches.
CORE METADATA FIELDS
The ID of the saved search,
A name assigned to the saved search.
A serialization of the search specification.
How often to send saves search email updates.
Whether to send saved search email updates if there are no results.
Additional email addresses to send updates about saved search results.
If the saved search results should be publicly accessible.
REFERENCES AND RELATED OBJECTS
The ID of the user to whom created this saved search.
Also see [[API:<EPrints/DataObj#INSTANCE_VARIABLES|EPrints::DataObj]].
The user who owns this saved search.
$saved_search = EPrints::DataObj::SavedSearch->create( $session, $userid )
Creates a new saved search, belonging to user with ID $userid.
$field_config = EPrints::DataObj::SavedSearch->get_system_field_info
Returns an array describing the system metadata of the saved search dataset.
$dataset = EPrints::DataObj::SavedSearch->get_dataset_id
Returns the ID of the EPrints::DataSet object to which this record belongs.
$dataset = $saved_search->get_dataset
Get the dataset that this saved search covers.
$success = $saved_search->commit( [ $force ] )
Writes this object to the database.
If $force is not true then it only actually modifies the database if one or more fields have been changed.
Returns true if commit was successfully. Otherwise, returns false.
$user = $saved_search->get_user
Returns the EPrints::DataObj::User which owns this saved search.
$searchexp = $saved_search->make_searchexp
Returns an EPrints::Search describing how to find the data objects which are in the scope of this saved search.
Sends out an email for this subscription. If there are no matching new data objects then an email is only sent if the saved search has mailempty set to true.
$boolean = $saved_search->has_owner( $possible_owner )
Returns true if $possible_owner is the same as the owner of this saved search. Otherwise, returns false.
$parent = $saved_search->parent
Returns the parent data object for this saved search. I.e. the user who owns this saved search. This is similar to get_user but is not as fault tolerant and does set instance variable:
$url = $saved_search->get_url( [ $staff ] )
Gets the URL for this saved search. Currently $staff will not effect the URL but in future this may return a specialised URL for staff only.
EPrints::DataObj::SavedSearch::process_set( $session, $frequency );
Calls send_out_alert on every saved search with a frequency matching $frequency.
Also saves a file logging that the alerts for this frequency was sent out at the current time.
$timestamp = EPrints::DataObj::SavedSearch::get_last_timestamp( $session, $frequency );
Return sthe timestamp of the last time this $frequency of alert was sent.
© Copyright 2022 University of Southampton.
EPrints 3.4 is supplied by EPrints Services.
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/.