- All Implemented Interfaces:
OnixComposite
,OnixComposite.OnixSuperComposite
,OnixTag
,Serializable
Name as subject composite
An optional group of data elements which together represent the name of a person or organization – real or fictional – that is part of the subject of a product. Repeatable in order to name multiple persons or organizations.
Each instance of the composite must contain either:
- one or more of the forms of representation of a person name, with or without an occurrence of the <NameIdentifier> composite; or
- one or more of the forms of representation of a corporate name, with or without an occurrence of the <NameIdentifier> composite; or
- an occurrence of the <NameIdentifier> composite without any accompanying name element(s).
The name of a person (not of a corporation) may optionally be followed by details of that person’s professional affiliation.
Reference name | <NameAsSubject> |
Short tag | <nameassubject> |
Cardinality | 0…n |
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from interface com.tectonica.jonix.common.OnixComposite
OnixComposite.OnixDataComposite<V extends JonixStruct>, OnixComposite.OnixDataCompositeUncommon, OnixComposite.OnixDataCompositeWithKey<V extends JonixKeyedStruct<K>,
K extends Enum<K> & OnixCodelist>, OnixComposite.OnixSuperComposite -
Field Summary
Modifier and TypeFieldDescription(type: dt.DateOrDateTime)static final NameAsSubject
static final String
static final String
(type: dt.NonEmptyString) -
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
This is an internal API.A repeatable group of data elements which together represent an alternative name of a person or organization that is part of the subject of a product, and specify its type.The name of a corporate body which contributed to the creation of the product, presented in inverted order, with the element used for alphabetical sorting placed first.The name of a corporate body which contributed to the creation of the product, unstructured, and presented in normal order.boolean
exists()
indicates whether this tag exists in the ONIX recordFor advanced use-cases only.void
ifExists
(Consumer<NameAsSubject> action) keyNames()
The fourth part of a structured name of a person who contributed to the creation of the product: key name(s), ie the name elements normally used to open an entry in an alphabetical list, eg ‘Smith’ or ‘Garcia Marquez’ or ‘Madonna’ or ‘Francis de Sales’ (in Saint Francis de Sales).The seventh part of a structured name of a person who contributed to the creation of the product: qualifications and honors following a person’s names, eg ‘CBE FRS’.Jonix-Comment: this list is required to contain at least one itemThe fifth part of a structured name of a person who contributed to the creation of the product: name suffix, or name(s) following a person’s key name(s), eg ‘Ibrahim’ (in Anwar Ibrahim).The second part of a structured name of a person who contributed to the creation of the product: name(s) and/or initial(s) preceding a person’s key name(s), eg James J.nameType()
An ONIX code indicating the type of a primary name.The name of a person who contributed to the creation of the product, unstructured, and presented in normal order.The name of a person who contributed to the creation of the product, presented with the element used for alphabetical sorting placed first (‘inverted order’).The third part of a structured name of a person who contributed to the creation of the product: a prefix which precedes the key name(s) but which is not to be treated as part of the key name, eg ‘van’ in Ludwig van Beethoven.An optional group of data elements which together identify a subject’s professional position and/or affiliation, repeatable to allow multiple positions and affiliations to be specified.A group of data elements which together specify a date associated with the person or organization identified in an occurrence of the <NameAsSubject> composite, eg birth or death.The sixth part of a structured name of a person who contributed to the creation of the product: a suffix following a person’s key name(s), eg ‘Jr’ or ‘III’.The eighth part of a structured name of a person who contributed to the creation of the product: titles following a person’s names, eg ‘Duke of Edinburgh’.The first part of a structured name of a person who contributed to the creation of the product: qualifications and/or titles preceding a person’s names, eg ‘Professor’ or ‘HRH Prince’ or ‘Saint’.
-
Field Details
-
refname
- See Also:
-
shortname
- See Also:
-
datestamp
(type: dt.DateOrDateTime) -
sourcename
(type: dt.NonEmptyString) -
sourcetype
-
EMPTY
-
-
Constructor Details
-
NameAsSubject
public NameAsSubject() -
NameAsSubject
-
-
Method Details
-
_initialize
public void _initialize()Description copied from interface:OnixComposite
This is an internal API. Since Jonix 8.0, composite objects are being populated lazily. This method initiates the population process, and is invoked internally by the accessor APIs of the composites- Specified by:
_initialize
in interfaceOnixComposite
-
exists
public boolean exists()Description copied from interface:OnixTag
indicates whether this tag exists in the ONIX record -
ifExists
-
getXmlElement
Description copied from interface:OnixComposite
For advanced use-cases only.- Specified by:
getXmlElement
in interfaceOnixComposite
- Returns:
- native representation of the XML element underlying to this tag
-
personName
The name of a person who contributed to the creation of the product, unstructured, and presented in normal order. Optional and non-repeating: see Group P.7 introductory text for valid options.
Jonix-Comment: this field is required -
keyNames
The fourth part of a structured name of a person who contributed to the creation of the product: key name(s), ie the name elements normally used to open an entry in an alphabetical list, eg ‘Smith’ or ‘Garcia Marquez’ or ‘Madonna’ or ‘Francis de Sales’ (in Saint Francis de Sales). Non-repeating. Required if name part elements P.7.11 to P.7.18 are used.
Jonix-Comment: this field is required -
nameIdentifiers
public ListOfOnixDataCompositeWithKey<NameIdentifier,JonixNameIdentifier, nameIdentifiers()NameIdentifierTypes> Jonix-Comment: this list is required to contain at least one item -
corporateNames
The name of a corporate body which contributed to the creation of the product, unstructured, and presented in normal order. Optional: see Group P.7 introductory text for valid options. Repeatable, to provide parallel names for a single organization in multiple languages (eg ‘World Health Organization’ and « Organisation mondiale de la santé »).The language attribute is optional for a single instance of <CorporateName>, but must be included in each instance if <CorporateName> is repeated.
Jonix-Comment: this list is required to contain at least one item -
nameType
An ONIX code indicating the type of a primary name. Optional, and non-repeating. If omitted, the default is ‘unspecified’ (ie the name as it is presented on the book).
Jonix-Comment: this field is optional -
personNameInverted
The name of a person who contributed to the creation of the product, presented with the element used for alphabetical sorting placed first (‘inverted order’). Optional and non-repeating: see Group P.7 introductory text for valid options.
Jonix-Comment: this field is optional -
titlesBeforeNames
The first part of a structured name of a person who contributed to the creation of the product: qualifications and/or titles preceding a person’s names, eg ‘Professor’ or ‘HRH Prince’ or ‘Saint’. Optional and non-repeating: see Group P.7 introductory text for valid options.
Jonix-Comment: this field is optional -
namesBeforeKey
The second part of a structured name of a person who contributed to the creation of the product: name(s) and/or initial(s) preceding a person’s key name(s), eg James J. Optional and non-repeating.
Jonix-Comment: this field is optional -
prefixToKey
The third part of a structured name of a person who contributed to the creation of the product: a prefix which precedes the key name(s) but which is not to be treated as part of the key name, eg ‘van’ in Ludwig van Beethoven. This element may also be used for titles that appear after given names and before key names, eg ‘Lord’ in Alfred, Lord Tennyson. Optional and non-repeating.
Jonix-Comment: this field is optional -
namesAfterKey
The fifth part of a structured name of a person who contributed to the creation of the product: name suffix, or name(s) following a person’s key name(s), eg ‘Ibrahim’ (in Anwar Ibrahim). Optional and non-repeating.
Jonix-Comment: this field is optional -
suffixToKey
The sixth part of a structured name of a person who contributed to the creation of the product: a suffix following a person’s key name(s), eg ‘Jr’ or ‘III’. Optional and non-repeating.
Jonix-Comment: this field is optional -
lettersAfterNames
The seventh part of a structured name of a person who contributed to the creation of the product: qualifications and honors following a person’s names, eg ‘CBE FRS’. Optional and non-repeating.
Jonix-Comment: this field is optional -
titlesAfterNames
The eighth part of a structured name of a person who contributed to the creation of the product: titles following a person’s names, eg ‘Duke of Edinburgh’. Optional and non-repeating.
Jonix-Comment: this field is optional -
corporateNameInverteds
The name of a corporate body which contributed to the creation of the product, presented in inverted order, with the element used for alphabetical sorting placed first. Optional: see Group P.7 introductory text for valid options. Repeatable, to provide parallel names for a single organization in multiple languages (eg ‘Polar Research Foundation, The’ and ‚Polarforschungsinstitut, Das‘).The language attribute is optional for a single instance of <CorporateNameInverted>, but must be included in each instance if <CorporateNameInverted> is repeated.
Jonix-Comment: this list may be empty -
alternativeNames
A repeatable group of data elements which together represent an alternative name of a person or organization that is part of the subject of a product, and specify its type. The <AlternativeName> composite is optional.
Jonix-Comment: this list may be empty -
subjectDates
public ListOfOnixDataCompositeWithKey<SubjectDate,JonixSubjectDate, subjectDates()PersonOrganizationDateRoles> A group of data elements which together specify a date associated with the person or organization identified in an occurrence of the <NameAsSubject> composite, eg birth or death. Optional, and repeatable to provide multiple dates with their various roles.
Jonix-Comment: this list may be empty -
professionalAffiliations
An optional group of data elements which together identify a subject’s professional position and/or affiliation, repeatable to allow multiple positions and affiliations to be specified.
Jonix-Comment: this list may be empty
-