Documentos de API

Departamentos de actualización

Actualiza los departamentos de un entorno Kintone.

MétodoPUT
URLhttps://{subdomain}.kintone.com/v1/organizations.json
Autenticación Autenticación de contraseña, Autenticación de sesión
Content-Typeapplication/json

Contenido

Permisos

Solo los administradores pueden usar esta API.

Para obtener más información sobre los administradores, consulte el siguiente artículo:
Tipos de administradores (External link)

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
organizations Matriz de objetos Sí Una matriz de Organizaciones objetos, que contienen datos de los Departamentos que se van a actualizar.
organizations[].code Cuerda Sí El código de departamento del departamento a actualizar.
Debe tener 128 caracteres o menos.
organizations[].name Cuerda Opcional El nuevo nombre del departamento.
Debe tener 128 caracteres o menos.
Si se ignora este parámetro, no se actualizará el nombre.
organizations[].localName Cuerda Opcional El nuevo nombre localizado del departamento.
Debe tener 128 caracteres o menos.
Si se ignora este parámetro, no se actualizará el nombre localizado.
organizations[].localNameLocale Cuerda Opcional La configuración regional del nombre localizado.
en, ja, zho es se puede especificar.
Si se omite este parámetro, se establece el valor como una cadena vacía o se especifica null no se actualizará la configuración regional.
organizations[].parentCode Cuerda Opcional El Código de Departamento del Departamento de Padres.
Debe tener 128 caracteres o menos.
Si se ignora este parámetro, no se actualizará el departamento principal.
Si se especifica una cadena vacía, se establecerá el Departamento en la raíz.
organizations[].description Cuerda Opcional La descripción del departamento.
Debe tener 1000 caracteres o menos.
Si se ignora este parámetro, no se actualizará la descripción.

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

var body = {
  'organizations': [
    {
      'code': 'code_and_IT',
      'name': 'Department of Code Troubleshooting',
      'localName': 'Department of Code Troubleshooting',
      'localNameLocale': 'en',
      'description': 'A Department dedicated to troubleshooting your code.'
    },
    {
      'code': 'R_and_D',
      'name': 'Research and Development',
      'localName': 'Research and Development',
      'localNameLocale': 'en',
      'description': 'The Kintone Research and Development team for rapid prototype development.'
    }
  ]
};

kintone.api(kintone.api.url('/v1/organizations.json', true), 'PUT', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

Muestra de curl 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

$ curl -X PUT \
  https://{subdomain}.kintone.com/v1/organizations.json \
  -H 'Content-Type: application/json' \
  -H 'X-Cybozu-Authorization: a2ludG9uZTpkZXZlbG9wZXI=' \
  -d '{"organizations":
  [
    {
      "code": "code_and_IT",
      "name": "Department of Code Troubleshooting",
      "localName": "Department of Code Troubleshooting",
      "localNameLocale": "en",
      "description": "A Department dedicated to troubleshooting your code."
    },
    {
      "code": "R_and_D",
      "name": "Research and Development",
      "localName": "Research and Development",
      "localNameLocale": "en",
      "description": "The Kintone Research and Development team for rapid prototype development."
    }
  ]
}'

Ejemplo de respuesta 

1

{}

Limitaciones

  • El Departamento de Padres declaró dentro de la parentCode también puede existir dentro de la matriz de parámetros de solicitud. En este caso, la matriz debe incluir los datos del Departamento Principal antes que los del Departamento Secundario.
  • Si se especifica el mismo Departamento dentro del parámetro de solicitud, el Departamento se actualizará con los detalles de los datos de este último Departamento.