Obtener filas

Puedes recuperar una fila individual o múltiples filas de datos de una tabla en el Catalyst Data Store. El objeto table utilizado en estos fragmentos de código está definido en la página de instancia del componente.

Obtener un objeto de fila

Antes de obtener una fila de una tabla en el Data Store, primero debes crear un objeto de fila para ella usando el Row ID único de la fila como se muestra a continuación. Esto no realizará una llamada del lado del servidor.

//Create a row object using the Rowid
var datastore = catalyst.table; 
var table = datastore.tableId("ShipmentTracking"); 
var row = table.rowId("12781121212121");

Obtener una fila individual

Ahora puedes obtener una fila individual de una tabla usando el método get(). Debes pasar el Row ID único de la fila al objeto de fila que creaste en la sección anterior, como se muestra a continuación.

La promesa devuelta aquí se resolverá a un objeto JSON de fila, en el cual la clave content contiene un objeto de fila.

//Fetch the row details by passing the row ID to the row object 
var datastore = catalyst.table; 
var table = datastore.tableId('ShipmentTracking'); 
var row = table.rowId("12781121212121"); 
var rowPromise = row.get();
rowPromise.then((response) => { console.log(response.content); }) .catch((err) => { console.log(err); });

A continuación se muestra una respuesta de ejemplo que recibirás. La respuesta es la misma para todas las versiones del Web SDK.

{
CREATORID: "2136000000006003",
MODIFIEDTIME: "2021-08-17 13:02:11:184",
CREATEDTIME: "2021-08-16 16:29:10:499",
CityName: "Pune",
ROWID: "2136000000011011"
}

Obtener todas las filas mediante paginación

Puedes recuperar todas las filas de datos de una tabla en el Data Store incorporando paginación en tu código usando la función getPagedRows(). La paginación te permite obtener las filas de una tabla en lotes o páginas a través de iteraciones.

Esta iteración se ejecuta hasta que se obtienen todas las filas, lo cual se valida mediante hasNext, como se muestra en el código de ejemplo a continuación. Puedes hacer referencia a la tabla por su Table ID único o nombre.

Por ejemplo, si necesitas que las filas se obtengan en lotes de 100 como páginas individuales, puedes especificar el conteo del parámetro max_rows como 100, como se muestra a continuación.

Además, después de cada ejecución del bucle, recibirás una cadena de token en los datos de respuesta que autoriza la obtención posterior de datos. Debes pasar este token a través del parámetro next_token durante la iteración posterior, como se muestra a continuación. Durante la primera ejecución del bucle, el valor para la cadena next_token se asigna como undefined. El siguiente conjunto de registros se obtiene a través de more_records en los datos de respuesta.

{
if (!hasNext) {
return;
} 
catalyst.table
.tableId('userDetails') //Specify the Table ID or Table name of the table to fetch the records from
.getPagedRows({ next_token, max_rows: 100 }) //Definir el máximo de filas a obtener en una sola página and pass it along with nextToken
.then(resp => {
console.log('rows : ', resp.content); //Obtener las filas de la tabla
return getMyPagedRows(resp.more_records, resp.next_token); //Obtener el siguiente conjunto de registros y la cadena de token para la siguiente iteración
})
.catch((err) => {
console.log(err.toString());
}); 
}

A continuación se muestra una respuesta de ejemplo que recibirás si hay más registros disponibles. El parámetro more_records se establecerá en true en este caso.

Web SDK v3.1.0

{
"status": 200,
"content": [
{
"CREATORID": "3359000000006003",
"MODIFIEDTIME": "2022-01-11 18:18:24:855",
"name": "raj",
"CREATEDTIME": "2022-01-11 18:18:24:855",
"ROWID": "3359000000108111"
},
{
"CREATORID": "3359000000006003",
"MODIFIEDTIME": "2022-01-11 18:18:25:117",
"name": "raj",
"CREATEDTIME": "2022-01-11 18:18:25:117",
"ROWID": "3359000000108114"
},
{
"CREATORID": "3359000000006003",
"MODIFIEDTIME": "2022-01-11 18:18:25:120",
"name": "raj",
"CREATEDTIME": "2022-01-11 18:18:25:120",
"ROWID": "3359000000108117"
}
],
"message": "OK",
"more_records": true,
"next_token": "{{token}}"
}

A continuación se muestra una respuesta de ejemplo que recibirás si no hay más registros disponibles. El parámetro more_records se establecerá en false en este caso.

{
"status": 200,
"content": [
{
"CREATORID": "3359000000006003",
"MODIFIEDTIME": "2022-01-11 18:18:43:556",
"name": "raj99",
"CREATEDTIME": "2022-01-11 18:18:43:556",
"ROWID": "3359000000108410"
},
{
"CREATORID": "3359000000006003",
"MODIFIEDTIME": "2022-01-11 18:18:43:557",
"name": "raj98",
"CREATEDTIME": "2022-01-11 18:18:43:557",
"ROWID": "3359000000108413"
},
{
"CREATORID": "3359000000006003",
"MODIFIEDTIME": "2022-01-11 18:18:43:568",
"name": "raj96",
"CREATEDTIME": "2022-01-11 18:18:43:568",
"ROWID": "3359000000108417"
}
],
"message": "OK",
"more_records": false
}