diff --git a/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast-aas.xml b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast-aas.xml new file mode 100644 index 00000000..5e991136 --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast-aas.xml @@ -0,0 +1,1926 @@ + + + + + defaultAdminShell + + + en + defaultAdminShell + + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProvideProductionForecast + + Type + + + + ModelReference + + + Submodel + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProvideProductionForecast/submodel + + + + + + + + + ProvideProductionForecast + + + en + Answer to a customer with all information about the requested items + + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProvideProductionForecast/submodel + Template + + ModelReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProvideProductionForecast + + + + + + ProductionForecastItem + + + en + Production Forecast Item + + + + + en + Datamodel of the concrete production forecast for one forecast item + + + + + listOfForecastItems + + + en + List Of Forecast Items + + + + + en + List of ForecastItems matching the items to an order + + + true + DataElement + + + ForecastItem + + + en + Forecast Item + + + + + en + ForecastItem entry for the requested order + + + + + positionId + + + en + Position Id + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#positionId + + + + xs:string + + + + productionForecast + + + en + Production Forecast + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#productionForecast + + + + xs:dateTime + + + + TimeValue + + + en + Time Value + + + + + en + Datatype to express a time value + + + + + timeUnit + + + en + Time Unit + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#timeUnit + + + + xs:string + + + + value + + + en + Value + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#value + + + + xs:integer + + + + + + productionStatus + + + en + Production Status + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#productionStatus + + + + xs:string + + + + reasonsForDelay + + + en + Reasons For Delay + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#reasonsForDelay + + + + xs:string + + + + returnCode + + + en + Return Code + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#returnCode + + + + xs:string + + + + forecastDate + + + en + Forecast Date + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#forecastDate + + + + xs:dateTime + + + + + + + + iterationNumber + + + en + Iteration Number + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#iterationNumber + + + + xs:integer + + + + communicationMode + + + en + Communication Mode + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#communicationMode + + + + xs:string + + + + versionDataModel + + + en + Version Data Model + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#versionDataModel + + + + xs:string + + + + + + MessageHeader + + + en + Message Header + + + + + en + The Catena-X Message Header contains standardized attributes for message processing that are common across several use cases. It targets a minimal set of aspects that are needed for overall message handling, and not for the processing of the business related payload part. By standardizing the message header structure, we support a harmonized modelling approach and re-use of concepts. The message header originated from discussions on push notifications but has since then been abstracted for overall message handling – and does not only apply to notification anymore. + + + + + messageId + + + en + Message ID + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:1.0.0#messageId + + + + xs:string + + + + context + + + en + Context + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:1.0.0#context + + + + xs:string + + + + sentDateTime + + + en + Sent Date Time + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:1.0.0#sentDateTime + + + + xs:dateTime + + + + senderBpn + + + en + Sender BPN + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:1.0.0#senderBpn + + + + xs:string + + + + receiverBpn + + + en + Receiver BPN + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:1.0.0#receiverBpn + + + + xs:string + + + + expectedResponseBy + + + en + Expected Response By + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:1.0.0#expectedResponseBy + + + + xs:dateTime + + + + relatedMessageId + + + en + Related Message ID + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:1.0.0#relatedMessageId + + + + xs:string + + + + version + + + en + Version + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:1.0.0#version + + + + xs:string + + + + + + + + + + APPLICATION_CLASS + ProvideProductionForecast + + + en + Provide Production Forecast + + + + + en + Answer to a customer with all information about the requested items + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProvideProductionForecast + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Provide Production Forecast + + + + + en + ProvideProductionForecast + + + + + en + Answer to a customer with all information about the requested items + + + + + + + + + positionId + + + en + Position Id + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#positionId + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Position Id + + + + + en + positionId + + + STRING + + + en + Identifier of a position of an order + + + + + + + + + productionForecast + + + en + Production Forecast + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#productionForecast + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Production Forecast + + + + + en + productionForecast + + + STRING + + + en + Date of completion + + + + + + + + + timeUnit + + + en + Time Unit + + + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#timeUnit + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Time Unit + + + + + en + timeUnit + + + STRING + + + en + Specifies the unit in which the time is represented + + + + + + unit:secondUnitOfTime + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#TimeUnitEnum:unit:secondUnitOfTime + + + + + + unit:minuteUnitOfTime + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#TimeUnitEnum:unit:minuteUnitOfTime + + + + + + unit:hour + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#TimeUnitEnum:unit:hour + + + + + + unit:day + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#TimeUnitEnum:unit:day + + + + + + unit:week + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#TimeUnitEnum:unit:week + + + + + + unit:month + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#TimeUnitEnum:unit:month + + + + + + unit:year + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#TimeUnitEnum:unit:year + + + + + + + + + + + + + value + + + en + Value + + + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#value + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Value + + + + + en + value + + + INTEGER_MEASURE + + + en + The amount of timeUnits considered + + + + + + + + + precisionOfForecast + + + en + Precision Of Forecast + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#precisionOfForecast + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Precision Of Forecast + + + + + en + precisionOfForecast + + + STRING + + + en + Accuracy of the prediction + + + + + + + + + productionStatus + + + en + Production Status + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#productionStatus + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Production Status + + + + + en + productionStatus + + + STRING + + + en + Status of the order/position within MP + + + + + + itemReceived + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProductionStatusEnum:itemReceived + + + + + + itemPlanned + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProductionStatusEnum:itemPlanned + + + + + + itemInProduction + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProductionStatusEnum:itemInProduction + + + + + + itemCompleted + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProductionStatusEnum:itemCompleted + + + + + + statusUndefined + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProductionStatusEnum:statusUndefined + + + + + + + + + + + + + reasonsForDelay + + + en + Reasons For Delay + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#reasonsForDelay + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Reasons For Delay + + + + + en + reasonsForDelay + + + STRING + + + en + Optional field to provide information to the customer why a delivery date is not met + + + + + + supplyProblems + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ReasonsForDelayEnum:supplyProblems + + + + + + otherCircumstances + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ReasonsForDelayEnum:otherCircumstances + + + + + + internalProblems + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ReasonsForDelayEnum:internalProblems + + + + + + noInformationAvailable + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ReasonsForDelayEnum:noInformationAvailable + + + + + + + + + + + + + returnCode + + + en + Return Code + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#returnCode + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Return Code + + + + + en + returnCode + + + STRING + + + en + Return code that indicates whether a single item of an order matches the customers desired request + + + + + + ok + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ReturnCodeEnum:ok + + + + + + lowerAccuracyOfPrecision + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ReturnCodeEnum:lowerAccuracyOfPrecision + + + + + + noForecastAvailable + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ReturnCodeEnum:noForecastAvailable + + + + + + + + + + + + + forecastDate + + + en + Forecast Date + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#forecastDate + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Forecast Date + + + + + en + forecastDate + + + STRING + + + en + Date/time of the forecast calculation + + + + + + + + + listOfForecastItems + + + en + List Of Forecast Items + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#listOfForecastItems + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + List Of Forecast Items + + + + + en + listOfForecastItems + + + STRING + + + en + List of ForecastItems matching the items to an order + + + + + + + + + iterationNumber + + + en + Iteration Number + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#iterationNumber + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Iteration Number + + + + + en + iterationNumber + + + INTEGER_MEASURE + + + en + Only set in CommunicationMode == "notification/cyclic" to be able to check the order of the notifications. + +Not required for communication mode = "synchronous" + + + + + + + + + communicationMode + + + en + Communication Mode + + + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#communicationMode + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Communication Mode + + + + + en + communicationMode + + + STRING + + + en + Specification of the communication mode + + + + + + synchronous + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#CommunicationModeEnum:synchronous + + + + + + cyclic + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#CommunicationModeEnum:cyclic + + + + + + notification + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#CommunicationModeEnum:notification + + + + + + + + + + + + + versionDataModel + + + en + Version Data Model + + + urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#versionDataModel + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Version Data Model + + + + + en + versionDataModel + + + STRING + + + en + Specifies the used version of the data model + + + + + + + + + productionForecastResponse + + + en + Production Forecast Response + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#productionForecastResponse + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Production Forecast Response + + + + + en + productionForecastResponse + + + STRING + + + en + The concrete information about a production forecast + + + + + + + + + messageId + + + en + Message ID + + + urn:samm:io.catenax.shared.message_header:1.0.0#messageId + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Message ID + + + + + en + messageId + + + STRING + + + en + Unique ID identifying the message. The purpose of the ID is to uniquely identify a single message, therefore it MUST not be reused. + + + + + + + + + context + + + en + Context + + + urn:samm:io.catenax.shared.message_header:1.0.0#context + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Context + + + + + en + context + + + STRING + + + en + Information about the context the message should be considered in. +The value MUST consist of two parts: an identifier of the context (e.g. business domain, etc.) followed by a version number. +Both the identifier and the version number MUST correspond to the content of the message. +If the content of a message is described by an aspect model available in the Catena-X Semantic Hub, then the unique identifier of this semantic model (e.g. urn:samm:io.catenax.<ASPECT-MODEL-NAME>:1.x.x) MUST be used as a value of the context field. This is considered the default case. +In all other cases the value of the context field MUST follow the pattern <domain>-<subdomain>-<object>:<[major] version> (e.g. TRACE-QM-Alert:1.x.x). +Versioning only refers to major versions in both default and fallback cases. +Note: The version of the message's header is specified in the version field. + + + + + + + + + sentDateTime + + + en + Sent Date Time + + + urn:samm:io.catenax.shared.message_header:1.0.0#sentDateTime + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Sent Date Time + + + + + en + sentDateTime + + + STRING + + + en + Time zone aware timestamp holding the date and the time the message was sent by the sending party. The value MUST be formatted according to the ISO 8601 standard + + + + + + + + + senderBpn + + + en + Sender BPN + + + urn:samm:io.catenax.shared.message_header:1.0.0#senderBpn + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Sender BPN + + + + + en + senderBpn + + + STRING + + + en + The Business Partner Number of the sending party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard + + + + + + + + + receiverBpn + + + en + Receiver BPN + + + urn:samm:io.catenax.shared.message_header:1.0.0#receiverBpn + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Receiver BPN + + + + + en + receiverBpn + + + STRING + + + en + The Business Partner Number of the receiving party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard. + + + + + + + + + expectedResponseBy + + + en + Expected Response By + + + urn:samm:io.catenax.shared.message_header:1.0.0#expectedResponseBy + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Expected Response By + + + + + en + expectedResponseBy + + + STRING + + + en + Time zone aware timestamp holding the date and time by which the sending party expects a certain type of response from the receiving party. The meaning and interpretation of the fields's value are context-bound and MUST therefore be defined by any business domain or platform capability making use of it. The value MUST be formatted according to the ISO 8601 standard + + + + + + + + + relatedMessageId + + + en + Related Message ID + + + urn:samm:io.catenax.shared.message_header:1.0.0#relatedMessageId + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Related Message ID + + + + + en + relatedMessageId + + + STRING + + + en + Unique ID identifying a message somehow related to the current one + + + + + + + + + version + + + en + Version + + + urn:samm:io.catenax.shared.message_header:1.0.0#version + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Version + + + + + en + version + + + STRING + + + en + The unique identifier of the aspect model defining the structure and the semantics of the message's header. The version number should reflect the versioning schema of aspect models in Catena-X. + + + + + + + + + header + + + en + Header + + + urn:samm:io.catenax.shared.message_header:1.0.0#header + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Header + + + + + en + header + + + STRING + + + en + Contains standardized attributes for message processing common across several use cases. + + + + + + + + + diff --git a/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast-schema.json b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast-schema.json new file mode 100644 index 00000000..239de962 --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast-schema.json @@ -0,0 +1,190 @@ +{ + "$schema" : "http://json-schema.org/draft-04/schema", + "description" : "Answer to a customer with all information about the requested items", + "type" : "object", + "components" : { + "schemas" : { + "urn_samm_io.catenax.shared.message_header_1.0.0_UuidCharacteristic" : { + "type" : "string", + "description" : "Structured Value for defining a property which requires an UUID" + }, + "urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" : { + "type" : "string", + "pattern" : "-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T(([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]+)?|(24:00:00(\\.0+)?))(Z|(\\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?", + "description" : "Describes a Property which contains the date and time with an optional timezone." + }, + "urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_TimeUnitEnum" : { + "type" : "string", + "pattern" : "[a-zA-Z]*:[a-zA-Z]+", + "description" : "Enumerates all time units", + "enum" : [ "unit:secondUnitOfTime", "unit:minuteUnitOfTime", "unit:hour", "unit:day", "unit:week", "unit:month", "unit:year" ] + }, + "urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_IntegerValueCharacteristic" : { + "type" : "number", + "description" : "The value of the specified timeUnit as an integer value" + }, + "urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_TimeValueCharacteristic" : { + "description" : "Link to the TimeUnit Data Type", + "type" : "object", + "properties" : { + "timeUnit" : { + "description" : "Specifies the unit in which the time is represented", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_TimeUnitEnum" + }, + "value" : { + "description" : "The amount of timeUnits considered", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_IntegerValueCharacteristic" + } + }, + "required" : [ "timeUnit", "value" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ProductionStatusEnum" : { + "type" : "string", + "description" : "Enumeration with all possible states of an order within MP", + "enum" : [ "itemReceived", "itemPlanned", "itemInProduction", "itemCompleted", "statusUndefined" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ReasonsForDelayEnum" : { + "type" : "string", + "description" : "Enum that specifies reasons for a delay of an order", + "enum" : [ "supplyProblems", "otherCircumstances", "internalProblems", "noInformationAvailable" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ReturnCodeEnum" : { + "type" : "string", + "description" : "Enumeration with all Return Codes", + "enum" : [ "ok", "lowerAccuracyOfPrecision", "noForecastAvailable" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ForecastItem" : { + "description" : "ForecastItem entry for the requested order", + "type" : "object", + "properties" : { + "positionId" : { + "description" : "Identifier of a position of an order", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_UuidCharacteristic" + }, + "productionForecast" : { + "description" : "Date of completion", + "$ref" : "#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" + }, + "precisionOfForecast" : { + "description" : "Accuracy of the prediction", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_TimeValueCharacteristic" + }, + "productionStatus" : { + "description" : "Status of the order/position within MP", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ProductionStatusEnum" + }, + "reasonsForDelay" : { + "description" : "Optional field to provide information to the customer why a delivery date is not met", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ReasonsForDelayEnum" + }, + "returnCode" : { + "description" : "Return code that indicates whether a single item of an order matches the customers desired request", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ReturnCodeEnum" + }, + "forecastDate" : { + "description" : "Date/time of the forecast calculation", + "$ref" : "#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" + } + }, + "required" : [ "positionId", "productionForecast", "precisionOfForecast", "productionStatus", "returnCode", "forecastDate" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ForecastItemList" : { + "description" : "List with the forecast items", + "type" : "array", + "items" : { + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ForecastItem" + } + }, + "urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_CommunicationModeEnum" : { + "type" : "string", + "description" : "Enumerates all possible communication modes", + "enum" : [ "synchronous", "cyclic", "notification" ] + }, + "urn_samm_io.catenax.shared.message_header_1.0.0_BpnCharacteristic" : { + "type" : "string", + "description" : "Characteristic for defining BPN values" + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ProductionForecastCharacteristic" : { + "description" : "All Data that is related to a production forecast", + "type" : "object", + "properties" : { + "listOfForecastItems" : { + "description" : "List of ForecastItems matching the items to an order", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ForecastItemList" + }, + "iterationNumber" : { + "description" : "Only set in CommunicationMode == \"notification/cyclic\" to be able to check the order of the notifications. \n\nNot required for communication mode = \"synchronous\"", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_IntegerValueCharacteristic" + }, + "communicationMode" : { + "description" : "Specification of the communication mode", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_CommunicationModeEnum" + }, + "versionDataModel" : { + "description" : "Specifies the used version of the data model", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_BpnCharacteristic" + } + }, + "required" : [ "listOfForecastItems", "communicationMode", "versionDataModel" ] + }, + "urn_samm_io.catenax.shared.message_header_1.0.0_ContextCharacteristic" : { + "type" : "string", + "description" : "Defining a string value for the context" + }, + "urn_samm_io.catenax.shared.message_header_1.0.0_VersionCharacteristic" : { + "type" : "string", + "description" : "Characteristic defining the value of version." + }, + "urn_samm_io.catenax.shared.message_header_1.0.0_HeaderCharacteristic" : { + "description" : "Characteristic describing the common shared aspect Message Header", + "type" : "object", + "properties" : { + "messageId" : { + "description" : "Unique ID identifying the message. The purpose of the ID is to uniquely identify a single message, therefore it MUST not be reused.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_UuidCharacteristic" + }, + "context" : { + "description" : "Information about the context the message should be considered in.\nThe value MUST consist of two parts: an identifier of the context (e.g. business domain, etc.) followed by a version number.\nBoth the identifier and the version number MUST correspond to the content of the message.\nIf the content of a message is described by an aspect model available in the Catena-X Semantic Hub, then the unique identifier of this semantic model (e.g. urn:samm:io.catenax.:1.x.x) MUST be used as a value of the context field. This is considered the default case.\nIn all other cases the value of the context field MUST follow the pattern --:<[major] version> (e.g. TRACE-QM-Alert:1.x.x).\nVersioning only refers to major versions in both default and fallback cases.\nNote: The version of the message's header is specified in the version field.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_ContextCharacteristic" + }, + "sentDateTime" : { + "description" : "Time zone aware timestamp holding the date and the time the message was sent by the sending party. The value MUST be formatted according to the ISO 8601 standard", + "$ref" : "#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" + }, + "senderBpn" : { + "description" : "The Business Partner Number of the sending party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_BpnCharacteristic" + }, + "receiverBpn" : { + "description" : "The Business Partner Number of the receiving party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_BpnCharacteristic" + }, + "expectedResponseBy" : { + "description" : "Time zone aware timestamp holding the date and time by which the sending party expects a certain type of response from the receiving party. The meaning and interpretation of the fields's value are context-bound and MUST therefore be defined by any business domain or platform capability making use of it. The value MUST be formatted according to the ISO 8601 standard", + "$ref" : "#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" + }, + "relatedMessageId" : { + "description" : "Unique ID identifying a message somehow related to the current one", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_UuidCharacteristic" + }, + "version" : { + "description" : "The unique identifier of the aspect model defining the structure and the semantics of the message's header. The version number should reflect the versioning schema of aspect models in Catena-X.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_VersionCharacteristic" + } + }, + "required" : [ "messageId", "context", "sentDateTime", "senderBpn", "receiverBpn", "version" ] + } + } + }, + "properties" : { + "productionForecastResponse" : { + "description" : "The concrete information about a production forecast", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ProductionForecastCharacteristic" + }, + "header" : { + "description" : "Contains standardized attributes for message processing common across several use cases.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_HeaderCharacteristic" + } + }, + "required" : [ "productionForecastResponse", "header" ] +} \ No newline at end of file diff --git a/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.aasx b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.aasx new file mode 100644 index 00000000..d0bff070 Binary files /dev/null and b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.aasx differ diff --git a/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.html b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.html new file mode 100644 index 00000000..93660f67 --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.html @@ -0,0 +1,1721 @@ + + + + + + + + + + + + + + Documentation Provide Production Forecast + + +
+
+
+
+

Aspect Model Provide Production Forecast

+
urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProvideProductionForecast
+
+
+
+
+
+
+
+ +
+ + +
+ Answer to a customer with all information about the requested items +
+ + +
+

Overview

+
+
+
+
+ Aspect Model Diagram +
+
+
+ + +
+
+

Properties

+
+ +
+ +
+

Header

+
+ +Contains standardized attributes for message processing common across several use cases. + +
+
Name
+
header
+
+ + + +
+
Characteristic
+
+
+
+
SingleEntity
+
+
+
+ Type urn:samm:io.catenax.shared.message_header:1.0.0#MessageHeader + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
header
+
+ + +
+
+ +
+

Production Forecast Response

+
+ +The concrete information about a production forecast + +
+
Name
+
productionForecastResponse
+
+ + + +
+
Characteristic
+
+
+
+
SingleEntity
+
+
+
+ Type urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ProductionForecastItem + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
productionForecastResponse
+
+ + +
+
+ + + +
+
+

Entities

+
+ +
+
+

Forecast Item

+
+
+ ForecastItem entry for the requested order +
+ +
+

Properties

+
+
+ +
+
Position Id
+
+ +Identifier of a position of an order + +
+
Name
+
positionId
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
00000000-0000-0000-C000-000000000046
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
positionId
+
+ + +
+
+ +
+
Production Forecast
+
+ +Date of completion + +
+
Name
+
productionForecast
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#dateTime + +
+
+
+
+
+ +
+
Example
+
2023-06-19T21:24:00+07:00
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
productionForecast
+
+ + +
+
+ +
+
Precision Of Forecast
+
+ +Accuracy of the prediction + +
+
Name
+
precisionOfForecast
+
+ + + +
+
Characteristic
+
+
+
+
SingleEntity
+
+
+
+ Type urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0#TimeValue + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
precisionOfForecast
+
+ + +
+
+ +
+
Production Status
+
+ +Status of the order/position within MP + +
+
Name
+
productionStatus
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • itemReceived
    • +
  • itemPlanned
    • +
  • itemInProduction
    • +
  • itemCompleted
    • +
  • statusUndefined
    • +
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
itemPlanned
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
productionStatus
+
+ + +
+
+ +
+
Reasons For Delay
+
+ +Optional field to provide information to the customer why a delivery date is not met + +
+
Name
+
reasonsForDelay
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • supplyProblems
    • +
  • otherCircumstances
    • +
  • internalProblems
    • +
  • noInformationAvailable
    • +
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
supplyProblems
+
+ +
+
Optional
+
+ Yes
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
reasonsForDelay
+
+ + +
+
+ +
+
Return Code
+
+ +Return code that indicates whether a single item of an order matches the customers desired request + +
+
Name
+
returnCode
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • ok
    • +
  • lowerAccuracyOfPrecision
    • +
  • noForecastAvailable
    • +
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
ok
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
returnCode
+
+ + +
+
+ +
+
Forecast Date
+
+ +Date/time of the forecast calculation + +
+
Name
+
forecastDate
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#dateTime + +
+
+
+
+
+ +
+
Example
+
2023-06-19T21:24:00+07:00
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
forecastDate
+
+ + +
+
+
+
+

Message Header

+
+
+ The Catena-X Message Header contains standardized attributes for message processing that are common across several use cases. It targets a minimal set of aspects that are needed for overall message handling, and not for the processing of the business related payload part. By standardizing the message header structure, we support a harmonized modelling approach and re-use of concepts. The message header originated from discussions on push notifications but has since then been abstracted for overall message handling – and does not only apply to notification anymore. +
+ +
+

Properties

+
+
+ +
+
Message ID
+
+ +Unique ID identifying the message. The purpose of the ID is to uniquely identify a single message, therefore it MUST not be reused. + +
+
Name
+
messageId
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
3b4edc05-e214-47a1-b0c2-1d831cdd9ba9
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
messageId
+
+ + +
+
+ +
+
Context
+
+ +Information about the context the message should be considered in. +The value MUST consist of two parts: an identifier of the context (e.g. business domain, etc.) followed by a version number. +Both the identifier and the version number MUST correspond to the content of the message. +If the content of a message is described by an aspect model available in the Catena-X Semantic Hub, then the unique identifier of this semantic model (e.g. urn:samm:io.catenax.<ASPECT-MODEL-NAME>:1.x.x) MUST be used as a value of the context field. This is considered the default case. +In all other cases the value of the context field MUST follow the pattern <domain>-<subdomain>-<object>:<[major] version> (e.g. TRACE-QM-Alert:1.x.x). +Versioning only refers to major versions in both default and fallback cases. +Note: The version of the message's header is specified in the version field. + +
+
Name
+
context
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
urn:samm:io.catenax.<ASPECT-MODEL-NAME>:1.x.x
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
context
+
+ + +
+
+ +
+
Sent Date Time
+
+ +Time zone aware timestamp holding the date and the time the message was sent by the sending party. The value MUST be formatted according to the ISO 8601 standard + +
+
Name
+
sentDateTime
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#dateTime + +
+
+
+
+
+ +
+
Example
+
2023-06-19T21:24:00+07:00
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
sentDateTime
+
+ + +
+
+ +
+
Sender BPN
+
+ +The Business Partner Number of the sending party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard + +
+
Name
+
senderBpn
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
BPNL7588787849VQ
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
senderBpn
+
+ + +
+
+ +
+
Receiver BPN
+
+ +The Business Partner Number of the receiving party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard. + +
+
Name
+
receiverBpn
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
BPNL6666787765VQ
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
receiverBpn
+
+ + +
+
+ +
+
Expected Response By
+
+ +Time zone aware timestamp holding the date and time by which the sending party expects a certain type of response from the receiving party. The meaning and interpretation of the fields's value are context-bound and MUST therefore be defined by any business domain or platform capability making use of it. The value MUST be formatted according to the ISO 8601 standard + +
+
Name
+
expectedResponseBy
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#dateTime + +
+
+
+
+
+ +
+
Example
+
2023-06-19T21:24:00+07:00
+
+ +
+
Optional
+
+ Yes
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
expectedResponseBy
+
+ + +
+
+ +
+
Related Message ID
+
+ +Unique ID identifying a message somehow related to the current one + +
+
Name
+
relatedMessageId
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
d9452f24-3bf3-4134-b3eb-68858f1b2362
+
+ +
+
Optional
+
+ Yes
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
relatedMessageId
+
+ + +
+
+ +
+
Version
+
+ +The unique identifier of the aspect model defining the structure and the semantics of the message's header. The version number should reflect the versioning schema of aspect models in Catena-X. + +
+
Name
+
version
+
+ + + +
+
Characteristic
+
+
+
+
+ Reference +
+
    +
  • https://semver.org
    • +
+
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
urn:samm:io.catenax.message_header:1.0.0
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
version
+
+ + +
+
+
+
+

Production Forecast Item

+
+
+ Datamodel of the concrete production forecast for one forecast item +
+ +
+

Properties

+
+
+ +
+
List Of Forecast Items
+
+ +List of ForecastItems matching the items to an order + +
+
Name
+
listOfForecastItems
+
+ + + +
+
Characteristic
+
+
+
+
List
+
+
+
Has a certain order
+
+
+
Duplicates allowed
+
+
+
+ Type urn:samm:io.catenax.shopfloor_information.provide_production_forecast:1.0.0#ForecastItem + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
listOfForecastItems
+
+ + +
+
+ +
+
Iteration Number
+
+ +Only set in CommunicationMode == "notification/cyclic" to be able to check the order of the notifications. + +Not required for communication mode = "synchronous" + +
+
Name
+
iterationNumber
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#integer + +
+
+
+
+
+ +
+
Example
+
6
+
+ +
+
Optional
+
+ Yes
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
iterationNumber
+
+ + +
+
+ +
+
Communication Mode
+
+ +Specification of the communication mode + +
+
Name
+
communicationMode
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • synchronous
    • +
  • cyclic
    • +
  • notification
    • +
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
synchronous
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
communicationMode
+
+ + +
+
+ +
+
Version Data Model
+
+ +Specifies the used version of the data model + +
+
Name
+
versionDataModel
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
versionDataModel
+
+ + +
+
+
+
+

Time Value

+
+
+ Datatype to express a time value +
+ +
+

Properties

+
+
+ +
+
Time Unit
+
+ +Specifies the unit in which the time is represented + +
+
Name
+
timeUnit
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • unit:secondUnitOfTime
    • +
  • unit:minuteUnitOfTime
    • +
  • unit:hour
    • +
  • unit:day
    • +
  • unit:week
    • +
  • unit:month
    • +
  • unit:year
    • +
+
+
+
+
+ Type urn:samm:org.eclipse.esmf.samm:meta-model:2.1.0#curie + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
timeUnit
+
+ + +
+
+ +
+
Value
+
+ +The amount of timeUnits considered + +
+
Name
+
value
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#integer + +
+
+
+
+
+ +
+
Example
+
12
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
value
+
+ + +
+
+
+ +
+ Third party licenses + +
+ +
+ + +
+ + + \ No newline at end of file diff --git a/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.json b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.json new file mode 100644 index 00000000..1d85e2ea --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.json @@ -0,0 +1,29 @@ +{ + "productionForecastResponse" : { + "listOfForecastItems" : [ { + "returnCode" : "ok", + "precisionOfForecast" : { + "value" : 12, + "timeUnit" : "unit:secondUnitOfTime" + }, + "reasonsForDelay" : "supplyProblems", + "positionId" : "00000000-0000-0000-C000-000000000046", + "productionStatus" : "itemReceived", + "productionForecast" : "2023-06-19T21:24:00+07:00", + "forecastDate" : "2023-06-19T21:24:00+07:00" + } ], + "versionDataModel" : "urn:samm:io.catenax.shared.shopfloor_information_types:1.0.0", + "communicationMode" : "synchronous", + "iterationNumber" : 6 + }, + "header" : { + "senderBpn" : "BPNL7588787849VQ", + "relatedMessageId" : "d9452f24-3bf3-4134-b3eb-68858f1b2362", + "expectedResponseBy" : "2023-06-19T21:24:00+07:00", + "context" : "urn:samm:io.catenax.:1.x.x", + "messageId" : "3b4edc05-e214-47a1-b0c2-1d831cdd9ba9", + "receiverBpn" : "BPNL6666787765VQ", + "sentDateTime" : "2023-06-19T21:24:00+07:00", + "version" : "urn:samm:io.catenax.message_header:1.0.0" + } +} \ No newline at end of file diff --git a/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.yml b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.yml new file mode 100644 index 00000000..fff15c53 --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/1.0.0/gen/ProvideProductionForecast.yml @@ -0,0 +1,299 @@ +--- +openapi: 3.0.3 +info: + title: Provide Production Forecast + version: v1 +servers: +- url: catenax.io/api/v1 + variables: + api-version: + default: v1 +paths: + /{tenant-id}/provide-production-forecast: + get: + tags: + - ProvideProductionForecast + operationId: getProvideProductionForecast + parameters: + - name: tenant-id + in: path + description: The ID of the tenant owning the requested Twin. + required: true + schema: + type: string + format: uuid + responses: + "200": + $ref: '#/components/responses/ProvideProductionForecast' + "401": + $ref: '#/components/responses/ClientError' + "402": + $ref: '#/components/responses/Unauthorized' + "403": + $ref: '#/components/responses/Forbidden' + "404": + $ref: '#/components/responses/NotFoundError' +components: + schemas: + ErrorResponse: + type: object + required: + - error + properties: + error: + $ref: '#/components/schemas/Error' + Error: + type: object + required: + - details + properties: + message: + type: string + minLength: 1 + path: + type: string + minLength: 1 + details: + type: object + minLength: 1 + additionalProperties: + type: object + code: + type: string + nullable: true + urn_samm_io.catenax.shared.message_header_1.0.0_UuidCharacteristic: + type: string + description: Structured Value for defining a property which requires an UUID + urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp: + type: string + pattern: "-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T(([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\\ + .[0-9]+)?|(24:00:00(\\.0+)?))(Z|(\\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?" + description: Describes a Property which contains the date and time with an optional + timezone. + urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_TimeUnitEnum: + type: string + pattern: "[a-zA-Z]*:[a-zA-Z]+" + description: Enumerates all time units + enum: + - unit:secondUnitOfTime + - unit:minuteUnitOfTime + - unit:hour + - unit:day + - unit:week + - unit:month + - unit:year + urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_IntegerValueCharacteristic: + type: number + description: The value of the specified timeUnit as an integer value + urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_TimeValueCharacteristic: + description: Link to the TimeUnit Data Type + type: object + properties: + timeUnit: + description: Specifies the unit in which the time is represented + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_TimeUnitEnum' + value: + description: The amount of timeUnits considered + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_IntegerValueCharacteristic' + required: + - timeUnit + - value + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ProductionStatusEnum: + type: string + description: Enumeration with all possible states of an order within MP + enum: + - itemReceived + - itemPlanned + - itemInProduction + - itemCompleted + - statusUndefined + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ReasonsForDelayEnum: + type: string + description: Enum that specifies reasons for a delay of an order + enum: + - supplyProblems + - otherCircumstances + - internalProblems + - noInformationAvailable + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ReturnCodeEnum: + type: string + description: Enumeration with all Return Codes + enum: + - ok + - lowerAccuracyOfPrecision + - noForecastAvailable + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ForecastItem: + description: ForecastItem entry for the requested order + type: object + properties: + positionId: + description: Identifier of a position of an order + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_UuidCharacteristic' + productionForecast: + description: Date of completion + $ref: '#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp' + precisionOfForecast: + description: Accuracy of the prediction + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_TimeValueCharacteristic' + productionStatus: + description: Status of the order/position within MP + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ProductionStatusEnum' + reasonsForDelay: + description: Optional field to provide information to the customer why a + delivery date is not met + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ReasonsForDelayEnum' + returnCode: + description: Return code that indicates whether a single item of an order + matches the customers desired request + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ReturnCodeEnum' + forecastDate: + description: Date/time of the forecast calculation + $ref: '#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp' + required: + - positionId + - productionForecast + - precisionOfForecast + - productionStatus + - returnCode + - forecastDate + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ForecastItemList: + description: List with the forecast items + type: array + items: + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ForecastItem' + urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_CommunicationModeEnum: + type: string + description: Enumerates all possible communication modes + enum: + - synchronous + - cyclic + - notification + urn_samm_io.catenax.shared.message_header_1.0.0_BpnCharacteristic: + type: string + description: Characteristic for defining BPN values + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ProductionForecastCharacteristic: + description: All Data that is related to a production forecast + type: object + properties: + listOfForecastItems: + description: List of ForecastItems matching the items to an order + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ForecastItemList' + iterationNumber: + description: "Only set in CommunicationMode == \"notification/cyclic\" to\ + \ be able to check the order of the notifications. \n\nNot required for\ + \ communication mode = \"synchronous\"" + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_IntegerValueCharacteristic' + communicationMode: + description: Specification of the communication mode + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_1.0.0_CommunicationModeEnum' + versionDataModel: + description: Specifies the used version of the data model + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_BpnCharacteristic' + required: + - listOfForecastItems + - communicationMode + - versionDataModel + urn_samm_io.catenax.shared.message_header_1.0.0_ContextCharacteristic: + type: string + description: Defining a string value for the context + urn_samm_io.catenax.shared.message_header_1.0.0_VersionCharacteristic: + type: string + description: Characteristic defining the value of version. + urn_samm_io.catenax.shared.message_header_1.0.0_HeaderCharacteristic: + description: Characteristic describing the common shared aspect Message Header + type: object + properties: + messageId: + description: "Unique ID identifying the message. The purpose of the ID is\ + \ to uniquely identify a single message, therefore it MUST not be reused." + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_UuidCharacteristic' + context: + description: |- + Information about the context the message should be considered in. + The value MUST consist of two parts: an identifier of the context (e.g. business domain, etc.) followed by a version number. + Both the identifier and the version number MUST correspond to the content of the message. + If the content of a message is described by an aspect model available in the Catena-X Semantic Hub, then the unique identifier of this semantic model (e.g. urn:samm:io.catenax.:1.x.x) MUST be used as a value of the context field. This is considered the default case. + In all other cases the value of the context field MUST follow the pattern --:<[major] version> (e.g. TRACE-QM-Alert:1.x.x). + Versioning only refers to major versions in both default and fallback cases. + Note: The version of the message's header is specified in the version field. + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_ContextCharacteristic' + sentDateTime: + description: Time zone aware timestamp holding the date and the time the + message was sent by the sending party. The value MUST be formatted according + to the ISO 8601 standard + $ref: '#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp' + senderBpn: + description: The Business Partner Number of the sending party. The value + MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints + are defined in the corresponding standard + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_BpnCharacteristic' + receiverBpn: + description: The Business Partner Number of the receiving party. The value + MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints + are defined in the corresponding standard. + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_BpnCharacteristic' + expectedResponseBy: + description: Time zone aware timestamp holding the date and time by which + the sending party expects a certain type of response from the receiving + party. The meaning and interpretation of the fields's value are context-bound + and MUST therefore be defined by any business domain or platform capability + making use of it. The value MUST be formatted according to the ISO 8601 + standard + $ref: '#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp' + relatedMessageId: + description: Unique ID identifying a message somehow related to the current + one + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_UuidCharacteristic' + version: + description: The unique identifier of the aspect model defining the structure + and the semantics of the message's header. The version number should reflect + the versioning schema of aspect models in Catena-X. + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_VersionCharacteristic' + required: + - messageId + - context + - sentDateTime + - senderBpn + - receiverBpn + - version + ProvideProductionForecast: + description: Answer to a customer with all information about the requested items + type: object + properties: + productionForecastResponse: + description: The concrete information about a production forecast + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_1.0.0_ProductionForecastCharacteristic' + header: + description: Contains standardized attributes for message processing common + across several use cases. + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_1.0.0_HeaderCharacteristic' + required: + - productionForecastResponse + - header + responses: + Unauthorized: + description: The requesting user or client is not authenticated. + Forbidden: + description: The requesting user or client is not authorized to access resources + for the given tenant. + NotFoundError: + description: The requested Twin has not been found. + ClientError: + description: Payload or user input is invalid. See error details in the payload + for more. + content: + application/json: + schema: + $ref: '#/components/schemas/ErrorResponse' + ProvideProductionForecast: + content: + application/json: + schema: + $ref: '#/components/schemas/ProvideProductionForecast' + description: The request was successful. + requestBodies: + ProvideProductionForecast: + content: + application/json: + schema: + $ref: '#/components/schemas/ProvideProductionForecast' diff --git a/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast-aas.xml b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast-aas.xml new file mode 100644 index 00000000..b3e7d7ba --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast-aas.xml @@ -0,0 +1,1926 @@ + + + + + defaultAdminShell + + + en + defaultAdminShell + + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProvideProductionForecast + + Type + + + + ModelReference + + + Submodel + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProvideProductionForecast/submodel + + + + + + + + + ProvideProductionForecast + + + en + Answer to a customer with all information about the requested items + + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProvideProductionForecast/submodel + Template + + ModelReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProvideProductionForecast + + + + + + ProductionForecastItem + + + en + Production Forecast Item + + + + + en + Datamodel of the concrete production forecast for one forecast item + + + + + listOfForecastItems + + + en + List Of Forecast Items + + + + + en + List of ForecastItems matching the items to an order + + + true + DataElement + + + ForecastItem + + + en + Forecast Item + + + + + en + ForecastItem entry for the requested order + + + + + positionId + + + en + Position Id + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#positionId + + + + xs:string + + + + productionForecast + + + en + Production Forecast + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#productionForecast + + + + xs:dateTime + + + + TimeValue + + + en + Time Value + + + + + en + Datatype to express a time value + + + + + timeUnit + + + en + Time Unit + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#timeUnit + + + + xs:string + + + + value + + + en + Value + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#value + + + + xs:integer + + + + + + productionStatus + + + en + Production Status + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#productionStatus + + + + xs:string + + + + reasonsForDelay + + + en + Reasons For Delay + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#reasonsForDelay + + + + xs:string + + + + returnCode + + + en + Return Code + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#returnCode + + + + xs:string + + + + forecastDate + + + en + Forecast Date + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#forecastDate + + + + xs:dateTime + + + + + + + + iterationNumber + + + en + Iteration Number + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#iterationNumber + + + + xs:integer + + + + communicationMode + + + en + Communication Mode + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#communicationMode + + + + xs:string + + + + version + + + en + Version + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:2.0.0#version + + + + xs:string + + + + + + MessageHeader + + + en + Message Header + + + + + en + The Catena-X Message Header contains standardized attributes for message processing that are common across several use cases. It targets a minimal set of aspects that are needed for overall message handling, and not for the processing of the business related payload part. By standardizing the message header structure, we support a harmonized modelling approach and re-use of concepts. The message header originated from discussions on push notifications but has since then been abstracted for overall message handling ? and does not only apply to notification anymore. + + + + + messageId + + + en + Message ID + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:2.0.0#messageId + + + + xs:string + + + + context + + + en + Context + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:2.0.0#context + + + + xs:string + + + + sentDateTime + + + en + Sent Date Time + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:2.0.0#sentDateTime + + + + xs:dateTime + + + + senderBpn + + + en + Sender BPN + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:2.0.0#senderBpn + + + + xs:string + + + + receiverBpn + + + en + Receiver BPN + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:2.0.0#receiverBpn + + + + xs:string + + + + expectedResponseBy + + + en + Expected Response By + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:2.0.0#expectedResponseBy + + + + xs:dateTime + + + + relatedMessageId + + + en + Related Message ID + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:2.0.0#relatedMessageId + + + + xs:string + + + + version + + + en + Version + + + + ExternalReference + + + ConceptDescription + urn:samm:io.catenax.shared.message_header:2.0.0#version + + + + xs:string + + + + + + + + + + APPLICATION_CLASS + ProvideProductionForecast + + + en + Provide Production Forecast + + + + + en + Answer to a customer with all information about the requested items + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProvideProductionForecast + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Provide Production Forecast + + + + + en + ProvideProductionForecast + + + + + en + Answer to a customer with all information about the requested items + + + + + + + + + positionId + + + en + Position Id + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#positionId + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Position Id + + + + + en + positionId + + + STRING + + + en + Identifier of a position of an order + + + + + + + + + productionForecast + + + en + Production Forecast + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#productionForecast + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Production Forecast + + + + + en + productionForecast + + + STRING + + + en + Date of completion + + + + + + + + + timeUnit + + + en + Time Unit + + + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#timeUnit + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Time Unit + + + + + en + timeUnit + + + STRING + + + en + Specifies the unit in which the time is represented + + + + + + unit:secondUnitOfTime + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#TimeUnitEnum:unit:secondUnitOfTime + + + + + + unit:minuteUnitOfTime + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#TimeUnitEnum:unit:minuteUnitOfTime + + + + + + unit:hour + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#TimeUnitEnum:unit:hour + + + + + + unit:day + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#TimeUnitEnum:unit:day + + + + + + unit:week + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#TimeUnitEnum:unit:week + + + + + + unit:month + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#TimeUnitEnum:unit:month + + + + + + unit:year + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#TimeUnitEnum:unit:year + + + + + + + + + + + + + value + + + en + Value + + + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#value + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Value + + + + + en + value + + + INTEGER_MEASURE + + + en + The amount of timeUnits considered + + + + + + + + + precisionOfForecast + + + en + Precision Of Forecast + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#precisionOfForecast + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Precision Of Forecast + + + + + en + precisionOfForecast + + + STRING + + + en + Accuracy of the prediction + + + + + + + + + productionStatus + + + en + Production Status + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#productionStatus + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Production Status + + + + + en + productionStatus + + + STRING + + + en + Status of the order/position within MP + + + + + + itemReceived + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProductionStatusEnum:itemReceived + + + + + + itemPlanned + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProductionStatusEnum:itemPlanned + + + + + + itemInProduction + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProductionStatusEnum:itemInProduction + + + + + + itemCompleted + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProductionStatusEnum:itemCompleted + + + + + + statusUndefined + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProductionStatusEnum:statusUndefined + + + + + + + + + + + + + reasonsForDelay + + + en + Reasons For Delay + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#reasonsForDelay + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Reasons For Delay + + + + + en + reasonsForDelay + + + STRING + + + en + Optional field to provide information to the customer why a delivery date is not met + + + + + + supplyProblems + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ReasonsForDelayEnum:supplyProblems + + + + + + otherCircumstances + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ReasonsForDelayEnum:otherCircumstances + + + + + + internalProblems + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ReasonsForDelayEnum:internalProblems + + + + + + noInformationAvailable + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ReasonsForDelayEnum:noInformationAvailable + + + + + + + + + + + + + returnCode + + + en + Return Code + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#returnCode + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Return Code + + + + + en + returnCode + + + STRING + + + en + Return code that indicates whether a single item of an order matches the customers desired request + + + + + + ok + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ReturnCodeEnum:ok + + + + + + lowerAccuracyOfPrecision + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ReturnCodeEnum:lowerAccuracyOfPrecision + + + + + + noForecastAvailable + + ModelReference + + + DataElement + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ReturnCodeEnum:noForecastAvailable + + + + + + + + + + + + + forecastDate + + + en + Forecast Date + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#forecastDate + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Forecast Date + + + + + en + forecastDate + + + STRING + + + en + Date/time of the forecast calculation + + + + + + + + + listOfForecastItems + + + en + List Of Forecast Items + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#listOfForecastItems + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + List Of Forecast Items + + + + + en + listOfForecastItems + + + STRING + + + en + List of ForecastItems matching the items to an order + + + + + + + + + iterationNumber + + + en + Iteration Number + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#iterationNumber + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Iteration Number + + + + + en + iterationNumber + + + INTEGER_MEASURE + + + en + Only set in CommunicationMode == "notification/cyclic" to be able to check the order of the notifications. + +Not required for communication mode = "synchronous" + + + + + + + + + communicationMode + + + en + Communication Mode + + + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#communicationMode + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Communication Mode + + + + + en + communicationMode + + + STRING + + + en + Specification of the communication mode + + + + + + synchronous + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#CommunicationModeEnum:synchronous + + + + + + cyclic + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#CommunicationModeEnum:cyclic + + + + + + notification + + ModelReference + + + DataElement + urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#CommunicationModeEnum:notification + + + + + + + + + + + + + version + + + en + Version + + + urn:samm:io.catenax.shared.message_header:2.0.0#version + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Version + + + + + en + version + + + STRING + + + en + The unique identifier of the aspect model defining the structure and the semantics of the message's header. The version number should reflect the versioning schema of aspect models in Catena-X. + + + + + + + + + productionForecastResponse + + + en + Production Forecast Response + + + urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#productionForecastResponse + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Production Forecast Response + + + + + en + productionForecastResponse + + + STRING + + + en + The concrete information about a production forecast + + + + + + + + + messageId + + + en + Message ID + + + urn:samm:io.catenax.shared.message_header:2.0.0#messageId + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Message ID + + + + + en + messageId + + + STRING + + + en + Unique ID identifying the message. The purpose of the ID is to uniquely identify a single message, therefore it MUST not be reused. + + + + + + + + + context + + + en + Context + + + urn:samm:io.catenax.shared.message_header:2.0.0#context + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Context + + + + + en + context + + + STRING + + + en + Information about the context the message should be considered in. +The value MUST consist of two parts: an identifier of the context (e.g. business domain, etc.) followed by a version number. +Both the identifier and the version number MUST correspond to the content of the message. +If the content of a message is described by an aspect model available in the Catena-X Semantic Hub, then the unique identifier of this semantic model (e.g. urn:samm:io.catenax.<ASPECT-MODEL-NAME>:1.x.x) MUST be used as a value of the context field. This is considered the default case. +In all other cases the value of the context field MUST follow the pattern <domain>-<subdomain>-<object>:<[major] version> (e.g. TRACE-QM-Alert:1.x.x). +Versioning only refers to major versions in both default and fallback cases. +Note: The version of the message's header is specified in the version field. + + + + + + + + + sentDateTime + + + en + Sent Date Time + + + urn:samm:io.catenax.shared.message_header:2.0.0#sentDateTime + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Sent Date Time + + + + + en + sentDateTime + + + STRING + + + en + Time zone aware timestamp holding the date and the time the message was sent by the sending party. The value MUST be formatted according to the ISO 8601 standard + + + + + + + + + senderBpn + + + en + Sender BPN + + + urn:samm:io.catenax.shared.message_header:2.0.0#senderBpn + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Sender BPN + + + + + en + senderBpn + + + STRING + + + en + The Business Partner Number of the sending party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard + + + + + + + + + receiverBpn + + + en + Receiver BPN + + + urn:samm:io.catenax.shared.message_header:2.0.0#receiverBpn + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Receiver BPN + + + + + en + receiverBpn + + + STRING + + + en + The Business Partner Number of the receiving party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard. + + + + + + + + + expectedResponseBy + + + en + Expected Response By + + + urn:samm:io.catenax.shared.message_header:2.0.0#expectedResponseBy + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Expected Response By + + + + + en + expectedResponseBy + + + STRING + + + en + Time zone aware timestamp holding the date and time by which the sending party expects a certain type of response from the receiving party. The meaning and interpretation of the fields's value are context-bound and MUST therefore be defined by any business domain or platform capability making use of it. The value MUST be formatted according to the ISO 8601 standard + + + + + + + + + relatedMessageId + + + en + Related Message ID + + + urn:samm:io.catenax.shared.message_header:2.0.0#relatedMessageId + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Related Message ID + + + + + en + relatedMessageId + + + STRING + + + en + Unique ID identifying a message somehow related to the current one + + + + + + + + + version + + + en + Version + + + urn:samm:io.catenax.shared.message_header:2.0.0#version + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Version + + + + + en + version + + + STRING + + + en + The unique identifier of the aspect model defining the structure and the semantics of the message's header. The version number should reflect the versioning schema of aspect models in Catena-X. + + + + + + + + + header + + + en + Header + + + urn:samm:io.catenax.shared.message_header:2.0.0#header + + + + ExternalReference + + + GlobalReference + https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 + + + + + + + + en + Header + + + + + en + header + + + STRING + + + en + Contains standardized attributes for message processing common across several use cases. + + + + + + + + + diff --git a/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast-schema.json b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast-schema.json new file mode 100644 index 00000000..55d5c624 --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast-schema.json @@ -0,0 +1,193 @@ +{ + "$schema" : "http://json-schema.org/draft-04/schema", + "description" : "Answer to a customer with all information about the requested items", + "type" : "object", + "components" : { + "schemas" : { + "urn_samm_io.catenax.shared.uuid_1.0.0_UuidV4Trait" : { + "type" : "string", + "description" : "The provided regular expression ensures that the UUID is composed of five groups of characters separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters (32 hexadecimal characters and 4 hyphens), optionally prefixed by \"urn:uuid:\" to make it an IRI.", + "pattern" : "(^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)|(^urn:uuid:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)" + }, + "urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" : { + "type" : "string", + "pattern" : "-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T(([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]+)?|(24:00:00(\\.0+)?))(Z|(\\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?", + "description" : "Describes a Property which contains the date and time with an optional timezone." + }, + "urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_TimeUnitEnum" : { + "type" : "string", + "pattern" : "[a-zA-Z]*:[a-zA-Z]+", + "description" : "Enumerates all time units", + "enum" : [ "unit:secondUnitOfTime", "unit:minuteUnitOfTime", "unit:hour", "unit:day", "unit:week", "unit:month", "unit:year" ] + }, + "urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_IntegerValueCharacteristic" : { + "type" : "number", + "description" : "The value of the specified timeUnit as an integer value" + }, + "urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_TimeValueCharacteristic" : { + "description" : "Link to the TimeUnit Data Type", + "type" : "object", + "properties" : { + "timeUnit" : { + "description" : "Specifies the unit in which the time is represented", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_TimeUnitEnum" + }, + "value" : { + "description" : "The amount of timeUnits considered", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_IntegerValueCharacteristic" + } + }, + "required" : [ "timeUnit", "value" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ProductionStatusEnum" : { + "type" : "string", + "description" : "Enumeration with all possible states of an order within modular production", + "enum" : [ "itemReceived", "itemPlanned", "itemInProduction", "itemCompleted", "statusUndefined" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ReasonsForDelayEnum" : { + "type" : "string", + "description" : "Enum that specifies reasons for a delay of an order", + "enum" : [ "supplyProblems", "otherCircumstances", "internalProblems", "noInformationAvailable" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ReturnCodeEnum" : { + "type" : "string", + "description" : "Enumeration with all Return Codes", + "enum" : [ "ok", "lowerAccuracyOfPrecision", "noForecastAvailable" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ForecastItem" : { + "description" : "ForecastItem entry for the requested order", + "type" : "object", + "properties" : { + "positionId" : { + "description" : "Identifier of a position of an order", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.uuid_1.0.0_UuidV4Trait" + }, + "productionForecast" : { + "description" : "Date of completion", + "$ref" : "#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" + }, + "precisionOfForecast" : { + "description" : "Accuracy of the prediction", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_TimeValueCharacteristic" + }, + "productionStatus" : { + "description" : "Status of the order/position within MP", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ProductionStatusEnum" + }, + "reasonsForDelay" : { + "description" : "Optional field to provide information to the customer why a delivery date is not met", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ReasonsForDelayEnum" + }, + "returnCode" : { + "description" : "Return code that indicates whether a single item of an order matches the customers desired request", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ReturnCodeEnum" + }, + "forecastDate" : { + "description" : "Date/time of the forecast calculation", + "$ref" : "#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" + } + }, + "required" : [ "positionId", "productionForecast", "precisionOfForecast", "productionStatus", "returnCode", "forecastDate" ] + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ForecastItemList" : { + "description" : "List with the forecast items", + "type" : "array", + "items" : { + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ForecastItem" + } + }, + "urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_CommunicationModeEnum" : { + "type" : "string", + "description" : "Enumerates all possible communication modes", + "enum" : [ "synchronous", "cyclic", "notification" ] + }, + "urn_samm_io.catenax.shared.message_header_2.0.0_SemanticVersioningTrait" : { + "type" : "string", + "description" : "Constraint for defining a SemVer version.", + "pattern" : "^(0|[1-9][0-9]*).(0|[1-9][0-9]*).(0|[1-9][0-9]*)(-(0|[1-9A-Za-z-][0-9A-Za-z-]*)(.[0-9A-Za-z-]+)*)?([0-9A-Za-z-]+(.[0-9A-Za-z-]+)*)?$" + }, + "urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ProductionForecastCharacteristic" : { + "description" : "All Data that is related to a production forecast", + "type" : "object", + "properties" : { + "listOfForecastItems" : { + "description" : "List of ForecastItems matching the items to an order", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ForecastItemList" + }, + "iterationNumber" : { + "description" : "Only set in CommunicationMode == \"notification/cyclic\" to be able to check the order of the notifications. \n\nNot required for communication mode = \"synchronous\"", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_IntegerValueCharacteristic" + }, + "communicationMode" : { + "description" : "Specification of the communication mode", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_CommunicationModeEnum" + }, + "version" : { + "description" : "The unique identifier of the aspect model defining the structure and the semantics of the message's header. The version number should reflect the versioning schema of aspect models in Catena-X.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_2.0.0_SemanticVersioningTrait" + } + }, + "required" : [ "listOfForecastItems", "communicationMode", "version" ] + }, + "urn_samm_io.catenax.shared.message_header_2.0.0_ContextCharacteristic" : { + "type" : "string", + "description" : "Defining a string value for the context" + }, + "urn_samm_io.catenax.shared.business_partner_number_1.0.0_BpnlTrait" : { + "type" : "string", + "description" : "The provided regular expression ensures that the BPNL is composed of prefix 'BPNL', 10 digits and two uppercase letters.", + "pattern" : "^BPNL[0-9]{8}[a-zA-Z0-9]{4}$" + }, + "urn_samm_io.catenax.shared.message_header_2.0.0_HeaderCharacteristic" : { + "description" : "Characteristic describing the common shared aspect Message Header", + "type" : "object", + "properties" : { + "messageId" : { + "description" : "Unique ID identifying the message. The purpose of the ID is to uniquely identify a single message, therefore it MUST not be reused.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.uuid_1.0.0_UuidV4Trait" + }, + "context" : { + "description" : "Information about the context the message should be considered in.\nThe value MUST consist of two parts: an identifier of the context (e.g. business domain, etc.) followed by a version number.\nBoth the identifier and the version number MUST correspond to the content of the message.\nIf the content of a message is described by an aspect model available in the Catena-X Semantic Hub, then the unique identifier of this semantic model (e.g. urn:samm:io.catenax.:1.x.x) MUST be used as a value of the context field. This is considered the default case.\nIn all other cases the value of the context field MUST follow the pattern --:<[major] version> (e.g. TRACE-QM-Alert:1.x.x).\nVersioning only refers to major versions in both default and fallback cases.\nNote: The version of the message's header is specified in the version field.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_2.0.0_ContextCharacteristic" + }, + "sentDateTime" : { + "description" : "Time zone aware timestamp holding the date and the time the message was sent by the sending party. The value MUST be formatted according to the ISO 8601 standard", + "$ref" : "#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" + }, + "senderBpn" : { + "description" : "The Business Partner Number of the sending party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.business_partner_number_1.0.0_BpnlTrait" + }, + "receiverBpn" : { + "description" : "The Business Partner Number of the receiving party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.business_partner_number_1.0.0_BpnlTrait" + }, + "expectedResponseBy" : { + "description" : "Time zone aware timestamp holding the date and time by which the sending party expects a certain type of response from the receiving party. The meaning and interpretation of the fields's value are context-bound and MUST therefore be defined by any business domain or platform capability making use of it. The value MUST be formatted according to the ISO 8601 standard", + "$ref" : "#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp" + }, + "relatedMessageId" : { + "description" : "Unique ID identifying a message somehow related to the current one", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.uuid_1.0.0_UuidV4Trait" + }, + "version" : { + "description" : "The unique identifier of the aspect model defining the structure and the semantics of the message's header. The version number should reflect the versioning schema of aspect models in Catena-X.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_2.0.0_SemanticVersioningTrait" + } + }, + "required" : [ "messageId", "context", "sentDateTime", "senderBpn", "receiverBpn", "version" ] + } + } + }, + "properties" : { + "productionForecastResponse" : { + "description" : "The concrete information about a production forecast", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ProductionForecastCharacteristic" + }, + "header" : { + "description" : "Contains standardized attributes for message processing common across several use cases.", + "$ref" : "#/components/schemas/urn_samm_io.catenax.shared.message_header_2.0.0_HeaderCharacteristic" + } + }, + "required" : [ "productionForecastResponse", "header" ] +} \ No newline at end of file diff --git a/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.aasx b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.aasx new file mode 100644 index 00000000..c07e10cb Binary files /dev/null and b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.aasx differ diff --git a/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.html b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.html new file mode 100644 index 00000000..4fefc5dc --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.html @@ -0,0 +1,2014 @@ + + + + + + + + + + + + + + Documentation Provide Production Forecast + + +
+
+
+
+

Aspect Model Provide Production Forecast

+
urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProvideProductionForecast
+
+
+
+
+
+
+
+ +
+ + +
+ Answer to a customer with all information about the requested items +
+ + +
+

Overview

+
+
+
+
+ Aspect Model Diagram +
+
+
+ + +
+
+

Properties

+
+ +
+ +
+

Header

+
+ +Contains standardized attributes for message processing common across several use cases. + +
+
Name
+
header
+
+ + + +
+
Characteristic
+
+
+
+
SingleEntity
+
+
+
+ Type urn:samm:io.catenax.shared.message_header:2.0.0#MessageHeader + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
header
+
+ + +
+
+ +
+

Production Forecast Response

+
+ +The concrete information about a production forecast + +
+
Name
+
productionForecastResponse
+
+ + + +
+
Characteristic
+
+
+
+
SingleEntity
+
+
+
+ Type urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ProductionForecastItem + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
productionForecastResponse
+
+ + +
+
+ + + +
+
+

Entities

+
+ +
+
+

Forecast Item

+
+
+ ForecastItem entry for the requested order +
+ +
+

Properties

+
+
+ +
+
Position Id
+
+ +Identifier of a position of an order + +
+
Name
+
positionId
+
+ + + +
+
Characteristic
+
+
+
+
Trait
+
+
+
+ Reference +
+
    +
  • https://tools.ietf.org/html/rfc4122
    • +
+
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
00000000-0000-0000-C000-000000000046
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
positionId
+
+ + +
+
Constraints
+
+
    +
  • +
    + +
    + UUID v4 Regular Expression +
    + +
    +
    Description
    +
    The provided regular expression ensures that the UUID is composed of five groups of characters separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters (32 hexadecimal characters and 4 hyphens), optionally prefixed by "urn:uuid:" to make it an IRI.
    +
    + +
    +
    Reference
    +
    +
    +
      +
    • https://datatracker.ietf.org/doc/html/rfc4122
      • +
    +
    +
    +
    + +
    +
    Regular expression
    +
    (^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)|(^urn:uuid:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)
    +
    + +
    • +
+
+
+
+
+ +
+
Production Forecast
+
+ +Date of completion + +
+
Name
+
productionForecast
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#dateTime + +
+
+
+
+
+ +
+
Example
+
2023-06-19T21:24:00+07:00
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
productionForecast
+
+ + +
+
+ +
+
Precision Of Forecast
+
+ +Accuracy of the prediction + +
+
Name
+
precisionOfForecast
+
+ + + +
+
Characteristic
+
+
+
+
SingleEntity
+
+
+
+ Type urn:samm:io.catenax.shared.shopfloor_information_types:2.0.0#TimeValue + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
precisionOfForecast
+
+ + +
+
+ +
+
Production Status
+
+ +Status of the order/position within MP + +
+
Name
+
productionStatus
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • itemReceived
    • +
  • itemPlanned
    • +
  • itemInProduction
    • +
  • itemCompleted
    • +
  • statusUndefined
    • +
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
itemPlanned
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
productionStatus
+
+ + +
+
+ +
+
Reasons For Delay
+
+ +Optional field to provide information to the customer why a delivery date is not met + +
+
Name
+
reasonsForDelay
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • supplyProblems
    • +
  • otherCircumstances
    • +
  • internalProblems
    • +
  • noInformationAvailable
    • +
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
supplyProblems
+
+ +
+
Optional
+
+ Yes
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
reasonsForDelay
+
+ + +
+
+ +
+
Return Code
+
+ +Return code that indicates whether a single item of an order matches the customers desired request + +
+
Name
+
returnCode
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • ok
    • +
  • lowerAccuracyOfPrecision
    • +
  • noForecastAvailable
    • +
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
ok
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
returnCode
+
+ + +
+
+ +
+
Forecast Date
+
+ +Date/time of the forecast calculation + +
+
Name
+
forecastDate
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#dateTime + +
+
+
+
+
+ +
+
Example
+
2023-06-19T21:24:00+07:00
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
forecastDate
+
+ + +
+
+
+
+

Message Header

+
+
+ The Catena-X Message Header contains standardized attributes for message processing that are common across several use cases. It targets a minimal set of aspects that are needed for overall message handling, and not for the processing of the business related payload part. By standardizing the message header structure, we support a harmonized modelling approach and re-use of concepts. The message header originated from discussions on push notifications but has since then been abstracted for overall message handling ? and does not only apply to notification anymore. +
+ +
+

Properties

+
+
+ +
+
Message ID
+
+ +Unique ID identifying the message. The purpose of the ID is to uniquely identify a single message, therefore it MUST not be reused. + +
+
Name
+
messageId
+
+ + + +
+
Characteristic
+
+
+
+
Trait
+
+
+
+ Reference +
+
    +
  • https://tools.ietf.org/html/rfc4122
    • +
+
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
3b4edc05-e214-47a1-b0c2-1d831cdd9ba9
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
messageId
+
+ + +
+
Constraints
+
+
    +
  • +
    + +
    + UUID v4 Regular Expression +
    + +
    +
    Description
    +
    The provided regular expression ensures that the UUID is composed of five groups of characters separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters (32 hexadecimal characters and 4 hyphens), optionally prefixed by "urn:uuid:" to make it an IRI.
    +
    + +
    +
    Reference
    +
    +
    +
      +
    • https://datatracker.ietf.org/doc/html/rfc4122
      • +
    +
    +
    +
    + +
    +
    Regular expression
    +
    (^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)|(^urn:uuid:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)
    +
    + +
    • +
+
+
+
+
+ +
+
Context
+
+ +Information about the context the message should be considered in. +The value MUST consist of two parts: an identifier of the context (e.g. business domain, etc.) followed by a version number. +Both the identifier and the version number MUST correspond to the content of the message. +If the content of a message is described by an aspect model available in the Catena-X Semantic Hub, then the unique identifier of this semantic model (e.g. urn:samm:io.catenax.<ASPECT-MODEL-NAME>:1.x.x) MUST be used as a value of the context field. This is considered the default case. +In all other cases the value of the context field MUST follow the pattern <domain>-<subdomain>-<object>:<[major] version> (e.g. TRACE-QM-Alert:1.x.x). +Versioning only refers to major versions in both default and fallback cases. +Note: The version of the message's header is specified in the version field. + +
+
Name
+
context
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
urn:samm:io.catenax.<ASPECT-MODEL-NAME>:1.x.x
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
context
+
+ + +
+
+ +
+
Sent Date Time
+
+ +Time zone aware timestamp holding the date and the time the message was sent by the sending party. The value MUST be formatted according to the ISO 8601 standard + +
+
Name
+
sentDateTime
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#dateTime + +
+
+
+
+
+ +
+
Example
+
2023-06-19T21:24:00+07:00
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
sentDateTime
+
+ + +
+
+ +
+
Sender BPN
+
+ +The Business Partner Number of the sending party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard + +
+
Name
+
senderBpn
+
+ + + +
+
Characteristic
+
+
+
+
Trait
+
+
+
+ Reference +
+
    +
  • https://catena-x.net/fileadmin/user_upload/Standard-Bibliothek/Update_PDF_Maerz/5_BPDM/CX_-_0010_BUSINESS_PARTNER_NUMBER_PlatformCapabilityBPDM_v_1.0.1.pdf
    • +
+
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
BPNL7588787849VQ
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
senderBpn
+
+ + +
+
Constraints
+
+
    +
  • +
    + +
    + BPNL Regular Expression +
    + +
    +
    Description
    +
    The provided regular expression ensures that the BPNL is composed of prefix 'BPNL', 10 digits and two uppercase letters.
    +
    + + +
    +
    Regular expression
    +
    ^BPNL[0-9]{8}[a-zA-Z0-9]{4}$
    +
    + +
    • +
+
+
+
+
+ +
+
Receiver BPN
+
+ +The Business Partner Number of the receiving party. The value MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints are defined in the corresponding standard. + +
+
Name
+
receiverBpn
+
+ + + +
+
Characteristic
+
+
+
+
Trait
+
+
+
+ Reference +
+
    +
  • https://catena-x.net/fileadmin/user_upload/Standard-Bibliothek/Update_PDF_Maerz/5_BPDM/CX_-_0010_BUSINESS_PARTNER_NUMBER_PlatformCapabilityBPDM_v_1.0.1.pdf
    • +
+
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
BPNL6666787765VQ
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
receiverBpn
+
+ + +
+
Constraints
+
+
    +
  • +
    + +
    + BPNL Regular Expression +
    + +
    +
    Description
    +
    The provided regular expression ensures that the BPNL is composed of prefix 'BPNL', 10 digits and two uppercase letters.
    +
    + + +
    +
    Regular expression
    +
    ^BPNL[0-9]{8}[a-zA-Z0-9]{4}$
    +
    + +
    • +
+
+
+
+
+ +
+
Expected Response By
+
+ +Time zone aware timestamp holding the date and time by which the sending party expects a certain type of response from the receiving party. The meaning and interpretation of the fields's value are context-bound and MUST therefore be defined by any business domain or platform capability making use of it. The value MUST be formatted according to the ISO 8601 standard + +
+
Name
+
expectedResponseBy
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#dateTime + +
+
+
+
+
+ +
+
Example
+
2023-06-19T21:24:00+07:00
+
+ +
+
Optional
+
+ Yes
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
expectedResponseBy
+
+ + +
+
+ +
+
Related Message ID
+
+ +Unique ID identifying a message somehow related to the current one + +
+
Name
+
relatedMessageId
+
+ + + +
+
Characteristic
+
+
+
+
Trait
+
+
+
+ Reference +
+
    +
  • https://tools.ietf.org/html/rfc4122
    • +
+
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
d9452f24-3bf3-4134-b3eb-68858f1b2362
+
+ +
+
Optional
+
+ Yes
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
relatedMessageId
+
+ + +
+
Constraints
+
+
    +
  • +
    + +
    + UUID v4 Regular Expression +
    + +
    +
    Description
    +
    The provided regular expression ensures that the UUID is composed of five groups of characters separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters (32 hexadecimal characters and 4 hyphens), optionally prefixed by "urn:uuid:" to make it an IRI.
    +
    + +
    +
    Reference
    +
    +
    +
      +
    • https://datatracker.ietf.org/doc/html/rfc4122
      • +
    +
    +
    +
    + +
    +
    Regular expression
    +
    (^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)|(^urn:uuid:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)
    +
    + +
    • +
+
+
+
+
+ +
+
Version
+
+ +The unique identifier of the aspect model defining the structure and the semantics of the message's header. The version number should reflect the versioning schema of aspect models in Catena-X. + +
+
Name
+
version
+
+ + + +
+
Characteristic
+
+
+
+
Trait
+
+
+
+ Reference +
+
    +
  • https://semver.org
    • +
+
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
2.0.0
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
version
+
+ + +
+
Constraints
+
+
    +
  • +
    + +
    + Semantic Versioning Constraint +
    + +
    +
    Description
    +
    Constraint for defining a SemVer version.
    +
    + + +
    +
    Regular expression
    +
    ^(0|[1-9][0-9]*).(0|[1-9][0-9]*).(0|[1-9][0-9]*)(-(0|[1-9A-Za-z-][0-9A-Za-z-]*)(.[0-9A-Za-z-]+)*)?([0-9A-Za-z-]+(.[0-9A-Za-z-]+)*)?$
    +
    + +
    • +
+
+
+
+
+
+
+

Production Forecast Item

+
+
+ Datamodel of the concrete production forecast for one forecast item +
+ +
+

Properties

+
+
+ +
+
List Of Forecast Items
+
+ +List of ForecastItems matching the items to an order + +
+
Name
+
listOfForecastItems
+
+ + + +
+
Characteristic
+
+
+
+
List
+
+
+
Has a certain order
+
+
+
Duplicates allowed
+
+
+
+ Type urn:samm:io.catenax.shopfloor_information.provide_production_forecast:2.0.0#ForecastItem + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
listOfForecastItems
+
+ + +
+
+ +
+
Iteration Number
+
+ +Only set in CommunicationMode == "notification/cyclic" to be able to check the order of the notifications. + +Not required for communication mode = "synchronous" + +
+
Name
+
iterationNumber
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#integer + +
+
+
+
+
+ +
+
Example
+
6
+
+ +
+
Optional
+
+ Yes
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
iterationNumber
+
+ + +
+
+ +
+
Communication Mode
+
+ +Specification of the communication mode + +
+
Name
+
communicationMode
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • synchronous
    • +
  • cyclic
    • +
  • notification
    • +
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
synchronous
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
communicationMode
+
+ + +
+
+ +
+
Version
+
+ +The unique identifier of the aspect model defining the structure and the semantics of the message's header. The version number should reflect the versioning schema of aspect models in Catena-X. + +
+
Name
+
version
+
+ + + +
+
Characteristic
+
+
+
+
Trait
+
+
+
+ Reference +
+
    +
  • https://semver.org
    • +
+
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#string + +
+
+
+
+
+ +
+
Example
+
2.0.0
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
version
+
+ + +
+
Constraints
+
+
    +
  • +
    + +
    + Semantic Versioning Constraint +
    + +
    +
    Description
    +
    Constraint for defining a SemVer version.
    +
    + + +
    +
    Regular expression
    +
    ^(0|[1-9][0-9]*).(0|[1-9][0-9]*).(0|[1-9][0-9]*)(-(0|[1-9A-Za-z-][0-9A-Za-z-]*)(.[0-9A-Za-z-]+)*)?([0-9A-Za-z-]+(.[0-9A-Za-z-]+)*)?$
    +
    + +
    • +
+
+
+
+
+
+
+

Time Value

+
+
+ Datatype to express a time value +
+ +
+

Properties

+
+
+ +
+
Time Unit
+
+ +Specifies the unit in which the time is represented + +
+
Name
+
timeUnit
+
+ + + +
+
Characteristic
+
+
+
+
Enumeration
+
+
+
Values
+
+
+
+
    +
  • unit:secondUnitOfTime
    • +
  • unit:minuteUnitOfTime
    • +
  • unit:hour
    • +
  • unit:day
    • +
  • unit:week
    • +
  • unit:month
    • +
  • unit:year
    • +
+
+
+
+
+ Type urn:samm:org.eclipse.esmf.samm:meta-model:2.1.0#curie + +
+
+
+
+
+ + +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
timeUnit
+
+ + +
+
+ +
+
Value
+
+ +The amount of timeUnits considered + +
+
Name
+
value
+
+ + + +
+
Characteristic
+
+
+
+
+ Type http://www.w3.org/2001/XMLSchema#integer + +
+
+
+
+
+ +
+
Example
+
12
+
+ +
+
Optional
+
+ No
+
+ +
+
In payload
+
+ Yes
+
+ +
+
Payload key
+
value
+
+ + +
+
+
+ +
+ Third party licenses + +
+ +
+ + +
+ + + \ No newline at end of file diff --git a/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.json b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.json new file mode 100644 index 00000000..5f5649df --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.json @@ -0,0 +1,29 @@ +{ + "productionForecastResponse" : { + "listOfForecastItems" : [ { + "returnCode" : "ok", + "precisionOfForecast" : { + "value" : 12, + "timeUnit" : "unit:secondUnitOfTime" + }, + "reasonsForDelay" : "supplyProblems", + "positionId" : "00000000-0000-0000-C000-000000000046", + "productionStatus" : "itemReceived", + "productionForecast" : "2023-06-19T21:24:00+07:00", + "forecastDate" : "2023-06-19T21:24:00+07:00" + } ], + "version" : "2.0.0", + "communicationMode" : "synchronous", + "iterationNumber" : 6 + }, + "header" : { + "senderBpn" : "BPNL7588787849VQ", + "relatedMessageId" : "d9452f24-3bf3-4134-b3eb-68858f1b2362", + "expectedResponseBy" : "2023-06-19T21:24:00+07:00", + "context" : "urn:samm:io.catenax.:1.x.x", + "messageId" : "3b4edc05-e214-47a1-b0c2-1d831cdd9ba9", + "receiverBpn" : "BPNL6666787765VQ", + "sentDateTime" : "2023-06-19T21:24:00+07:00", + "version" : "2.0.0" + } +} \ No newline at end of file diff --git a/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.yml b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.yml new file mode 100644 index 00000000..d653f4a5 --- /dev/null +++ b/io.catenax.shopfloor_information.provide_production_forecast/2.0.0/gen/ProvideProductionForecast.yml @@ -0,0 +1,309 @@ +--- +openapi: 3.0.3 +info: + title: Provide Production Forecast + version: v2 +servers: +- url: catenax.io/api/v2 + variables: + api-version: + default: v2 +paths: + /{tenant-id}/provide-production-forecast: + get: + tags: + - ProvideProductionForecast + operationId: getProvideProductionForecast + parameters: + - name: tenant-id + in: path + description: The ID of the tenant owning the requested Twin. + required: true + schema: + type: string + format: uuid + responses: + "200": + $ref: '#/components/responses/ProvideProductionForecast' + "401": + $ref: '#/components/responses/ClientError' + "402": + $ref: '#/components/responses/Unauthorized' + "403": + $ref: '#/components/responses/Forbidden' + "404": + $ref: '#/components/responses/NotFoundError' +components: + schemas: + ErrorResponse: + type: object + required: + - error + properties: + error: + $ref: '#/components/schemas/Error' + Error: + type: object + required: + - details + properties: + message: + type: string + minLength: 1 + path: + type: string + minLength: 1 + details: + type: object + minLength: 1 + additionalProperties: + type: object + code: + type: string + nullable: true + urn_samm_io.catenax.shared.uuid_1.0.0_UuidV4Trait: + type: string + description: "The provided regular expression ensures that the UUID is composed\ + \ of five groups of characters separated by hyphens, in the form 8-4-4-4-12\ + \ for a total of 36 characters (32 hexadecimal characters and 4 hyphens),\ + \ optionally prefixed by \"urn:uuid:\" to make it an IRI." + pattern: "(^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)|(^urn:uuid:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)" + urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp: + type: string + pattern: "-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T(([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\\ + .[0-9]+)?|(24:00:00(\\.0+)?))(Z|(\\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?" + description: Describes a Property which contains the date and time with an optional + timezone. + urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_TimeUnitEnum: + type: string + pattern: "[a-zA-Z]*:[a-zA-Z]+" + description: Enumerates all time units + enum: + - unit:secondUnitOfTime + - unit:minuteUnitOfTime + - unit:hour + - unit:day + - unit:week + - unit:month + - unit:year + urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_IntegerValueCharacteristic: + type: number + description: The value of the specified timeUnit as an integer value + urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_TimeValueCharacteristic: + description: Link to the TimeUnit Data Type + type: object + properties: + timeUnit: + description: Specifies the unit in which the time is represented + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_TimeUnitEnum' + value: + description: The amount of timeUnits considered + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_IntegerValueCharacteristic' + required: + - timeUnit + - value + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ProductionStatusEnum: + type: string + description: Enumeration with all possible states of an order within modular + production + enum: + - itemReceived + - itemPlanned + - itemInProduction + - itemCompleted + - statusUndefined + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ReasonsForDelayEnum: + type: string + description: Enum that specifies reasons for a delay of an order + enum: + - supplyProblems + - otherCircumstances + - internalProblems + - noInformationAvailable + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ReturnCodeEnum: + type: string + description: Enumeration with all Return Codes + enum: + - ok + - lowerAccuracyOfPrecision + - noForecastAvailable + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ForecastItem: + description: ForecastItem entry for the requested order + type: object + properties: + positionId: + description: Identifier of a position of an order + $ref: '#/components/schemas/urn_samm_io.catenax.shared.uuid_1.0.0_UuidV4Trait' + productionForecast: + description: Date of completion + $ref: '#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp' + precisionOfForecast: + description: Accuracy of the prediction + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_TimeValueCharacteristic' + productionStatus: + description: Status of the order/position within MP + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ProductionStatusEnum' + reasonsForDelay: + description: Optional field to provide information to the customer why a + delivery date is not met + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ReasonsForDelayEnum' + returnCode: + description: Return code that indicates whether a single item of an order + matches the customers desired request + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ReturnCodeEnum' + forecastDate: + description: Date/time of the forecast calculation + $ref: '#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp' + required: + - positionId + - productionForecast + - precisionOfForecast + - productionStatus + - returnCode + - forecastDate + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ForecastItemList: + description: List with the forecast items + type: array + items: + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ForecastItem' + urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_CommunicationModeEnum: + type: string + description: Enumerates all possible communication modes + enum: + - synchronous + - cyclic + - notification + urn_samm_io.catenax.shared.message_header_2.0.0_SemanticVersioningTrait: + type: string + description: Constraint for defining a SemVer version. + pattern: "^(0|[1-9][0-9]*).(0|[1-9][0-9]*).(0|[1-9][0-9]*)(-(0|[1-9A-Za-z-][0-9A-Za-z-]*)(.[0-9A-Za-z-]+)*)?([0-9A-Za-z-]+(.[0-9A-Za-z-]+)*)?$" + urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ProductionForecastCharacteristic: + description: All Data that is related to a production forecast + type: object + properties: + listOfForecastItems: + description: List of ForecastItems matching the items to an order + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ForecastItemList' + iterationNumber: + description: "Only set in CommunicationMode == \"notification/cyclic\" to\ + \ be able to check the order of the notifications. \n\nNot required for\ + \ communication mode = \"synchronous\"" + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_IntegerValueCharacteristic' + communicationMode: + description: Specification of the communication mode + $ref: '#/components/schemas/urn_samm_io.catenax.shared.shopfloor_information_types_2.0.0_CommunicationModeEnum' + version: + description: The unique identifier of the aspect model defining the structure + and the semantics of the message's header. The version number should reflect + the versioning schema of aspect models in Catena-X. + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_2.0.0_SemanticVersioningTrait' + required: + - listOfForecastItems + - communicationMode + - version + urn_samm_io.catenax.shared.message_header_2.0.0_ContextCharacteristic: + type: string + description: Defining a string value for the context + urn_samm_io.catenax.shared.business_partner_number_1.0.0_BpnlTrait: + type: string + description: "The provided regular expression ensures that the BPNL is composed\ + \ of prefix 'BPNL', 10 digits and two uppercase letters." + pattern: "^BPNL[0-9]{8}[a-zA-Z0-9]{4}$" + urn_samm_io.catenax.shared.message_header_2.0.0_HeaderCharacteristic: + description: Characteristic describing the common shared aspect Message Header + type: object + properties: + messageId: + description: "Unique ID identifying the message. The purpose of the ID is\ + \ to uniquely identify a single message, therefore it MUST not be reused." + $ref: '#/components/schemas/urn_samm_io.catenax.shared.uuid_1.0.0_UuidV4Trait' + context: + description: |- + Information about the context the message should be considered in. + The value MUST consist of two parts: an identifier of the context (e.g. business domain, etc.) followed by a version number. + Both the identifier and the version number MUST correspond to the content of the message. + If the content of a message is described by an aspect model available in the Catena-X Semantic Hub, then the unique identifier of this semantic model (e.g. urn:samm:io.catenax.:1.x.x) MUST be used as a value of the context field. This is considered the default case. + In all other cases the value of the context field MUST follow the pattern --:<[major] version> (e.g. TRACE-QM-Alert:1.x.x). + Versioning only refers to major versions in both default and fallback cases. + Note: The version of the message's header is specified in the version field. + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_2.0.0_ContextCharacteristic' + sentDateTime: + description: Time zone aware timestamp holding the date and the time the + message was sent by the sending party. The value MUST be formatted according + to the ISO 8601 standard + $ref: '#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp' + senderBpn: + description: The Business Partner Number of the sending party. The value + MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints + are defined in the corresponding standard + $ref: '#/components/schemas/urn_samm_io.catenax.shared.business_partner_number_1.0.0_BpnlTrait' + receiverBpn: + description: The Business Partner Number of the receiving party. The value + MUST be a valid BPN. BPNA and BPNS are not allowed. Applicable constraints + are defined in the corresponding standard. + $ref: '#/components/schemas/urn_samm_io.catenax.shared.business_partner_number_1.0.0_BpnlTrait' + expectedResponseBy: + description: Time zone aware timestamp holding the date and time by which + the sending party expects a certain type of response from the receiving + party. The meaning and interpretation of the fields's value are context-bound + and MUST therefore be defined by any business domain or platform capability + making use of it. The value MUST be formatted according to the ISO 8601 + standard + $ref: '#/components/schemas/urn_samm_org.eclipse.esmf.samm_characteristic_2.1.0_Timestamp' + relatedMessageId: + description: Unique ID identifying a message somehow related to the current + one + $ref: '#/components/schemas/urn_samm_io.catenax.shared.uuid_1.0.0_UuidV4Trait' + version: + description: The unique identifier of the aspect model defining the structure + and the semantics of the message's header. The version number should reflect + the versioning schema of aspect models in Catena-X. + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_2.0.0_SemanticVersioningTrait' + required: + - messageId + - context + - sentDateTime + - senderBpn + - receiverBpn + - version + ProvideProductionForecast: + description: Answer to a customer with all information about the requested items + type: object + properties: + productionForecastResponse: + description: The concrete information about a production forecast + $ref: '#/components/schemas/urn_samm_io.catenax.shopfloor_information.provide_production_forecast_2.0.0_ProductionForecastCharacteristic' + header: + description: Contains standardized attributes for message processing common + across several use cases. + $ref: '#/components/schemas/urn_samm_io.catenax.shared.message_header_2.0.0_HeaderCharacteristic' + required: + - productionForecastResponse + - header + responses: + Unauthorized: + description: The requesting user or client is not authenticated. + Forbidden: + description: The requesting user or client is not authorized to access resources + for the given tenant. + NotFoundError: + description: The requested Twin has not been found. + ClientError: + description: Payload or user input is invalid. See error details in the payload + for more. + content: + application/json: + schema: + $ref: '#/components/schemas/ErrorResponse' + ProvideProductionForecast: + content: + application/json: + schema: + $ref: '#/components/schemas/ProvideProductionForecast' + description: The request was successful. + requestBodies: + ProvideProductionForecast: + content: + application/json: + schema: + $ref: '#/components/schemas/ProvideProductionForecast'