Bloco padrão destinado para o login de um usuário a partir do nome do usuário e senha.

Figura 1 - Bloco Login

As aplicações padrão do Cronapp utilizam esse bloco na função login do arquivo blockly Login nas aplicações Mobile (Localização: Bloco de Programação/Mobile/auth/Login ). 

Compatibilidade

• Bloco cliente: cronapi.authentication.login()

Retorno

Bloco sem retorno.

Parâmetros

Nome do usuário

Nome do usuário para login.

• Posição: 1
• Inglês: Username
• Tipo: Texto / String
• Exemplo: "user"

Senha

Senha do usuário para login.

• Posição: 2
• Inglês: Password
• Tipo: Texto / String
• Exemplo: "minh@Senha"

Opções

Esse parâmetro recebe um token de autenticação proveniente de um provedor externo em aplicações com autenticação via SSO. As aplicações padrão do Cronapp geralmente utilizam autenticação via token e nesse tipo de autenticação o parâmetro Opções pode ficar vazio. Para mais informações sobre os tipos de autenticação, confira o tópico Autenticação e Segurança da documentação Configurações do projeto. 

• Posição: 3
• Inglês: Options
• Tipo: Objeto / Object

Exemplo

A função abaixo através do bloco Obter valor do Campo obtém o nome e a senha do usuário, e a partir disso o bloco Login realiza o login do usuário na aplicação. Visto que a aplicação em questão é do tipo autenticação via token o parâmetro Opções permanece vazio.

Figura 2 - Exemplo de uso do bloco Login

A imagem a seguir mostra uma tela de login de uma aplicação mobile. Após preencher os campos de "Usuário" e "Senha" e clicar no botão "Login" a função da Figura 2 é executada. Se os campos estiverem preenchidos corretamente, o usuário será logado e direcionado para a página inicial da aplicação (Figura 3.1).

Figura 3 - Tela de login de uma aplicação mobile

Figura 3.1 - Resultado exibido a partir das configurações da Figura 2