Difference between revisions of "Counter field"

From EPrints Documentation
Jump to: navigation, search
(Moved description to top. Added link to API page.)
m
Line 11: Line 11:
  
 
== Properties ==
 
== Properties ==
 +
As for [[Int field]]s except for:
 
{| border="1" cellpadding="3" cellspacing="0"
 
{| border="1" cellpadding="3" cellspacing="0"
 
| name || default || description  
 
| name || default || description  
 
|-
 
|-
| '''digits''' || n/a || '''This property is taken from the repository configuration.'''
+
| '''sql_counter''' || n/a || '''This property REQUIRED and taken from the repository configuration.'''
|-
 
| '''sql_counter''' || n/a || '''REQUIRED'''. '''This property is taken from the repository configuration.'''
 
 
|}
 
|}
  
 
== Required Phrases ==
 
== Required Phrases ==
No additional phrases.
+
No additional phrases beyond those required for [[Int field]]s.
  
 
== Database ==
 
== Database ==

Revision as of 08:58, 9 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 represents an integer whose default value is an incrementing integer (1,2,3 ...).

Inheritance

Properties

As for Int fields except for:

name default description
sql_counter n/a This property REQUIRED and taken from the repository configuration.

Required Phrases

No additional phrases beyond those required for Int fields.

Database

Counter fields are stored in the database as

fieldname INT(11)

API

See API page.

Examples

Most basic example. sql_counter is required but typically would be set to the same as name.

{
    name => "mycounter",
    type => "counter",
    sql_counter => "mycounter"
}

Typically, you would not want to allow a value for this field to be imported or cloned as it is an auto-incremented field.

{  
    name => "subjectcounter", 
    type => "counter", 
    required => 1, 
    import => 0, 
    can_clone => 0, 
    sql_counter => "subjectcounter" 
},