Tabla Master Db

Tipo de widget

En el esquema se representa como

"widget_type": "MASTER_DB_TABLE"

Lectura

A la hora de leer este tipo de widget, obtenemos un valor de tipo object que se especifica a continuacion.

El objeto JSON tiene dos campos "rows" y "totals". Donde rows es un array de Objetos Json.

rows

Los fields "numericos" (aunque son strings). representan las columnas en la Master Db correspondiente. El "1" es el identificador del elemento dentro de la tabla. Ver la sección Master Db para comprender los campos.

Los fields que comienzan con "USER_COL" son las columnas extras que fueron completadas por el usuario final, ya sea desde la web o desde el celular. Si bien las columnas pueden ser de varios tipos (Numero, Texto, Lista), los resultados obtenidos son siempre en formato string.

totals

Los fields comienzan todos con USER_TOTAL y representan los campos totales que fueron completados por el usuario desde la web o desde el celular. Al igual que las columnas mencionadas anteriormente, los resultados son todos de tipo string mas alla que los campos puedan ser de diferentes tipos.

{
    ...
    "FW9ilaip": {
        "rows": [{
	    "1": "ABC9893821",
            "2": "Destornillador phillips",
            "5": "Rojo",
            "6": "55",
            "USER_COL_VDJD1649708416806": "Me pidieron 5",
	    "USER_COL_CxbS1649708422321": "18.32",
	    "USER_COL_jBVx1649708426690": "Blanco"
	},
	{
	    "1": "DJKS2321DDC",
            "2": "Llave de 10",
            "5": "Plateado",
            "6": "30",
            "USER_COL_VDJD1649708416806": "No me especifico bien",
	    "USER_COL_CxbS1649708422321": "45.30",
	    "USER_COL_jBVx1649708426690": "Rojo"
        }
	],
	"totals": {
            "USER_TOTAL_DbOq1649708498075": "Se aplica descuento",
            "USER_TOTAL_bCpo1649708492977": "5",
            "USER_TOTAL_OjNg1649708485631": "563.32"
	}
    },
    ...
}

Escritura

Cuando insertamos un formulario, en el field correspondiente a este widget, debemos colocar un objeto similar al que se explica arriba, con fields rows y totals

rows

Es un array de objetos Json con los siguientes fields

rows[x].field_1: Es el identificador del elemento de la Master Db que queremos insertar. Debe ser un elemento que exista en la tabla, caso contrario obtendremos como respuesta 404 NOT FOUND.

rows[x].USER_COL_......: El valor de cada una de las columnas configuradas en la plantilla del formulario. Si bien las columnas son de distintos tipos (NUMERO, TEXTO, LISTA, CALCULADO), debemos enviar siempre valores de tipo string.

En el caso particular de que la columna sea de tipo lista, el valor que enviamos debe ser una opción válida de dicha lista, caso contrario obtendremos como respuesta 400 BAD REQUEST

En el caso de que haya un CAMPO CALCULADO. El calculo no se realizará cuando la inserción se hace desde la API, es decir, todo pasa como si fuese un CAMPO TEXTO, y hay que enviar el valor a guardar.

totals

Es un objeto JSON en donde cada uno de los fields representa un campo total a insertar. Sin importar los tipos de campo, se deben enviar valores de tipo string.

En el caso particular de un campo total de tipo lista, el valor que enviamos debe ser una opción válida de dicha lista, caso contrario obtendremos como respuesta 400 BAD REQUEST

En el caso de que haya un CAMPO CALCULADO. El calculo no se realizará cuando la inserción se hace desde la API, es decir, todo pasa como si fuese un CAMPO TEXTO, y hay que enviar el valor a guardar.

{
    ...
    "FW9ilaip": {
        "rows": [{
	    "field_1": "ABC9893821",
            "USER_COL_VDJD1649708416806": "Me pidieron 5",
	    "USER_COL_CxbS1649708422321": "18.32",
	    "USER_COL_jBVx1649708426690": "Blanco"
	},
	{
	    "field_1": "DJKS2321DDC",
            "USER_COL_VDJD1649708416806": "No me especifico bien",
	    "USER_COL_CxbS1649708422321": "45.30",
	    "USER_COL_jBVx1649708426690": "Rojo"
        }
	],
	"totals": {
            "USER_TOTAL_DbOq1649708498075": "Se aplica descuento",
            "USER_TOTAL_bCpo1649708492977": "5",
            "USER_TOTAL_OjNg1649708485631": "563.32"
	}
    },
    ...
}

Se puede enviar un valor vacio, indicando que la tabla no tiene ninguna fila

"rows": []. Sin embargo totals no puede estar vacio