Actualizar la configuración de la acción
Actualiza la configuración de acción de la aplicación. Para obtener más información sobre las acciones, consulte el siguiente artículo:
Configuración de acciones en la 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/actions.json |
URL (espacio de invitado) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/app/actions.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 de la aplicación de origen.
- Se necesitan permisos para ver la aplicación de destino de copia.*
* Si el Acciones. {actionname}.destApp y Acciones. {actionname}.mappings se omiten los parámetros, no se requieren permisos para ver la aplicación de destino de copia.
Parámetros de solicitud
Parámetro | Tipo | Obligatorio | Descripción |
---|---|---|---|
app | Entero o cadena | Sí | El identificador de la aplicación. |
actions | Objeto | Sí | Una lista de objetos Acción Configuración. La clave del objeto es la Acción, que es igual al identificador único Acciónen su configuración de idioma predeterminada. Los valores de la clave son los distintos Acción configuración asociada a eso Acción. |
actions.{actionname} | Objeto | Una lista de objetos Acción Información de 1 Acción. Si actionname es igual al nombre de un Acciónel Acción se actualizará con los valores del objeto. Si actionname no es igual a un nombre de un Acción, un nuevo Acción se creará con los valores del objeto. Cualquier Acción que no esté establecido para este parámetro se eliminará. |
|
actions.{actionname}.name | Cuerda | Condicional | El nombre de la Acción. Se pueden especificar de 1 a 32 caracteres. Al crear un nuevo archivo Acción, se producirá un error en la solicitud si el valor de este parámetro no es el mismo que Acciones. {actionname}. Obligatorio al actualizar un archivo existente Accióno la creación de un nuevo archivo Acción. |
actions.{actionname}.index | Entero o cadena | Condicional | El orden de la Acciones. El Acción se ordena en orden ascendente, a partir de 0. Se producirá un error en la solicitud si hay valores duplicados. Obligatorio al actualizar un archivo existente Accióno la creación de un nuevo archivo Acción. |
actions.{actionname}.destApp | Objeto | Condicional | Objeto que contiene la opción Target que especifica la aplicación de destino en la que se van a copiar los datos. Obligatorio al crear un nuevo archivo Acción. |
actions.{actionname}.destApp.app | Entero o cadena | Condicional | El identificador de aplicación de la aplicación de destino de la copia. Requerido si el Acciones. {actionname}.destApp.code no se especifica. |
actions.{actionname}.destApp.code | Cuerda | Condicional | El código de aplicación de la aplicación de destino de copia. Requerido si el Acciones. {actionname}.destApp.app no se especifica. Si ambos Acciones. {actionname}.destApp.app y Acciones. {actionname}.destApp.code se especifican, el código tiene prioridad. |
actions.{actionname}.mappings | Arreglo | Condicional | Una matriz de objetos que contiene las opciones "Asignaciones de campos". Si la matriz está vacía, el Acción no tendrá configuradas las opciones de "Asignaciones de campos". Obligatorio al especificar el parámetro Acciones. {actionname}.destApp o crear un nuevo parámetro Acción. |
actions.{actionname}.mappings[].srcType | Cuerda | Condicional | Tipo de datos de origen que se van a copiar.
|
actions.{actionname}.mappings[].srcField | Cuerda | Condicional | El código de campo del campo especificado en las opciones "Asignaciones de campos" como origen. Requerido cuando el Acciones. {actionname}.mappings[].srcType se establece en FIELD. |
actions.{actionname}.mappings[].destField | Cuerda | Condicional | El código de campo del campo especificado en las opciones "Asignaciones de campos" como destino. Obligatorio al especificar el parámetro Acciones. {actionname}.mappings parámetro. |
actions.{actionname}.entities | Arreglo | Condicional | Una matriz de objetos que contiene las entidades Acción se concede a. Esto refleja las opciones "Disponible para". Si la matriz está vacía, el Acción no estará disponible para ningún usuario/departamento/grupo. Obligatorio al crear un nuevo archivo Acción. |
actions.{actionname}.entities[].type | Cuerda | Condicional | El tipo de entidad que el Acción se concede a.
Obligatorio al especificar el parámetro Acciones. {actionname}.entities parámetro. |
actions.{actionname}.entities[].code | Cuerda | Condicional | El código de la entidad el Acción se concede a. En el caso de los usuarios invitados, agregue guest/ antes del nombre de inicio de sesión. Obligatorio al especificar el parámetro Acciones. {actionname}.entities parámetro. |
revision | Entero o cadena | 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 se especifica -1. |
Solicitud de muestra
|
|
Muestra de curl
|
|
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. |
actions | Objeto | Una lista de objetos Acción Configuración. |
actions.{actionname}.id | Cuerda | El ID de la propiedad Acción. |
Ejemplo de respuesta
|
|
Limitaciones
Si varias acciones tienen (o darán lugar a tener) el mismo nombre dentro de la misma aplicación, esta API devolverá un error.