Difference between revisions of "Storable field"

From EPrints Documentation
Jump to: navigation, search
(Added page for storable field)
 
(Additional Properties)
 
(One intermediate revision by the same user not shown)
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 Value !! Required !! Description !! Notes
 +
|-
 +
| '''sql_index''' || <tt>0</tt> || NO || Whether field should be index for quicker lookup by the database. || Different from [[Metadata]] default (<tt>1</tt>).
 +
|}
 +
 
 +
== 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',
 +
}

Latest revision as of 10:15, 16 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 - 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 Value Required Description Notes
sql_index 0 NO Whether field should be index for quicker lookup by the database. Different from Metadata default (1).

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',
}