Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

objeto de tabla

 

Proporciona funcionalidad para trabajar con tablas específicas.


SUPR (itemOrId, opciones)

Elimina un objeto itemID de la tabla.

Parámetros

Name

Tipo de

Argumento

Descripción

itemOrId

OBJECT

elemento que se va a eliminar

Opciones

parámetro de devolución de llamada

Insert (elemento, opciones)

Inserta el objeto item en la tabla.

Parámetros

Name

Tipo de

Argumento

Descripción

elemento

OBJECT

elemento que se va a insertar

Opciones

parámetro de devolución de llamada

orderBy (arg1, arg2,...)

Devuelve un objeto Query instancia donde la consulta está ordenada por los argumentos de nombre de columna proporcionados, en orden ascendente.

Parámetros

Name

Tipo de

Argumento

Descripción

Arg1

cadena

Columnas principales para ordenar por

Arg2

cadena

opcionales, como son más nombres de columna

Próxima columna para ordenar por

orderByDescending (arg1, arg2,...)

Devuelve un objeto Query instancia donde la consulta está ordenada por los argumentos de nombre de columna proporcionados, en orden descendente.

Parámetros

Name

Tipo de

Argumento

Descripción

Arg1

cadena

Columnas principales para ordenar por

Arg2

cadena

opcionales, como son más nombres de columna

Próxima columna para ordenar por

Lectura (opciones)

Lee todos los datos de la tabla y se invoca el controlador correcto especificado en el options parámetro pasando una matriz de resultados.

System_CAPS_importantImportante

No debe llamar a la read método en tablas de tamaño ilimitado.

Parámetros

Name

Tipo de

Argumento

Descripción

Opciones

parámetro de devolución de llamada

Select(String)

Devuelve un objeto Query instancia con solicitado string aplicado la proyección.

Parámetros

Name

Tipo de

Argumento

Descripción

cadena

lista de cadena delimitada por comas

devolver, delimitados por comillas simples, separados por comas de nombres de columna

Select(Function)

Devuelve un objeto Query instancia con solicitado string aplicado la proyección.

Parámetros

Name

Tipo de

Argumento

Descripción

(función)

(función)

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

Skip(recordCount)

Devuelve un objeto Query instancia que omite los primeros recordCount número de registros.

Parámetros

Name

Tipo de

Argumento

Descripción

recordCount

INTEGER

Número de registros que se van a omitir

Take(recordCount)

Devuelve un objeto Query instancia que devuelve la recordCount número de registros.

Parámetros

Name

Tipo de

Argumento

Descripción

recordCount

INTEGER

Número de registros que se va a devolver

WHERE(Object)

Devuelve un objeto Query instancia que se filtra según los valores de propiedad de JSON proporcionado object.

Parámetros

Name

Tipo de

Argumento

Descripción

OBJECT

OBJECT

Objeto JSON con valores de propiedad para filtrar

WHERE(Function)

Devuelve un objeto Query instancia que se filtra según proporcionado función.

Parámetros

Name

Tipo de

Argumento

Descripción

(función)

(función)

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

Update (elemento, opciones)

Inserta el objeto item en la tabla.

Parámetros

Name

Tipo de

Argumento

Descripción

elemento

OBJECT

elemento que se va a insertar

Opciones

función de devolución de llamada

Insertar, actualizar, y SUPR métodos aceptan un options objeto, que puede tener éxito o error de los controladores definidos.

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

Estos son algunos ejemplos:

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

  2. Filtro WHERE

  3. Código TSQL con filtros

Ejemplo

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

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');
            }
        }
    });;

Ejemplo

El siguiente script llama el where método para filtrar las filas devueltas por los valores del objeto proporcionado. Cuando se devuelve al menos un registro, se supone que el usuario tiene los permisos necesarios para enviar un pedido y la inserción se ejecuta; 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.');
            }
        }
    });
}

Ejemplo

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');
            }
        }});

Ejemplo

La siguiente función, de un trabajo programado, ejecuta Transact-SQL que devuelve filas duplicadas y, a continuación, usa el del método 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: