Obtiene la configuración de permisos de campo de una aplicación.
Ajustes previos a la transmisión en vivo
Es posible que las aplicaciones contengan configuraciones previas a la transmisión en vivo que aún no se hayan implementado en la aplicación en vivo.
Acceda a la configuración previa a la transmisión en vivo con la siguiente URL.
| URL |
https://{subdomain}.kintone.com/k/v1/preview/field/acl.json |
| URL (espacio de invitado) |
https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/field/acl.json |
Permisos
- Los permisos de administración de aplicaciones son necesarios para obtener información de aplicaciones activas.
- Los permisos de administración de aplicaciones son necesarios para obtener información de la configuración previa a la transmisión.
Parámetros de solicitud
| Parámetro |
Valor |
Obligatorio |
Descripción |
| app |
Entero o cadena |
Sí |
El identificador de la aplicación. |
Solicitud de muestra
1
2
3
4
5
6
7
8
9
10
11
|
var body = {
'app': 1
};
kintone.api(kintone.api.url('/k/v1/field/acl.json', true), 'GET', body, function(resp) {
// success
console.log(resp);
}, function(error) {
// error
console.log(error);
});
|
XMLHttpRequest
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
var url = 'https://{subdomain}.kintone.com/k/v1/field/acl.json?app=1';
var xhr = new XMLHttpRequest();
xhr.open('GET', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.onload = function() {
if (xhr.status === 200) {
// success
console.log(JSON.parse(xhr.responseText));
} else {
// error
console.log(JSON.parse(xhr.responseText));
}
};
xhr.send();
|
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. |
| rights |
Arreglo |
Matriz de objetos que contienen datos de la configuración de permisos. |
| rights[].code |
Cuerda |
El código de campo de un campo que tiene una configuración de permisos. |
| rights[].entities |
Arreglo |
Matriz que enumera las entidades a las que se conceden los permisos, en orden de prioridad. |
| rights[].entities[].accessibility |
Cuerda |
El permiso concedido a la entidad.- READ: Permisos para ver solamente.
- WRITE: Permisos para ver y editar.
- NONE: No hay permisos para ver o editar.
|
| rights[].entities[].entity |
Objeto |
Objeto que contiene datos de la entidad a la que se concede el permiso. |
| rights[].entities[].entity.code |
Cuerda |
El código de la entidad a la que se concede el permiso. |
| rights[].entities[].entity.type |
Cuerda |
El tipo de entidad a la que se concede el permiso.- USER: Usuario
- GROUP: Grupo
- ORGANIZATION: Departamento
- FIELD_ENTITY: Campo de usuario
|
| rights[].entities[].includeSubs |
Booleano o cadena |
La configuración de herencia de permisos del departamento al que se concede el permiso.true: Los permisos se heredan.false: Los permisos no se heredan.
|
Ejemplo de respuesta
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
|
{
"rights": [
{
"code": "Text__single_line_",
"entities": [
{
"accessibility": "WRITE",
"entity": {
"type": "USER",
"code": "user1"
},
"includeSubs": false
},
{
"accessibility": "READ",
"entity": {
"type": "GROUP",
"code": "group1"
},
"includeSubs": false
}
]
},
{
"code": "Number",
"entities": [
{
"accessibility": "NONE",
"entity": {
"type": "ORGANIZATION",
"code": "org1"
},
"includeSubs": true
}
]
}
],
"revision": "2"
}
|
