Cadena de consulta
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 |
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 |
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:
|
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:
|
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:
|
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:
|
THIS_MONTH(número o texto) |
|
Se convierte en el mes en que se inició la API. Se puede especificar lo siguiente:
|
LAST_MONTH (número o texto) |
|
Se convierte al mes anterior al momento en que se inició la API. Se puede especificar lo siguiente:
|
NEXT_MONTH(número o texto) |
|
Se convierte al mes siguiente de cuando se inició la API. Se puede especificar lo siguiente:
|
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 |
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 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.
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
|
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"
|
|
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
|
|
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
|
|
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"
|
|