Configuración de notificación de actualización por registro
Actualiza la configuración de notificación por registro de la aplicación. Para obtener más información, consulte el siguiente documento:
Notificaciones por registro
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/notifications/perRecord.json |
URL (espacio de invitado) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/notifications/perRecord.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.
- A la entidad se le debe conceder el permiso de visualización de registros para que la entidad reciba la notificación.
Parámetros de solicitud
Parámetro | Valor | Obligatorio | Descripción |
---|---|---|---|
app | Entero o cadena | Sí | El identificador de la aplicación. |
notifications | Arreglo | Matriz de objetos que contiene datos de la configuración de notificación por registro. Si la matriz está vacía, se eliminarán todos los ajustes de notificación por registro. Si se ignora, esta configuración no se cambiará. |
|
notifications[].filterCond | Cuerda | Condicional | La condición de filtro del registro en formato de cadena de consulta. Para obtener más información sobre los formatos de consulta, consulte el siguiente documento: Cadena de consulta Obligatorio al especificar el parámetro notifications parámetro. |
notifications[].title | Cuerda | El asunto de la notificación se guardó en "Resumen". Si se omite, el asunto de la notificación será una cadena vacía. |
|
notifications[].targets | Arreglo | Condicional | Matriz de objetos que contiene los destinatarios de la notificación por registro. Si la matriz está vacía, la notificación por registro no tendrá un destinatario. Obligatorio al especificar el parámetro notifications parámetro. |
notifications[].targets[].entity | Objeto | Condicional | Un objeto que contiene detalles de la entidad por destinatario de la notificación por registro. Obligatorio al especificar el parámetro notifications parámetro. |
notifications[].targets[].entity.type | Cuerda | Condicional | El tipo de entidad en la que está configurada la configuración de notificación por registro.
|
notifications[].targets[].entity.code | Cuerda | Condicional | El código de la entidad en la que está configurada la configuración de notificación por registro. Especifique el código de campo si el notifications[].targets[].entity.type se especifica como FIELD_ENTITY. En el caso de los usuarios invitados, agregue guest/ antes del nombre de inicio de sesión. Obligatorio al especificar el parámetro entity parámetro. |
notifications[].targets[].includeSubs | Booleano | La configuración "Incluir departamentos afiliados" del Departamento. Este parámetro está disponible si notificaciones[].targets[].entity.type se especifica en ORGANIZATION o FIELD_ENTITY.
|
|
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
|
|
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
|
|