Actualizar vistas
Actualiza la configuración de visualización de una aplicación.
Esta API actualiza la configuración previa a la puesta en marcha.
Después de usar esta API, use la siguiente API para implementar la configuración en la aplicación activa:
Implementar la configuración de la aplicación
Método | PUT |
---|---|
URL | https://{subdomain}.kintone.com/k/v1/preview/app/views.json |
URL (espacio de invitado) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/views.json |
Autenticación | Autenticación de contraseña, Autenticación de token de API, Autenticación de sesión |
Content-Type | application/json |
Contenido
Permisos
Vista de lista/calendario:
- Se necesitan permisos de administración de aplicaciones.
Personalizar vista:
- Se necesitan permisos de administrador de Kintone.
- Los tokens de API no se pueden usar con esta API.
Parámetros de solicitud
Esta API reemplazará todas las vistas actuales por las vistas enumeradas en la solicitud.
Se eliminarán los nombres de vista que no se indiquen en la solicitud.
Parámetro | Valor | Obligatorio | Descripción |
---|---|---|---|
app | Integer | Sí | El identificador de la aplicación. |
views | Objeto | Sí | Objeto de datos de Views. |
views.{viewname} | Objeto | Sí | El nombre de la vista a la que se van a agregar cambios. Si se especifica un nombre de vista que existe, se creará una nueva vista con este nombre. |
views.{viewname}.index | Cuerda | Sí | El orden de visualización de la vista, en la lista de vistas, especificado con un número. La lista de vistas se mostrará en orden ascendente. |
views.{viewname}.type | Cuerda | Sí | El tipo de View.
|
views.{viewname}.name | Cuerda | Condicional | El nombre de la vista. El límite máximo de caracteres es de 64. Obligatorio, si views. {viewname} es una nueva vista. En este caso, especifique el mismo nombre de vista nuevo para este parámetro. |
views.{viewname}.fields | Arreglo | Condicional | Se utiliza para las vistas de lista. La lista de campos que se mostrarán en la lista. Especifique los campos por sus códigos de campo. Este parámetro es obligatorio si se agrega una nueva vista de lista. |
views.{viewname}.date | Cuerda | Se utiliza para las vistas de calendario. El campo que se utilizará como "Campo de fecha" de la vista de calendario. Especifique un campo de tipo de fecha por su código de campo. Si se ignora, se establecerá el campo Fecha y hora creada. |
|
views.{viewname}.title | Cuerda | Se utiliza para las vistas de calendario. El campo que se utilizará como "Campo de título" de la vista de calendario. Especifique un campo de tipo de texto por su código de campo. Si se ignora, se establecerá el campo Número de registro. |
|
views.{viewname}.html | Cuerda | Se utiliza para vistas personalizadas. El código HTML que se va a establecer para la vista personalizada. |
|
views.{viewname}.pager | Booleano | La configuración de paginación. Especifique una de las siguientes opciones:
|
|
views.{viewname}.device | Cuerda | Ámbito del lugar en el que se muestra la vista. Si no se especifica este parámetro, el valor predeterminado es DESKTOP. Si la configuración de la vista se actualiza sin especificar este parámetro, este parámetro no cambia.
|
|
views.{viewname}.filterCond | Cuerda | La condición de filtro en un formato de consulta. Para obtener más datos sobre los formatos de consulta, consulte el siguiente documento: Cadena de consulta |
|
views.{viewname}.sort | Cuerda | El criterio de ordenación en un formato de consulta. Para obtener más datos sobre los formatos de consulta, consulte el siguiente documento: Cadena de consulta |
|
revision | Integer | Especifique el número de revisión de la configuración que se implementará. Se producirá un error en la solicitud si el número de revisión no es la última revisión. La revisión no se comprobará si se ignora este parámetro o si se especifica -1. |
Solicitud de muestra
|
|
XMLHttpRequest
|
|
Parámetros de respuesta
Parámetro | Tipo | Descripción |
---|---|---|
revision | Cuerda | El número de revisión de la configuración de la aplicación. |
views | Objeto | Objeto que contiene datos de las vistas. |
views.{viewname}.id | Cuerda | El ID de vista. |
Ejemplo de respuesta
|
|
Limitaciones
- Esta API no se puede usar para actualizar la configuración de la vista si hay varias vistas con el mismo nombre.
- Si la aplicación de destino contiene vistas personalizadas, esta API no puede actualizar las vistas si se autentica con tokens de API, ya que se necesitan permisos de administración de Kintone para actualizar esta configuración. Para obtener más información, consulte la siguiente sección del artículo:
Administrador de Kintone