Actualizar permisos de la aplicación

Documentos de API

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étodo	PUT
URL	https://{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-Type	application/json

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	Sí	El identificador de la aplicación.
rights	Arreglo	Sí	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	Sí	Objeto que contiene datos de la entidad a la que se concede el permiso.
rights[].entity.type	Cuerda	Sí	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

JavaScript using kintone.api()

 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"
}