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

Class PublishingDetail

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

Publishing detail composite

The publishing detail block covers data Groups P.19 to P.21, carrying information on the publisher(s), ‘global’ publishing status, and rights attaching to a product. The block as a whole is non-repeating. It is mandatory in any <Product> record unless the <NotificationType> in Group P.1 indicates that the record is an update notice which carries only those blocks in which changes have occurred.

Reference name <PublishingDetail>
Short tag <publishingdetail>
Cardinality 0…1

This tag may be included in the following composites:

Possible placements within ONIX message:

See Also:

  • Field Details

  • Constructor Details

    • PublishingDetail

      public PublishingDetail()

    • PublishingDetail

      public PublishingDetail(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 (<PublishingDetail> or <publishingdetail>) is explicitly provided in the ONIX XML

    • ifExists

      public void ifExists(Consumer<PublishingDetail> 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

    • imprints

      public ListOfOnixComposite<Imprint> imprints()

      An optional group of data elements which together identify an imprint or brand under which the product is marketed. The composite must carry either a name identifier or a name or both, and is repeatable to specify multiple imprints or brands.

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

    • countryOfPublication

      public CountryOfPublication countryOfPublication()

      An ONIX code identifying the country where the product is published (ie where the publisher is based). Optional and non-repeating.

      Jonix-Comment: this field is optional

    • publishingStatus

      public PublishingStatus publishingStatus()

      An ONIX code which identifies the status of a published product. Optional and non-repeating, but required if publishing status is not identified at market level in <MarketPublishingDetail> (P.25).

      Where the element is sent by a sender who is not the publisher, based on information that has been previously supplied by the publisher, it is strongly recommended that it should carry a datestamp attribute to indicate its likely reliability. See Section 1 for further details of the datestamp attribute.

      Jonix-Comment: this field is optional

    • latestReprintNumber

      public LatestReprintNumber latestReprintNumber()

      The number of the most recent reprint (or current ‘impression number’) of the product. Optional and non-repeating. This element is used only in certain countries where there is a legal requirement to record reprints.

      Jonix-Comment: this field is optional

    • rowSalesRightsType

      public ROWSalesRightsType rowSalesRightsType()

      An ONIX code describing the sales rights applicable in territories not specifically associated with a sales right within an occurrence of the <SalesRights> composite. Must be preceded by at least one <SalesRights> composite. Optional, but required in all cases where no sales rights type is associated with the region ‘WORLD’, and in all cases where a sales rights type is associated with ‘WORLD’ but with exclusions that are not themselves associated with a sales rights type. Not repeatable. Note the value ‘00’ should be used to indicate where sales rights are genuinely unknown, or are unstated for any reason – in this case, data recipients must not assume anything about the rights that are applicable.

      Jonix-Comment: this field is optional

    • publishers

      public ListOfOnixComposite<Publisher> publishers()

      An optional group of data elements which together identify an entity which is associated with the publishing of a product. The composite allows additional publishing roles to be introduced without adding new fields. Each occurrence of the composite must carry a publishing role code and either a name identifier or a name or both, and the composite is repeatable in order to identify multiple entities.

      Jonix-Comment: this list may be empty

    • cityOfPublications

      public ListOfOnixElement<CityOfPublication,String> cityOfPublications()

      The name of a city or town associated with the imprint or publisher. Optional, and repeatable if parallel names for a single location appear on the title page in multiple languages, or if the imprint carries two or more cities of publication.

      Where necessary to avoid ambiguity, a state, province or region may be included – for example ‘Springfield, IL’.

      A place of publication is normally given in the form in which it appears on the title page. If the place name appears in more than one language, <CityOfPublication> may be repeated. The language attribute is optional with a single instance of <CityOfPublication>, but must be included in each instance if <CityOfPublication> is repeated.

      Jonix-Comment: this list may be empty

    • productContacts

      public ListOfOnixComposite<ProductContact> productContacts()

      An optional group of data elements which together specify an organization (which may or may not be the publisher) responsible for dealing with enquiries related to the product. Repeatable in order to specify multiple responsible organizations.

      Jonix-Comment: this list may be empty

    • publishingStatusNotes

      public ListOfOnixElement<PublishingStatusNote,String> publishingStatusNotes()

      Free text that describes the status of a published product, when the code in <PublishingStatus> is insufficient. Optional, but when used, must be accompanied by the <PublishingStatus> element. Repeatable if parallel notes are provide in multiple languages. The language attribute is optional for a single instance of <PublishingStatusNote>, but must be included in each instance if <PublishingStatusNote> is repeated.

      Jonix-Comment: this list may be empty

    • publishingDates

      public ListOfOnixDataCompositeWithKey<PublishingDate,JonixPublishingDate,PublishingDateRoles> publishingDates()

      A group of data elements which together specify a date associated with the publishing of the product. Optional, but where known, at least a date of publication must be specified either here (as a ‘global’ pub date) or in <MarketPublishingDetail> (P.25). Other dates related to the publishing of a product can be sent in further repeats of the composite.

      Jonix-Comment: this list may be empty

    • copyrightStatements

      public ListOfOnixComposite<CopyrightStatement> copyrightStatements()

      An optional and repeatable group of data elements which together represent a summary copyright or neighboring right statement for the product. At least one <CopyrightYear> or one instance of the <CopyrightOwner> composite must be sent within an instance of the composite, but it is recommended that all elements in the composite are explicitly populated. The Copyright statement may be repeated to provide a full structured rights statement listing year(s) and rights holder(s).

      Jonix-Comment: this list may be empty

    • copyrightStatementTexts

      public ListOfOnixElement<CopyrightStatementText,String> copyrightStatementTexts()

      Free text showing how the copyright should be described, when a standard concatenation of individual copyright statements would not give a satisfactory presentation. Optional but must only be used if one or more instances of <CopyrightStatement> are present, and repeatable if parallel text is provided in multiple languages. The language attribute is optional for a single instance of <CopyrightStatementText>, but must be included in each instance if <CopyrightStatementText> is repeated. When the <CopyrightStatementText> field is sent, the receiver should use it to replace all detail sent in the <CopyrightStatement> composite for display purposes only. It does not replace the <CopyrightStatement> element. The individual name detail must also be sent in one or more <CopyrightStatement> composites for indexing and retrieval purposes.

      Jonix-Comment: this list may be empty

    • salesRightss

      public ListOfOnixComposite<SalesRights> salesRightss()

      An optional and repeatable group of data elements which together identify territorial sales rights which a publisher chooses to exercise in a product. When specifying a territory in which the product is not for sale, the publisher and product ID for an edition which is available in the specified territory can optionally be included. (In releases prior to 3.0, this functionality was provided in a <NotForSale> composite, which is now redundant and has been deleted.) See examples at the end of the sales rights composite.

      Jonix-Comment: this list may be empty