fix: updates during expert round

eclipse-tractusx · Feb 26, 2024 · db68d75 · db68d75
1 parent 57886fb
commit db68d75
Show file tree

Hide file tree

Showing 2 changed files with 58 additions and 54 deletions.
diff --git a/io.catenax.short_term_material_demand/1.0.0/ShortTermMaterialDemand.ttl b/io.catenax.short_term_material_demand/1.0.0/ShortTermMaterialDemand.ttl
@@ -36,23 +36,17 @@
 @prefix ext-uuid: <urn:samm:io.catenax.shared.uuid:2.0.0#> .
 
 :ShortTermMaterialDemand a samm:Aspect ;
-   samm:preferredName "Material Demand Base"@en ;
+   samm:preferredName "Short Term Material Demand"@en ;
    samm:description "The requirements of a customer towards a specific supplier for a specific material. Each material demand is unique by its Customer, Supplier and Material Number."@en ;
-   samm:properties ( :demandSeries :changedAt :materialGlobalAssetId ) ;
+   samm:properties ( :demandSeries :materialGlobalAssetId ) ;
    samm:operations ( ) ;
    samm:events ( ) .
 
 :demandSeries a samm:Property ;
    samm:preferredName "Demand Series"@en ;
-   samm:description "The demands for a dedicated material in a given time period of a given demand rate, distinguished by their demand location and demand category."@en ;
+   samm:description "The demands for a dedicated material in a given time period, distinguished by their demand location and demand category."@en ;
    samm:characteristic :DemandSeriesSet .
 
-:changedAt a samm:Property ;
-   samm:preferredName "Changed At"@en ;
-   samm:description "Point in time when the content (any property according to the data model) of the material demand was changed, at the customer, either by a human user or an automated process."@en ;
-   samm:characteristic samm-c:Timestamp ;
-   samm:exampleValue "2023-11-05T08:15:30.123-05:00"^^xsd:dateTime .
-
 :materialGlobalAssetId a samm:Property ;
    samm:preferredName "UUID of the Part Type Twin"@en ;
    samm:description "Identifier used uniquely to identify part type twin."@en ;
@@ -67,56 +61,52 @@
 :DemandSeries a samm:Entity ;
    samm:preferredName "Demand Series"@en ;
    samm:description "Encapsulates the demand series related information."@en ;
-   samm:properties ( :demands :demandCategory :expectedSupplierLocationBpns :customerLocationBpns ) .
+   samm:properties ( :demands :demandCategory [ samm:property :expectedSupplierLocationBpns; samm:optional true ] :customerLocationBpns :lastUpdatedOnDateTime ) .
 
 :demands a samm:Property ;
    samm:preferredName "Demands"@en ;
-   samm:description "A time series with a specified demand rate along a given time period to describe the demand values for this demand series."@en ;
+   samm:description "A time series on a daily basis along a given time period to describe the demand values for this demand series."@en ;
    samm:characteristic :DemandTimeSeries .
 
-:DemandTimeSeries a samm-c:SortedSet ;
-   samm:preferredName "Demand Time Series"@en ;
-   samm:description "The demands in a given time period for a given demand rate."@en ;
-   samm:dataType :Demand .
-
-:Demand a samm:Entity ;
-   samm:preferredName "Demand"@en ;
-   samm:description "A single demand for a given point in time according to the demand rate."@en ;
-   samm:properties ( :demand :day ) .
-
-:day a samm:Property ;
-   samm:preferredName "Day"@en ;
-   samm:description "Day of the demand quantity. This demand should be as close as possible to the demand that is derived from the actual production program."@en ;
-   samm:characteristic :PointInTimeCharacteristic ;
-   samm:exampleValue "2023-10-09"^^xsd:date .
-
-:PointInTimeCharacteristic a samm:Characteristic ;
-   samm:preferredName "Point in Time Characteristic"@en ;
-   samm:description "An ISO day on which a given demand is needed. Must be given as single day (consider the time zone of the customer's location). (ISO-8601)"@en ;
-   samm:see <https://www.iso.org/iso-8601-date-and-time-format.html> ;
-   samm:dataType xsd:date .
-
-:demand a samm:Property ;
-   samm:preferredName "Demand"@en ;
-   samm:description "Quantity of materials required in the specified point in time according specified demand rate. This demand should be as close as possible to demand that is derived from the actual production program."@en ;
-   samm:characteristic :DemandQuantityCharacteristic .
-
-:DemandQuantityCharacteristic a samm:Characteristic ;
-   samm:preferredName "Demand Quantity Characteristic"@en ;
-   samm:description "Demand expressed as item quantity with a unit of measure."@en ;
-   samm:dataType ext-quantity:ItemQuantityEntity .
-
 :demandCategory a samm:Property ;
    samm:preferredName "Demand Category"@en ;
    samm:description "Type of demand for this demand series."@en ;
    samm:characteristic :DemandCategoryCharacteristic .
 
+:expectedSupplierLocationBpns a samm:Property ;
+   samm:preferredName "Expected Supplier Location"@en ;
+   samm:description "The Business Partner Number Site (BPNS) of the site from where the customer expects the supplier to fulfill the demands of the demand series. The value is used for informational purposes only and is therefore not binding for the supplier."@en ;
+   samm:characteristic ext-number:BpnsTrait ;
+   samm:exampleValue "BPNS8888888888XX" .
+
+:customerLocationBpns a samm:Property ;
+   samm:preferredName "Customer Location"@en ;
+   samm:description "The Business Partner Number Site (BPNS) of the site at which the customer needs the specified material for this demand series."@en ;
+   samm:characteristic ext-number:BpnsTrait ;
+   samm:exampleValue "BPNS8888888888XX" .
+
+:lastUpdatedOnDateTime a samm:Property ;
+   samm:preferredName "Lasted Updated on Date"@en ;
+   samm:description "Date and time at which the DemandSeries has been updated by the reporting partner's system. Date and time are set according to a timezone."@en ;
+   samm:characteristic samm-c:Timestamp ;
+   samm:exampleValue "2023-11-05T08:15:30.123-05:00"^^xsd:dateTime .
+
+:DemandTimeSeries a samm-c:SortedSet ;
+   samm:preferredName "Demand Time Series"@en ;
+   samm:description "The demands in a given time period."@en ;
+   samm:dataType :Demand .
+
 :DemandCategoryCharacteristic a samm-c:Enumeration ;
    samm:preferredName "Demand Category Characteristic"@en ;
    samm:description "The classification of demands used for prioritization or allocation."@en ;
    samm:dataType :DemandCategoryType ;
    samm-c:values ( :DemandCategoryDefault :DemandCategoryAfterSales :DemandCategorySeries :DemandCategoryPhaseInPeriod :DemandCategorySingleOrder :DemandCategorySmallSeries :DemandCategoryExtraordinaryDemand :DemandCategoryPhaseOutPeriod ) .
 
+:Demand a samm:Entity ;
+   samm:preferredName "Demand"@en ;
+   samm:description "A single demand for a day."@en ;
+   samm:properties ( :demand :day ) .
+
 :DemandCategoryType a samm:Entity ;
    samm:preferredName "Demand Category Type"@en ;
    samm:description "Describes the type of a demand category."@en ;
@@ -154,6 +144,17 @@
    :demandCategoryCode "PO01" ;
    :demandCategoryName "Phase-Out Period"@en .
 
+:demand a samm:Property ;
+   samm:preferredName "Demand"@en ;
+   samm:description "Quantity of materials required on a specific day. This demand is not a call-off and should be as close as possible to the actual production program."@en ;
+   samm:characteristic :DemandQuantityCharacteristic .
+
+:day a samm:Property ;
+   samm:preferredName "Day"@en ;
+   samm:description "Day of the demanded quantity."@en ;
+   samm:characteristic :DateCharacteristic ;
+   samm:exampleValue "2023-10-09"^^xsd:date .
+
 :demandCategoryCode a samm:Property ;
    samm:preferredName "Demand Category Code"@en ;
    samm:description "The code identifying a demand category."@en ;
@@ -166,19 +167,21 @@
    samm:characteristic samm-c:MultiLanguageText ;
    samm:exampleValue "Default"@en .
 
+:DemandQuantityCharacteristic a samm:Characteristic ;
+   samm:preferredName "Demand Quantity Characteristic"@en ;
+   samm:description "Demand expressed as item quantity with a unit of measure."@en ;
+   samm:dataType ext-quantity:ItemQuantityEntity .
+
+:DateCharacteristic a samm:Characteristic ;
+   samm:preferredName "Date Characteristic"@en ;
+   samm:description "An ISO date on which a given demand is needed. Must be given as single day (consider the time zone of the customer's location)."@en ;
+   samm:see <https://www.iso.org/iso-8601-date-and-time-format.html> ;
+   samm:dataType xsd:date .
+
 :DemandCategoryCodeCharacteristic a samm-c:Code ;
    samm:preferredName "Demand Category Code Characteristic"@en ;
    samm:description "The code identifying a demand category."@en ;
    samm:dataType xsd:string .
 
-:customerLocationBpns a samm:Property ;
-   samm:preferredName "Customer Location"@en ;
-   samm:description "The Business Partner Number Site (BPNS) of the site at which the customer needs the specified material for this demand series."@en ;
-   samm:characteristic ext-number:BpnsTrait ;
-   samm:exampleValue "BPNS8888888888XX" .
 
-:expectedSupplierLocationBpns a samm:Property ;
-   samm:preferredName "Expected Supplier Location"@en ;
-   samm:description "The Business Partner Number Site (BPNS) of the site from where the customer expects the supplier to fulfill the demands of the demand series. The value is used for informational purposes only and is therefore not binding for the supplier."@en ;
-   samm:characteristic ext-number:BpnsTrait ;
-   samm:exampleValue "BPNS8888888888XX" .
+
diff --git a/io.catenax.short_term_material_demand/RELEASE_NOTES.md b/io.catenax.short_term_material_demand/RELEASE_NOTES.md
@@ -15,11 +15,12 @@ All notable changes to this model will be documented in this file.
   - renamed expectedSupplierLocation to expectedSupplierLocationBpns
   - renamed customerLocation to customerLocationBpns
   - replaced pointInTime by day
+  - moved changedAt to DemandSeries and renamed to lastUpdatedOn including semanticxs
 
 ### Removed
 - compared to io.catenax.material_demand:1.0.0
   - removed all material related information except for materialGlobalAssetId (materialDescriptionCustomer, materialNumberSupplier, materialNumberCustomer)
   - removed demandId
   - removed unitOfMeasureIsOmmitted
-  - removed demandRate
+  - removed demandRate and updated semantics
   - removed supplier and customer