Exportar (0) Imprimir
Expandir todo

table (objeto)

Actualizado: febrero de 2015

Proporciona funcionalidad para trabajar con tablas específicas.

del(itemOrId, options)
Elimina un itemID especificado de la tabla.

Parámetros

Nombre Tipo Argumento Descripción

itemOrId

objeto

elemento que desea eliminar

opciones

parámetro de devolución de llamada

insert(item, options)
Inserta el item especificado en la tabla.

Parámetros

Nombre Tipo Argumento Descripción

item

objeto

elemento para insertar

opciones

parámetro de devolución de llamada

orderBy(arg1, arg2, …)
Devuelve una instancia de Query (objeto) donde la consulta está ordenada por los argumentos de nombre de columna proporcionados, en orden ascendente.

Parámetros

Nombre Tipo Argumento Descripción

Arg1

string

Columnas principales para ordenar por

Arg2

string

opcional, ya que son más nombres de columna

Próxima columna para ordenar por

orderByDescending(arg1, arg2, …)
Devuelve una instancia de Query (objeto) donde la consulta está ordenada por los argumentos de nombre de columna proporcionados, en orden descendente.

Parámetros

Nombre Tipo Argumento Descripción

Arg1

string

Columnas principales para ordenar por

Arg2

string

opcional, ya que son más nombres de columna

Próxima columna para ordenar por

Read (options)
Lee todos los datos de la tabla e invoca el controlador de operación correcta especificado en el parámetro options que pasa una matriz de resultados.

ImportantImportante
No debe llamar al método read en tablas de tamaño ilimitado.

Parámetros

Nombre Tipo Argumento Descripción

opciones

parámetro de devolución de llamada

select(string)
Devuelve una instancia de Query (objeto) a la que se ha aplicado la proyección de string solicitada.

Parámetros

Nombre Tipo Argumento Descripción

string

lista de cadenas delimitada por comas

nombres de columnas para devolver, delimitados por comillas simples, separados por comas

select(function)
Devuelve una instancia de Query (objeto) a la que se ha aplicado la proyección de string solicitada.

Parámetros

Nombre Tipo Argumento Descripción

función

función

Devuelve una instancia de Query (objeto) a la que se ha aplicado la proyección de function solicitada. En la definición de función, la palabra clave this tiene acceso a una fila, el operador punto tiene acceso a una columna y las funciones de JavaScript pueden aplicarse a ellos.

skip(recordCount)
Devuelve una instancia de Query (objeto) que omite el primer número de registros recordCount.

Parámetros

Nombre Tipo Argumento Descripción

recordCount

integer

Número de registros que se van a omitir

take(recordCount)
Devuelve una instancia de Query (objeto) que devuelve el número de registros recordCount.

Parámetros

Nombre Tipo Argumento Descripción

recordCount

integer

Número de registros que se van a devolver

where(object)
Devuelve una instancia de Query (objeto) filtrada según los valores de propiedad del object JSON especificado.

Parámetros

Nombre Tipo Argumento Descripción

Objeto

objeto

Objeto JSON con valores de propiedad para filtrar

where(function)
Devuelve una instancia de Query (objeto) filtrada según el valor de función especificado.

Parámetros

Nombre Tipo Argumento Descripción

función

función

Devuelve una instancia de Query (objeto) a la que se ha aplicado el filtro de function solicitado. En la definición de función, la palabra clave this tiene acceso a una fila, el operador punto tiene acceso a una columna y las funciones de JavaScript pueden aplicarse a ellos.

update(item, options)
Inserta el item especificado en la tabla.

Parámetros

Nombre Tipo Argumento Descripción

item

objeto

elemento para insertar

opciones

función de devolución de llamada

Los métodos insert, update y del aceptan un objeto options, que puede tener definidos controladores de operación correcta o con errores.

Los métodos de consulta (orderBy, orderByDescending, select, skip, take y where) devuelven un Query (objeto). Este objeto expone estos mismos métodos, lo que permite componer consultas como una serie de llamadas de método.

Aquí se indican algunos ejemplos:

  1. Consulta de proyección que devuelve las columnas seleccionadas

  2. Filtro Where

  3. Código TSQL con filtros

Este script muestra cómo ejecutar una consulta de proyección que devuelva solo las columnas seleccionadas. El parámetro read muestra cómo se codifica el parámetro options.

    var tableName = tables.getTable("TodoItem");
    console.log("table name is " + tableName);
    tableName.select('text', 'complete')
        .read(
            { success: function(results) {
                if (results.length > 0) {
                    console.log(results);
                } else {
                    console.log('no results returned');
                }
            }
        });;

El script siguiente llama al método where para filtrar las filas devueltas por los valores de objeto suministrados. Cuando se devuelve al menos un registro, se supone que el usuario tiene el permiso necesario para enviar un pedido y se ejecuta la inserción; de lo contrario, se devuelve un error.

function insert(item, user, request) {
    var permissionsTable = tables.getTable('permissions');

    permissionsTable.where({
        userId: user.userId,
        permission: 'submit order'
    }).read({
        success: function(results) {
            if (results.length > 0) {
                // Permission record was found. Continue normal execution.
                request.execute();
            } else {
                console.log('User %s attempted to submit an order without permissions.', user.userId);
                request.respond(statusCodes.FORBIDDEN, 'You do not have permission to submit orders.');
            }
        }
    });
}

Este ejemplo muestra cómo llamar a un select con un parámetro de función.

    tableName.select(function() { return this.id.substring(2,5) })
    .read(
        { success: function(results) { 
                if (results.length > 0) {
                    console.log(results);
                } else {
                    console.log('no results returned');
                }
            }});

La función siguiente, de un trabajo programado, ejecuta código Transact-SQL que devuelve las filas duplicadas y después usa el método del para quitar los duplicados.

function cleanup_channels() {
    var sql = "SELECT MAX(Id) as Id, Uri FROM Channel " + 
        "GROUP BY Uri HAVING COUNT(*) > 1";
    var channelTable = tables.getTable('Channel');

    mssql.query(sql, {
        success: function(results) {
            if (results.length > 0) {
                for (var i = 0; i < results.length; i++) {
                    channelTable.del(results[i].Id);
                    console.log('Deleted duplicate channel:' + 
                    results[i].Uri);
                }
            } else {
                console.log('No duplicate rows found.');
            }
        }
    });
}

Mostrar:
© 2015 Microsoft