Documentación

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)
  • The awards and contracts stages for targets agreed with the successful supplier (e.g. availability levels or KPIs)
  • La etapa implementation para la información de desempeño actual (por ejemplo: demanda actual, disponibilidad o indicadores claves de rendimiento)

Cuando la extensión de métricas se utiliza para modelar objetivos para un proceso de contratación, el campo description puede utilizarse para iniciar si el objetivo es un objetivo mínimo o recomendado.

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"
          }
        ]
      }
    ]
  }
}

Physical progress

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

  • Add minProperties, minItems and/or minLength properties.

2019-03-20

  • Set "uniqueItems": true on array fields, and add "minLength": 1 on required string fields.
  • Make Observation.unit non-nullable, like Item.unit.
  • Make Observation.dimensions non-nullable (undo earlier change).

2018-05-08

  • Make Metric.id and Observation.id required to support revision tracking and list merging

2018-05-01

  • Add title and description to Observation.period and Observation.value.
  • Make Observation.dimensions nullable.