Cadastro e Atualização de Usuários
Bem vindo ao tutorial de como cadastrar e atualiza Usuários. Vamos lá?
Formas de Cadastro/Atualizar
Primeiro vamos entender quais são as formas de realizar o cadastro (ou atualização) de usuários na plataforma. Atualmente estão disponíveis três formas , são elas:
- Cadastro/Atualização por tela de Formulário
- Cadastro/Atualização por Importação de Planilha
- Cadastro/Atualização por API
Abaixo vamos detalhar mais sobre cada opção:
1.1 Cadastro por Formulário
Nesta opção o cadastro é feito diretamente na plataforma. Para isso o usuário precisa ser Administrador ou Gestor de Usuários
Você pode atribuir a permissão de gestor, seguindo: clicar no ícone do seu usuário no canto superior direito > selecionar "Permissões" > selecionar Usuários no campo "Ferramentas" > Adicionar o usuário
Sabendo disso, caso você queria cadastrar, basta somente acessar o menu de usuários, e na tela de usuários acionar a opção Gestão de Usuários > Criar Usuário
Caso você deseje editar um usuário, basta clicar no usuário desejado, e no detalhe do usuário selecionar Gestão > Editar

Você será direcionado então ao formulário de usuário, após isso é só preencher o formulário e clicar em Salvar. Pronto usuário criado!

1.2 Cadastro por Importação de Planilha
Nesta opção o cadastro também é feito através da plataforma, utilizando a importação de uma planilha Excel. Esta opção é ideal, para cadastrar ou atualizar vários usuários de uma só vez
Importante: assim como as demais opções, o usuário que fizer esta ação precisa ser Administrador ou Gestor de Usuários.
Semelhante ao item anterior, ao acessar a tela de Usuários, basta clicar no botão Gestão de Usuários > Criar em Lote

Ao abrir a tela de Importação de Usuários, é preciso primeiramente, fazer o download da planilha. Para isso, basta clicar em Download de Planilhas > Inclusão/Alteração

Importante: O preenchimento da planilha deve atender as instruções exibidas na tela

A planilha de Inclusão/Alteração deve ser preenchida com as informações dos usuários que serão importados ou atualizado, após isso basta clicar na opção Inclusão/Alteração exibido na tela e após isso Selecionar o Arquivo

Após isso, será exibido um resumo das informações planilha, caso esteja tudo ok é só apertar o botão Processar Tabela você pode também clicar em Limpar Tabela para anexar um novo outro arquivo.
Em caso de erro no formato da planilha, uma mensagem explicativa é exibida.
Após o processamento das informações da planilha, caso algum erro seja encontrado será exibido abaixo da tabela, a seção de Relatório da Importação com a lista de erros encontrados, em cada linha do Excel. Segue exemplo

Após corrigir os erros informados, iniciar novamente o processo de importação e anexar o arquivo atualizado. Caso a planilha esteja com todas as informações preenchidas corretamente, será liberado o botão de Salvar.
É possível também associar os usuários que estão sendo cadastrados à um Grupo da plataforma (previamente cadastrado) para isso é só seleciona o Grupo no campo disponível antes de Salvar.

A importação por planilha pode ser utilizada também como forma de atualizar os dados dos usuários já existentes. Para isso o processo é semelhante, basta preencher a planilha com as informações do usuário, importar e ele será atualizado.
Dicas:
O sistema identifica se o usuário da planilha é novo ou uma atualização, através do: e-mail, cpf ou código externo! Ou seja, caso umas das três informações do usuário já esteja atrelada a um usuário existente, entende-se que é uma atualização das informações deste usuário.
O preenchimento de senha é exigido, somente se, o usuário senha um novo cadastro
Campos em verde do Excel são obrigatórios, os em azul, não obrigatórios
1.3 Cadastro por API de Integração
Nesta opção o cadastro é realizado por API de integração. Para isso, é preciso montar uma rotina em linguagem de programação para chamar um dos web-services disponíveis para cadastrar/atualizar usuários , são eles:
createUser - Cadastra um usuário por vez
updateUser - Atualiza as informações de um usuário
insertUpdateUserBatch - Cadastra e/ou atualiza as informações de uma lista de usuários
A descrição de cada campo da API pode ser encontrada em: docs.mybeehome.com