Actualizar la configuración general

Actualiza la descripción, el nombre, el icono, la revisión y el tema de color de una 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étodoPUT
URLhttps://{subdomain}.kintone.com/k/v1/preview/app/settings.json
URL (espacio de invitado)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/settings.json
Autenticación Autenticación de contraseña , Autenticación de token de API , Autenticación de sesión
Content-Typeapplication/json

Contenido

Permisos

  • Se necesitan permisos de administración de aplicaciones.

Parámetros de solicitud

Los parámetros que se ignoren no se actualizarán.

Parámetro Tipo Obligatorio Descripción
app Integer o String El identificador de la aplicación.
name String El nombre de la aplicación. El límite máximo de caracteres es de 64.
descripción Cuerda La descripción de la aplicación. El límite máximo de caracteres es de 10.000. Se pueden utilizar etiquetas HTML.
icon Objeto Objeto que contiene información del icono de la aplicación.
icon.type Cuerda Condicional El tipo de icono. Especifique una de las siguientes opciones:
  • FILE: Una imagen cargada.
  • PRESET: Un icono preestablecido dentro de Kintone.
Requerido, si se va a establecer el parámetro icon.
icon.key Cuerda Condicional El identificador de clave del icono.
Obligatorio, si el icon.type El parámetro se establece como PRESET.
Los iconos preestablecidos tienen identificadores clave que se pueden obtener mediante la siguiente API:
Obtener la configuración general
icon.file Objeto Condicional Objeto que contiene información de los archivos de icono cargados.
Obligatorio, si el icon.type El parámetro se establece como FILE.
icon.file.fileKey Cuerda Condicional La clave de archivo del icono.
Para adjuntar un archivo, especifique la clave de archivo respondida al usar la siguiente API:
Subir archivo
El límite máximo de tamaño de archivo es de 800 KB.
Obligatorio, si el icon.type El parámetro se establece como FILE.
theme Cuerda El tema Color.
Se puede especificar lo siguiente:
  • WHITE: Predeterminado
  • RED
  • BLUE
  • GREEN
  • YELLOW
  • BLACK
titleField Object El título del registro.
titleField.selectionMode Cuerda Condicional La opción de El campo que se va a utilizar como título del registro Configuración.
  • AUTO: El Establecer automáticamente opción.
  • MANUAL: El Ajuste manual opción.
Requerido si titleField se especifica.
titleField.code Cuerda Condicional El código de campo del campo utilizado como título del registro. Obligatorio, si MANUAL se establece para el titleField.selectionMode parámetro.
enableThumbnails Boolean El Mostrar miniaturas ajuste.
enableBulkDeletion Boolean El Habilitar la eliminación masiva de registros ajuste.
enableComments Boolean El Habilitar comentarios ajuste.
enableDuplicateRecord Boolean El Habilite la función para "duplicar registro" ajuste.
enableInlineRecordEditing Boolean El Habilitar la edición de registros en línea ajuste.
numberPrecision Object El Precisión de números y cálculos ajuste.
Para obtener más información, consulte el siguiente artículo en el sitio de ayuda de Kintone:
Precisión de los números y los cálculos (External link)
numberPrecision.digits Integer o String El Número total de dígitos ajuste.
Especifica un entero del 1 al 30.
numberPrecision.decimalPlaces Integer o String El Número de decimales para redondear ajuste.
Especifica un entero de 0 a 10.
numberPrecision.roundingMode String El Redondeo ajuste
  • HALF_EVEN: Redondear al número par más cercano
  • UP: Rodear
  • DOWN: Redondear hacia abajo
firstMonthOfFiscalYear Integer o String El Primer mes del año fiscal ajuste. Especifica un entero del 1 al 12, que representa el mes.
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
var body = {
  'app': 1,
  'name': 'APP_NAME',
  'description': 'Here is app description.',
  'icon': {
    'type': 'PRESET',
    'key': 'APP72'
  },
  'theme': 'WHITE',
  'titleField': {
    'selectionMode': 'MANUAL',
    'code': 'RecordNumber'
  },
  'enableThumbnails': true,
  'enableBulkDeletion': true,
  'enableComments': true,
  'enableDuplicateRecord': true,
  'enableInlineRecordEditing': true,
  'numberPrecision': {
    'digits': 16,
    'decimalPlaces': 4,
    'roundingMode': 'HALF_EVEN'
  },
  'firstMonthOfFiscalYear': 4
};

kintone.api(kintone.api.url('/k/v1/preview/app/settings.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
var body = {
  'app': 1,
  'name': 'APP_NAME',
  'description': 'Here is app description.',
  'icon': {
    'type': 'PRESET',
    'key': 'APP72'
  },
  'theme': 'WHITE',
  'titleField': {
    'selectionMode': 'MANUAL',
    'code': 'RecordNumber'
  },
  'enableThumbnails': true,
  'enableBulkDeletion': true,
  'enableComments': true,
  'enableDuplicateRecord': true,
  'enableInlineRecordEditing': true,
  'numberPrecision': {
    'digits': 16,
    'decimalPlaces': 4,
    'roundingMode': 'HALF_EVEN'
  },
  'firstMonthOfFiscalYear': 4,
  // 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/preview/app/settings.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 String El número de revisión de la configuración de la aplicación.

Ejemplo de respuesta

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