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. Para obtener información sobre los símbolos que no se pueden utilizar, consulte el siguiente artículo del sitio de Ayuda de Kintone: Al buscar con caracteres especiales
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. Para obtener información sobre los símbolos que no se pueden utilizar, consulte el siguiente artículo del sitio de Ayuda de Kintone: Al buscar con caracteres especiales
or	number_0 < 10 or number_0 > 20	Registros en los que la expresión a ambos lados de la or 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 and 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.
is	Multi_line_text_0 is empty	Registros en los que el valor del campo es una cadena vacía o consta solo de espacios en blanco, saltos de línea o caracteres de tabulación.
is not	Multi_line_text_0 is not empty	Registros en los que el valor del campo no es una cadena vacía y no consta solo de espacios en blanco, saltos de línea o caracteres de tabulación.

• Los códigos de campo deben colocarse antes del operador, no después de él.
• Las fórmulas se pueden agrupar mediante el uso de () Soportes.
  Por ejemplo, (number_0 >= 10 y number_0 <= 20)="" or="" (number_1="">= 100 y number_1 <= 200)</=>

Funciones de consulta

Operadores y funciones disponibles para cada campo

Los operadores que se pueden utilizar difieren según la operación de consulta.

En las operaciones que recuperan registros, se pueden utilizar todos los operadores disponibles para el campo o el identificador de sistema de destino.

En las operaciones que cambian la configuración de la aplicación, solo se pueden utilizar los operadores disponibles en la interfaz de usuario.

Las condiciones de filtro tienen las siguientes restricciones:

• order by, limit y offset no se pueden utilizar.
• and y or no se pueden combinar.

Lista de operadores y funciones disponibles

Restricciones adicionales para cada API

Las siguientes API tienen restricciones adicionales.

Especificación de campos dentro de los campos de registro relacionados

• Especifique los campos dentro de la carpeta Registros relacionados con el siguiente formato:
  relatedrecords.specifiedfield Dónde Related Records es la línea de campo de la Related Records campo, y specifiedfieldld 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
order by	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 Si se ignora, se ordenará por el ID de Registro en orden descendente. Para campos que pueden ordenarse usando order by, consulte el siguiente artículo: ¿Qué campos y elementos se pueden usar para "Ordenar por"?
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.
offset	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.

Notas

• Asegúrate de especificar estas opciones de consulta en el siguiente orden: order by,limit,offset
• El máximo limit es 500 por Get Records API .
  Para otras APIs, el máximo limit es 100.
  Por ejemplo, el máximo limit para Obtener API de aplicaciones es 100.

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"

Ejemplo 6

• El campo Text_area está en blanco

1

Text_area is empty

• El campo Text_area no está en blanco

1

Text_area is not empty