Actualizar el diseño del formulario
Actualiza la información de diseño de campo de un formulario en 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/form/layout.json |
URL (espacio de invitado) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/form/layout.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
- Se necesitan permisos de administración de aplicaciones.
Parámetros de solicitud
Los parámetros que se ignoren no se actualizarán
Todos los campos del formulario deben especificarse en la solicitud.
Parámetro | Valor | Obligatorio | Descripción |
---|---|---|---|
app | Integer | Sí | El identificador de la aplicación. |
layout | Arreglo | Sí | Una lista de diseños de campo para cada fila. |
layout[].type | Cuerda | Sí | El tipo de fila.
|
layout[].code | Cuerda | Condicional | El código de campo del campo Tabla o Grupo. Omitir, si el tipo de fila no es una tabla o un grupo. |
layout[].fields | Arreglo | La lista de campos de la fila. | |
layout[].fields[].type | Cuerda | Sí | El tipo de campo.
|
layout[].fields[].code | Cuerda | Condicional | El código de campo del campo. Ignorar, si el campo es una etiqueta, un espacio en blanco o un borde. |
layout[].fields[].label | Cuerda | El texto que se va a establecer en el campo Etiqueta. Especifique solo para los campos de etiqueta. |
|
layout[].fields[].elementId | Cuerda | El ID de elemento que se va a establecer en el campo Espacio en blanco. Especifique solo para los campos de espacio en blanco. | |
layout[].fields[].size | Objeto | Un objeto con datos del tamaño del campo. Dependiendo de cómo se coloque el campo, es posible que el campo no tenga el tamaño especificado. |
|
layout[].fields[].size.width | Integer | El ancho del campo en píxeles. El ancho se puede establecer para los siguientes campos:
|
|
layout[].fields[].size.height | Integer | La altura del campo en píxeles, incluida la altura del nombre del campo. Solo los campos de espacio en blanco pueden utilizar este parámetro. |
|
layout[].fields[].size.innerHeight | Integer | La altura del campo en píxeles, excluyendo la altura del nombre del campo. Solo los siguientes campos pueden utilizar este parámetro:
|
|
layout[].layout | Arreglo | Una lista de diseños de campo para cada fila dentro de un campo de grupo. Los parámetros para esto son los mismos para el diseño propiedad. |
|
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. |
Ejemplo de respuesta
|
|