diff --git a/OpenAPI/TS28104_MdaReport.yaml b/OpenAPI/TS28104_MdaReport.yaml index 942a1cb6f731f9bb582d6363fd4a8b47de5ab22c..ba2f51e3c4deb1689f1e3f341899245ed7932c03 100644 --- a/OpenAPI/TS28104_MdaReport.yaml +++ b/OpenAPI/TS28104_MdaReport.yaml @@ -45,7 +45,13 @@ components: mDAType: $ref: 'TS28104_MdaNrm.yaml#/components/schemas/MDAType' mDAOutputList: - oneOf: + oneOf: + - $ref: '#/components/schemas/CoverageProblemAnalysisoutput' + - $ref: '#/components/schemas/MobilityPerformanceAnalysisoutput' + - $ref: '#/components/schemas/TrainingDataAnalysisOutput' + - $ref: '#/components/schemas/NFScalingDimensioningDataAnalysisOutput' + - $ref: '#/components/schemas/PMDataOutput' + - $ref: '#/components/schemas/FailurePredictionOutput' - $ref: '#/components/schemas/PagingOptimizationAnalysisOutput' - type: array uniqueItems: true @@ -86,3 +92,306 @@ components: $ref: '#/components/schemas/MDAOutputs' mDARequestRef: $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo' + +#-------- Definition of recommended action -------------------------------------------- + Recommended3GPPAction: + type: object + properties: + mOInstance: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + path: + type: string + op: + type: string + enum: + - ADD + - REMOVE + - REPLACE + value: + type: array + uniqueItems: true + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/AttributeNameValuePairSet' + additionalText: + type: array + items: + type: string + + RecommendedAction: + type: object + properties: + recommended3GPPActions: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/Recommended3GPPAction' + recommendedNon3GPPActions: + type: array + uniqueItems: true + items: + type: string + recommendedHumanReadableActions: + type: array + uniqueItems: true + items: + type: string + actionInterval: + type: integer + timeWindow: + type: array + uniqueItems: false + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + + + +#-------- Definition of specific MobilityPerformanceAnalysis MDAoutput ----------------------------- + MobilityPerformanceAnalysisoutput: + type: object + properties: + mobilityPerformanceIssueIdentifier: + type: integer + mobilityPerformanceIssueRootCause: + type: string + enum: + - TooLongMobilityInterruptionTime + - PoorCoverageOfTheCelledge + - InappropriateHandoverParameters + - Other + mobilityPerformanceIssueLocation: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' + +#-------- Definition of specific CoverageProblemAnalysis MDAoutput ----------------------------- + CoverageProblemAnalysisoutput: + type: object + properties: + coverageProblemId: + type: string + coverageProblemType: + type: string + enum: + - WEAK_COVERAGE + - COVERAGE_HOLE + - PILOT_POLLUTION + - OVERSHOOT_COVERAGE + - DL_ULCHANNEL_COVERAGE_MISMATCH + - Other + coverageProblemAreas: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' + problematicCells: + type: integer + recommendedActions: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/RecommendedAction' + radioEnvironmentMap: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/RadioEnvironmentMap' + cellConfigurations: + description: A map (list of key-value pairs) + $ref: 'TS28623_ComDefs.yaml#/components/schemas/AttributeNameValuePairSet' + + RadioEnvironmentMap: + type: object + properties: + geoCoordinate: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' + coverageCharacterization: + $ref: '#/components/schemas/CoverageCharacterization' + + CoverageCharacterization: + type: object + properties: + rsrp: + type: number + format: float + sinr: + type: number + format: float + +#-------- Definition of specific TrainingDataAnalysis MDAoutput ----------------------------- + + TrainingDataAnalysisOutput: + type: object + properties: + measurementDataCorrelationRecommendation: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/MeasurementDataCorrelationRecommendation' + + MeasurementDataCorrelationRecommendation: + type: object + properties: + recommendedMeasurementDataToCollect: + type: array + uniqueItems: true + items: + type: string + recommendedMeasurementDataNotToCollect: + type: array + uniqueItems: true + items: + type: string + modelPerformanceImpact: + type: integer + minimum: 0 + maximum: 100 + + + + +#-------- Definition of specific NFScalingDimensioningDataAnalysis MDAoutput ----------------------------- + + NFScalingDimensioningDataAnalysisOutput: + type: object + properties: + recommendedActions: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/RecommendedAction' + + + + + +#-------- Definition of specific PMData MDAoutput ----------------------------- + PMDataOutput: + type: object + properties: + pmPredictions: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/PmPrediction' + minItems: 1 + thresholdAssessment: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/ThresholdAssessment' + thresholdAdjustmentRecommendations: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/RecommendedAction' + + PmPrediction: + type: object + properties: + pmName: + type: string + pmPredictedValue: + description: >- + This specifies the predicted value of the PM specified by “pmName” + attribute. + oneOf: + - type: integer + - type: number + format: float + + thresholdAssessment: + $ref: '#/components/schemas/ThresholdAssessment' + + ThresholdAssessment: + type: object + properties: + performanceMetrics: + description: >- + It indicates list of performance metrics with threshold + configuration issue. + Performance metrics include measurements defined in TS 28.552 + and KPIs defined in TS 28.554. + For non-3GPP specified measurements the name is defined elsewhere. + type: array + uniqueItems: true + items: + type: string + timeWindow: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + confidenceScore: + type: number + format: float + + +#-------- Definition of specific FailurePrediction MDAoutput ----------------------------- + + FailurePredictionOutput: + type: object + properties: + failurePredictionObject: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList' + potentialFailureType: + type: string + potentialFailureCause: + oneOf: + - type: integer + - type: string + eventTime: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + issueID: + type: string + issueDomain: + type: string + enum: + - RAN_ISSUE + - CN_ISSUE + - UNKNOWN + perceivedSeverity: + type: string + enum: + - CRITICAL + - MAJOR + - MINOR + - WARNING + - INTERMEDIATE + - CLEARED + trendIndication: + type: string + enum: + - MORE_SEVERE + - NO_CHANGE + - LESS_SEVERE + predictedFailureEndTime: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + statisticsInfoList: + type: array + items: + type: integer + managementDataCollectionRecommendations: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/ManagementDataCollectionInfo' + recommendedActions: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/RecommendedAction' + + ManagementDataCollectionInfo: + type: object + properties: + managementDataType: + type: string + enum: + - MEASUREMENT + - KPI + - TRACE_MDT + - QOE + managementData: + $ref: 'TS28623_ManagementDataCollectionNrm.yaml#/components/schemas/ManagementData' + targetEntities: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList' + collectionDuration: + type: array + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + + + +