Pular para o conteúdo principal
Versão: 2.2.1

newUser

Este método possibilita inserir/editar:

  • Dados de um usuário;
  • Relacionamento entre Usuário, Área e Função;
  • Relacionamento entre Usuário e Grupo de acesso.

Se o usuário já existir e estiver sendo informada uma área diferente da qual o usuário já está associado, a nova área será associada e considerada como a padrão;

Se o usuário já existir e algum campo for alterado com a mesma área e função já cadastrada, o sistema irá retornar erro informando que o usuário já está sendo utilizado por essa área e função. Para realizar uma edição, deverá ser informado em branco o identificador de IDAREA e IDFUNC. Caso o objetivo seja a alteração de área e função, podem ser inseridas essas duas informações, que o sistema fará a alteração.

Para a inserção de cada um destes itens é necessário seguir o padrão abaixo documentado.

Classe Java
Requisiçãoweb\wwwroot\ws\java\admin\NewUserRequestType.java
Retornoweb\wwwroot\ws\java\admin\NewUserResponseType.java

Requisição:

IdentificadorRequeridoDescrição
IDUSERXMatrícula do usuário (identificador).
NAMEXNome do usuário.
LOGINXNome utilizado pelo usuário para entrar no sistema.
PASSXSenha do usuário.
EMAILXEndereço de e-mail do usuário.
IDAREAIdentificador da área a ser associada ao usuário.
IDFUNCIdentificador da função a ser associada ao usuário.
IDACCGROUPIdentificador do grupo de acesso a ser associado ao usuário.
CDLEADERMatrícula do líder a ser associada ao usuário.
LANGUAGEInformar código para idioma do usuário, conforme coluna "Código no banco de dados" da seção Localização, no documento Requisitos do Sistema
info
  • X¹ - Obrigatório somente quando IDFUNC tiver preenchido.
  • X² - obrigatório somente quando IDAREA tiver preenchido.
cuidado

Você só pode inserir ou editar um usuário de cada vez utilizando esse método. Isso significa que não é possível atualizar uma lista de usuários enviando uma única requisição.

Estrutura da requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:admin">
<soapenv:Header/>
<soapenv:Body>
<urn:newUser>
<!--You may enter the following 10 items in any order-->
<urn:IDUSER>?</urn:IDUSER>
<urn:NAME>?</urn:NAME>
<urn:LOGIN>?</urn:LOGIN>
<urn:PASS>?</urn:PASS>
<urn:EMAIL>?</urn:EMAIL>
<!--Optional:-->
<urn:LANGUAGE>?</urn:LANGUAGE>
<urn:IDAREA>?</urn:IDAREA>
<urn:IDFUNC>?</urn:IDFUNC>
<urn:IDACCGROUP>?</urn:IDACCGROUP>
<!--Optional:-->
<urn:CDLEADER>?</urn:CDLEADER>
</urn:newUser>
</soapenv:Body>
</soapenv:Envelope>

Retorno:

IdentificadorDescrição
returnSUCESSO: Chave primária do usuário cadastrado.
FALHA: -1
StatusSUCESSO: SUCCESS
FALHA: FAILURE
CodeSUCESSO: 1
FALHA: Código referente ao erro ocorrido.
RecordIdSUCESSO: Matrícula do usuário (identificador).
FALHA: N/A
RecordKeySUCESSO: Chave primária do usuário cadastrado.
FALHA: N/A
CódigoDescrição
-1Erro inesperado.
2Grupo de acesso inexistente.
3campo¹: O tamanho máximo para este campo é 50.
4Erro ao identificar o usuário. Existe mais de um registro com o mesmo login.
5Não é permitido usar aspas no campo login.
6Login do usuário nulo.
7Matrícula do usuário nulo.
8Nome do usuário nulo.
9Senha nula.
10Linguagem nula ou inexistente.
11O líder informado não existe.
12Usuário inexistente.
13Identificador da função nulo.
14Identificador da área nulo.
15Área inexistente.
16Função inexistente.
17Relacionamento entre área e função inexistente.
18A matrícula do usuário não pode ser igual à matrícula do líder.
59Idioma não suportado pela base de dados.
60Idioma inexistente.
89E-mail do usuário nulo.