diff --git a/io.catenax.demand_and_capacity_notification/1.0.0/DemandAndCapacityNotification.ttl b/io.catenax.demand_and_capacity_notification/1.0.0/DemandAndCapacityNotification.ttl new file mode 100644 index 00000000..5480102b --- /dev/null +++ b/io.catenax.demand_and_capacity_notification/1.0.0/DemandAndCapacityNotification.ttl @@ -0,0 +1,164 @@ +####################################################################### +# Copyright (c) 2024 ISTOS GmbH (a member of the DMG Mori Group) +# Copyright (c) 2024 Fraunhofer-Gesellschaft zur Foerderung der angewandten Forschung e.V. (represented by Fraunhofer ISST) +# Copyright (c) 2024 TRUMPF Werkzeugmaschinen SE + Co. KG +# Copyright (c) 2024 Volkswagen AG +# Copyright (c) 2024 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-number: . +@prefix ext-uuid: . + +:DemandAndCapacityNotification a samm:Aspect ; + samm:preferredName "Demand and Capacity Notification"@en ; + samm:description "This aspect model defines the standard for demand and capacity notification exchange between business partners. Demand and Capacity Notifications refer to specific events within the supply chain which affect production or demand."@en ; + samm:properties ( [ samm:property :affectedSitesSender; samm:optional true ] [ samm:property :affectedSitesRecipient; samm:optional true ] :leadingRootCause :effect [ samm:property :text; samm:optional true ] [ samm:property :materialGlobalAssetId; samm:optional true ] :startDateOfEffect [ samm:property :expectedEndDateOfEffect; samm:optional true ] :status :contentChangedAt [ samm:property :relatedSourceMessageId; samm:optional true ] [ samm:property :materialNumberSupplier; samm:optional true ] [ samm:property :materialNumberCustomer; samm:optional true ] ) ; + samm:operations ( ) ; + samm:events ( ) . + +:affectedSitesSender a samm:Property ; + samm:preferredName "Affected sites of the sender"@en ; + samm:description "The affected Business Partner Site Numbers of the sender of the notification. It is RECOMMENDED to set this property."@en ; + samm:characteristic :AffectedSitesCharacteristic ; + samm:exampleValue "BPNS7588787849VQ" . + +:affectedSitesRecipient a samm:Property ; + samm:preferredName "Affected sites of the recipient"@en ; + samm:description "The affected Business Partner Site Numbers of the recipient of the notification. It is RECOMMENDED to set this property. It MUST NOT contain any BPNS that doesn't belong to the receiver."@en ; + samm:characteristic :AffectedSitesCharacteristic ; + samm:exampleValue "BPNS6666787765VQ" . + +:leadingRootCause a samm:Property ; + samm:preferredName "Leading root cause"@en ; + samm:description "The main cause that has or may have an impact on the supply of goods."@en ; + samm:characteristic :LeadingRootCauseEnumeration ; + samm:exampleValue "strike" . + +:effect a samm:Property ; + samm:preferredName "Effect"@en ; + samm:description "Effect or impact on the supply of goods as a consequence mentioned in the leadingRootCause. From business perspective demand/capacity reduction are most relevant values in connection with mentioned root causes. For technical completeness demand/capacity increase are also added to the enumeration."@en ; + samm:characteristic :EffectEnumeration ; + samm:exampleValue "capacity-reduction" . + +:text a samm:Property ; + samm:preferredName "Text"@en ; + samm:description "Free text description for notification (max. 4000 characters)."@en ; + samm:characteristic :UserInputTrait ; + samm:exampleValue "Capacity reduction due to ongoing strike." . + +:materialGlobalAssetId a samm:Property; + samm:preferredName "UUID of the Part Type Twin"@en; + samm:description "Identifier used uniquely to identify part type twin."@en; + samm:characteristic :MaterialNumberDigitalTwinCharacteristic ; + samm:exampleValue "urn:uuid:48878d48-6f1d-47f5-8ded-a441d0d879df" . + +:startDateOfEffect a samm:Property ; + samm:preferredName "Start date of the effect."@en ; + samm:description "This property defines the start date and time of the effect regardless of the time the notification was sent."@en ; + samm:characteristic samm-c:Timestamp ; + samm:exampleValue "2023-12-13T15:00:00+01:00"^^xsd:dateTime . + +:expectedEndDateOfEffect a samm:Property ; + samm:preferredName "Expected end date of effect."@en ; + samm:description "Expected end date of the impact MAY be defined by the sender of the notification."@en ; + samm:characteristic samm-c:Timestamp ; + samm:exampleValue "2023-12-17T08:00:00+01:00"^^xsd:dateTime . + +:status a samm:Property ; + samm:preferredName "Status"@en ; + samm:description "Status \"open\" should be used in the context of an effect which remains active. Status \"resolved\" should be used to inform the partner that the effect of the initial notification stopped or has been resolved."@en ; + samm:characteristic :StatusEnumeration ; + samm:exampleValue "open" . + +:contentChangedAt a samm:Property ; + samm:preferredName "Content changed at"@en ; + samm:description "The timestamp of the latest change of this notification. Date and time are set according to a timezone."@en ; + samm:characteristic samm-c:Timestamp ; + samm:exampleValue "2023-12-13T15:00:00+01:00"^^xsd:dateTime . + +:relatedSourceMessageId a samm:Property ; + samm:preferredName "Related Source Message ID"@en ; + samm:description "Unique ID identifying the source message that started the notification thread."@en ; + samm:characteristic ext-uuid:UuidV4Trait ; + samm:exampleValue "urn:uuid:d8b6b4ca-ca9c-42d9-8a34-f62591a1c68a" . + +:materialNumberSupplier a samm:Property ; + samm:preferredName "Material Number Supplier"@en ; + samm:description "Material identifiers as assigned by the supplier or manufacturer. This property identifies the material in the supplier's database. If the supplier is the data provider, sending this property is RECOMMENDED."@en ; + samm:characteristic :MaterialNumberSet ; + samm:exampleValue "MNR-8101-ID146955.001" ; + samm:see . + +:materialNumberCustomer a samm:Property ; + samm:preferredName "Material Number Customer"@en ; + samm:description "Material identifier as assigned by the customer. This property identifies the material in the customer's database. For standard materials (e.g. screws) for which a customer does not have an own ID, the manufacturer material ID should be set in this field, too. If the customer is the data provider, sending this property is RECOMMENDED."@en ; + samm:characteristic :MaterialNumberSet ; + samm:exampleValue "MNR-7307-AU340474.002" ; + samm:see . + +:AffectedSitesCharacteristic a samm-c:Set ; + samm:preferredName "Affected Sites Characteristic"@en ; + samm:description "A set of Business Partner Number Sites (BPNS) that are affected."@en ; + samm-c:elementCharacteristic ext-number:BpnsTrait . + +:LeadingRootCauseEnumeration a samm-c:Enumeration ; + samm:preferredName "Leading root cause enumeration"@en ; + samm:description "Enumeration of the available leading root causes."@en ; + samm:dataType xsd:string ; + samm-c:values ( "strike" "natural-disaster" "production-incident" "pandemic-or-epidemic" "logistics-disruption" "war" "other" ) . + +:EffectEnumeration a samm-c:Enumeration ; + samm:preferredName "Effect enumeration"@en ; + samm:description "Enumeration of the available effects due to the mentioned leadingRootCause."@en ; + samm:dataType xsd:string ; + samm-c:values ( "demand-reduction" "demand-increase" "capacity-reduction" "capacity-increase" ) . + +:UserInputTrait a samm-c:Trait ; + samm:preferredName "User Input Trait"@en ; + samm:description "Trait to ensure correct values for the user input."@en ; + samm-c:baseCharacteristic :UserInputCharacteristic ; + samm-c:constraint :TextLengthConstraint . + +:MaterialNumberDigitalTwinCharacteristic a samm-c:Set ; + samm:preferredName "Material Number Digital Twin Characteristic"@en ; + samm:description "A set of Digital Twin material numbers."@en ; + samm-c:elementCharacteristic ext-uuid:UuidV4Trait . + +:StatusEnumeration a samm-c:Enumeration ; + samm:preferredName "Status enumeration."@en ; + samm:description "Status can be either \"open\" or \"resolved\"."@en ; + samm:dataType xsd:string ; + samm-c:values ( "resolved" "open" ) . + +:MaterialNumberSet a samm-c:Set ; + samm:preferredName "Material Number Set"@en ; + samm:description "The set of material numbers, usually a multi-character string assigned by an ERP system of the customer or the supplier."@en ; + samm:dataType xsd:string . + +:UserInputCharacteristic a samm:Characteristic ; + samm:preferredName "User input characteristic"@en ; + samm:description "User input can be any string that is max. 4000 characters."@en ; + samm:dataType xsd:string . + +:TextLengthConstraint a samm-c:LengthConstraint ; + samm:preferredName "UserInputConstraint"@en ; + samm:description "Constraint for a string to be max. 4000 characters long."@en ; + samm-c:maxValue "4000"^^xsd:nonNegativeInteger . + diff --git a/io.catenax.demand_and_capacity_notification/1.0.0/metadata.json b/io.catenax.demand_and_capacity_notification/1.0.0/metadata.json new file mode 100644 index 00000000..c22749ae --- /dev/null +++ b/io.catenax.demand_and_capacity_notification/1.0.0/metadata.json @@ -0,0 +1 @@ +{ "status" : "release"} diff --git a/io.catenax.demand_and_capacity_notification/RELEASE_NOTES.md b/io.catenax.demand_and_capacity_notification/RELEASE_NOTES.md new file mode 100644 index 00000000..e198080d --- /dev/null +++ b/io.catenax.demand_and_capacity_notification/RELEASE_NOTES.md @@ -0,0 +1,6 @@ +# Changelog +All notable changes to this model will be documented in this file. + +## [1.0.0] - 2024-02-19 +### Added +- initial model