Module jonix.onix3
Package com.tectonica.jonix.onix3

Class ContributorReference

java.lang.Object
com.tectonica.jonix.onix3.ContributorReference
All Implemented Interfaces:
OnixComposite, OnixComposite.OnixSuperComposite, OnixTag, Serializable
public class ContributorReference extends Object implements OnixComposite.OnixSuperComposite, Serializable

Contributor by reference composite

Optional composite that identifies a contributor – a person or corporate body – participating in the promotional event who is also a contributor to the product, or who is its subject (ie who is fully described in an instance of the <Contributor> composite within Groups P.5, P.7 or P.18, or in an instance of <NameAsSubject> within Groups P.12 or P.18, in the same Product record). Repeatable to refer to multiple contributors.

Note that an instance of <PromotionalEvent> may also contain one or more <Contributor> composites – the latter listing participants to the event who are not contributors to the product.

Reference name <ContributorReference>
Short tag <contributorreference>
Cardinality 0…n

This tag may be included in the following composites:

Possible placements within ONIX message:

Since:
Onix-3.07
See Also:

  • Field Details

  • Constructor Details

    • ContributorReference

      public ContributorReference()

    • ContributorReference

      public ContributorReference(Element element)

  • 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 interface OnixComposite

    • exists

      public boolean exists()
      Description copied from interface: OnixTag
      indicates whether this tag exists in the ONIX record
      Specified by:
      exists in interface OnixTag
      Returns:
      whether this tag (<ContributorReference> or <contributorreference>) is explicitly provided in the ONIX XML

    • ifExists

      public void ifExists(Consumer<ContributorReference> action)

    • getXmlElement

      public Element getXmlElement()
      Description copied from interface: OnixComposite
      For advanced use-cases only.
      Specified by:
      getXmlElement in interface OnixComposite
      Returns:
      native representation of the XML element underlying to this tag

    • contributorRoles

      public ListOfOnixCodelist<ContributorRole,ContributorRoles> contributorRoles()

      An ONIX code indicating the role played by a person or corporate body participating in a promotional event, which need not be the same role as specified for the contributor referenced in Groups P.5, P.7 or P.18. Mandatory in each instance of the <ContributorReference> composite, and may be repeated if the same person or corporate body has more than one role in relation to the event.

      Jonix-Comment: this list is required to contain at least one item

    • nameIdentifiers

      public ListOfOnixDataCompositeWithKey<NameIdentifier,JonixNameIdentifier,NameIdentifierTypes> nameIdentifiers()

      A group of data elements which together specify a name identifier, used here to carry an identifier for a personal or organizational name which must match a name identifier in an instance of the <Contributor> composite within Groups P.5, P.7 or P.18, or in an instance of <NameAsSubject> within Groups P.12 or P.18, in the same Product record. The <NameIdentifier> composite is mandatory within each instance of the <ContributorReference> composite, and is repeatable to specify name identifiers of different types for the same person or organization name.

      Jonix-Comment: this list is required to contain at least one item

    • sequenceNumber

      public SequenceNumber sequenceNumber()

      A number which specifies a single overall sequence of event participant names. Optional and non-repeating. It is strongly recommended that each occurrence of the <ContributorReference> and <Contributor> composites within <PromotionalEvent> should carry a <SequenceNumber>. The sequence is independent of the sequence of contributors to the product specified in Groups P.5, P.7 or P.18.

      Jonix-Comment: this field is optional