Difference between revisions of "Storable field"

From EPrints Documentation
Jump to: navigation, search
(Added page for storable field)
 
(Amended structure to standardise for metadata field type.)
Line 1: Line 1:
 
{{fieldtypes}}
 
{{fieldtypes}}
  
[[Metadata]] field, which is a text serialization of structured data that can be interpreted by EPrints.
+
 
 +
== Description ==
 +
This field supports arbitrary Perl data structures by serialising them using <code>Storable</code> perl module, up to the same maximum length of [[Longtext field]]s.
 +
 
 +
When serialised into XML the values are further encoded in Base64 to avoid any problems with invalid XML character data being emitted by Storable.
 +
 
 +
This field does <b>not</b> support storing simple scalars, (e.g. "Hello, World!").
 +
 
 +
== Inheritance ==
 +
* [[Metadata]]
 +
** [[Storable field]]
 +
 
 +
== Additional Properties ==
 +
{| border="1" cellpadding="3" cellspacing="0"
 +
| name || default || description
 +
|-
 +
| '''text_index''' || 0|| '''Different default.'''
 +
|-
 +
| '''sql_index''' || 0 || '''Different default.''
 +
|}
 +
 
 +
== Required Phrases ==
 +
No additional phrases  beyond the [[Metadata#Required_Phrases|standard metadata field phrases]].
 +
 
 +
== Database ==
 +
Storable fields are stored in the database as
 +
  fieldname BLOB
 +
 
 +
== API ==
 +
See [[API:EPrints/MetaField/Storable|API page]].
 +
 
 +
== Examples ==
 +
Most basic example.
 +
{
 +
    name => 'configuration',
 +
    type => 'storable',
 +
}

Revision as of 23:16, 10 April 2023

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 - Recaptcha3 - Relation - Search - Secret - Set - Storable - Subject - Subobject - Text - Time - Timestamp - Url - Uuid


Description

This field supports arbitrary Perl data structures by serialising them using Storable perl module, up to the same maximum length of Longtext fields.

When serialised into XML the values are further encoded in Base64 to avoid any problems with invalid XML character data being emitted by Storable.

This field does not support storing simple scalars, (e.g. "Hello, World!").

Inheritance

Additional Properties

name default description
text_index 0 Different default.
sql_index 0 'Different default.

Required Phrases

No additional phrases beyond the standard metadata field phrases.

Database

Storable fields are stored in the database as

 fieldname BLOB

API

See API page.

Examples

Most basic example.

{
    name => 'configuration',
    type => 'storable',
}