Module bau_3_0_7_0-bau.gerencia
Base de Autorização Única.
Funções que inserem, atualizam ou criam vinculações de usuários.
Functions
| cadastra_permissao (db, user, recurso, nivel, estrangeira) | Atribui uma nova permissão ao usuário. |
| remove_permissao (db, user, recurso, nivel, estrangeira) | Remove uma permissão existente do usuário. |
| cadastra_usuario (db, matricula, dados) | Cadastra usuário. |
| desliga_usuario (db, user, tab, id, nome_campo) | Desfaz um relacionamento entre o usuario e alguma outra tabela. |
| liga_usuario (db, user, tab, id, nome_campo) | Cria um relacionamento entre o usuario e alguma outra tabela. |
| liga_orientador (db, user, orientador) | Associa (ou desassocia) um aluno a seu orientador. |
| liga_usuario_centro (db, user, centro) | Cria uma ligação entre um usuário e um centro. |
| liga_usuario_programa (db, user, programa) | Cria uma ligação entre um usuário e um programa. |
| liga_usuario_coordenacao (db, user, coordenacao) | Cria uma ligação entre um usuário e uma coordenação. |
| liga_usuario_curso (db, user, curso, extra) | Cria uma ligação entre um usuário e um curso. |
| liga_aluno_area_concentracao (db, user, area_concentracao) | Cria uma ligação entre um aluno e uma área de concentração. |
| atualiza_cadastro (db, usuario) | Atualiza os dados do usuário a partir do que está no SAU. |
Functions
- cadastra_permissao (db, user, recurso, nivel, estrangeira)
-
Atribui uma nova permissão ao usuário.
Dá erro se a permissão já existir (se o nível for programa ou curso,
aceita-se duplicação).
Parameters:
- db Objeto conexão.
- user Identificador do usuário.
- recurso Identificador do recurso.
- nivel Identificador do nível de acesso (ou subselect que obtenha essa informação).
- estrangeira Chave estrangeira quando o nível é curso ou programa.
Returns:
- Número de linhas afetadas (0 ou 1), ou nil (em caso de erro).
- Mensagem de erro (em caso de erro).
- remove_permissao (db, user, recurso, nivel, estrangeira)
-
Remove uma permissão existente do usuário.
Parameters:
- db Objeto conexão.
- user Identificador do usuário.
- recurso Identificador do recurso.
- nivel Identificador do nível de acesso (número ou string; não aceita subselect).
- estrangeira Valor da chave estrangeira para os casos de níveis de acesso que o exijam (curso (3), programa (4) ou coordenacao (9)).
Returns:
-
Número de linhas afetadas (0 ou 1).
- cadastra_usuario (db, matricula, dados)
-
Cadastra usuário.
Parameters:
- db Objeto conexão.
- matricula Matricula do usuário.
- dados Tabela de dados do usuario (tipo é obrigatório).
Returns:
-
Identificador do novo usuário.
- desliga_usuario (db, user, tab, id, nome_campo)
-
Desfaz um relacionamento entre o usuario e alguma outra tabela.
Parameters:
- db Objeto conexão.
- user Identificador do usuário.
- tab String com o nome da outra tabela.
- id Identificador na "outra tabela".
- nome_campo String com o nome do campo (sem o prefixo "id_") na "outra tabela" (opcional).
- liga_usuario (db, user, tab, id, nome_campo)
-
Cria um relacionamento entre o usuario e alguma outra tabela.
No caso de ligação entre usuário e orientador, os parâmetros
devem ser usados da seguinte forma: user == id do aluno,
tab == "usuario", id == id do professor, nome_campo == "orientador".
Parameters:
- db Objeto conexão.
- user Identificador do usuário.
- tab String com o nome da outra tabela.
- id Identificador na "outra tabela".
- nome_campo String com o nome do campo (sem o prefixo "id_") na "outra tabela" (opcional).
Returns:
-
Número de linhas afetadas (0 ou 1).
- liga_orientador (db, user, orientador)
-
Associa (ou desassocia) um aluno a seu orientador.
Parameters:
- db Objeto conexão.
- user Número com o identificador do usuário.
- orientador Número com o identificador do orientador (ou (NULL) para desassociar).
Returns:
-
Número de linhas afetadas (0 ou 1).
- liga_usuario_centro (db, user, centro)
-
Cria uma ligação entre um usuário e um centro.
Parameters:
- db Objeto conexão.
- user Número com o identificador do usuário.
- centro Identificador do centro. (identificador pode ser um sub-select)
Returns:
- Número de linhas inseridas.
- Número com o identificador do centro.
- liga_usuario_programa (db, user, programa)
-
Cria uma ligação entre um usuário e um programa.
Parameters:
- db Objeto conexão.
- user Número com o identificador do usuário.
- programa Identificador do programa. (identificador pode ser um sub-select)
Returns:
- Número de linhas inseridas.
- Número com o identificador do programa.
- liga_usuario_coordenacao (db, user, coordenacao)
-
Cria uma ligação entre um usuário e uma coordenação.
Parameters:
- db Objeto conexão.
- user Número com o identificador do usuário.
- coordenacao Identificador da coordenação. (identificador pode ser um sub-select)
Returns:
- Número de linhas inseridas.
- Número com o identificador da coordenação.
- liga_usuario_curso (db, user, curso, extra)
-
Cria uma ligação entre um usuário e um curso.
Parameters:
- db Objeto conexão.
- user Número com o identificador do usuário.
- curso Identificador do curso. (identificador pode ser um sub-select)
- extra Tabela contendo colunas extras a serem preenchidas.
Returns:
- Número de linhas inseridas.
- Número com o identificador do curso.
- liga_aluno_area_concentracao (db, user, area_concentracao)
-
Cria uma ligação entre um aluno e uma área de concentração.
Parameters:
- db Objeto conexão.
- user Número com o identificador do usuário.
- area_concentracao Identificador da área de concentração. (identificador pode ser um sub-select)
Returns:
- Número de linhas inseridas.
- Número com o identificador da área de concentração.
- atualiza_cadastro (db, usuario)
-
Atualiza os dados do usuário a partir do que está no SAU.
Parameters:
- db Objeto conexão.
- usuario Objeto usuário com dados do SAU.
Returns:
- Boolean indicando se os dados estão iguais.
- String com mensagem sobre o que está diferente.