15.3 Configuración de sourceCode y customSource

Configuración de sourceCode

 
El sourceCode se refiere al método desde el cual se extraerán los datos para alimentar cada ítem, este método consiste en una query o consulta a la base de datos.
{
        "type": "DB",
        "method": "SELECT a.nombre, a.usuario_creador, to_char(a.fec_creacion, 'dd/MM/yyyy HH24:MI:ss') as fec_creacion from motor.accion a, gestion.usuario u WHERE a.id_cliente = #idOperacion# and a.usuario_creador = u.usuario and to_char(a.fec_creacion, 'yyyy-MM-dd') > '#fechaDesde#';",
        "outputFields": [
            {
                "name": "nombre",
                "label": "Nombre"
            },
            {
                "name": "usuario_creador",
                "label": "Usuario"
            },
            {
                "name": "fec_creacion",
                "label": "Fecha Creacion"
            }
        ]
}
Parámetro
Descripción
type
Por ahora no tiene ninguna lógica, pero eventualmente podría referirse a diferentes fuentes de datos como Elastic o Redis, estableciendo parámetros de conexión, etc.
method
Query a ejecutar.
• En cada query se reemplazan los valores entre # (ejemplo #fechaDesde#) por el valor de dicha key si existe dentro de los filtros disponibles.
• Los filtros se llenan con variables de “entorno” como idUsuario, idOperacion y los valores de los filtros o inputs llenados por el usuario bajo su respectiva key definida en la configuración de dicho ítem.
• Si en la query se desea evaluar un STRING, la key a reemplazar debe aparecer entre comillas simples (ejemplo ‘#fechaDesde#’).
outputFields
Formato de salida de la query.
• name: se refiere al nombre de la columna que se obtiene de la query.
• label: texto utilizado  por los gráficos y tablas para contextualizar lo que representa cada columna.
 

Configuración de customSource

Es una alternativa al sourceCode y al dummy. Se utiliza cuando la lógica para llenar un ítem requiere hacerlo en otra API.
"customSource": {
          "source": "PNG_API",
          "api": "dashboard/wom_co/provi_getConfigMapa",
           "params": {
                        "customParam1": "value1",
                        "customParam2": "value2"
           }
}
Parámetro
Descripción
source
Tipo de fuente para determinar qué lógica aplicar. Por ahora solo es PNG_API.
api
Endpoint o método con el que llamar a la API.
• Si source es PNG_API, representa al JSON a ejecutar.
params
Payload con variables predeterminadas para enviar a la API.
• Si source es PNG_API, forma parte de los parameters a enviar.
• Consta de 2 objetos:
◦ params: mezcla del params del customSource y los parámetros globales (obtenidos por los inputs o fórmulas).
◦ itemConf: configuración del ítem a llenar.