O Protheus permite a criação de usuários através de Webservices REST. Para tanto, deve-se configurar o serviço REST no arquivo appserver.ini do Protheus.

Para que seja possível incluir um novo cadastro, é necessário que o usuário enviado no header da requisição REST possua permissão de acesso a rotina CFGA510.

Segue abaixo um exemplo de configuração no arquivo appserver.ini. Para maiores detalhes sobre a configuração do WebService REST no Protheus, acesse:
http://tdn.totvs.com/display/tec/REST

Para testar a conexão com o REST, acesse, pelo navegador:
- Página inicial dos serviços REST: http://localhost:8088/rest/
- Ping ao Webservice REST: http://localhost:8088/rest/ping/
- Usuários do Protheus: http://localhost:8088/rest/users/

Após o Webservice REST estar iniciado com o Protheus, deve-se enviar para este Webservice via POST um JSON com as informações abaixo:

{
  "schemas": [
    "urn:scim:schemas:core:2.0:User",
    "urn:scim:schemas:extension:enterprise:2.0:User"
  ],
  "meta": {
  },
 

urn:scim:schemas:extension:enterprise:2.0:User":{
	"manager":[
	{
		"managerid":"000000"
		
	}
	]  
  }
}

Descrição das chaves do JSON:

• userName – Nome do usuário (usuário);
• displayName – Nome completo do usuário (Nome completo);
• e-mails – Array de objetos. O primeiro e-mail com o valor primary apontado como true é o email cadastrado para o usuário (é necessário no mínimo um email primário. Qualquer email não primário enviado é descartado);
- value – valor do email
- primary – Se é um email que será cadastrado
• active - Indica se o usuário estará bloqueado ou não (true);
• groups – Array de objetos contendo os códigos dos grupos de usuário ao qual o usuário está ligado;
• password – Senha do usuário. Se não informada, é gerada uma senha que deverá ser alterada posteriormente pelo admin do sistema;
• ext/SAMAccountName – Indica o login do usuário no SSO (caso informado, ele substituirá o valor informado no campo userName);
• ext/adDomain – Domínio do usuário no SSO;
• urn:scim:schemas:extension:enterprise:2.0:User – Objeto que vai indicar o superior do usuário, sendo:
- manager – Array de objetos contendo os superiores do usuário:
• managerid – Código do superior do usuário

No exemplo, estamos utilizando um aplicativo Client para envio do JSON, mas pode ser utilizada uma customização do cliente para este envio.

Image Added

Ao efetuar o envio do JSON (Send), será exibido no Console do Protheus uma informação de confirmação como esta:

Image Modified