Changelog/20080801

Changelog: Differences between the Technical Report and the deployed version

Summary: Changes between the Technical Report and the Official Release Version 1, http://purl.org/goodrelations/v1#

  • Base URI: We moved the whole ontology to purl.org. The new authoritative base URI is <http://purl.org/goodrelations/v1#>.
  • Project Home Page: We moved the project home to purl.org. The new authoritative project URI is <http://purl.org/goodrelations/>.
  • Price Ranges for Unit Price, Shipping Charge, Payment Charge: We added support for price ranges by creating two new properties that can be attached to any PriceSpecification, i.e., any instance of UnitPriceSpecification, DeliveryChargeSpecification, and PaymentChargeSpecification: hasCurrencyValueMin and hasCurrencyValueMax. The initial property hasCurrencyValue is a subproperty of both, applying the same pattern for ranges as explained in section 3.3.4 of the Technical Report.Old data using hasCurrencyValue requires no changes, and hasCurrencyValue keeps on being supported as a shortcut. The only modification is that querying for the price requires now to search for hasCurrencyValueMax or hasCurrencyValueMin explicitly (since hasCurrencyValue y implies hasCurrencyValueMax y and hasCurrencyValueMin y, but naturally, nothing is inferred about hasCurrencyValue if a range is declared).
  • List Prices: We added support for list prices by providing the datatype property isListPrice, with the domain of UnitPriceSpecification and the range of boolean. By that, you can indicate that a given UnitPriceSpecification is a list price.
  • Properties for EAN/UPC, ISBN, ISSN, and other identifiers: We added support for the EAN/UPC/UCC by adding the datatype property hasEAN_UCC-13. Note that UPC, EAN-13, and ISBN number have now all been consolidated into EAN-UCC-13. This code is now officially called GTIN-13 (Global Trade Identifier Number) or EAN·UCC-13. Former 12-digit UPC codes can be converted into EAN·UCC-13 code by simply adding a preceeding zero. Note: When using this property for searching by 12-digit UPC codes, you must add a preceeding zero digit. There is no need for a separate ISBN attribute, because the ten digit ISBN is deprecated now (as of 2007). Instead, old ISBNs are to be imported into the EAN-UCC-13 scheme by prefixing 978 or 979. As far as we know, the whole book sales business has already updated all systems and data.
  • GTIN14: We also added support for the more comprehensive GTIN-14 code by providing the datatype property hasGTIN-14. This can hold the Global Trade Item Number (GTIN-14) of the given ProductOrService. Both are subproperties of gr:datatypeProductOrServiceProperty.
  • Properties identifying businesses: We added support for two other common identifiers, which are often used for business entities or locations, GLN/ILN and DUNS: hasGlobalLocationNumber for BusinessEntity and LocationOfSalesOrServiceProvisioning hasDUNS for BusinessEntity only
  • We added time-zone support for validFrom and validThrough by explaining the use of the "Z" suffix for datetime.

For a time in GMT/UTC, simply add a "Z" following the time:

2008-05-30T09:30:10Z

Alternatively, you can specify an offset from the UTC time by adding a positive or negative time following the time:

2008-05-30T09:30:10-09:00

or

2008-05-30T09:30:10+09:00

  • We added time-zone support for "opens" and "closes"and updated the definition:

If no time-zone suffix is included, the time is given in the local time valid at the Location.

For a time in GMT/UTC, simply add a "Z" following the time

Alternatively, you can specify an offset from the UTC time by adding a positive or negative time following the time:

09:30:10-09:00

or

09:30:10+09:00

  • The missing property "hasOpeningHourSpecification" was added to the ontology and documentation.
  • A property gr:hasManufacturer hat been added. This should be used to link a ProductOrServiceModel to the BusinessEntity that produces it.


Category:Changelog