Module sapolio.cep

Propostas e Reuniões do Conselho de Ensino e Pesquisa.

As seguintes afirmativas precisam ser sempre verdadeiras: (1) Só pode haver uma única reunião "em aberto" (ou nenhuma estará nesta situação). (2) Todas as propostas que estiverem na fase "Em Pauta" precisam estar vinculadas à reunião que estiver "em aberto". Logo: (a) Assim que uma proposta for vinculada a uma reunião, ela deve mudar da fase "Aguardando Reunião" para a fase "Em Pauta". (b) Se uma proposta for desvinculada de uma reunião, ela deve mudar da fase "Em Pauta" para a fase "Aguardando Reunião". (c) Assim que uma reunião for concluída, todas as propostas vinculadas a ela devem mudar da fase "Em Pauta" para a fase "Resultado Final".

Info:

  • Release: $Id: cep.lua,v 1.73 2016/06/16 17:06:57 tomas Exp $

Functions

lista_fases (db) Iterador de fases das propostas, lista os nomes de todos os estados.
id_colegiados_do_usuario (usuario) Monta subselect que obtém os id_colegiado de um usuário.
id_colegiado_da_reuniao (reuni) Monta subselect que obtém o id_colegiado de uma reunião.
id_colegiado_reuniao (reuni) Retorna o id_colegiado de uma reunião.
id_centro_do_usuario (usuario) Monta subselect que obtém o id_centro de um usuário.
lista_reunioes_parametro (db, usuario) Retorna todas as Reuniões que o usuário pode ver de acordo com o parametro fornecido, caso este não seja passado a função retorna as reuniões em aberto, caso contrário retorna as concluídas.
num_colegiados_usuario (db, id_usuario) Retorna o npumero de colegiados diferentes que dos quaqis o usuário faz parte
lista_reunioes_em_aberto (db, usuario) Retorna todas as Reuniões em aberto que o usuário pode ver.
lista_reunioes_concluidas (db, id_usuario, id_colegiado) Retorna todas as Reuniões concluídas que o usuário pode ver.
lista_conselheiros (db) Lista todos os professores que podem consultar propostas para o CEP.
lista_conselheiros_colegiado (db, colegiado) Lista todos os professores que podem consultar propostas que estiverem em uma reunião de um dado colegiado.
lista_administradores_reuniao (db, colegiado) Lista os usuarios que podem administrar a reunião de um determinado colegiado
lista_colegiados_administrador (db, id_usuario) Lista os colegiados que um usuario administra
lista_colegiados_analise (db, usuario) Lista os órgãos colegiados dos quais o usuário pode gerenciar reuniões.
tipo_proposta2descricao (db, id) Obtém o nome de um tipo de proposta.
tipo_projeto_cepq2descricao (db, id) Obtém o nome de um tipo de projeto para a CEPQ.
lista_tipos_proposta (db) Lista os tipos de proposta para órgãos colegiados.
lista_tipos_projeto_cepq (db) Lista os tipos de projeto para a Câmara de Ética em Pesquisa.
quadro_professor2descricao (db, id) Obtém o nome de um tipo de quadro de professor.
lista_quadro_professor (db) Lista os quadros de professor para propostas de carreira docente.
categoria_professor2descricao (db, id) Obtém o nome de um tipo de categoria de professor.
lista_categoria_professor (db, id_quadro_professor) Lista as categorias de professor para um dado quadro para propostas de carreira docente.
carga_horaria_professor2descricao (db, id) Obtém o nome de um tipo de carga horaria.
lista_carga_horaria_professor (db) Lista as cargas horarias de professor para propostas de carreira docente.
dados_reuniao (db, reuniao, mode) Retorna os dados de uma reunião.
criar_reuniao (db, codigo, data, id_colegiado) Cria uma reunião, se não houver nenhuma em aberto.
alterar_reuniao (db, id_reuniao, codigo, data, id_colegiado) Altera o código e a data de uma reunião.
pode_ser_relator_reuniao (db, id_relator, id_reuniao) Checa se um usuário pode ser relator de propostas da reunião.
alterar_relator_pauta (db, id_reuniao, id_processo, id_relator) Altera o relator de um processo na pauta de uma reunião.
acrescenta_proposta_reuniao (db, id_reuniao, id_proposta, id_relator) Acrescenta uma proposta (com seu relator) a uma reunião.
remove_proposta_reuniao (db, id_reuniao, propostas) Remove proposta de uma reunião a qual ela está associada.
id_da_reuniao_em_aberto (id_colegiado) Monta subselect que obtém o identificador da reunião em aberto.
reuniao_em_aberto (db) Obtém a reunião que estiver criada e ainda não concluída.
concluir_reuniao (db, reuniao) Conclui a reunião.
id_reuniao_atual_proposta (id_processo) Obtém o identificador da reunião de uma proposta.
quantidade_propostas_reuniao (db, id_reuniao) Descobre a quantidade de propostas na pauta da reunião
lista_criadores_proposta (db, id_proposta) Lista os usuários que podem criar propostas como a dada.
lista_implementadores (db, id_proposta) Lista os usuários dos órgãos implementadores selecionados para serem avisados sobre a proposta.
lista_propostas_filhas (db, id_proposta) Lista propostas que tenham sido criadas a partir da proposta dada.
lista_propostas (db, usuario, filtro) Lista propostas de acordo com filtros ou as pendências de um usuário
lista_tipos_prop_sgoc (db, usuario) Lista os tipos de proposta do SGOC que um usuário pode ver, independente de existir algum ativo no momento.
pode_adm_reuniao (db, usuario) Checa se um usuário pode administrar algum tipo de reunião de órgão colegiado.
corrige_dono (db, id_processo, tp, id_usuario) Muda o dono do processo.
remove_conselheiro_colegiado (db, id_conselheiro, id_colegiado) Remove um conselheiro de uma colegiado.
inclui_conselheiro_colegiado (db, id_conselheiro, id_colegiado) Remove um conselheiro de um colegiado.
lista_usuarios_diretores (db, str) Obtém a lista de usuários com perfil de diretor (de unidade/departamento).
lista_av_tri_centros (db) Lista de centros participando da avaliação trienal com a quantidade de processos pendentes
lista_av_tri_unidades (db, id_centro) Lista de unidades de um centro participando da avaliação trienal com a quantidade de processos pendentes
lista_av_tri_processos (db, id_unidade, id_lua_encaminhar) Lista de processos de avaliação trienal de uma unidade
existe_av_tri_a_encaminhar (db, id_unidade, id_lua_encaminhar) Testa se há alguma avaliação da unidade aguardando para ser enviada pelo botão associado ao recurso.

Fields

lista_reunioes_cd_proposta Retorna todas as reuniões do CD pelas quais a proposta passou.
lista_reunioes_decanato_proposta Retorna todas as reuniões do decanato (exceto as do CD) pelas quais a proposta passou.
lista_reunioes_cep_proposta Retorna todas as reuniões do decanato (exceto as do CD) pelas quais a proposta passou.
lista_reunioes_cepq_proposta Retorna todas as reuniões do CEPQ pelas quais a proposta passou.
lista_reunioes_cccd_proposta Retorna todas as reuniões CCCD pelas quais a proposta passou.


Functions

lista_fases (db)
Iterador de fases das propostas, lista os nomes de todos os estados.

Parameters:

  • db Objeto conexão com o banco de dados.

Returns:

    Iterador que retorna o nome de cada fase.
id_colegiados_do_usuario (usuario)
Monta subselect que obtém os id_colegiado de um usuário.

Parameters:

  • usuario Identificador do usuário (aceita subselect).

Returns:

    String com o subselect.
id_colegiado_da_reuniao (reuni)
Monta subselect que obtém o id_colegiado de uma reunião.

Parameters:

  • reuni ão Identificador da reunião (aceita subselect).

Returns:

    String com o subselect.
id_colegiado_reuniao (reuni)
Retorna o id_colegiado de uma reunião.

Parameters:

  • reuni ão Identificador da reunião (aceita subselect).

Returns:

    String com o subselect.
id_centro_do_usuario (usuario)
Monta subselect que obtém o id_centro de um usuário.

Parameters:

  • usuario Identificador do usuário (aceita subselect).

Returns:

    String com o subselect.
lista_reunioes_parametro (db, usuario)
Retorna todas as Reuniões que o usuário pode ver de acordo com o parametro fornecido, caso este não seja passado a função retorna as reuniões em aberto, caso contrário retorna as concluídas.

Parameters:

  • db Objeto conexão com o banco de dados.
  • usuario Identificador do usuário (aceita subselect).

Returns:

    Iterador que retorna pares (id, descricao) para cada fase.
num_colegiados_usuario (db, id_usuario)
Retorna o npumero de colegiados diferentes que dos quaqis o usuário faz parte

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_usuario Identificador do usuário.

Returns:

    Número de colegiados diferentes de um usuario
lista_reunioes_em_aberto (db, usuario)
Retorna todas as Reuniões em aberto que o usuário pode ver.

Parameters:

  • db Objeto conexão com o banco de dados.
  • usuario Identificador do usuário (aceita subselect).

Returns:

    Iterador que retorna pares (id, descricao) para cada fase.
lista_reunioes_concluidas (db, id_usuario, id_colegiado)
Retorna todas as Reuniões concluídas que o usuário pode ver.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_usuario Identificador do usuário (aceita subselect).
  • id_colegiado Identificador do colegiado (aceita subselect).

Returns:

    Iterador que retorna pares (id, descricao) para cada fase.
lista_conselheiros (db)
Lista todos os professores que podem consultar propostas para o CEP.

Parameters:

  • db Objeto conexão com o banco de dados.

Returns:

    Iterador que retorna pares (id, nome) de cada conselheiro.
lista_conselheiros_colegiado (db, colegiado)
Lista todos os professores que podem consultar propostas que estiverem em uma reunião de um dado colegiado.

Parameters:

  • db Objeto conexão com o banco de dados.
  • colegiado Identificação do colegiado (aceita subselect).

Returns:

    Iterador que retorna pares (id, nome) de cada conselheiro.
lista_administradores_reuniao (db, colegiado)
Lista os usuarios que podem administrar a reunião de um determinado colegiado

Parameters:

  • db Objeto conexão com o banco de dados.
  • colegiado Identificação do colegiado.

Returns:

    Iterador que retorna pares (id, nome, e-mail) de cada usuario.
lista_colegiados_administrador (db, id_usuario)
Lista os colegiados que um usuario administra

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_usuario Identificado do usuário

Returns:

    Iterador que retorna as informações do colegiado (id, sigla e nome).
lista_colegiados_analise (db, usuario)
Lista os órgãos colegiados dos quais o usuário pode gerenciar reuniões.

Parameters:

  • db Objeto conexão com o banco de dados.
  • usuario Identificador do usuário (aceita subselect).

Returns:

    Iterador que retorna pares (id, nome) de cada conselheiro.
tipo_proposta2descricao (db, id)
Obtém o nome de um tipo de proposta.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id Identificador do tipo de proposta.

Returns:

    String com o nome do tipo de proposta.
tipo_projeto_cepq2descricao (db, id)
Obtém o nome de um tipo de projeto para a CEPQ.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id Identificador do tipo de proposta.

Returns:

    String com o nome do tipo de projeto.
lista_tipos_proposta (db)
Lista os tipos de proposta para órgãos colegiados.

Parameters:

  • db Objeto conexão com o banco de dados.

Returns:

    Iterador que retorna pares (id, nome) de cada tipo de proposta.
lista_tipos_projeto_cepq (db)
Lista os tipos de projeto para a Câmara de Ética em Pesquisa.

Parameters:

  • db Objeto conexão com o banco de dados.

Returns:

    Iterador que retorna pares (id, nome) de cada tipo de projeto.
quadro_professor2descricao (db, id)
Obtém o nome de um tipo de quadro de professor.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id Identificador do quadro.

Returns:

    String com o nome do quadro.
lista_quadro_professor (db)
Lista os quadros de professor para propostas de carreira docente.

Parameters:

  • db Objeto conexão com o banco de dados.

Returns:

    Iterador que retorna pares (id, nome) de quadro.
categoria_professor2descricao (db, id)
Obtém o nome de um tipo de categoria de professor.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id Identificador da categoria.

Returns:

    String com o nome da categoria.
lista_categoria_professor (db, id_quadro_professor)
Lista as categorias de professor para um dado quadro para propostas de carreira docente.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_quadro_professor Identificador do quadro de professor cujas categorias serão listadas.

Returns:

    Iterador que retorna pares (id, nome) de categoria.
carga_horaria_professor2descricao (db, id)
Obtém o nome de um tipo de carga horaria.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id Identificador da caraga horaria.

Returns:

    String com o valor da carga horaria.
lista_carga_horaria_professor (db)
Lista as cargas horarias de professor para propostas de carreira docente.

Parameters:

  • db Objeto conexão com o banco de dados.

Returns:

    Iterador que retorna pares (id, valor) de carga horária.
dados_reuniao (db, reuniao, mode)
Retorna os dados de uma reunião.

Parameters:

  • db Objeto conexão com o banco de dados.
  • reuniao Identificador da reunião (aceita subselect).
  • 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).

Returns:

  1. String com o identificador da reunião ou tabela com os campos (caso o parâmetro 'mode' seja 'a' ou 'n').
  2. String com o código da reunião.
  3. String com a data da reunião.
  4. String indicando se a reunião se foi concluída ('t') ou não ('f').
criar_reuniao (db, codigo, data, id_colegiado)
Cria uma reunião, se não houver nenhuma em aberto.

Parameters:

  • db Objeto conexão com o banco de dados.
  • codigo String com o código da reunião.
  • data String com a data da realização da reunião.
  • id_colegiado Identificador do colegiado (aceita subselect).

Returns:

  1. Identificador da reunião ou nil, caso exista reunião em aberto.
  2. String com mensagem de erro, se houver.
alterar_reuniao (db, id_reuniao, codigo, data, id_colegiado)
Altera o código e a data de uma reunião.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_reuniao Identificador da reunião (aceita subselect).
  • codigo String com o novo código da reunião.
  • data String com a nova data da realização da reunião.
  • id_colegiado Identificador do colegiado (aceita subselect).

Returns:

  1. Número de linhas alteradas no banco (1, caso OK, ou 0, caso não tenha encontrado a reunião).
  2. String com mensagem de erro (se houver).
pode_ser_relator_reuniao (db, id_relator, id_reuniao)
Checa se um usuário pode ser relator de propostas da reunião.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_relator Identificador do relator (aceita subselect).
  • id_reuniao Identificador da reunião e compõe a chave da tabela pauta (aceita subselect).

Returns:

    Booleano indicando se o usuário pode ser relator da reunião.
alterar_relator_pauta (db, id_reuniao, id_processo, id_relator)
Altera o relator de um processo na pauta de uma reunião.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_reuniao Identificador da reunião e compõe a chave da tabela pauta (aceita subselect).
  • id_processo Identificador do processo e compõe a chave da tabela pauta.
  • id_relator Identificador do relator.

Returns:

  1. Número de linhas alteradas no banco (1, caso OK, ou 0, caso não tenha encontrado a reunião).
  2. String com mensagem de erro (se houver).
acrescenta_proposta_reuniao (db, id_reuniao, id_proposta, id_relator)
Acrescenta uma proposta (com seu relator) a uma reunião.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_reuniao Identificador da reunião (aceita subselect).
  • id_proposta Identificador do processo que representa a proposta (aceita subselect).
  • id_relator Identificador do usuário indicado como relator (aceita subselect).

Returns:

  1. Número de linhas alteradas no banco, em caso de sucesso, ou nil, em caso de problema com o relator.
  2. String com mensagem de erro, se houver.
remove_proposta_reuniao (db, id_reuniao, propostas)
Remove proposta de uma reunião a qual ela está associada.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_reuniao Número identificador da reunião.
  • propostas String com o identificador de uma proposta ou array de identificadores de propostas.

Returns:

    Número de propostas removidas.
id_da_reuniao_em_aberto (id_colegiado)
Monta subselect que obtém o identificador da reunião em aberto.

Parameters:

  • id_colegiado
reuniao_em_aberto (db)
Obtém a reunião que estiver criada e ainda não concluída.

Parameters:

  • db Objeto conexão com o banco de dados.

Returns:

    Identificador da reunião (ou nil, caso não haja nenhuma em aberto).
concluir_reuniao (db, reuniao)
Conclui a reunião.

Parameters:

  • db Objeto conexão com o banco de dados.
  • reuniao Identificador da reunião (aceita subselect).

Returns:

  1. Booleano, indicando se correu tudo bem ou não.
  2. String com mensagem de erro (se houver).
id_reuniao_atual_proposta (id_processo)
Obtém o identificador da reunião de uma proposta.

Parameters:

  • id_processo Identificador da proposta (aceita subselect).

Returns:

    Identificador da reunião da proposta ou nil, caso não exista.
quantidade_propostas_reuniao (db, id_reuniao)
Descobre a quantidade de propostas na pauta da reunião

Parameters:

  • db Objeto de conexão com o banco de dados
  • id_reuniao Número identificador da reuniao (obrigatório, aceita subselect)

Returns:

    Quantidade de propostas na pauta da reunião
lista_criadores_proposta (db, id_proposta)
Lista os usuários que podem criar propostas como a dada.

Parameters:

  • db Objeto de conexão com o banco de dados
  • id_proposta Identificador da proposta (aceita subselect).

Returns:

    Iterador que retorna o id e o nome dos usuários que podem criar propostas deste tipo.
lista_implementadores (db, id_proposta)
Lista os usuários dos órgãos implementadores selecionados para serem avisados sobre a proposta.

Parameters:

  • db Objeto de conexão com o banco de dados
  • id_proposta Identificador da proposta (aceita subselect).

Returns:

    Iterador que retorna o id e o nome dos usuários que devem ser notificados da finalização da proposta.
lista_propostas_filhas (db, id_proposta)
Lista propostas que tenham sido criadas a partir da proposta dada.

Parameters:

  • db Objeto de conexão com o banco de dados.
  • id_proposta Identificador da proposta (aceita subselect).

Returns:

    Iterador que retorna o id e o título das propostas encontradas.
lista_propostas (db, usuario, filtro)
Lista propostas de acordo com filtros ou as pendências de um usuário

Parameters:

  • db Objeto conexão com o banco de dados.
  • usuario Identificador do usuário.
  • filtro Tabela contendo campos para filtragem: * id_proposta Número identificador de uma proposta * tipo_processo Número (ou string com lista de números separados por vírgulas) do(s) tipo(s) de processo que podem constar do resultado (opcional). * fase String com o tipo de fase: pendencias, todos ou a descrição de alguma fase (opcional). * id_centro Número identificador do centro * id_unidade Número identificador da unidade * id_tipo_proposta Número identificador do tipo de proposta * id_colegiado Número identificador do colegiado * titulo_proposta Texto do título da proposta (ou parte) * descricao_proposta Texto da descrição da proposta (ou parte)

Returns:

    Iterador de propostas que retorna os campos: id_proposta, titulo_proposta, tipo_proposta (string), descricao_estado, estado_atual, estado_final, ultima_alteracao, status e unidade
lista_tipos_prop_sgoc (db, usuario)
Lista os tipos de proposta do SGOC que um usuário pode ver, independente de existir algum ativo no momento.

Parameters:

  • db Objeto conexão com o banco de dados.
  • usuario Identificador do usuário.

Returns:

    Iterador que retorna: identificador do tipo de processo, seu nome, identificador do recurso de consulta.
pode_adm_reuniao (db, usuario)
Checa se um usuário pode administrar algum tipo de reunião de órgão colegiado.

Parameters:

  • db Objeto conexão com o banco de dados.
  • usuario Identificador do usuário (aceita subselect).

Returns:

    Booleano indicando se o usuário pode convocar reuniões.
corrige_dono (db, id_processo, tp, id_usuario)
Muda o dono do processo. O novo dono pode ser o pseudo-usuário da unidade (nos casos de processos de admissão (39) ou cep (32 ou 66) ou avaliação trienal (71)) ou o novo dono pode ser o professor cuja matrícula está indicada no campo com id_lua 'matricula_professor'.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_processo Identificador do processo (não aceita subselect).
  • tp Número com o identificador do tipo de processo (não aceita subselect).
  • id_usuario Identificador do usuário que está criando/modificando o processo (aceita subselect).
remove_conselheiro_colegiado (db, id_conselheiro, id_colegiado)
Remove um conselheiro de uma colegiado.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_conselheiro Identificador do a ser removido.
  • id_colegiado Identificador do colegiado.
inclui_conselheiro_colegiado (db, id_conselheiro, id_colegiado)
Remove um conselheiro de um colegiado.

Parameters:

  • db Objeto conexão com o banco de dados.
  • id_conselheiro Identificador do a ser removido.
  • id_colegiado Identificador do colegiado.
lista_usuarios_diretores (db, str)
Obtém a lista de usuários com perfil de diretor (de unidade/departamento).

Parameters:

  • db Objeto conexão.
  • str String opcional com parte do nome dos usuários ou da unidade.

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.
lista_av_tri_centros (db)
Lista de centros participando da avaliação trienal com a quantidade de processos pendentes

Parameters:

  • db Objeto conexão.

Returns:

    Iterador que retorna o identificador, nome do centro e quantidade de processos pendentes
lista_av_tri_unidades (db, id_centro)
Lista de unidades de um centro participando da avaliação trienal com a quantidade de processos pendentes

Parameters:

  • db Objeto conexão.
  • id_centro Identificador do centro (aceita subselect).

Returns:

    Iterador que retorna o identificador, nome da unidade e quantidade de processos pendentes
lista_av_tri_processos (db, id_unidade, id_lua_encaminhar)
Lista de processos de avaliação trienal de uma unidade

Parameters:

  • db Objeto conexão.
  • id_unidade Identificador da unidade (aceita subselect).
  • id_lua_encaminhar String com o id_lua do recurso que controla o botão de encaminhamento.

Returns:

    Iterador que retorna o identificador, titulo, ..., e fase dos processos
existe_av_tri_a_encaminhar (db, id_unidade, id_lua_encaminhar)
Testa se há alguma avaliação da unidade aguardando para ser enviada pelo botão associado ao recurso.

Parameters:

  • db Objeto conexão.
  • id_unidade Identificador da unidade (aceita subselect).
  • id_lua_encaminhar String com o id_lua do recurso que controla o botão de encaminhamento.

Returns:

    Booleano indicando se há alguma avaliação aguardando.

Fields

lista_reunioes_cd_proposta
Retorna todas as reuniões do CD pelas quais a proposta passou.
  • db Objeto conexão com o banco de dados.
  • proposta Identificador da proposta (id_processo).
lista_reunioes_decanato_proposta
Retorna todas as reuniões do decanato (exceto as do CD) pelas quais a proposta passou.
  • db Objeto conexão com o banco de dados.
  • proposta Identificador da proposta (id_processo).
lista_reunioes_cep_proposta
Retorna todas as reuniões do decanato (exceto as do CD) pelas quais a proposta passou.
  • db Objeto conexão com o banco de dados.
  • proposta Identificador da proposta (id_processo).
lista_reunioes_cepq_proposta
Retorna todas as reuniões do CEPQ pelas quais a proposta passou.
  • db Objeto conexão com o banco de dados.
  • proposta Identificador da proposta (id_processo).
lista_reunioes_cccd_proposta
Retorna todas as reuniões CCCD pelas quais a proposta passou.
  • db Objeto conexão com o banco de dados.
  • proposta Identificador da proposta (id_processo).
generated by LDoc 1.4.6 Last updated 2023-06-20 11:33:24