Departamentos de actualización

Documentos de API

Departamentos de actualización

Actualiza los departamentos de un entorno Kintone.

Método	PUT
URL	https://{subdomain}.kintone.com/v1/organizations.json
Autenticación	Autenticación mediante token API , Autenticación mediante contraseña , Autenticación mediante sesión
Content-Type	application/json

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

Parámetros de solicitud

Parámetro	Tipo	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`: Inglés `ja`: Japonés `zh`: Chino (simplificado) `zh-TW`: Chino (tradicional) `es`: Español `pt-BR`: Portugués de Brasil `th`: Thai 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.