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 award y contract para objetivos que se acuerden con el proveedor ganador (ejemplo: niveles de disponibilidad o indicadores claves de rendimiento)
  • 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.

Example

Forecasts

{
  "forecasts":[
    {
      "id":"annualDemand",
      "title":"Annual Demand",
      "description":"The annual demand",
      "observations":[
        {
          "period":{
            "startDate":"2015-01-01T00:00:00Z",
            "endDate":"2015-12-31T23:59:59Z"
          },
          "quantity":"10000",
          "dimensions":{
            "vehicleType":"Car"
          }
        },
        {
          "period":{
            "startDate":"2015-01-01T00:00:00Z",
            "endDate":"2015-12-31T23:59:59Z"
          },
          "quantity":"1000",
          "dimensions":{
            "vehicleType":"Trucks"
          },
          "note":"Simple note"
        }
      ]
    }
  ]
}

Example

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:

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

Uso con requerimientos

Las métricas se pueden utilizar junto con la extensión de requisitos que agregará una propiedad 'relatedRequirementID' a las métricas.

Con la extensión de requerimientos, las ofertas, adjudicaciones y contratos pueden incluir un RequirementResponse indicando los valores contra cada métrica que un proveedor desea cumplir.

Esto puede permitir un cierto grado de comparación entre el rendimiento previsto en las fases de licitación, adjudicación, contrato y ejecución.

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.

Changelog

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.