⧼vector-jumptocontent⧽

Storable field: Difference between revisions

From EPrints Documentation
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


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