Module `sapolio`

API de acesso ao banco de dados do Sapólio.

Functions

inscricoes (tp)	Verifica se o tipo do requerimento é de inscrições.
processo_em_tramitacao (db)
em_exigencia_ao_dono (db, id)	Retorna TRUE caso o processo esteja em um estado de exigência.
em_pagamento (db, id)	Retorna TRUE caso o processo esteja em fase de confirmação de pagamento.
pode_estar_pendente (db, id_processo)	Retorna TRUE caso o processo esteja em fase em que possa ser pendência para algum usuário.
lista_boletos (db)	Iterador de boletos, lista todos os boletos (não cancelados) na fase de "Confirmação de pagamento", com status temporário ou ativo.
lista_tipos_processo (db, usuario, circulacao)	Lista os tipos de processo (ignora propostas para órgãos colegiados) que um usuário pode ver, independente de existir algum ativo no momento.
lista_tipos_requerimentos (db, usuario)	Lista os tipos de processo (ignora propostas para órgãos colegiados) que um usuário pode ver, independente de existir algum ativo no momento.
lista_tipos_processo_ativos (db, usuario, circulacao)	Lista os tipos de processo ativos (ignora propostas para órgãos colegiados) que um usuário pode ver, independente de existir algum ativo no momento.
tipos_processo (db, usuario, sistema)	Iterador de tipos de processo que o usuário pode criar.
lista_estados (db, tipo, estado)	Retorna a descrição em ordem dos estados de um tipo de processo.
ultimo_estado (db, id_processo)	Retorna TRUE caso o processo esteja no último estado.
no_estado_inicial (db, id_processo)	Retorna TRUE caso o processo esteja no primeiro estado.
aguardando_entrega_material (db, id_processo)	Retorna TRUE caso o processo esteja na fase de entrega do material.
estado_aparente (db, id_processo)	Retorna o estado atual do processo (estado_aparente).
campos_fixos (db, proc)	Iterador dos campos "fixos" do processo.
restricao_por_nivel (nivel, usuario, tab)	Monta uma restrição de acordo com o nível de acesso do usuário.
busca_botao_pular (db, id_usuario, id_processo)	Procura um botão-pular que tenha o id_lua dado.
botoes (db, usuario, proc)	Obtém os dados dos botões visíveis.
botao_id_lua (db, usuario, proc, id_lua)	Obtém o botão com o id_lua dado.
dados_botao (db, id_campo, tipo_processo)	Obtém dados sobre um botão.
lista_fases (db)	Iterador de fases, lista os nomes de todos os estados de todos os tipos de processo.
lista_fases_atuaveis (db)	Iterador de fases, lista os nomes de todos os estados de todos os tipos de processo que o usuário tem algum botão de ação disponível.
muda_estado (db, usuario, proc)	Recalcula o estado do processo.
salva_processo (db, usuario, proc)	Salva o processo, efetuando eventuais "efeitos colaterais".
corrige_dono_aluno (db, id)	Muda o dono do processo para o usuário cuja matrícula está indicada no campo de id_lua 'matricula_aluno'.
corrige_dono_pseudo_usuario (db, id)	Muda o dono do processo para o pseudo-usuário da unidade do dono
corrige_dono_professor (db, id)	Preenche id_unidade com id_unidade om id_usuario do professor
corrige_coordenacao (db, id, id_coordenacao)	Muda a coordenação do processo.
lista_processos (db, usuario, filtro)	Lista todos os processos que um usuário pode ver.
dados_processo (db, id, expandidos, versao)	Obtém todos os dados do processo.
tem_acesso_processo (db, user, id_processo)	Verifica se um usuário pode ter acesso a um processo.
tipo_processo2descricao (db, id)	Obtém a descrição de um tipo de processo.
tipo_processo2explicacao (db, tipo)	Obtém a descrição e a explicação de um tipo de processo.
tipo_processo_campo2explicacao (db, tipo_processo, id_campo)
estado2descricao (db, tp, estado)	Obtém a descrição e a explicacao de um estado.
curso_programa_sau_processo (db, id_processo)	Obtém o código SAU do curso e do programa de um processo.
descricao2status (status)	Monta SQL para obter o id de um status a partir de parte de sua descrição.
cancela_processo (db, id_processo, mensagem)	Cancela um processo registrando o motivo na tabela log.
estado_do_processo (id_processo)	Monta SQL para obter o estado de um processo a partir de seu id.
tipo_do_processo (id_processo)	Monta SQL para obter o tipo de um processo a partir de seu id.
tipo_processo (id_processo)	Retorna o tipo de um processo a partir de seu id.
aluno_do_processo (id_processo)	Monta SQL para obter o usuário (id) de um processo a partir de seu id.
curso_do_aluno_do_processo (id_processo)	Monta SQL para obter o curso (id) do dono de um processo a partir de seu id.
curso_do_processo (id_processo)	Monta SQL para obter o curso (id) vinculado ao processo.
programa_do_processo (id_processo)	Monta SQL para obter o programa (id) vinculado ao processo.
coordenacao_do_processo (id_processo)	Monta SQL para obter a coordenação (id) associada a um processo a partir de seu id.
unidade_do_processo (id_processo)	Monta SQL para obter a unidade (id) associada a um processo a partir do seu id.
boleto2processo (db, id_processo)
boleto (db, id_processo)	Obtém o número do boleto de um dado processo.
estados (db, id_processo)	Obtém dados sobre os estados de um processo (atual, retorno, alteração).
dono_processo (db, id)	Obtém o usuário que criou o processo.
matricula_do_dono (id_processo)	Monta subselect que obtém a matrícula do dono do processo (assumindo que é um aluno).
professor_processo (db, user)	Obtém o professor (id) de um processo.
pode_criar_banca_aluno (db, id_usuario, id_aluno)	Checa se o usuário pode criar uma proposta de banca para o aluno.
pode_alterar_prazos_requerimentos (db, usuario)	Indica se o usuário pode alterar prazos e taxas de requerimentos.
pode_anotar_inscricao (db, usuario, id_processo)	Indica se o usuário pode anotar a dada inscrição.
pode_analizar_inscricao (db, usuario, id_processo)	Indica se o usuário pode analizar a dada inscrição.
pode_filtrar (db, user)	Indica se o usuário pode ver mais dados que os seus próprios.
pode_filtrar_requerimentos (db, user)	Indica se o usuário pode ver mais dados que os seus próprios.
pode_configurar_alunos (db, user)	Indica se o usuário pode configurar alunos do programa.
pode_configurar_usuario (db, usuario, id_usuario)	Verifica se um usuário pode configurar outro usuário.
pode_configurar (db, usuario)	Verifica se um usuário está vinculado a algum recurso de configuração.
salva_dados_id_lua (db, id_processo, campos)	Altera uma lista de campos na tabela detalhe_processo, a partir de uma tabela com id_lua's.
salva_dados_id_campo (db, id_processo, campos)	Salva os dados fornecidos nos detalhes do processo.
id_campo_do_id_lua_do_processo (id_processo, id_lua)	Monta subselect que obtém o id_campo do id_lua de um processo.
id_campo_do_id_lua (tp, id_lua)	Monta subselect que obtém o id_campo do id_lua de um dado tipo.
id_lua2id_campo (db, tp, id_lua)	Obtém o id_campo de um tipo de processo e um id_lua.
id_campo2id_lua (db, tp, id_campo)	Obtém o id_lua de um tipo de processo e um id_campo.
valor_do_id_lua (id_processo, id_lua, type_cast)	Monta subselect que obtém o valor correspondente ao id_lua do processo.
valor_id_lua (db, id_processo, id_lua)	Obtém dados do detalhamento de um requerimento a partir dos id_lua.
lista_professores_coordenacao_processo (db, id_processo)	Lista os professores da coordenacao mencionada no requerimento.
lista_professores_programa_processo (db, id_processo, lista_ids_profs)	Lista os professores do programa do curso mencionada no requerimento.
lista_responsaveis_inscricao (db, id_processo)	Lista os usuários responsáveis pela seleção da inscrição.
responsavel_isencao (db, id_processo, id_usuario)	Obtém o nome do cargo do responsável pela isenção de um processo.
pode_criar_comentario (db, id_processo, id_usuario, Booleano)	Identifica se um usuário pode criar um comentário.
responsaveis_processo (db, id_processo)	Lista os responsáveis pelo processo dado.
pode_editar_processo (db, id_processo, id_usuario)	Checa se o usuário é um dos responsáveis pelo processo.
pode_criar (db, tipo_processo, usuario, id_aluno, id_processo)	Verifica se um usuário pode criar um processo
gera_cobranca_valor (db, id_processo, valor, vencimento)	Gera uma cobrança para o processo com valor e prazo dados.
gera_cobranca (db, id_processo)	Gera uma nova cobrança para o processo dado.
defesa_com_matricula (db, matricula, exceto)	Procura se há uma defesa (tipo 9 ou 10) ativa (e não reprovada) com essa matrícula.
consulta_anteriores (db, matricula, tipo_processo, exceto)	Conta processos de um dado tipo e de uma matrícula.
conta_processos_tipo (db, id_dono, tipo_processo, filtros)	Conta processos de um dado tipo e de um dado dono.
conta_processos_tipo_tramitando (db, id_dono, tipo_processo, exceto)	Conta processos em tramitação de um dado tipo e de um dado dono.
conta_processos_tipo_criados (db, id_dono, tipo_processo, exceto)	Conta processos criados e não concluídos de um dado tipo e de um dado dono.
conta_processos_tipo_encaminhados (db, id_dono, tipo_processo, exceto)	Conta processos encaminhados de um dado tipo e de um dado aluno.
pode_consultar_coordenadores (db, usuario)	Checa se um usuário pode consultar quem são os coordenadores.
pode_consultar_cep (db, usuario)	Checa se um usuário pode consultar alguma proposta para órgão colegiado.
pode_encaminhar_propostas (db, usuario)	Checa se um usuário pode encaminhar proposta da unidade.
pode_encaminhar_propostas_tipo (db, usuario)	Checa se um usuário pode encaminhar proposta da unidade.
pode_consultar_requerimentos (db, usuario)	Checa se um usuário pode consultar algum requerimento.
pode_exportar_identificacao (db, usuario)	Checa se um usuário pode exportar identificações de candidatos.
pode_exportar_anexos (db, usuario)	Checa se um usuário pode exportar os arquivos anexos das inscrições.
pode_configurar_inscricao (db, usuario, curso)	Checa se um usuário pode editar a configuração do processo seletivo para um dado curso.
pode_preencher_em_bloco (db, usuario, curso)	Checa se o usuário tem permissão para usar a ferramenta de preenchimento em bloco.
tem_outras_versoes (db, id_processo)	Verifica se o processo tem outras versões.
lista_versoes (db, id_processo)	Lista as "versões" de um processo.
ultima_versao (db, id_processo)	Verifica se a versão dada é a última versão do processo.
tipo_circulacao (db)	Obtém a circulação de um tipo de processo.
gera_numero_oficio_dar (db, id_processo, id_usuario)	Gera um novo número para ofícios para a DAR e guarda-o no processo.
lista_recomendantes_com_emails_problematicos (db)	Iterador de emails problemáticos dos recomendantes de um candidato, lista os emails problemáticos dos recomendantes e as mensagens de erro recebidas.
lista_processos_calouro (db, id_usuario)	Lista os processos de matrícula de calouro.
processo_pronto_para_matricula (db, id_usuario)	Retorna o processo do calouro que esteja pronto para matrícula.
ingresso_matricula (db, matricula)	Obtém a modalidade de ingresso a partir de uma matrícula.
historico_matricula (db, matricula)	Retorna o id_anexo do histórico (se houver) que foi anexado ao requerimento de ingresso desta matrícula.
deduz_inscricao (db, id_usuario)	Obtém o número de inscrição de um aluno a partir de seu processo de entrega de documentação
copia_processo (db, id_processo, id_usuario)	Copia os dados de um processo.
gera_numero_ato (db, id_processo)	Gera um novo número para o ato do decano do centro do dono do processo.
remove_usuario_duplicado (db, id_usuario, id_remove)	Remove usuário duplicado, corrigindo as referências para o que ficar.
config_matricula_em (db, data)	Obtém as configurações para matrícula em vigor.
config_matricula_id (db, id_convocacao)	Obtém as configurações para matrícula da convocação dada.
config_matricula_desc (db, descricao)	Obtém as configurações para matrícula da convocação dada.
config_matricula_processo (db, id_processo)	Obtém as configurações para matrícula da convocação dada.
lista_configuracoes_matricula (db, recentes)	Lista as convocações

Fields

botoes_coment	Iterador de botões para acrescentar comentário ao processo.
botoes_saida	Iterador de botões de impressão de dados do processo.
botoes_info	Iterador de botões de informação sobre o processo.
campos_dados	Iterador dos campos de dados do processo.

Functions

inscricoes (tp)

Verifica se o tipo do requerimento é de inscrições.

Parameters:

tp String ou número com um identificador de tipo de requerimento (não aceita subselect!).

Returns:

Booleano indicando se o tipo é de inscrição.

processo_em_tramitacao (db)

Parameters:

db Objeto conexão com o banco de dados.

Returns:

String 't' caso o requerimento esteja em tramitação.

em_exigencia_ao_dono (db, id)

Retorna TRUE caso o processo esteja em um estado de exigência.

Parameters:

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

Returns:

Booleano indicando se o processo está em exigência (true) ou não (false).

em_pagamento (db, id)

Retorna TRUE caso o processo esteja em fase de confirmação de pagamento.

Parameters:

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

Returns:

Booleano indicando se o processo está aguardando o pagamento (true) ou não (false).

pode_estar_pendente (db, id_processo)

Retorna TRUE caso o processo esteja em fase em que possa ser pendência para algum usuário.

Parameters:

db
id_processo

lista_boletos (db)

Iterador de boletos, lista todos os boletos (não cancelados) na fase de "Confirmação de pagamento", com status temporário ou ativo.

Parameters:

db Objeto conexão com o banco de dados.

Returns:

Iterador que retorna pares (id, descricao) para cada boleto.

lista_tipos_processo (db, usuario, circulacao)

Lista os tipos de processo (ignora propostas para órgãos colegiados) 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.
circulacao String com o tipo de circulacao dos tipos (opcional).

Returns:

Iterador que retorna: identificador do tipo de processo, seu nome, identificador do recurso de criação e seu nome.

lista_tipos_requerimentos (db, usuario)

Lista os tipos de processo (ignora propostas para órgãos colegiados) 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, circulação.

lista_tipos_processo_ativos (db, usuario, circulacao)

Lista os tipos de processo ativos (ignora propostas para órgãos colegiados) 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.
circulacao String com o tipo de circulacao dos tipos (opcional).

Returns:

Iterador que retorna: identificador do tipo de processo, seu nome e a circulação.

tipos_processo (db, usuario, sistema)

Iterador de tipos de processo que o usuário pode criar. A lista de tipos de processo vem em ordem alfabética de descrição. Na verdade, a restrição aos tipos de processo é feita de acordo com o recurso ligado ao tipo de processo; se o usuário tiver algum direito de acesso a esse recurso, o tipo de processo será listado.

Parameters:

db Objeto conexão com o banco de dados.
usuario Identificador do usuário.
sistema String com o nome do sistema (valores válidos: SAP e CEP; default = nil).

Returns:

Iterador que retorna tuplas (id, descricao, explicacao) para cada tipo de processo.

lista_estados (db, tipo, estado)

Retorna a descrição em ordem dos estados de um tipo de processo.

Parameters:

db Objeto conexão com o banco de dados.
tipo Identificador do tipo do processo.
estado Indica o estado atual do processo (necessário para calcular os estados inicial e exigência, e desconsiderar os dois últimos estados caso ainda não se tenha chegado em Recurso).

Returns:

Iterador que retorna (estado, descricao).

ultimo_estado (db, id_processo)

Retorna TRUE caso o processo esteja no último estado.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo.

Returns:

Boolean.

no_estado_inicial (db, id_processo)

Retorna TRUE caso o processo esteja no primeiro estado.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo.

Returns:

Boolean.

aguardando_entrega_material (db, id_processo)

Retorna TRUE caso o processo esteja na fase de entrega do material.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo.

Returns:

Booleano.

estado_aparente (db, id_processo)

Retorna o estado atual do processo (estado_aparente). Se o estado_aparente for -1, usa o estado_aparente do estado_retorno.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo.

Returns:

Número do estado aparente do processo.

campos_fixos (db, proc)

Iterador dos campos "fixos" do processo. Os campos matrícula e nome sempre aparecem nos processos. Quando o processo ainda não foi criado, é necessário incluir os campos tipo_processo, estado e id_usuario também.

Parameters:

db Objeto conexão com o banco de dados.
proc Tabela com os dados do processo.

Returns:

Iterador de campos "fixos" do processo.

restricao_por_nivel (nivel, usuario, tab)

Monta uma restrição de acordo com o nível de acesso do usuário.

Parameters:

nivel Número (no banco) do nível de acesso.
usuario String (ou número) com o identificador do usuário.
tab Tabela com programas, cursos e coordenacoes de um usuário.

Returns:

String com trecho de SQL

busca_botao_pular (db, id_usuario, id_processo)

Procura um botão-pular que tenha o id_lua dado.

Parameters:

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

Returns:

Iterador que retorna: id_campo, descrição, valor, classe, dica, observação e id_lua.

botoes (db, usuario, proc)

Obtém os dados dos botões visíveis.

Parameters:

db Objeto conexão com o banco de dados.
usuario Identificador do usuário.
proc Tabela com alguns dados do processo (precisa ter os campo estado e tipo_processo).

Returns:

Tabela (indexada pelas classes) com todos os botões visíveis.

botao_id_lua (db, usuario, proc, id_lua)

Obtém o botão com o id_lua dado.

Parameters:

db Objeto conexão com o banco de dados.
usuario Identificador do usuário.
proc Tabela com alguns dados do processo (precisa ter os campo estado e tipo_processo).
id_lua String com o valor do id_lua do botão.

Returns:

Tabela com os dados do botão.

dados_botao (db, id_campo, tipo_processo)

Obtém dados sobre um botão.

Parameters:

db Objeto conexão com o banco de dados.
id_campo Identificador do botão dentro dos campos do tipo de processo.
tipo_processo Identificador do tipo do processo.

Returns:

String com a descrição do botão.
String com a classe do botão.
String com a dica.
String com o tipo do campo.

lista_fases (db)

Iterador de fases, lista os nomes de todos os estados de todos os tipos de processo.

Parameters:

db Objeto conexão com o banco de dados.

Returns:

Iterador que retorna pares (id, descricao) para cada fase.

lista_fases_atuaveis (db)

Iterador de fases, lista os nomes de todos os estados de todos os tipos de processo que o usuário tem algum botão de ação disponível.

Parameters:

db Objeto conexão com o banco de dados.

Returns:

Iterador que retorna pares (id, descricao) para cada fase.

muda_estado (db, usuario, proc)

Recalcula o estado do processo. Altera o `status' do processo para `ativo'. Pode alterar também os campos estado_retorno, estado, estado_ultima_alteracao e boleto.

Parameters:

db Objeto conexão com o banco de dados.
usuario Identificador do usuário.
proc Tabela com os dados do processo (se a entrada estado_retorno tiver o valor true, calcula o estado de retorno do processo).

Returns:

Resultado da atualização do registro no banco.
Expressão aplicada ao estado.

salva_processo (db, usuario, proc)

Salva o processo, efetuando eventuais "efeitos colaterais". Campos de ação serão executados e seus efeitos aplicados ao registro, que poderá mudar de estado e ter novos campos definidos.

Parameters:

db Objeto conexão com o banco de dados.
usuario Identificador do usuário.
proc Tabela com os dados do processo.

Returns:

Booleano confirmando (ou não) que a operação foi efetuada.

corrige_dono_aluno (db, id)

Muda o dono do processo para o usuário cuja matrícula está indicada no campo de id_lua 'matricula_aluno'.

Parameters:

db Objeto conexão com o banco de dados.
id Identificador do processo (não aceita subselect).

corrige_dono_pseudo_usuario (db, id)

Muda o dono do processo para o pseudo-usuário da unidade do dono

Parameters:

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

corrige_dono_professor (db, id)

Preenche id_unidade com id_unidade om id_usuario do professor

Parameters:

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

corrige_coordenacao (db, id, id_coordenacao)

Muda a coordenação do processo.

Parameters:

db Objeto conexão com o banco de dados.
id Identificador do processo (não aceita subselect).
id_coordenacao Identificador da coordenação (aceita subselect).

lista_processos (db, usuario, filtro)

Lista todos os processos que um usuário pode ver.

Parameters:

db Objeto conexão com o banco de dados.
usuario Identificador do usuário.
filtro Tabela contendo campos para filtragem: 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). exceto_id_processo Id do processo que não deve ser listado (opcional) o id_usuario do dono do processo é extraído desse processo. curso_ou_prog String com parte do nome ou sigla de um curso ou programa a ser filtrado (opcional).

Returns:

Iterador de processos (que retorna os campos: id, tipo (descrição), estado (descrição), dono (id), matrícula, nome, estado (id), estado final, data da última alteração, status, curso (nome) e área de concentração (nome)).

dados_processo (db, id, expandidos, versao)

Obtém todos os dados do processo.

Parameters:

db Objeto conexão com o banco de dados.
id Identificador do processo.
expandidos Flag indicando se a tabela deve ter os campos também indexados por seus `identificadores Lua' (campo id_lua).
versao String com a 'versão' dos dados (opcional).

Returns:

Tabela com os dados do processo, ou nil, caso o processo não exista.

tem_acesso_processo (db, user, id_processo)

Verifica se um usuário pode ter acesso a um processo.

Parameters:

db Objeto conexão com o banco de dados.
user Identificador do usuário.
id_processo Identificador do processo.

Returns:

Booleano indicando se o usuário tem permissão para ver o dado processo.

tipo_processo2descricao (db, id)

Obtém a descrição de um tipo de processo.

Parameters:

db Objeto conexão com o banco de dados.
id String com o identificador do tipo de processo.

Returns:

String com a descrição do tipo de processo seguida de string com o nome do módulo.

tipo_processo2explicacao (db, tipo)

Obtém a descrição e a explicação de um tipo de processo.

Parameters:

db Objeto conexão com o banco de dados.
tipo Identificador do tipo de processo (aceita subselect).

Returns:

String com a descrição do tipo de processo.
String com a explicação do tipo de processo.

tipo_processo_campo2explicacao (db, tipo_processo, id_campo)

Parameters:

db Objeto conexão com o banco de dados.
tipo_processo String (ou número) com o identificador do tipo de processo.
id_campo String (ou número) com o identificador do campo do tipo de processo.

Returns:

String com o texto da explicação correspondente.
String com o texto da dica correspondente.

estado2descricao (db, tp, estado)

Obtém a descrição e a explicacao de um estado.

Parameters:

db Objeto conexão com o banco de dados.
tp String com o identificador do tipo de processo.
estado String com o identificador do estado.

Returns:

String com a descrição do estado seguida de string com a explicação

curso_programa_sau_processo (db, id_processo)

Obtém o código SAU do curso e do programa de um processo.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Número com o identificador do processo.

Returns:

Código SAU do curso do processo.
Código SAU do programa do processo.

descricao2status (status)

Monta SQL para obter o id de um status a partir de parte de sua descrição.

Parameters:

status String com a descrição do status.

Returns:

String com um subselect.

cancela_processo (db, id_processo, mensagem)

Cancela um processo registrando o motivo na tabela log.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo (aceita subselect).
mensagem String com o motivo do cancelamento.

estado_do_processo (id_processo)

Monta SQL para obter o estado de um processo a partir de seu id.

Parameters:

id_processo Número com o identificador do processo.

Returns:

String com um subselect.

tipo_do_processo (id_processo)

Monta SQL para obter o tipo de um processo a partir de seu id.

Parameters:

id_processo Número com o identificador do processo.

Returns:

String com um subselect.

tipo_processo (id_processo)

Retorna o tipo de um processo a partir de seu id.

Parameters:

id_processo Número com o identificador do processo.

Returns:

id do tipo de processo.

aluno_do_processo (id_processo)

Monta SQL para obter o usuário (id) de um processo a partir de seu id.

Parameters:

id_processo Número com o identificador do processo.

Returns:

String com um subselect.

curso_do_aluno_do_processo (id_processo)

Monta SQL para obter o curso (id) do dono de um processo a partir de seu id.

Parameters:

id_processo Número com o identificador do processo.

Returns:

String com um subselect.

curso_do_processo (id_processo)

Monta SQL para obter o curso (id) vinculado ao processo.

Parameters:

id_processo Número com o identificador do processo.

Returns:

String com um subselect.

programa_do_processo (id_processo)

Monta SQL para obter o programa (id) vinculado ao processo.

Parameters:

id_processo Número com o identificador do processo.

Returns:

String com um subselect.

coordenacao_do_processo (id_processo)

Monta SQL para obter a coordenação (id) associada a um processo a partir de seu id.

Parameters:

id_processo Número com o identificador do processo.

Returns:

String com um subselect.

unidade_do_processo (id_processo)

Monta SQL para obter a unidade (id) associada a um processo a partir do seu id.

Parameters:

id_processo Número com o identificador do processo.

Returns:

String com um subselect.

boleto2processo (db, id_processo)

Parameters:

db Objeto conexão com o banco de dados.
id_processo Número com o número (identificador) do boleto.

Returns:

String com o identificador do processo, ou nil, caso não encontre.

boleto (db, id_processo)

Obtém o número do boleto de um dado processo. Verifica se o boleto foi emitido, se o processo existe e se este está dentro das condições.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Número com o identificador do processo.

Returns:

String com o número (identificador) do boleto, ou false, caso não exista boleto, ou nil, caso ocorra algum problema.
String com a data de vencimento (se houver boleto) ou uma mensagem de erro (se não houver boleto).

estados (db, id_processo)

Obtém dados sobre os estados de um processo (atual, retorno, alteração).

Parameters:

db Objeto conexão com o banco de dados.
id_processo Número com o identificador do processo.

Returns:

String com o estado atual do processo.
String com o estado de retorno do processo.
String com o estado do processo na última alteração.

dono_processo (db, id)

Obtém o usuário que criou o processo.

Parameters:

db Objeto de conexão com o banco.
id Identificador do processo.

Returns:

Identificador do usuário.

matricula_do_dono (id_processo)

Monta subselect que obtém a matrícula do dono do processo (assumindo que é um aluno).

Parameters:

id_processo Identificador do processo.

Returns:

String com consulta SQL que obtém a matrícula do dono do processo.

professor_processo (db, user)

Obtém o professor (id) de um processo.

Parameters:

db Objeto conexão com o banco de dados.
user Identificador do processo.

Returns:

String com o identificador do professor ou nil.

pode_criar_banca_aluno (db, id_usuario, id_aluno)

Checa se o usuário pode criar uma proposta de banca para o aluno.

Parameters:

db Objeto conexão com o banco de dados.
id_usuario Identificador do usuário (que está tentando criar a defesa).
id_aluno Identificador do aluno (que vai defender).

Returns:

Booleano indicando se o requerimento pode ser criado.
String com mensagem de erro (em caso negativo)

pode_alterar_prazos_requerimentos (db, usuario)

Indica se o usuário pode alterar prazos e taxas de requerimentos.

Parameters:

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

Returns:

Booleano.

pode_anotar_inscricao (db, usuario, id_processo)

Indica se o usuário pode anotar a dada inscrição.

Parameters:

db Objeto de conexão com o banco.
usuario Identificador do usuário (aceita subselect).
id_processo Identificador da inscrição (aceita subselect) (opcional).

Returns:

Booleano.

pode_analizar_inscricao (db, usuario, id_processo)

Indica se o usuário pode analizar a dada inscrição.

Parameters:

db Objeto de conexão com o banco.
usuario Identificador do usuário (aceita subselect).
id_processo Identificador da inscrição (aceita subselect) (opcional).

Returns:

Booleano.

pode_filtrar (db, user)

Indica se o usuário pode ver mais dados que os seus próprios.

Parameters:

db Objeto de conexão com o banco.
user Identificador do usuário.

Returns:

Booleano.

pode_filtrar_requerimentos (db, user)

Indica se o usuário pode ver mais dados que os seus próprios.

Parameters:

db Objeto de conexão com o banco.
user Identificador do usuário.

Returns:

Booleano.

pode_configurar_alunos (db, user)

Indica se o usuário pode configurar alunos do programa.

Parameters:

db Objeto de conexão com o banco.
user Identificador do usuário.

Returns:

Booleano.

pode_configurar_usuario (db, usuario, id_usuario)

Verifica se um usuário pode configurar outro usuário.

Parameters:

db Objeto conexão com o banco de dados.
usuario Identificador do usuário (não será "quoted" pela função).
id_usuario Identificador do usuário alvo (que se quer configurar).

Returns:

Booleano indicando se o usuário tem permissão para configurar o dado usuário.

pode_configurar (db, usuario)

Verifica se um usuário está vinculado a algum recurso de configuração.

Parameters:

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

Returns:

Número indicando a quantidade de recursos de configuração aos quais o usuário tem acesso.

salva_dados_id_lua (db, id_processo, campos)

Altera uma lista de campos na tabela detalhe_processo, a partir de uma tabela com id_lua's.

Parameters:

db Objeto de conexão com o banco.
id_processo Id do processo.
campos Tabela com valores: id_lua do campo que será alterado e o valor.

salva_dados_id_campo (db, id_processo, campos)

Salva os dados fornecidos nos detalhes do processo.

Parameters:

db Objeto de conexão com o banco.
id_processo Identificador do processo (aceita subselect).
campos Tabela com os dados (indexada por strings com o id_campo).

id_campo_do_id_lua_do_processo (id_processo, id_lua)

Monta subselect que obtém o id_campo do id_lua de um processo.

Parameters:

id_processo Identificador do processo (aceita subselect).
id_lua String com o valor da coluna id_lua.

Returns:

String com o subselect que obtém o id_campo correspondente.

id_campo_do_id_lua (tp, id_lua)

Monta subselect que obtém o id_campo do id_lua de um dado tipo.

Parameters:

tp Identificador do tipo de processo (pode ser subselect).
id_lua String com o valor da coluna id_lua.

Returns:

String com o subselect que obtém o id_campo correspondente.

id_lua2id_campo (db, tp, id_lua)

Obtém o id_campo de um tipo de processo e um id_lua.

Parameters:

db Objeto conexão com o banco de dados.
tp Identificador do tipo de processo (pode ser sub-select).
id_lua String com o valor da coluna id_lua.

Returns:

String com o identificador na tabela tipo_processo_campo.

id_campo2id_lua (db, tp, id_campo)

Obtém o id_lua de um tipo de processo e um id_campo.

Parameters:

db Objeto conexão com o banco de dados.
tp Identificador do tipo de processo (pode ser sub-select).
id_campo String com o valor da coluna id_campo.

Returns:

String com o id_lua na tabela tipo_processo_campo.

valor_do_id_lua (id_processo, id_lua, type_cast)

Monta subselect que obtém o valor correspondente ao id_lua do processo.

Parameters:

id_processo Identificador do requerimento (ou sub-select).
id_lua String com o id_lua do campo desejado.
type_cast String com o nome do tipo para o qual o valor deve ser convertido (opcional).

Returns:

String com subselect SQL.

valor_id_lua (db, id_processo, id_lua)

Obtém dados do detalhamento de um requerimento a partir dos id_lua.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do requerimento (ou sub-select).
id_lua String com o id_lua do campo desejado.

Returns:

String com o valor do campo no processo.

lista_professores_coordenacao_processo (db, id_processo)

Lista os professores da coordenacao mencionada no requerimento.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo.

Returns:

Iterador que dá o identificador e nome do usuário.

lista_professores_programa_processo (db, id_processo, lista_ids_profs)

Lista os professores do programa do curso mencionada no requerimento.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo.
lista_ids_profs Lista com identificadores de professores.

Returns:

Iterador que dá o identificador e nome do usuário.

lista_responsaveis_inscricao (db, id_processo)

Lista os usuários responsáveis pela seleção da inscrição.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo.

Returns:

Iterador que retorna o identificador, o nome e o e-mail do usuário.

responsavel_isencao (db, id_processo, id_usuario)

Obtém o nome do cargo do responsável pela isenção de um processo. Não garante a ordem, caso o usuário tenha mais de uma permissão.

Parameters:

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

Returns:

String com o nome do cargo do responsável pela isenção do processo.

pode_criar_comentario (db, id_processo, id_usuario, Booleano)

Identifica se um usuário pode criar um comentário.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo (aceita subselect).
id_usuario Identificador do usuário (aceita subselect).
Booleano indicando se o usuário pode criar um comentário.

responsaveis_processo (db, id_processo)

Lista os responsáveis pelo processo dado.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo.

Returns:

Iterador de usuários (que retorna o id).

pode_editar_processo (db, id_processo, id_usuario)

Checa se o usuário é um dos responsáveis pelo processo.

Parameters:

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

Returns:

Booleano indicando se o usuário é um dos responsáveis pelo processo.

pode_criar (db, tipo_processo, usuario, id_aluno, id_processo)

Verifica se um usuário pode criar um processo

Parameters:

db Objeto conexão com o banco de dados.
tipo_processo Número do tipo de processo.
usuario Tabela com dados do usuário: id_usuario, situacao, curso, nivel.
id_aluno Identificador do aluno para o qual se deseja criar o requerimento.
id_processo Identificador do processo atual (ou nil, se for novo ou fora do contexto).

Returns:

Booleano indicando se o usuário pode criar o processo e uma mensagem caso ele não possa.

gera_cobranca_valor (db, id_processo, valor, vencimento)

Gera uma cobrança para o processo com valor e prazo dados.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo (aceita subselect).
valor String ou Número com o valor da cobrança.
vencimento String com a data do vencimento (formato DD/MM/YYYY).

Returns:

String com o número do boleto ou nil (caso não consiga gerar a cobrança).
String com a data de vencimento ou mensagem de erro (caso não consiga gerar a cobrança).

gera_cobranca (db, id_processo)

Gera uma nova cobrança para o processo dado.

Parameters:

db Objeto conexão com o banco de dados.
id_processo Identificador do processo.

Returns:

String com o número do boleto (ou nil, em caso de erro).
String com a data de vencimento ou mensagem de erro (se houver).

defesa_com_matricula (db, matricula, exceto)

Procura se há uma defesa (tipo 9 ou 10) ativa (e não reprovada) com essa matrícula.

Parameters:

db Objeto conexão com o banco de dados.
matricula String com a matrícula (com 7 algarismos).
exceto String com identificador de processo a ser excetuado da busca (default = nil).

Returns:

String com identificador do processo encontrado ou nil, caso não encontrado.

consulta_anteriores (db, matricula, tipo_processo, exceto)

Conta processos de um dado tipo e de uma matrícula.