Documentation
La extensión de métricas proporciona un bloque de construcción común para reportar información estructurada de rendimiento de los contratos.
Las métricas están estructuradas como un cubo de datos OLAP con cada instancia de Metric
representando una sola observación, categorizada por un número de dimensiones.
La extensión de métricas se puede usar en:
- La etapa
planning
para predicciones sobre el proceso de contratación (ejemplo: predicciones de los niveles de demanda) - La etapa
tender
para objetivos del proceso de contrataciones (por ejemplo: niveles de disponibilidad objetivo o indicadores clave de rendimiento) - Las etapas
awards
ycontracts
para los objetivos acordados con el proveedor adjudicado (por ejemplo, niveles de disponibilidad o KPI) - La etapa
implementation
para la información de desempeño actual (por ejemplo: demanda actual, disponibilidad o indicadores claves de rendimiento)
Dónde se usa la extensión métricas para modelar objetivos para un proceso de contratación, el campo description
puede usarse para indicar si el objetivo es un mínimo o un objetivo recomendando.
Ejemplo
Pronósticos
{
"planning": {
"forecasts": [
{
"id": "annualDemand",
"title": "Annual Demand",
"description": "The annual demand",
"observations": [
{
"id": "1",
"period": {
"startDate": "2015-01-01T00:00:00Z",
"endDate": "2015-12-31T23:59:59Z"
},
"measure": 10000,
"dimensions": {
"vehicleType": "Car"
}
},
{
"id": "2",
"period": {
"startDate": "2015-01-01T00:00:00Z",
"endDate": "2015-12-31T23:59:59Z"
},
"measure": 1000,
"dimensions": {
"vehicleType": "Trucks"
},
"notes": "Simple note"
}
]
}
]
}
}
Progreso físico
La extensión de métricas también puede ser utilizada para reportar el progreso físico de un contrato. El siguiente fragmento de JSON muestra como la extensión de métrica puede ser utilizada para reportar el progreso en la construcción de una carretera, tanto por porcentaje completado como por número de kilómetros construidos:
{
"contracts": [
{
"id": "1",
"awardID": "1",
"implementation": {
"metrics": [
{
"id": "completionPercent",
"title": "Construction progress (percent)",
"description": "Percent completion of the construction of example highway",
"observations": [
{
"id": "completionPercent-2016-Q1",
"period": {
"startDate": "2016-03-31T23:59:59Z",
"endDate": "2016-03-31T23:59:59Z"
},
"measure": "25",
"unit": {
"name": "percent",
"id": "P1",
"scheme": "UNCEFACT"
}
}
]
},
{
"id": "completionKilometres",
"title": "Construction progress (kilometres)",
"description": "Progress of construction of example highway measured in kilometres",
"observations": [
{
"id": "completionKilometres-2016-Q1",
"period": {
"startDate": "2016-03-31T23:59:59Z",
"endDate": "2016-03-31T23:59:59Z"
},
"measure": "15",
"unit": {
"name": "kilometre",
"id": "KMT",
"scheme": "UNCEFACT"
}
}
]
}
]
}
}
]
}
Issues
Reporte issues para esta extensión en el repositorio de extensiones ocds, poniendo el nombre de la extensión en el título del issue.
Registro de cambios
2020-04-24
- Agregar las propiedades
minProperties
,minItems
y/ominLength
.
2019-03-20
- Establecer
"uniqueItems ": true
en los campos matriz y agregar"minLength": 1
en los campos de cadena obligatorios. - Hacer
Observation.unit
no nulo, comoItem.unit
. - Hacer
Observation.dimensions
no nulo (deshacer el cambio anterior).
2018-05-08
- Hacer
Metric.id
yObservation.id
obligatorios para soportar el seguimiento de revisiones y fusión de listas
2018-05-01
- Agregar título y descripción a
Observation.period
yObservation.value
. - Hacer que
Observation.dimensions
pueda ser nulo.