Actualizar los departamentos de los usuarios

Documentos de API

Actualizar los departamentos de los usuarios

Actualiza la información de los Departamentos a los que pertenece un Usuario y la información del Puesto de Trabajo relacionada con el Departamento.

Método	PUT
URL	https://{subdomain}.kintone.com/v1/userOrganizations.json
Autenticación	Autenticación de contraseña, Autenticación de 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	Valor	Obligatorio	Descripción
userOrganizations	Matriz de objetos	Sí	Una lista de objetos que contiene usuarios que tendrán sus departamentos afiliados actualizados.
userOrganizations[].code	Cuerda	Sí	El código del usuario (nombre de inicio de sesión). El límite máximo es de 128 caracteres. No se permiten valores que consten solo de espacios en blanco o nulos.
userOrganizations[].organizations	Matriz de objetos	Sí	Una matriz de organizations objetos que contienen datos de los departamentos de los que los usuarios serán miembros. El límite máximo es de 100 objetos. Cualquier departamento existente que no esté configurado para este parámetro dará lugar a que el usuario se elimine de ese departamento. Si la matriz está vacía, el usuario no será miembro de ningún departamento.
userOrganizations[].organizations[].orgCode	Cuerda	Condicional	El código de departamento del departamento al que se va a agregar el usuario. El límite máximo es de 128 caracteres. Obligatorio cuando se especifica un puesto de trabajo.
userOrganizations[].organizations[].titleCode	Cuerda		El código del puesto de trabajo. El límite máximo es de 128 caracteres.

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


var body = {
  'userOrganizations':
    [
      {
        'code': 'sample_user_code',
        'organizations': [
          {
            'orgCode': 'sample_department_code',
            'titleCode': 'sample_job_title_code'
          }
        ]
      }
    ]
};

kintone.api(kintone.api.url('/v1/userOrganizations.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


$ curl -X PUT \
  https://{subdomain}.kintone.com/v1/userOrganizations.json \
  -H 'X-Cybozu-Authorization: a2ludG9uZTpkZXZlbG9wZXI=' \
  -H 'Content-Type: application/json' \
  -d '{"userOrganizations":
        [
          {
            "code": "sample_user_code",
            "organizations": [
              {
                "orgCode": "sample_department_code",
                "titleCode": "sample_job_title_code"
              }
            ]
          }
        ]
      }'

Ejemplo de respuesta

1

{}

Limitaciones

Pueden producirse interbloqueos si se opera simultáneamente lo siguiente:
- Un administrador del sistema importa un archivo CSV a través de la interfaz gráfica de usuario para actualizar a los usuarios del dominio.
  Para obtener más información, consulte el siguiente enlace:
  Modificación de datos a través de un archivo
- El Actualizar los departamentos de los usuarios Se utiliza la API.