Id field

From EPrints Documentation
Jump to: navigation, search

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


Metadata Fields: Arclanguage - Base64 - Bigint - Boolean - Compound - Counter - Dataobjref - Date - Decimal - Email - Fields - Float - Id - Idci - Image - Int - Itemref - Keywords - Langid - Longtext - Longtext_counter - Multilang - Multipart - Name - Namedset - Pagerange - Recaptcha - Relation - Search - Secret - Set - Storable - Subject - Subobject - Text - Time - Timestamp - Url - Uuid


Description

This metadata field is very similar to a Text field, the main difference is for search where the whole value is indexed rather than in individual parts. In particular this is useful for things like ISBN or ISSN numbers which contain hyphens (-). For a text field the parts either side of the hyphen would be indexed separately but for a Id field this will be indexed as a single value. Therefore, allowing search to find only those items that match exactly.

Inheritance

Additional Properties

Name Default Value Required? Description Notes
match EX NO Searches should match string values exactly. Default from parent default (EQ). This should not be modified in field configuration, as the purpose of Id fields is to match exactly.

Required Phrases

No additional phrases beyond standard metadata field phrases.

Database

Id fields are stored in the database as

fieldname VARCHAR(255)

API

See API page.

Examples

Most basic example.

{
    name => 'isbn',
    type => 'id',
},

Use a bespoke value renderer to add links to DOIs where appropriate.

{
    name => 'id_number',
    type => 'id',
    render_value => 'EPrints::Extras::render_possible_doi',
},