Actualizar permisos de la aplicación

Actualiza los permisos de aplicación de una aplicación.
Todas las configuraciones de la aplicación previa a la puesta en marcha (no solo la configuración de permisos) se implementarán en la aplicación en vivo mediante esta API.

MétodoPUT
URLhttps://{subdomain}.kintone.com/k/v1/app/acl.json
URL (espacio de invitado)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/app/acl.json
Autenticación Autenticación de contraseña , Autenticación de token de API , Autenticación de sesión
Content-Typeapplication/json

Contenido

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/app/acl.json
URL (espacio de invitado) https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/acl.json

Permisos

  • Se necesitan permisos de administración de aplicaciones.

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
app Entero o cadena El identificador de la aplicación.
rights Arreglo Una matriz que enumera los datos de los permisos de la aplicación, en orden de prioridad.
El grupo "Everyone" se tratará con la prioridad más baja, independientemente de dónde se coloque en la lista.
rights[].entity Objeto Objeto que contiene datos de la entidad a la que se concede el permiso.
rights[].entity.type Cuerda El tipo de entidad a la que se concederá el permiso.
  • USER: Usuario
  • GROUP: Grupo
  • ORGANIZATION: Departamento
  • CREATOR: El creador de la App
rights[].entity.code Cuerda Condicional El código de la entidad a la que se concede el permiso.
Para especificar usuarios de espacio de invitado, agregue la cadena "guest/" antes del nombre de inicio de sesión del invitado.
Si no se especifica el grupo "Everyone", el grupo "Everyone" no tendrá permisos para ver/editar/eliminar.
Si se especifica "CREATOR" para el rights[].entity.type parámetro, ignore este parámetro. De lo contrario, este parámetro es obligatorio.
rights[].includeSubs Booleano o cadena La configuración de herencia de permisos del departamento al que se concede el permiso. Este parámetro está disponible si se especifica "ORGANIZATION" para el right[].entity.tipo parámetro.
  • true: Los permisos se heredarán.
  • false: Los permisos no se heredarán.
Si se omite, este valor es falso.
rights[].appEditable Booleano o cadena El permiso de administración de aplicaciones de la entidad.
  • Se podrá acceder a la configuración de la aplicación.
  • No se podrá acceder a la configuración de la aplicación.
Si se omite, este valor es falso.
rights[].recordViewable Booleano o cadena El permiso de vista de registro de la entidad.
  • true: Los registros serán visibles.
  • false: Los registros no se podrán ver.
Si se omite, este valor es falso.
rights[].recordAddable Booleano o cadena El permiso de adición de registro de la entidad
  • true: Se pueden agregar registros.
  • false: No se pueden agregar registros.
Si se omite, este valor es falso.
rights[].recordEditable Booleano o cadena El permiso de edición de registros de la entidad.
Los permisos de visualización de registros también deben estar habilitados para establecer este valor como true.
  • true: Los registros serán editables.
  • false: Los registros no serán editables.
Si se omite, este valor es falso.
rights[].recordDeletable Booleano o cadena El permiso de eliminación de registros de la entidad.
Los permisos de visualización de registros también deben estar habilitados para establecer este valor como true.
  • true: Los registros serán eliminables.
  • false: Los registros no serán eliminables.
Si se omite, este valor es falso.
rights[].recordImportable Booleano o cadena El permiso de importación de archivos de la entidad.
Los permisos de adición de registros también deben estar habilitados para establecer este valor como true.
  • true: Los archivos serán importables
  • false: Los archivos no serán importables
Si se omite, este valor es falso.
rights[].recordExportable Booleano o cadena El permiso de exportación de archivos de la entidad.
  • true: Los archivos serán exportables
  • false: Los archivos no serán exportables
Si se omite, este valor es falso.
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 si se especifica -1.

Solicitud de muestra

 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
40
41
42
43
44
45
46
47
48
49
50
51
52
var body = {
  'app': 1,
  'rights': [
    {
      'entity': {
        'type': 'USER',
        'code': 'user1'
      },
      'appEditable': true,
      'recordViewable': true,
      'recordAddable': true,
      'recordEditable': true,
      'recordDeletable': true,
      'recordImportable': true,
      'recordExportable': true
    },
    {
      'entity': {
        'type': 'GROUP',
        'code': 'everyone'
      },
      'includeSubs': true,
      'appEditable': true,
      'recordViewable': true,
      'recordAddable': true,
      'recordEditable': true,
      'recordDeletable': true,
      'recordImportable': false,
      'recordExportable': false
    },
    {
      'entity': {
        'type': 'CREATOR'
      },
      'appEditable': true,
      'recordViewable': true,
      'recordAddable': true,
      'recordEditable': true,
      'recordDeletable': true,
      'recordImportable': true,
      'recordExportable': true
    }
  ]
};

kintone.api(kintone.api.url('/k/v1/app/acl.json', true), 'PUT', 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
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
var body = {
  'app': 1,
  'rights': [
    {
      'entity': {
        'type': 'USER',
        'code': 'user1'
      },
      'appEditable': true,
      'recordViewable': true,
      'recordAddable': true,
      'recordEditable': true,
      'recordDeletable': true,
      'recordImportable': true,
      'recordExportable': true
    },
    {
      'entity': {
        'type': 'GROUP',
        'code': 'everyone'
      },
      'includeSubs': true,
      'appEditable': true,
      'recordViewable': true,
      'recordAddable': true,
      'recordEditable': true,
      'recordDeletable': true,
      'recordImportable': false,
      'recordExportable': false
    },
    {
      'entity': {
        'type': 'CREATOR'
      },
      'appEditable': true,
      'recordViewable': true,
      'recordAddable': true,
      'recordEditable': true,
      'recordDeletable': true,
      'recordImportable': true,
      'recordExportable': true
    }

  ],
  // CSRF TOKEN: used for all APIs that have an HTTP method of POST, PUT and DELETE on Kintone.
  '__REQUEST_TOKEN__': kintone.getRequestToken()
};

var url = 'https://{subdomain}.kintone.com/k/v1/app/acl.json';
var xhr = new XMLHttpRequest();
xhr.open('PUT', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send(JSON.stringify(body));

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

1
2
3
{
  "revision": "3"
}