From d5c1913e2c79d6d63221a7ea6f66a7f6f90905a6 Mon Sep 17 00:00:00 2001 From: johannsvarela Date: Mon, 11 Dec 2023 17:49:55 +0100 Subject: [PATCH] [Model Update]: Batch 2.0.1 (#502) * Create metadata.json * Create Batch.ttl * Update RELEASE_NOTES.md * Update Batch.ttl * Update RELEASE_NOTES.md --- io.catenax.batch/2.0.1/Batch.ttl | 190 +++++++++++++++++++++++++++ io.catenax.batch/2.0.1/metadata.json | 1 + io.catenax.batch/RELEASE_NOTES.md | 12 +- 3 files changed, 202 insertions(+), 1 deletion(-) create mode 100644 io.catenax.batch/2.0.1/Batch.ttl create mode 100644 io.catenax.batch/2.0.1/metadata.json diff --git a/io.catenax.batch/2.0.1/Batch.ttl b/io.catenax.batch/2.0.1/Batch.ttl new file mode 100644 index 000000000..95a57026b --- /dev/null +++ b/io.catenax.batch/2.0.1/Batch.ttl @@ -0,0 +1,190 @@ +####################################################################### +# Copyright(c) 2023 BASF SE +# Copyright(c) 2023 Bayerische Motoren Werke Aktiengesellschaft(BMW AG) +# Copyright(c) 2023 Fraunhofer-Gesellschaft zur Foerderung der angewandten Forschung e.V.(represented by Fraunhofer ISST & Fraunhofer IML) +# Copyright(c) 2023 German Edge Cloud GmbH & Co. KG +# Copyright(c) 2023 Henkel AG & Co. KGaA +# Copyright(c) 2023 Mercedes Benz AG +# Copyright(c) 2023 Robert Bosch Manufacturing Solutions GmbH +# Copyright(c) 2023 SAP SE +# Copyright(c) 2023 Siemens AG +# Copyright(c) 2023 T-Systems International GmbH +# Copyright(c) 2023 ZF Friedrichshafen AG +# Copyright(c) 2023 Contributors to the Eclipse Foundation +# +# See the NOTICE file(s) distributed with this work for additional +# information regarding copyright ownership. +# +# This work is made available under the terms of the +# Creative Commons Attribution 4.0 International(CC-BY-4.0) license, +# which is available at +# https://creativecommons.org/licenses/by/4.0/legalcode. +# +# SPDX-License-Identifier: CC-BY-4.0 +####################################################################### + +@prefix samm: . +@prefix samm-c: . +@prefix samm-e: . +@prefix unit: . +@prefix rdf: . +@prefix rdfs: . +@prefix xsd: . +@prefix : . +@prefix ext-built: . +@prefix ext-uuid: . + +:Batch a samm:Aspect; + samm:preferredName "Batch"@en; + samm:description "A batch is a quantity of(semi-) finished products or(raw) material product that have been produced under the same circumstances(e.g. same production location), as specified groups or amounts, within a certain time frame. Every batch can differ in the number or amount of products. Different batches can have varied specifications, e.g., different colors. A batch is identified via a Batch ID."@en; + samm:properties (:catenaXId :localIdentifiers :manufacturingInformation :partTypeInformation [ samm:property ext-built:sites; samm:optional true ]); + samm:operations (); + samm:events (). + +:catenaXId a samm:Property; + samm:preferredName "Catena-X Identifier"@en; + samm:description "The fully anonymous Catena-X ID of the batch, valid for the Catena-X dataspace."@en; + samm:characteristic ext-uuid:UuidV4Trait; + samm:exampleValue "580d3adf-1981-44a0-a214-13d6ceed9379". + +:localIdentifiers a samm:Property; + samm:preferredName "Local Identifiers"@en; + samm:description "A local identifier enables identification of a part in a specific dataspace, but is not unique in Catena-X dataspace. Multiple local identifiers may exist."@en; + samm:characteristic :LocalIdentifierCharacteristic. + +:manufacturingInformation a samm:Property; + samm:preferredName "Manufacturing Information"@en; + samm:description "Information from manufacturing process, such as manufacturing date and manufacturing country"@en; + samm:characteristic :ManufacturingCharacteristic. + +:partTypeInformation a samm:Property; + samm:preferredName "Part Type Information"@en; + samm:description "The part type of which the batch has been instantiated of."@en; + samm:characteristic :PartTypeInformationCharacteristic. + +:LocalIdentifierCharacteristic a samm-c:Set; + samm:preferredName "Local Identifier Characteristic"@en; + samm:description "A batch may have multiple attributes, which uniquely identify that batch in a specific dataspace(e.g. the manufacturer`s dataspace)"@en; + samm:dataType :KeyValueList. + +:ManufacturingCharacteristic a samm:Characteristic; + samm:preferredName "Manufacturing Characteristic"@en; + samm:description "Characteristic to describe manufacturing related data"@en; + samm:dataType :ManufacturingEntity. + +:PartTypeInformationCharacteristic a samm:Characteristic; + samm:preferredName "Part Type Information Characteristic"@en; + samm:description "The characteristics of the part type"@en; + samm:dataType :PartTypeInformationEntity. + +:KeyValueList a samm:Entity; + samm:preferredName "Key Value List"@en; + samm:description "A list of key value pairs for local identifiers, which are composed of a key and a corresponding value."@en; + samm:properties (:key :value). + +:ManufacturingEntity a samm:Entity; + samm:preferredName "Manufacturing Entity"@en; + samm:description "Encapsulates the manufacturing relevant attributes"@en; + samm:properties (:date [ samm:property :country; samm:optional true ]). + +:PartTypeInformationEntity a samm:Entity; + samm:preferredName "Part Type Information Entity"@en; + samm:description "Encapsulation for data related to the part type"@en; + samm:properties (:manufacturerPartId :nameAtManufacturer :classification). + +:key a samm:Property; + samm:preferredName "Identifier Key"@en; + samm:description "The key of a local identifier."@en; + samm:characteristic :KeyTrait; + samm:exampleValue "batchId". + +:value a samm:Property; + samm:preferredName "Identifier Value"@en; + samm:description "The value of an identifier."@en; + samm:characteristic :ValueCharacteristic; + samm:exampleValue "BID12345678". + +:date a samm:Property; + samm:preferredName "Production Date"@en; + samm:description "Timestamp of the manufacturing date as the final step in production process(e.g. final quality check, ready-for-shipment event)"@en; + samm:characteristic samm-c:Timestamp; + samm:exampleValue "2022-02-04T14:48:54"^^xsd:dateTime. + +:country a samm:Property; + samm:preferredName "Country code"@en; + samm:description "Country code where the part was manufactured"@en; + samm:characteristic :ProductionCountryCodeTrait; + samm:exampleValue "HUR". + +:manufacturerPartId a samm:Property; + samm:preferredName "Manufacturer Part ID"@en; + samm:description "Part ID as assigned by the manufacturer of the part. The Part ID identifies the part(as designed) in the manufacturer`s dataspace. The Part ID does not reference a specific instance of a part and thus should not be confused with the serial number or batch number."@en; + samm:characteristic :PartIdCharacteristic; + samm:exampleValue "123-0.740-3434-A". + +:nameAtManufacturer a samm:Property; + samm:preferredName "Name at Manufacturer"@en; + samm:description "Name of the part as assigned by the manufacturer"@en; + samm:characteristic :PartNameCharacteristic; + samm:exampleValue "Mirror left". + +:classification a samm:Property; + samm:preferredName "Classification"@en; + samm:description "The classification of the part type according to STEP standard definition"@en; + samm:characteristic :ClassificationCharacteristic; + samm:exampleValue "raw material". + +:KeyTrait a samm-c:Trait; + samm:preferredName "Key Trait"@en; + samm:description "Trait that ensures the usage of predefined keys."@en; + samm-c:baseCharacteristic :KeyCharacteristic; + samm-c:constraint :KeyRegularExpression. + +:ValueCharacteristic a samm:Characteristic; + samm:preferredName "Value Characteristic"@en; + samm:description "The value of an identifier."@en; + samm:dataType xsd:string. + +:ProductionCountryCodeTrait a samm-c:Trait; + samm:preferredName "Production Country Code Trait"@en; + samm:description "Trait to ensure standard data format for country code"@en; + samm-c:baseCharacteristic :CountryCodeCharacteristic; + samm-c:constraint :CountryCodeRegularExpression. + +:PartIdCharacteristic a samm:Characteristic; + samm:preferredName "Part ID Characteristic"@en; + samm:description "The part ID is a multi-character string, usually assigned by an ERP system"@en; + samm:dataType xsd:string. + +:PartNameCharacteristic a samm:Characteristic; + samm:preferredName "Part Name Characteristic"@en; + samm:description "Part Name in string format from the respective system in the value chain"@en; + samm:dataType xsd:string. + +:ClassificationCharacteristic a samm-c:Enumeration; + samm:preferredName "Classification Characteristic"@en; + samm:description "A part type must be placed into one of the following classes: 'component', 'product', 'software', 'assembly', 'tool', or 'raw material'."@en; + samm:see ; + samm:dataType xsd:string; + samm-c:values ("product" "raw material" "software" "assembly" "tool" "component"). + +:KeyCharacteristic a samm:Characteristic; + samm:preferredName "Key Characteristic"@en; + samm:description "The key characteristic of a local identifier. A specific subset of keys is predefined. Custom keys are not allowed. Predefined keys:\n- \"manufacturerId\" - The Business Partner Number(BPN) of the manufacturer. Value: BPN-Nummer\n- \"batchId\" - The identifier of the batch, to which the serialzed part belongs"@en; + samm:dataType xsd:string. + +:KeyRegularExpression a samm-c:RegularExpressionConstraint; + samm:preferredName "Key Regular Expression"@en; + samm:description "Constraint that ensures that the predefined keys are used."@en; + samm:value "^(manufacturerId|batchId)$". + +:CountryCodeCharacteristic a samm:Characteristic; + samm:preferredName "Country Code Characteristic"@en; + samm:description "ISO 3166-1 alpha-3 ? three-letter country codes"@en; + samm:see ; + samm:dataType xsd:string. + +:CountryCodeRegularExpression a samm-c:RegularExpressionConstraint; + samm:preferredName "Country Code Regular Expression"@en; + samm:description "Regular Expression that ensures a three-letter code"@en; + samm:value "^[A-Z]{3}$". diff --git a/io.catenax.batch/2.0.1/metadata.json b/io.catenax.batch/2.0.1/metadata.json new file mode 100644 index 000000000..af60ff1f2 --- /dev/null +++ b/io.catenax.batch/2.0.1/metadata.json @@ -0,0 +1 @@ +{"status": "release"} diff --git a/io.catenax.batch/RELEASE_NOTES.md b/io.catenax.batch/RELEASE_NOTES.md index 2328440fb..013b77bde 100644 --- a/io.catenax.batch/RELEASE_NOTES.md +++ b/io.catenax.batch/RELEASE_NOTES.md @@ -1,7 +1,17 @@ # Changelog All notable changes to this model will be documented in this file. -## [Unreleased] +## [2.0.1] 2023-12-04 +### Added +- integration of the sites property and its childtree of the shared PartSiteInformationAsBuilt (1.0.0) aspect model as optional content +- integration of the shared UUID characteristic and RegEx for the catenaXId property + +### Changed +- n/a + +### Removed +- removed existing characteristic and RegEx of the catenaXId property and replaced it with content of the shared UUID aspect model (see added information) + ## [2.0.0] - 2023-09-04 ### Added - added KeyRegularExpression