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ção	web\wwwroot\ws\java\admin\NewUserRequestType.java
Retorno	web\wwwroot\ws\java\admin\NewUserResponseType.java

Requisição:

Identificador	Requerido	Descrição
IDUSER	X	Matrícula do usuário (identificador).
NAME	X	Nome do usuário.
LOGIN	X	Nome utilizado pelo usuário para entrar no sistema.
PASS	X	Senha do usuário.
EMAIL	X	Endereço de e-mail do usuário.
IDAREA	X¹	Identificador da área a ser associada ao usuário.
IDFUNC	X²	Identificador da função a ser associada ao usuário.
IDACCGROUP		Identificador do grupo de acesso a ser associado ao usuário.
CDLEADER		Matrícula do líder a ser associada ao usuário.
LANGUAGE		Informar 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:

Identificador	Descrição
return	SUCESSO: Chave primária do usuário cadastrado. FALHA: -1
Status	SUCESSO: SUCCESS FALHA: FAILURE
Code	SUCESSO: 1 FALHA: Código referente ao erro ocorrido.
RecordId	SUCESSO: Matrícula do usuário (identificador). FALHA: N/A
RecordKey	SUCESSO: Chave primária do usuário cadastrado. FALHA: N/A

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