From c0f527e8b1351dcfd32442f77554f11acc5b448e Mon Sep 17 00:00:00 2001 From: Gertjan Date: Wed, 11 Sep 2024 14:04:28 +0200 Subject: [PATCH 1/2] First draft of ADR-38: allow URI's --- ...0038-allow-uris-for-product-identifiers.md | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 decisions/log/0038-allow-uris-for-product-identifiers.md diff --git a/decisions/log/0038-allow-uris-for-product-identifiers.md b/decisions/log/0038-allow-uris-for-product-identifiers.md new file mode 100644 index 00000000..00589418 --- /dev/null +++ b/decisions/log/0038-allow-uris-for-product-identifiers.md @@ -0,0 +1,47 @@ +# 38. Allow URI's for Product Identifiers + +Date: 2024-09-11 + +## Status + +Proposed + +This is an expansion of the common URN format introduced by ADR-0034. The proposal is ready for review, following consultation with GS1, Digital Twin and being presented in the PACT Tech WG September 11. + +## Context + + + +The current PACT Technical Specifications mandate the use of Uniform Resource Names (URNs) for product identification and classification, and include a recommended `urn:pact` namespace with a common format for specifying product ids. + +For most point-to-point cases this default, recommended way of using id's will suffice. However, there is a need to accommodate emerging standards like Digital Link and Digital Product Passport, which rely on Uniform Resource Identifiers (URIs), a superset of URNs. + +This ADR proposes expanding from URNs to URIs for product identification within the PACT Technical Specifications. + +### Specific problems this proposal addresses + The PACT Technical Specification will be revised to use URIs for product identification, replacing the current requirement for URNs. This change will: + * Expand Compatibility: Allow for the integration of emerging and future product identification standards, such as Digital Link and Digital Product Passport. + * Enhance Interoperability: Improve compatibility with various identifier schemes and systems used by different organizations and industry networks. + * Future-Proofing: Ensure the PACT specification remains adaptable to evolving digitalization trends in supply chain sustainability and circular economy. + +Scope + * The scope of this proposal is for product identifiers `productIDs` *and* product *classification* identifiers as stored in `productClassification` (see ADR-0037). + + +## Proposal + +The proposal consists of three recommendations: + 1. Change the data type of `productIDs` from URN to **URI** (as defined in RFC ) + 1. Change the data type of `productClassification` from *array* or URN to *array* of **URI** + 1. Include additional examples for real-world URI's in the documentation + + ### Examples + + GS1 Digital Link + + https://qr.patagonia.com/01/00889833298392/21/000000001842 + + +## Consequences + + * Inclusion of v3 ensures backwards compatibility with v2.x URNs. From 649c422d5598336ca942c1c39e441c79a9ec03da Mon Sep 17 00:00:00 2001 From: Gertjan Date: Wed, 11 Sep 2024 14:18:56 +0200 Subject: [PATCH 2/2] Included reference to RFC 3986 (URI definition) --- decisions/log/0038-allow-uris-for-product-identifiers.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/decisions/log/0038-allow-uris-for-product-identifiers.md b/decisions/log/0038-allow-uris-for-product-identifiers.md index 00589418..dfc6eaa7 100644 --- a/decisions/log/0038-allow-uris-for-product-identifiers.md +++ b/decisions/log/0038-allow-uris-for-product-identifiers.md @@ -8,13 +8,18 @@ Proposed This is an expansion of the common URN format introduced by ADR-0034. The proposal is ready for review, following consultation with GS1, Digital Twin and being presented in the PACT Tech WG September 11. + ## Context The current PACT Technical Specifications mandate the use of Uniform Resource Names (URNs) for product identification and classification, and include a recommended `urn:pact` namespace with a common format for specifying product ids. -For most point-to-point cases this default, recommended way of using id's will suffice. However, there is a need to accommodate emerging standards like Digital Link and Digital Product Passport, which rely on Uniform Resource Identifiers (URIs), a superset of URNs. +For most point-to-point cases this default, recommended way of using id's will suffice. However, there is a need to accommodate emerging standards like Digital Link and Digital Product Passport, which rely on Uniform Resource Identifiers (URIs), a superset of URNs. + + +https://gs1.eu/activities/digital-product-passport/gs1-data-architecture-for-the-dpp/ +https://ref.gs1.org/standards/digital-link/uri-syntax/ This ADR proposes expanding from URNs to URIs for product identification within the PACT Technical Specifications. @@ -31,7 +36,7 @@ Scope ## Proposal The proposal consists of three recommendations: - 1. Change the data type of `productIDs` from URN to **URI** (as defined in RFC ) + 1. Change the data type of `productIDs` from URN to **URI** (as defined in RFC 3986) 1. Change the data type of `productClassification` from *array* or URN to *array* of **URI** 1. Include additional examples for real-world URI's in the documentation