Cadena de consulta

Contenido

Operadores y funciones de consulta

Operadores de consulta

OPERADOR SAMPLE REGISTROS RESPONDIDOS
= string_0 = "test" Registra dónde coinciden el valor de la línea de campo antes del operador y la cadena después del operador.
!= string_0 != "test" Registros en los que el valor de la línea de campo antes del operador y la cadena después del operador no coinciden.
> number_0 > 10 Registros en los que el valor de la línea de campo antes del operador es mayor que el valor después del operador.
< number_0 < 10 Registros en los que el valor de la línea de campo antes del operador es menor que el valor después del operador.
>= number_0 >= 10 Registros en los que el valor de la línea de campo antes del operador es mayor o igual que el valor después del operador.
<= number_0 <= 10 Registros en los que el valor de la línea de campo antes del operador es menor o igual que el valor después del operador.
in dropdown_0 in ("A", "B") Registros en los que el valor de la línea de campo antes del operador coincide con cualquiera de las cadenas enumeradas entre corchetes después del operador.

Esta expresión se puede utilizar para buscar qué opciones se han seleccionado para los campos que tienen varias selecciones, como Menú desplegable campos y Botón de opción Campos.

La muestra de la izquierda responde a los registros en los que se han seleccionado las opciones "A" o "B" para el campo "dropdown_0".
not in dropdown_0 not in ("A", "B") Registros en los que el valor de la línea de campo antes del operador no coincide con ninguna de las cadenas enumeradas entre corchetes después del operador.

Esta expresión se puede utilizar para buscar qué opciones no se han seleccionado para los campos que tienen varias selecciones, como Menú desplegable campos y Botón de opción Campos.

El ejemplo de la izquierda responde a los registros en los que no se han seleccionado las opciones "A" o "B" para el campo "dropdown_0".
like Single_line_text_0 like "test" Registros en los que la cadena después del operador se incluye en el valor de línea de campo antes del operador.

Si se especifica un campo Datos adjuntos, se responderán los registros en los que la cadena después del operador se incluya en el nombre del archivo o en el contenido del archivo.

Consulte el siguiente artículo de la Ayuda de Kintone para obtener información sobre los símbolos que no se pueden utilizar:
Puntos a tener en cuenta al introducir palabras clave de búsqueda (External link)
not like Single_line_text_0 not like "test" Registros en los que la cadena después del operador no se incluye en el valor de línea de campo después del operador.

Consulte el siguiente artículo de la Ayuda de Kintone para obtener información sobre los símbolos que no se pueden utilizar:
Puntos a tener en cuenta al introducir palabras clave de búsqueda (External link)
o number_0 < 10 or number_0 > 20 Registros en los que la expresión a ambos lados de la o es cierto.

El ejemplo de la izquierda responde a los registros en los que el valor de "number_0" es menor que 10 o mayor que 20.
and number_0 >= 10 and number_0 <= 20 Registros en los que la expresión a ambos lados de la y es cierto.

La muestra de la izquierda responde a los registros en los que el valor de "number_0" es mayor o igual que 10 y menor o igual que 20.
  • Los códigos de campo deben colocarse antes del operador, no después de él.
  • Las fórmulas se pueden agrupar utilizando corchetes "()", por ejemplo: (number_0 >= 10 and number_0 <= 20) or (number_1 >= 100 and number_1 <= 200)

Funciones de consulta

FUNCIÓN SAMPLE DESCRIPCIÓN
LOGINUSER() author in (LOGINUSER()) Se convierte en el usuario que inicia la API.
PRIMARY_ORGANIZATION() department in (PRIMARY_ORGANIZATION()) Se convierte en el departamento de prioridad del usuario que inicia la API.
NOW() created_datetime = NOW() Se convierte en la fecha y hora en que se inició la API.
TODAY() created_datetime = TODAY() Se convierte en la fecha en la que se inició la API.
AYER() created_datetime = YESTERDAY() Se convierte a la fecha 1 día anterior a que se iniciara la API.
TOMORROW() Date = TOMORROW() Se convierte a la fecha 1 día después de que se inició la API.
FROM_TODAY(número, punto) created_datetime < FROM_TODAY(5, "DAYS") Se pueden especificar los siguientes períodos:
  • DAYS
  • WEEKS
  • MONTHS
  • YEARS
THIS_WEEK() created_datetime = THIS_WEEK(SUNDAY) Se convierte en el día especificado de esta semana. Las semanas comienzan a partir de un domingo. Si no se especifica nada, se convierte en todos los días de esta semana, a partir del domingo.
Se pueden establecer los siguientes días de la semana:
  • SUNDAY
  • MONDAY
  • TUESDAY
  • WEDNESDAY
  • THURSDAY
  • FRIDAY
  • SATURDAY
LAST_WEEK() created_datetime = LAST_WEEK() Se convierte al día especificado de la semana anterior. Las semanas comienzan a partir de un domingo. Si no se especifica nada, se convierte en todos los días de la semana anterior, a partir del domingo.
Se pueden establecer los siguientes días de la semana:
  • SUNDAY
  • MONDAY
  • TUESDAY
  • WEDNESDAY
  • THURSDAY
  • FRIDAY
  • SATURDAY
NEXT_WEEK() created_datetime = NEXT_WEEK() Se convierte en el día especificado de la semana siguiente. Las semanas comienzan a partir de un domingo. Si no se especifica nada, se convierte en todos los días de la semana siguiente, a partir del domingo.
Se pueden establecer los siguientes días de la semana:
  • SUNDAY
  • MONDAY
  • TUESDAY
  • WEDNESDAY
  • THURSDAY
  • FRIDAY
  • SATURDAY
THIS_MONTH(número o texto)
  • Todos los días de este mes
    created_datetime = THIS_MONTH()
  • Día 23 de este mes
    created_datetime = THIS_MONTH(23)
  • Último día de este mes
    created_datetime = THIS_MONTH(LAST)
Se convierte en el mes en que se inició la API.
Se puede especificar lo siguiente:
  • Números del 1 al 31 : el día del mes. Si el número no existe, se convertirá al primer día del mes siguiente.
  • LAST : el último día del mes.
LAST_MONTH (número o texto)
  • Todos los días del mes anterior
    created_datetime = LAST_MONTH()
  • Día 23 del mes anterior
    created_datetime = LAST_MONTH(23)
  • Último día del mes anterior
    created_datetime = LAST_MONTH(LAST)
Se convierte al mes anterior al momento en que se inició la API.
Se puede especificar lo siguiente:
  • Números del 1 al 31 : el día del mes anterior. Si el número no existe, se convertirá al primer día del mes siguiente.
  • LAST : el último día del mes anterior.
NEXT_MONTH(número o texto)
  • Todos los días del mes siguiente
    Date = NEXT_MONTH()
  • Día 23 del mes siguiente
    Date = NEXT_MONTH(23)
  • Último día del mes siguiente
    Date = NEXT_MONTH(LAST)
Se convierte al mes siguiente de cuando se inició la API.
Se puede especificar lo siguiente:
  • Números del 1 al 31 : el día del mes anterior. Si el número no existe, se convertirá al primer día del mes siguiente.
  • LAST : el último día del mes anterior.
THIS_YEAR() created_datetime = THIS_YEAR() Se convierte en el año en que se inició la API.
LAST_YEAR() created_datetime = LAST_YEAR() Se convierte en el año anterior a la creación de la API.
NEXT_YEAR() Date = NEXT_YEAR() Se convierte en el año posterior a la creación de la API.

Operadores y funciones disponibles para cada campo

CAMPO OPERACIONES FUNCIONES
Número de registro = != > < >= <= in not in
$id = != > < >= <= in not in
Creado por in not in LOGINUSER()
Fecha y hora creada = != > < >= <= NOW()
TODAY()
AYER()
TOMORROW()
FROM_TODAY()
THIS_WEEK()
LAST_WEEK()
NEXT_WEEK()
LAST_MONTH()
NEXT_MONTH()
THIS_YEAR()
LAST_YEAR()
NEXT_YEAR()
Actualizado por in not in LOGINUSER()
Fecha y hora actualizada = != > < >= <= NOW()
TODAY()
AYER()
TOMORROW()
FROM_TODAY()
THIS_WEEK()
LAST_WEEK()
NEXT_WEEK()
LAST_MONTH()
NEXT_MONTH()
THIS_YEAR()
LAST_YEAR()
NEXT_YEAR()
Mensaje de texto = != in not in like not like
Enlace = != in not in like not like
Número = != > < >= <= in not in
Calculado = != > < >= <= in not in
Área de texto like not like
Texto enriquecido like not like
Casilla de verificación in not in
Botón de opción in not in
Menú desplegable in not in
Opción múltiple in not in
Archivo adjunto like not like
Fecha = != > < >= <= TODAY()
AYER()
TOMORROW()
FROM_TODAY()
THIS_WEEK()
LAST_WEEK()
NEXT_WEEK()
THIS_MONTH()
LAST_MONTH()
NEXT_MONTH()
THIS_YEAR()
LAST_YEAR()
NEXT_YEAR()
Hora = != > < >= <=
Fecha y hora = != > < >= <= NOW()
TODAY()
AYER()
TOMORROW()
FROM_TODAY()
THIS_WEEK()
LAST_WEEK()
NEXT_WEEK()
LAST_MONTH()
NEXT_MONTH()
THIS_YEAR()
LAST_YEAR()
NEXT_YEAR()
Selección de usuarios in not in LOGINUSER()
Selección de departamentos in not in PRIMARY_ORGANIZATION()
Selección de grupos in not in
Estado = != in not in
Búsqueda Igual que el tipo de campo que está buscando. Igual que el tipo de campo que está buscando.
Registros relacionados Igual que el tipo de campo del campo Aplicación de origen de datos.
= y != Los operadores son inutilizables y deben reemplazarse por operadores in y not in.
Igual que el tipo de campo del campo Aplicación de origen de datos.
Campos dentro de las tablas Igual que el tipo de campo del campo de la tabla.
= y != Los operadores son inutilizables y deben reemplazarse por operadores in y not in.
Igual que el tipo de campo del campo de la tabla.
Grupo No disponible
Categoría No disponible
  • Especifique los campos dentro de la carpeta Registros relacionados con el siguiente formato:
    relatedrecords.specifiedfield Dónde Registros relacionados es la línea de campo de la Registros relacionados campo, y Campo especificado es la línea de campo del campo especificado.

Opciones de consulta

Las siguientes opciones se pueden utilizar en conjunto.

OPCIÓN SAMPLE DESCRIPCIÓN
Ordenar por order by Updated_Datetime asc El orden de los registros se ordena en función del valor del código de campo después de esta opción. asc ordena los registros en orden ascendente, y desc Ordena los registros en orden descendente. Para especificar criterios de ordenación en varios campos, sepárelos con comas.
p. ej.. order by fieldcode1 desc, fieldcode2 asc
limit limit 20 El número de registros generados viene determinado por el valor que sigue a esta opción. El número inicial es de 100 registros y el máximo es de 500.
compensar offset 30 De este modo, se omite la salida del primer número de registros. En el ejemplo de la izquierda se omiten los primeros 30 registros y se obtiene el registro número 31. El máximo es 10000.

Personajes de escape

Consultar parámetros confidenciales como: " (comillas dobles) y \ (barras invertidas) debe escaparse correctamente mediante un \ Barra diagonal inversa cuando se incluye en una cadena de consulta para los siguientes campos:

  • Mensaje de texto
  • Área de texto
  • Texto enriquecido
  • Casilla de verificación
  • Botón de opción
  • Menú desplegable
  • Opción múltiple
  • Estado

Consultas de ejemplo que contienen caracteres de escape

En este ejemplo, un campo de casilla de verificación con el código de campo Checkbox se consulta. El valor de la casilla de verificación es sample"1", que incluye comillas dobles y, por lo tanto, debe escaparse correctamente.

1
Checkbox in ("sample\"1\"")

Del mismo modo, este campo de casilla de verificación tiene un valor de sample\2\, lo que requiere que se escapen los caracteres de barra diagonal inversa.

1
Checkbox in ("sample\\2\\")

Al utilizar la función Kintone REST API, los caracteres confidenciales también deben escaparse dentro del JSON del cuerpo de la solicitud y requieren barras diagonales inversas adicionales. En el siguiente ejemplo, para enviar el valor sample"1" en el cuerpo de una solicitud, tenga en cuenta que JavaScript requiere una barra diagonal inversa para escapar, además del escape requerido para las cadenas de consulta de Kintone.

1
2
3
4
const body = {
  app: kintone.app.getId(),
  query: 'Checkbox in ("sample\\"1\\"")'
};

Del mismo modo, el envío del valor sample\1\ también requiere un carácter de escape para JavaScript y otro para la cadena de consulta de Kintone.

1
2
3
4
const body = {
  app: kintone.app.getId(),
  query: 'Checkbox in ("sample\\\\1\\\\")'
};

Consultas de ejemplo

Ejemplo 1

  • El campo Mensaje de texto Incluye la cadena "sample"
  • El campo Text_area Incluye la cadena "sample"
  • Los resultados se enumeran en orden descendente del campo Created_datetime
1
Text like "sample" and Text_area like "sample" order by Created_datetime desc

Ejemplo 2

  • El campo Drop_down incluye los valores "valor1" o "valor2"
  • El campo Multi_choice incluye el valor "value3" o el campo Radio_button Incluye el valor "value4"
1
Drop_down in ("value1", "value2") and (Multi_choice in ("value3") or Radio_button in ("value4"))

Ejemplo 3

  • El campo Hora es mayor que el valor "10:00"
  • El campo Hora es menor que el valor "19:00"
  • El campo Created_datetime es igual a la fecha de hoy
  • los resultados se enumeran en orden ascendente del campo Número de registro
  • Solo se emiten hasta los primeros 10 resultados
1
Time > 10:00 and Time < 19:00 and Created_datetime = TODAY() order by $id asc limit 10

Ejemplo 4

  • El usuario que ejecuta la llamada a la API se incluye en el campo User_selection
  • El departamento prioritario del usuario que ejecuta la llamada a la API no se incluye en el campo Department_selection
1
User_selection in (LOGINUSER()) and Department_selection not in (PRIMARY_ORGANIZATION())

Ejemplo 5

  • El campo company_name dentro del campo Company_DB (un campo Registros relacionados) tiene un valor igual a "kintone"
  • El campo ubicación dentro del campo Company_DB (un campo Registros relacionados) incluye la cadena "San Francisco"
1
Company_DB.company_name in ("kintone") and Company_DB.location like "San Francisco"