Difference between revisions of "Counter field"

From EPrints Documentation
Jump to: navigation, search
(Added standard sections some with content. Unhide ToC)
(Reinstate link to API page even though a redirect)
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{fieldtypes}}
 
{{fieldtypes}}
 +
 +
 +
== Description ==
 +
This field represents an integer whose default value is an incrementing integer (1,2,3 ...).
  
 
== Inheritance ==
 
== Inheritance ==
Line 6: Line 10:
 
*** [[Counter field]]
 
*** [[Counter field]]
  
== Description ==
+
== Additional Properties ==
This field represents an integer whose default value is an incrementing integer (1,2,3 ...).
+
As for [[Int field#Additional Properties|Int fields]] except for:
 
 
== Properties ==
 
 
{| border="1" cellpadding="3" cellspacing="0"
 
{| border="1" cellpadding="3" cellspacing="0"
| name || default || description
+
! Name !! Default Value !! Required !! Description !! Notes
 
|-
 
|-
| '''digits''' || n/a || '''This property is taken from the repository configuration.'''
+
| '''sql_counter''' || n/a || YES  || The counter name for this field that appears as <tt>counters</tt> database table. ||
| '''sql_counter''' || n/a || '''REQUIRED'''. '''This property is taken from the repository configuration.'''
 
 
|}
 
|}
  
 
== Required Phrases ==
 
== Required Phrases ==
No additional phrases required.
+
No additional phrases beyond those required for [[Int field#Required_Phrases|Int fields]].
  
 
== Database ==
 
== Database ==
Line 25: Line 26:
  
 
== API ==
 
== API ==
''To be added''
+
See [[API:EPrints/MetaField/Counter|API page]].
  
 
== Examples ==
 
== Examples ==
Line 34: Line 35:
 
     sql_counter => "mycounter"
 
     sql_counter => "mycounter"
 
  }
 
  }
Typically, you would noty want to allow a value for this field to be imported or cloned as it is an auto-incremented field
+
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",  
 
     name => "subjectcounter",  

Latest revision as of 09:49, 9 July 2024

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 represents an integer whose default value is an incrementing integer (1,2,3 ...).

Inheritance

Additional Properties

As for Int fields except for:

Name Default Value Required Description Notes
sql_counter n/a YES The counter name for this field that appears as counters database table.

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