Visualizaciones

El módulo de visualizaciones permite activar ciertas visualizaciones predefinidas por Gobierto e incorporar visualizaciones específicas que no formen parte del código de Gobierto (a través de plugins).

Hay que seguir dos pasos para activar una visualización:

1 - preparar una URL con los datos
2 - activar la visualización en la configuración del módulo, donde indicaremos en un formato JSON qué visualizaciones vamos a habilitar. El contenido tiene esta forma, donde cada subnivel por debajo de visualizations corresponde a una visualización.

{
  "visualizations": {
    "contracts": {
       ...
    },
    "subsidies": {
       ...
    }, ....
  }
}

Visualización de contratos

El formato de datos que espera esta visualización es:

Contratos:

id: identificador único del contrato (texto)
title: título (texto)
permalink: enlace a la plataforma de contratación (texto)
batch_number: número de lote, si aplica (número)
start_date: fecha de inicio del contrato (fecha en formato YYYY-MM-DD)
end_date: fecha de fin del contrato (fecha en formato YYYY-MM-DD)
duration: duración del contrato en días
assignee: nombre de la entidad adjudicataria
assignee_type: tipo de la entidad adjudicataria
status: estado del contrato (texto)
initial_amount: cantidad inicial
initial_amount_no_taxes: cantidad inicial sin IVA
final_amount: cantidad final
final_amount_no_taxes: cantidad final sin IVA
contractor: nombre de la entidad adjudicadora
contractor_id: identificador de la entidad adjudicadora (NIF, DIR3...)
contractor_type: tipo de la entidad adjudicadora
contract_type: tipo de contrato
process_type: tipo de proceso
minor_contract: boolean que es true si es un contrato menor
cpvs: lista de cpvs separadas por coma
category_id: id de la categoría
category_title: nombre de la categoría
award_published_at: fecha de adjudicación del contrato (fecha en formato YYYY-MM-DD)

Licitaciones:

id: identificador único de la licitación (texto)
title: título (texto)
document_number: número de expediente (texto)
permalink: enlace a la plataforma de contratación (texto)
status: estado de la licitación (texto)
minor_contract: boolean que es true si es un contrato menor
contract_type: tipo de contrato
submission_date: fecha de fin envío de propuestas (fecha en formato YYYY-MM-DD)
open_proposals_date: fecha de inicio de envío de propuestas (fecha en formato YYYY-MM-DD)
number_of_proposals: número de propuestas recibidas
number_of_batches: número de lotes de la licitación (si aplica)
contractor: nombre de la entidad adjudicadora
contractor_id: identificador de la entidad adjudicadora (NIF, DIR3...)
contractor_type: tipo de la entidad adjudicadora
process_type: tipo de proceso
cpvs: lista de cpvs separadas por coma
category_id: id de la categoría
category_title: nombre de la categoría
initial_amount: cantidad inicial
initial_amount_no_taxes: cantidad inicial sin IVA
contract_value: valor del contrato

El fragmento de JSON que hay que utilizar para activar la visualización es:

    "contracts": {
      "enabled": true,
      "data_urls": {
        "tenders": "https://entidad.gobierto.es/api/v1/data/licitaciones.csv",
        "contracts": "https://entidad.gobierto.es/api/v1/data/contratos.csv"
      },
      "data_download_source": "/datos/contratos"
    }

Donde:

enabled (true o false): indica si está activada
data_urls indica las fuentes de los datos
data_download_source: permite introducir una URL desde la cuál se pueden descargar los datos

Visualización de subvenciones

El formato de datos que espera esta visualización es:

Subvenciones:

call: convocatoria (texto)
budget_line: partida presupuestaria (texto)
grant_date: fecha de la subvención (fecha en formato YYYY-MM-DD)
year: año de la subvención (número)
beneficiary: nombre de la persona o entidad beneficiaria (texto)
amount: cantidad (número)
category: categoría (texto opcional)
beneficiary_type: tipo de beneficiario. Puede ser "persona" o "colectivo"

El fragmento de JSON que hay que utilizar para activar la visualización es:

    "subsidies": {
      "enabled": true,
      "home": true,
      "data_urls": {
        "subsidies": "https://entidad.gobierto.es/api/v1/data/subvenciones.csv"
      },
      "data_download_source": "/datos/subvenciones"
    }

Donde:

enabled (true o false): indica si está activada
home (opcional: true o false): Indica si esta es la visualización por defecto del módulo. Esta será la que se verá en la home cuando el módulo está configurado para serlo.
data_urls indica las fuentes de los datos
data_download_source: permite introducir una URL desde la cuál se pueden descargar los datos