Editing Namedset field

{{fieldtypes}}


== Description ==
This field allows a choice from a set of options like a [[Set field]].  However, here the options can be defined within a namedset file rather than under the <tt>options></tt> attribute of the field configuration.  This makes it easier to update the available options, potentially programmatically.  

This field offers a halfway house between a [[Set field]] and a [[Subject field]].  Being more easily re-configurable that the former whilst less complex than the latter.

== Inheritance ==
* [[Metadata]]
** [[Id field]]
*** [[Text field]]
**** [[Set field]]
***** [[Namedset field]]

== Additional Properties ==
As for [[Set field#Additional_Properties|Set fields]] except for:

{| border="1" cellpadding="3" cellspacing="0"
! Name !! Default Value !! Required !! Description !! Notes
|-
| '''set_name''' || n/a || YES || Specifies the filename of the namedset file. ||
|-
| '''options''' || <tt>undef</tt> || NO || Options from which to choose. || NOT inherited from [[Set field]].  Options provided by namedset file defined in <tt>set_name</tt>.
|}

== Required Phrases ==
No additional phrases beyond those required for [[Set field#Required_Phrases|Set fields]].  However, you may need to add phrases for some or all the values on the namedset file, depending on whether this is a bespoke namedset file.  These will take the form:
 namedset_filename + "_typename_" + value
For example for <tt>[[lib/namedsets/]]</tt>'s <tt>security</tt> file, the phrase for <tt>staffonly</tt> has the ID:
 security_typename_staffonly

== Database ==
Namedset fields are stored in the database as
 fieldname VARCHAR(255)

== API ==
See [[API:EPrints/MetaField/Namedset|API page]].

== Examples ==
Most basic example.
 { 
     name => 'archive', 
     type => 'namedset',
     set_name => 'archives',
 }
Make field required and only show one input row.
 {
     name => 'security', 
     type => 'namedset', 
     required => 1, 
     input_rows => 1,
     set_name=> 'security',
 }
Allow multiple values with long input style (i.e. a list of labelled checkboxes).  Link rendered values to a browse view listing.
 {
     name => 'category', 
     type => 'namedset',
     set_name => 'artwork', 
     multiple => 1, 
     required => 1, 
     input_style => 'long', 
     browse_link => 'category'
 }