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

Class ProductContact

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

Product contact composite

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.

Reference name <ProductContact>
Short tag <productcontact>
Cardinality 0…n

Technical notes about <ProductContact> from the schema author: Details of a organization responsible for answering enquiries about the product ● Added <StreetAddress>, <LocationName>, <PostalCode>, <RegionCode> and <CountryCode> at revision 3.1.2 ● Added <FaxNumber>, changed cardinality of <EmailAddress> at release 3.1 ● Added <TelephoneNumber> at revision 3.0.8 ● Added at revision 3.0.1 This tag may be included in the following composites:

Possible placements within ONIX message:
Since:
Onix-3.01
See Also:

  • Field Details

  • Constructor Details

    • ProductContact

      public ProductContact()

    • ProductContact

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

    • ifExists

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

    • productContactRole

      public ProductContactRole productContactRole()

      An ONIX code which identifies the role played by the product contact in relation to the product – for example answering enquiries related to sales or to promotion.

      JONIX adds: this field is required

    • productContactIdentifiers

      public ListOfOnixDataCompositeWithKey<ProductContactIdentifier,JonixProductContactIdentifier,NameIdentifierTypes> productContactIdentifiers()

      A group of data elements which together define an identifier of the product contact. The composite is optional, and repeatable if more than one identifier of different types is sent; but either a <ProductContactName> or a <ProductContactIdentifier> must be included.

      JONIX adds: this list is required to contain at least one item

    • productContactName

      public ProductContactName productContactName()

      The name of the product contact organization, which should always be stated in a standard form. Optional and non-repeating; but either a <ProductContactName> element or a <ProductContactIdentifier> composite must be included.

      JONIX adds: this field is optional

    • contactName

      public ContactName contactName()

      Free text giving the name, department, etc for a contact person in the product contact organization who is responsible for the product. Optional and non-repeating.

      JONIX adds: this field is optional

    • streetAddress

      public StreetAddress streetAddress()

      A text field giving a street address and forming the first part of the postal address of the product contact organization. Optional and non-repeatable. Care should be taken that the Product contact name (plus optionally the Contact name), Street address, Location name, any Postal code or Region code, and the Country code can be combined into a complete postal address, without repetition.

      JONIX adds: this field is optional

    • locationName

      public LocationName locationName()

      The name of a city or town location, forming part of the postal address of the product contact organization. Mandatory and non-repeatable if a Street address is present, but otherwise omitted.

      JONIX adds: this field is optional

    • postalCode

      public PostalCode postalCode()

      The postal code (postcode, zip code etc), forming part of the postal address of the product contact organization. Optional and non-repeatable if a Street address is present, but otherwise omitted.

      JONIX adds: this field is optional

    • regionCode

      public RegionCode regionCode()

      An ONIX code identifying the region within which the product contact organization is located. Optional and non-repeatable if a Street address is present, but otherwise omitted.

      For some addresses, a Region code is useful in addition to the Postal code and Country code. In other addresses, a region is unnecessary because it is clearly encoded within the Postal code.

      JONIX adds: this field is optional

    • countryCode

      public CountryCode countryCode()

      An ONIX code identifying the country within which the product contact organization is located. Mandatory and non-repeatable if a Street address is present, but otherwise omitted.

      JONIX adds: this field is optional

    • telephoneNumbers

      public ListOfOnixElement<TelephoneNumber,String> telephoneNumbers()

      A telephone number of the contact person in the product contact organization who is responsible for the product, wherever possible including the plus sign and the international dialing code. Optional, and repeatable to provide multiple numbers for the same contact.

      JONIX adds: this list may be empty

    • faxNumbers

      public ListOfOnixElement<FaxNumber,String> faxNumbers()

      A fax number for the contact person in the product contact organization who is responsible for the product, wherever possible including the plus sign and the international dialing code. Optional, and repeatable to provide multiple numbers for the same contact.

      JONIX adds: this list may be empty

    • emailAddresss

      public ListOfOnixElement<EmailAddress,String> emailAddresss()

      A text field giving the e‑mail address for a contact person in the product contact organization who is responsible for the product. Optional, and repeatable to provide multiple e‑mail addresses for the same contact.

      JONIX adds: this list may be empty