Module bau_3_0_8_0-bau.usuario
Funções de acesso à tabela usuário.
Functions
| checa_email_problematico (db, email) | Obtém informação sobre um e-mail que _pode_ estar com qualquer problema. |
| guarda_email_problematico (db, email, mensagem) | Guarda informação sobre um e-mail que está com qualquer tipo de problema. |
| remove_email_problematico (db, email) | Remove um e-mail problemático da tabela. |
| vincula_candidato_matricula (db, id_candidato, matricula) | Associa um candidato a um aluno. |
| dados (db, user, mode) | Obtém dados do usuário. |
| busca_por_nome (db, str, tipos) | Busca por usuários a partir de uma parte do nome. |
| busca_ativos (db, str, tipo) | Lista usuários com o nome e tipo dados. |
| busca_por_email (db, str, tipos) | Busca por usuários a partir de uma parte do e-mail. |
| checa_senha_email_tipo (db, email, senha, tipo_usuario) | Verifica a senha de um usuário externo (login via e-mail). |
| candidato_cadastrado (db, email, senha) | Verifica se um usuário existe no sistema. |
| gerar_nova_senha_tipo (db, email, tipo_usuario) | Gera uma nova senha para um usuario do tipo especificado. |
| gerar_nova_senha (db, email) | Gera uma nova senha para o candidato. |
| lista_areas_curso (db, id_usuario) | Lista as áreas de concentração do curso de um usuário. |
| quantidade_areas_curso (db, id_usuario) | Obtém a quantidade de áreas de concentração do curso de um usuário. |
| lista_areas_conhecimento_programa (db, user) | Lista as áreas de conhecimento vinculadas ao programa do aluno. |
| lista_ligacoes_nivel (db, user, nivel) | Lista as ligações de um dado nível do usuário. |
| matricula2id (db, matricula, tipo) | Extrai o id_usuario a partir da matrícula e tipo fornecidos pelo usuário. |
| matricula_ativa (db, matricula, tipo) | Checa se uma matrícula-tipo está ativa (ou seja, data de saída é nula). |
| id_da_matricula (matricula, tipo) | Monta uma consulta para obter o id_usuario a partir da matrícula e do tipo fornecidos. |
| lista_permissoes (db, id_usuario) | Lista todas as permissões de um usuário. |
| existe (db, id_usuario) | Checa se o usuário existe |
| usuarios_com_mesmo_recurso (id_usuario, recurso, tabela, id) | Monta um subselect que obtém os usuários ligados ao mesmo recurso do usuário. |
Functions
- checa_email_problematico (db, email)
-
Obtém informação sobre um e-mail que _pode_ estar com qualquer problema.
Parameters:
- db Objeto de conexão com o banco.
- email String com o e-mail problemático.
Returns:
- String com a mensagem do problema ou nil, se não houver.
- String com a data do cadastro do problema.
- guarda_email_problematico (db, email, mensagem)
-
Guarda informação sobre um e-mail que está com qualquer tipo de problema.
Se já houver alguma mensagem antiga, guarda a nova no lugar e retorna a
antiga.
Parameters:
- db Objeto de conexão com o banco.
- email String com o e-mail problemático.
- mensagem String com informação sobre o problema.
Returns:
-
String com a mensagem antiga ou nil, caso de entrada nova.
- remove_email_problematico (db, email)
-
Remove um e-mail problemático da tabela.
Parameters:
- db Objeto de conexão com o banco.
- email String com o e-mail problemático.
Returns:
-
String com a mensagem antiga ou nil, caso de entrada nova.
- vincula_candidato_matricula (db, id_candidato, matricula)
-
Associa um candidato a um aluno.
Parameters:
- db Objeto de conexão com o banco.
- id_candidato String com o identificador do candidato.
- matricula String com o número de matrícula do aluno.
Returns:
-
Número indicando se a atualização na tabela aluno foi feita.
- dados (db, user, mode)
-
Obtém dados do usuário.
Os dados vêm das tabelas usuario, programa, curso e area_concentracao.
Parameters:
- db Objeto conexão.
- user Identificador do usuário (ou subselect que o obtenha).
- mode String com o modo de obtenção dos dados da LuaSQL ( 'a' ou 'n' ou nil = default) ou com a lista de campos da tabela u).
Returns:
- String com o nome do usuário ou tabela com os campos (caso o parâmetro mode seja 'a' ou 'n').
- String com a matrícula do usuário (matricula).
- String com o email do usuário (email).
- String com o cpf do usuário (cpf).
- String com o nome do curso (curso).
- String com o nome da área de concentração (area).
- String com o nome do programa (programa).
- String com o nome do tipo do usuário (tipo).
- String com o comentário do usuário (comentario).
- String com o identificador do curso (id_curso).
- String com o identificador da área de concentração (id_area).
- String com a data de saída (se houver).
- String com a data de defesa (se houver).
- String com o nome de contato do curso (se houver).
- String com a situação da matrícula.
- String com o identificador do usuário.
- String com o identificador da pessoa (se houver).
- String com o identificador do centro ao qual o usuário está vinculado.
- String com o identificador da unidade ao qual o usuário está vinculado.
- String com o número de inscrição do usuário (se houver).
- String com o código de acesso do usuário (se houver).
- busca_por_nome (db, str, tipos)
-
Busca por usuários a partir de uma parte do nome.
Parameters:
- db Objeto conexão.
- str String com parte do nome a ser buscado (opcional).
- tipos Tabela ou String com os IDs dos tipos de usuários que devem ser incluídos na busca (opcional).
Returns:
-
Iterador que retorna o identificador, o nome, a matrícula,
o email, o cpf, a data de saída (se houver) e o (nome do) tipo
dos usuários encontrados.
- busca_ativos (db, str, tipo)
-
Lista usuários com o nome e tipo dados.
Parameters:
- db Objeto conexão.
- str String com parte do nome/nome_ideal ou matrícula a ser buscado.
- tipo Identificador do tipo do usuário (String ou número).
Returns:
-
Iterador que retorna o identificador do usuário, o nome da pessoa
(ou do usuário, se não houver pessoa), a matrícula, o e-mail, o id do
centro, a sigla do centro.
- busca_por_email (db, str, tipos)
-
Busca por usuários a partir de uma parte do e-mail.
Parameters:
- db Objeto conexão.
- str String com parte do e-mail a ser buscado (opcional).
- tipos String com os IDs dos tipos de usuários que devem ser incluídos na busca (opcional).
Returns:
-
Iterador que retorna o identificador, o nome, a matrícula,
o email, o cpf, a data de saída (se houver) e o (nome do) tipo
dos usuários encontrados.
- checa_senha_email_tipo (db, email, senha, tipo_usuario)
-
Verifica a senha de um usuário externo (login via e-mail).
Valida a senha, caso tenha sido fornecida.
Parameters:
- db Objeto de conexão com o banco.
- email E-mail do usuário externo.
- senha Senha cadastrada anteriormente.
- tipo_usuario ID do tipo de usuário
Returns:
- ID do usuário se existir.
- Booleano indicando se a senha fornecida é a mesma que está guardada no banco de dados.
- candidato_cadastrado (db, email, senha)
-
Verifica se um usuário existe no sistema.
Valida a senha, caso tenha sido fornecida.
Parameters:
- db Objeto de conexão com o banco.
- email E-mail do candidato.
- senha Senha cadastrada anteriormente.
Returns:
-
ID do usuário se existir.
- gerar_nova_senha_tipo (db, email, tipo_usuario)
-
Gera uma nova senha para um usuario do tipo especificado.
Parameters:
- db Objeto de conexão com o banco.
- email E-mail do usuario.
- tipo_usuario String com o identificador do tipo de usuário (aceita subselect).
Returns:
- Identificador do usuário ou nil (caso o e-mail+tipo não exista)
- String com a nova senha.
- gerar_nova_senha (db, email)
-
Gera uma nova senha para o candidato.
Parameters:
- db Objeto de conexão com o banco.
- email E-mail do candidato.
Returns:
-
Nova senha.
- lista_areas_curso (db, id_usuario)
-
Lista as áreas de concentração do curso de um usuário.
Parameters:
- db Objeto conexão.
- id_usuario Identificador do usuário.
Returns:
-
Iterador de áreas (que retorna o id seguido do nome).
- quantidade_areas_curso (db, id_usuario)
-
Obtém a quantidade de áreas de concentração do curso de um usuário.
Parameters:
- db Objeto conexão.
- id_usuario Identificador do usuário.
Returns:
-
Quantidade.
- lista_areas_conhecimento_programa (db, user)
-
Lista as áreas de conhecimento vinculadas ao programa do aluno.
Parameters:
- db Objeto conexão.
- user Identificador do usuário.
Returns:
-
Iterador de áreas de conhecimento (que retorna o id seguido do nome).
- lista_ligacoes_nivel (db, user, nivel)
-
Lista as ligações de um dado nível do usuário.
Parameters:
- db Objeto conexão.
- user Identificador do usuário.
- nivel Identificador do nível de acesso, que pode ser '3' ou conter 'curso' ou '4' ou conter 'programa' ou '9' ou conter 'coordenacao' ou '2' ou conter 'centro'.
Returns:
-
Iterador de ligações (que retorna o id seguido do nome).
- matricula2id (db, matricula, tipo)
-
Extrai o id_usuario a partir da matrícula e tipo fornecidos pelo usuário.
Parameters:
- db Objeto conexão.
- matricula Matricula do usuário.
- tipo String indicando o nome do tipo do usuário.
Returns:
- String com o id_usuario (ou nil, em caso de erro).
- Identificador do tipo do usuário (ou mensagem de erro).
See also:
- matricula_ativa (db, matricula, tipo)
-
Checa se uma matrícula-tipo está ativa (ou seja, data de saída é nula).
Parameters:
- db Objeto conexão.
- matricula Matricula do usuário.
- tipo String indicando o nome do tipo do usuário.
Returns:
-
Booleano indicando se a matrícula está ativa.
- id_da_matricula (matricula, tipo)
-
Monta uma consulta para obter o id_usuario a partir da matrícula e
do tipo fornecidos.
Parameters:
- matricula Matricula do usuário.
- tipo String indicando o nome do tipo do usuário.
Returns:
-
String com consulta (subselect) para obter o id_usuario.
See also:
- lista_permissoes (db, id_usuario)
-
Lista todas as permissões de um usuário.
Parameters:
- db Objeto conexão.
- id_usuario Identificador do usuário.
Returns:
-
Iterador que retorna o identificador do recurso, seu nome, o nível,
seu nome, o identificador "estrangeiro" (ou nil), seu nome (ou nil).
- existe (db, id_usuario)
-
Checa se o usuário existe
Parameters:
- db Objeto conexão.
- id_usuario Identificador do usuário (ou sub-select).
Returns:
-
Identificador (número) do usuário ou nil.
- usuarios_com_mesmo_recurso (id_usuario, recurso, tabela, id)
-
Monta um subselect que obtém os usuários ligados ao mesmo recurso do
usuário.
Parameters:
- id_usuario String com o identificador do usuário (não será "quoted" pela função).
- recurso String com parte do nome do recurso.
- tabela String com o nome da tabela relacionada (programa ou curso).
- id Identificador vinculado (id da tabela de programa ou de curso) (opcional).
Returns:
-
String com trecho de cláusula-where.