🛠️ Documentação Técnica: Tabela de Imposto de Renda

[!NOTE] Documentação Gerada Automaticamente O conteúdo abaixo foi gerado por IA através de engenharia reversa do código-fonte e deve ser validado.

Aprofundando a análise, temos as seguintes informações:

1. Visão Geral

• Propósito da tela: A tela ImpostoRendaLista.aspx tem como objetivo principal exibir e gerenciar as tabelas de Imposto de Renda (IR) e Imposto de Renda sobre Participação nos Lucros e Resultados (IR-PLR). Ela permite a visualização das faixas de alíquotas e valores de dedução para cada período de vigência.
• Contexto no sistema: Esta tela faz parte do módulo WebFoPag, que lida com funcionalidades relacionadas à folha de pagamento. Ela é crucial para a configuração e consulta das regras de cálculo de imposto de renda.
• Usuários que utilizam: Usuários com permissão de “Visualizar Imposto de Renda” (conforme verificado no método Inicializar do code-behind). Provavelmente, são usuários do departamento de RH ou contabilidade que precisam consultar e validar as tabelas de IR.

2. Tipos/Modalidades A tela apresenta duas modalidades principais de Imposto de Renda:

• Imposto de Renda (IR) convencional: Exibido no dlImpostoRenda, com faixas de vigência e alíquotas.
• Imposto de Renda sobre PLR (IR-PLR): Exibido no dlImpostoRendaPLR, com suas próprias faixas de vigência e alíquotas, recuperadas de um serviço externo (ServiceSupercalcAPIClient).

3. Interface — Campos e Controles

4. Abas e Seções A tela é dividida em duas seções principais, cada uma com seu próprio painel e DataList:

• Imposto de Renda: Contida no pnlImpostoRenda, exibe as tabelas de IR convencional.
• Imposto de Renda - PLR: Contida no pnlImpostoRendaPLR, exibe as tabelas de IR sobre PLR.

5. Regras de Negócio

🛡️ 5. Regras de Negócio

5.1. Validações de Campos

• Permissão de Visualização: O usuário deve possuir a permissão Enumeradores.Permissoes.ImpostoDeRenda.VisualizarImpostoDeRenda para acessar a tela. Caso contrário, é redirecionado para a página de acesso negado. (Origem: ImpostoRendaLista.aspx.cs, método Inicializar)
• Entrada de Página (uc1:Paginacao): O valor digitado no campo de texto para “Ir para página” (txtNovaPagina) deve ser um número inteiro válido. Se não for, a ação de atualização da página não é executada. (Origem: Paginacao.ascx.cs, método btnAtualizarPagina_Click)

5.2. Regras de Habilitação/Desabilitação e Visibilidade

• Expansão de Faixas de IR: O painel pnlFaixaImpostoRenda (e o gvFaixaImpostoRenda) é visível apenas quando o usuário clica no botão de visualizar de uma tabela de Imposto de Renda. Se a tabela for a vigente (btlTabelaVigente com valor “1”), o painel é expandido automaticamente na inicialização da tela. (Origem: ImpostoRendaLista.aspx.cs, métodos Inicializar, dlImpostoRenda_EditCommand, Expandir_dlImpostoRenda)
• Expansão de Faixas de IR PLR: O painel pnlFaixaImpostoRendaPLR (e o gdvFaixaImpostoRendaPLR) é visível apenas quando o usuário clica no botão de visualizar de uma tabela de Imposto de Renda PLR. Se a data de início de vigência da tabela for do ano corrente, o painel é expandido automaticamente na inicialização da tela. (Origem: ImpostoRendaLista.aspx.cs, métodos Inicializar, dlImpostoRendaPLR_EditCommand, ExpandirPLR_dlImpostoRenda)
• Botões de Paginação (uc1:Paginacao):
• Se TotalResultados for 0, todos os botões de navegação (btiPrimeira, btiAnterior, btiProxima, btiUltima), o campo txtNovaPagina e o botão btnAtualizarPagina são desabilitados.
• Se PaginaCorrente for 1: btiPrimeira e btiAnterior são desabilitados. Se TotalPaginas for maior que 1, txtNovaPagina, btnAtualizarPagina, btiProxima e btiUltima são habilitados. Caso contrário, são desabilitados.
• Se PaginaCorrente for igual a TotalPaginas: txtNovaPagina, btnAtualizarPagina, btiPrimeira e btiAnterior são habilitados. btiProxima e btiUltima são desabilitados.
• Em outros casos (páginas intermediárias): todos os botões de navegação, txtNovaPagina e btnAtualizarPagina são habilitados. (Origem: Paginacao.ascx.cs, método AjustarBotoesPaginacao)
• Dropdown de Tamanho da Página (uc2:TamanhoPaginaGrid): A visibilidade do dropdown (ddlTamanhoPagina) e dos rótulos (lblTextoParte1, lblTextoParte2) pode ser controlada pela propriedade EsconderSelecao. Se EsconderSelecao for true, os componentes ficam invisíveis. (Origem: TamanhoPaginaGrid.ascx.cs, propriedade EsconderSelecao)

5.3. Regras de Inativação e Exclusão

• Exclusão de FaixaImpostoRenda: É possível excluir uma faixa de imposto de renda individualmente (Delete(int idFaixaImpostoRenda)) ou em lote (Delete(List<int> idFaixaImpostoRenda)). A exclusão em lote constrói uma cláusula IN na query SQL. (Origem: FaixaImpostoRenda_P1.cs, métodos Delete)
• Exclusão de ImpostoRenda: É possível excluir uma tabela de imposto de renda individualmente (Delete(int idImpostoRenda)) ou em lote (Delete(List<int> idImpostoRenda)). A exclusão em lote constrói uma cláusula IN na query SQL. (Origem: ImpostoRenda_P1.cs, métodos Delete)

5.4. Regras de Salvar e Fluxo de Configuração

• Persistência de FaixaImpostoRenda: O método Save() de FaixaImpostoRenda decide se deve inserir (Insert()) ou atualizar (Update()) um registro com base na propriedade _persisted. A data de cadastro (Dta_Cadastro) é definida apenas na inserção, enquanto a data de alteração (Dta_Alteracao) é atualizada em ambas as operações. (Origem: FaixaImpostoRenda_P1.cs, métodos Save, Insert, Update)
• Persistência de ImpostoRenda: O método Save() de ImpostoRenda decide se deve inserir (Insert()) ou atualizar (Update()) um registro com base na propriedade _persisted. A data de cadastro (Dta_Cadastro) é definida apenas na inserção, enquanto a data de alteração (Dta_Alteracao) é atualizada em ambas as operações. (Origem: ImpostoRenda_P1.cs, métodos Save, Insert, Update)

5.5. Outras Regras Específicas da Tela

• Ordenação da Lista de IR: A lista de Imposto de Renda convencional (dlImpostoRenda) é ordenada pela coluna especificada (ColunaOrdenacao) e direção (DirecaoOrdenacao), que alternam entre “Asc” e “Desc” a cada clique nos botões de cabeçalho. (Origem: ImpostoRendaLista.aspx.cs, métodos btlDtInicioVigencia_Click, btlDtFimVigencia_Click)
• Ordenação da Lista de IR PLR: A lista de Imposto de Renda PLR (dlImpostoRendaPLR) é ordenada pela coluna especificada (ColunaOrdenacaoPLR) e direção (DirecaoOrdenacaoPLR), que alternam entre “Asc” e “Desc” a cada clique nos botões de cabeçalho. (Origem: ImpostoRendaLista.aspx.cs, métodos lbtDataInicioVigenciaPLR_OnClick, lbtDataFimVigenciaPLR_OnClick)
• Recuperação de Faixas de IR PLR: As faixas de Imposto de Renda PLR são obtidas através de uma chamada ao serviço externo ServiceSupercalcAPIClient.RecuperarFaixasIRRFPLR(), que retorna uma string XML. Essa string é então desserializada para um DataTable e armazenada em dtPLR. (Origem: ImpostoRendaLista.aspx.cs, método CarregarDataListPLR)
• Cálculo de Paginação (uc1:Paginacao): O TotalPaginas é calculado dividindo TotalResultados por TamanhoPagina. Se houver resto na divisão, TotalPaginas é incrementado em 1. Se a PaginaCorrente for maior que TotalPaginas (e TotalPaginas não for zero), a PaginaCorrente é resetada para 1 e o evento MudaPagina é invocado. (Origem: Paginacao.ascx.cs, método AjustarPaginacao)

🔄 6. Fluxos Principais

• Inicialização da Tela (Page_Load):

1. Define o título da página como “ImpostoRendaLista”.
2. Se não for um postback, chama o método Inicializar().

• Método Inicializar():

1. Carrega as permissões do usuário logado para a categoria Enumeradores.CategoriaPermissao.ImpostoRenda usando Usuario.CarregarPermissoes(new Usuario(base.CodigoUsuarioLogado), Enumeradores.CategoriaPermissao.ImpostoRenda).
2. Verifica se o usuário tem a permissão Enumeradores.Permissoes.ImpostoDeRenda.VisualizarImpostoDeRenda. Se não tiver, redireciona para Configuracao.UrlAcessoNegado.
3. Define as propriedades ColunaOrdenacao como “Dta_Inicio_Vigencia” e DirecaoOrdenacao como “DESC” para o IR convencional.
4. Define as propriedades ColunaOrdenacaoPLR como “DataInicioVigencia” e DirecaoOrdenacaoPLR como “DESC” para o IR PLR.
5. Chama CarregarDataList() para popular o dlImpostoRenda.
6. Chama CarregarDataListPLR() para popular o dlImpostoRendaPLR.
7. Itera sobre os itens do dlImpostoRenda: se btlTabelaVigente.Text for “1”, chama Expandir_dlImpostoRenda para expandir o painel de faixas de IR.
8. Itera sobre os itens do dlImpostoRendaPLR: se a data de início de vigência for do ano corrente, chama ExpandirPLR_dlImpostoRenda para expandir o painel de faixas de IR PLR.

• Carregamento da Lista de IR (CarregarDataList):

1. Define o DataSource do dlImpostoRenda chamando ImpostoRenda.Listar(ColunaOrdenacao, DirecaoOrdenacao).
2. Chama dlImpostoRenda.DataBind().

• Carregamento da Lista de IR PLR (CarregarDataListPLR):

1. Instancia SuperCalcAPIWeb.ServiceSupercalcAPIClient.
2. Chama obj.RecuperarFaixasIRRFPLR() para obter os dados do serviço externo.
3. Desserializa o XML retornado para um DataTable (dtPLR).
4. Cria um DataView de dtPLR e aplica a ordenação com base em ColunaOrdenacaoPLR e DirecaoOrdenacaoPLR.
5. Filtra os dados para obter apenas os valores distintos de Idf_TabelaIRRFPLR, DataInicioVigencia e DataFimVigencia.
6. Define o DataSource do dlImpostoRendaPLR com os dados filtrados.
7. Chama dlImpostoRendaPLR.DataBind().

• Ordenação da Lista de IR (btlDtInicioVigencia_Click, btlDtFimVigencia_Click):

1. Inverte a DirecaoOrdenacao (ASC/DESC) se a coluna clicada for a mesma da ordenação atual.
2. Define a ColunaOrdenacao com base no LinkButton clicado.
3. Chama CarregarDataList().

• Ordenação da Lista de IR PLR (lbtDataInicioVigenciaPLR_OnClick, lbtDataFimVigenciaPLR_OnClick):

1. Inverte a DirecaoOrdenacaoPLR (ASC/DESC) se a coluna clicada for a mesma da ordenação atual.
2. Define a ColunaOrdenacaoPLR com base no LinkButton clicado.
3. Chama CarregarDataListPLR().

• Visualização das Faixas de IR (dlImpostoRenda_EditCommand, Expandir_dlImpostoRenda):

1. Recupera o GridView (gvFaixaImpostoRenda) e o Panel (pnlFaixaImpostoRenda) do item clicado.
2. Se o painel não estiver visível, chama UIHelper.CarregarGridView(grid, FaixaImpostoRenda.ListarPorImpostoRenda(idImpostoRenda)) para popular o GridView e torna o painel visível.
3. Se o painel estiver visível, limpa o GridView e torna o painel invisível.

• Visualização das Faixas de IR PLR (dlImpostoRendaPLR_EditCommand, ExpandirPLR_dlImpostoRenda):

1. Recupera o GridView (gdvFaixaImpostoRendaPLR) e o Panel (pnlFaixaImpostoRendaPLR) do item clicado.
2. Se o painel não estiver visível, filtra o dtPLR pelo idImpostoRenda e chama UIHelper.CarregarGridView para popular o GridView e torna o painel visível.
3. Se o painel estiver visível, limpa o GridView e torna o painel invisível.

• Eventos de Paginação (uc1:Paginacao):

1. ucPaginacao_MudarPagina(): Chama CarregarDataList().
2. ucTamanhoPaginaGrid_MudarTamanhoPagina(): Chama CarregarDataList().

🔌 7. Integrações e Dependências

7.1. Classes BLL e Service utilizadas

• Employer.Plataforma.BLL.WebFoPag.FaixaImpostoRenda

• Arquivos de Origem: Employer.Plataforma.BLL.WebFoPag\FaixaImpostoRenda_P1.cs, Employer.Plataforma.BLL.WebFoPag\FaixaImpostoRenda_P2.cs

• Propósito: Gerencia as faixas de imposto de renda.

• Métodos Relevantes:

• ListarPorImpostoRenda(int idImpostoRenda): Retorna um IDataReader com as faixas de imposto de renda para um determinado idImpostoRenda. Internamente, executa uma consulta SQL inline (SPSELECT) que filtra por Idf_Imposto_Renda.

• Listar(ImpostoRenda objImpostoRenda): Retorna uma List<FaixaImpostoRenda> para um determinado objeto ImpostoRenda. Internamente, chama ListarPorImpostoRenda.

• ListarFaixaIRRF(PeriodoCalculo objPeriodoCalculo): Retorna uma List<FaixaImpostoRenda> para um período de cálculo específico. Executa uma consulta SQL inline (SPSELECTFIR) que busca faixas de IR vigentes para o período.

• ListarTodos(): Retorna um Dictionary<int, FaixaImpostoRenda> com todas as faixas de imposto de renda. Executa uma consulta SQL inline (SPSELECTFIR).

• Save(), Insert(), Update(), Delete(): Métodos para persistência de dados (CRUD) da entidade FaixaImpostoRenda.

• Employer.Plataforma.BLL.WebFoPag.ImpostoRenda

• Arquivos de Origem: Employer.Plataforma.BLL.WebFoPag\ImpostoRenda_P1.cs, Employer.Plataforma.BLL.WebFoPag\ImpostoRenda_P2.cs

• Propósito: Gerencia as tabelas de imposto de renda.

• Métodos Relevantes:

• Listar(string nomeColuna, string direcaoOrdenacao): Retorna um DataTable com as tabelas de imposto de renda, ordenadas pela coluna e direção especificadas. Inclui uma coluna vigente que indica se a tabela está ativa na data atual. Internamente, executa uma consulta SQL inline.

• Listar(): Retorna uma List<ImpostoRenda> com todas as tabelas de imposto de renda, incluindo suas faixas de IR (FaixasIR) e o valor de dedução por dependente (ValorDeducaoDependenteIR). Internamente, chama FaixaImpostoRenda.Listar(objIRRF) e DependenteImpostoRenda.RecuperarValorDeducaoAtivo.

• ListarTodos(): Retorna um Dictionary<int, ImpostoRenda> com todas as tabelas de imposto de renda.

• Save(), Insert(), Update(), Delete(): Métodos para persistência de dados (CRUD) da entidade ImpostoRenda.

• Employer.Plataforma.Web.Code.UIHelper

• Arquivo de Origem: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.Web.Code\UIHelper.cs

• Propósito: Classe utilitária para operações comuns de UI, como carregar GridViews e DataLists.

• Métodos Relevantes:

• CarregarGridView(GridView gv, IDataReader dataSource): Popula um GridView com dados de um IDataReader.

• CarregarGridView(GridView gv, DataTable dataSource): Popula um GridView com dados de um DataTable.

• Employer.Plataforma.BLL.Usuario

• Arquivos de Origem: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Usuario_P1.cs, C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Usuario_P2.cs

• Propósito: Gerencia informações e permissões de usuários.

• Métodos Relevantes:

• CarregarPermissoes(Usuario usuario, Enumeradores.CategoriaPermissao categoriaPermissao): Retorna uma lista de IDs de permissões que o usuário possui para uma determinada categoria de permissão. Internamente, executa a stored procedure SPSELECTPERMISSOESUSUARIO.

7.2. Stored Procedures chamadas

• SQL inline (FaixaImpostoRenda_P1.cs)
• Nome: INSERT INTO FLH_Faixa_Imposto_Renda (...) VALUES (...)
• Arquivo BLL: FaixaImpostoRenda_P1.cs
• Parâmetros: @Idf_Imposto_Renda, @Vlr_Inicial, @Vlr_Final, @Vlr_Aliquota, @Vlr_Parcela_Deduzir, @Vlr_Deducao_Dependente, @Flg_Inativo, @Dta_Cadastro, @Dta_Alteracao
• Propósito: Insere um novo registro na tabela FLH_Faixa_Imposto_Renda.
• SQL inline (FaixaImpostoRenda_P1.cs)
• Nome: UPDATE FLH_Faixa_Imposto_Renda SET ... WHERE Idf_Faixa_Imposto_Renda = @Idf_Faixa_Imposto_Renda
• Arquivo BLL: FaixaImpostoRenda_P1.cs
• Parâmetros: @Idf_Imposto_Renda, @Vlr_Inicial, @Vlr_Final, @Vlr_Aliquota, @Vlr_Parcela_Deduzir, @Vlr_Deducao_Dependente, @Flg_Inativo, @Dta_Cadastro, @Dta_Alteracao, @Idf_Faixa_Imposto_Renda
• Propósito: Atualiza um registro existente na tabela FLH_Faixa_Imposto_Renda.
• SQL inline (FaixaImpostoRenda_P1.cs)
• Nome: DELETE FROM FLH_Faixa_Imposto_Renda WHERE Idf_Faixa_Imposto_Renda = @Idf_Faixa_Imposto_Renda
• Arquivo BLL: FaixaImpostoRenda_P1.cs
• Parâmetros: @Idf_Faixa_Imposto_Renda
• Propósito: Exclui um registro da tabela FLH_Faixa_Imposto_Renda.
• SQL inline (FaixaImpostoRenda_P1.cs)
• Nome: delete from FLH_Faixa_Imposto_Renda where Idf_Faixa_Imposto_Renda in (...)
• Arquivo BLL: FaixaImpostoRenda_P1.cs
• Parâmetros: @parm0, @parm1, … (lista dinâmica de IDs)
• Propósito: Exclui múltiplos registros da tabela FLH_Faixa_Imposto_Renda.
• SQL inline (FaixaImpostoRenda_P1.cs)
• Nome: SELECT * FROM FLH_Faixa_Imposto_Renda WHERE Idf_Faixa_Imposto_Renda = @Idf_Faixa_Imposto_Renda
• Arquivo BLL: FaixaImpostoRenda_P1.cs
• Parâmetros: @Idf_Faixa_Imposto_Renda
• Propósito: Recupera um registro específico da tabela FLH_Faixa_Imposto_Renda.
• SQL inline (FaixaImpostoRenda_P1.cs)
• Nome: SELECT ROW_NUMBER() OVER (ORDER BY {colunaOrdenacao} {direcaoOrdenacao}) AS RowID, Fai.Idf_Faixa_Imposto_Renda, ... FROM FLH_Faixa_Imposto_Renda Fai
• Arquivo BLL: FaixaImpostoRenda_P1.cs
• Parâmetros: colunaOrdenacao, direcaoOrdenacao (concatenados na string SQL)
• Propósito: Retorna um conjunto de faixas de imposto de renda com paginação e ordenação.
• SPSELECT (FaixaImpostoRenda_P2.cs)
• Nome: DECLARE @sql varchar(8000) SET @sql = ' SELECT Fai.Idf_Faixa_Imposto_Renda, Fai.Idf_Imposto_Renda, Fai.Vlr_Inicial, Fai.Vlr_Final, Fai.Vlr_Aliquota, Fai.Vlr_Parcela_Deduzir, Fai.Vlr_Deducao_Dependente, Fai.Flg_Inativo, Fai.Dta_Cadastro, Fai.Dta_Alteracao FROM plataforma.FLH_Faixa_Imposto_Renda Fai WHERE 1 = 1' IF (@Idf_Imposto_Renda IS NOT NULL) SET @sql = @sql + ' AND Fai.Idf_Imposto_Renda = ' + CONVERT(VARCHAR,@Idf_Imposto_Renda) PRINT(@sql) EXECUTE(@sql)
• Arquivo BLL: FaixaImpostoRenda_P2.cs
• Parâmetros: @Idf_Imposto_Renda
• Propósito: Seleciona faixas de imposto de renda da tabela plataforma.FLH_Faixa_Imposto_Renda, filtrando opcionalmente por Idf_Imposto_Renda.
• SPSELECTFIR (FaixaImpostoRenda_P2.cs)
• Nome: DECLARE @datainicio DATETIME; DECLARE @datafim DATETIME; select @datainicio = Dta_Inicio, @datafim = Dta_Fim from TAB_Periodo_Calculo (nolock) where Idf_Periodo_Calculo = @idf_periodo_calculo; select fir.Idf_Faixa_Imposto_Renda, fir.Idf_Imposto_Renda, fir.Vlr_Inicial, fir.Vlr_Final, fir.Vlr_Aliquota, fir.Vlr_Parcela_Deduzir, fir.Vlr_Deducao_Dependente, fir.Flg_Inativo, fir.Dta_Cadastro, fir.Dta_Alteracao FROM plataforma.FLH_Faixa_Imposto_Renda fir (nolock) INNER JOIN plataforma.FLH_Imposto_Renda ir (nolock) ON ir.Idf_Imposto_Renda = fir.Idf_Imposto_Renda where isnull((SELECT 1 FROM plataforma.FLH_Imposto_Renda irTab (nolock) WHERE irTab.Idf_Imposto_Renda = ir.Idf_Imposto_Renda AND ir.Dta_Inicio_Vigencia <= @datainicio AND ( ir.Dta_Fim_Vigencia >= @datafim OR ir.Dta_Fim_Vigencia IS NULL )),0) = 1 order by Vlr_Inicial
• Arquivo BLL: FaixaImpostoRenda_P2.cs
• Parâmetros: @Idf_Periodo_Calculo
• Propósito: Seleciona faixas de imposto de renda que são vigentes para um determinado período de cálculo.
• SQL inline (FaixaImpostoRenda_P2.cs)
• Nome: select fir.Idf_Faixa_Imposto_Renda, fir.Idf_Imposto_Renda, fir.Vlr_Inicial, fir.Vlr_Final, fir.Vlr_Aliquota, fir.Vlr_Parcela_Deduzir, fir.Vlr_Deducao_Dependente, fir.Flg_Inativo, fir.Dta_Cadastro, fir.Dta_Alteracao FROM plataforma.FLH_Faixa_Imposto_Renda fir (nolock) INNER JOIN plataforma.FLH_Imposto_Renda ir (nolock) ON ir.Idf_Imposto_Renda = fir.Idf_Imposto_Renda
• Arquivo BLL: FaixaImpostoRenda_P2.cs
• Parâmetros: Nenhum
• Propósito: Retorna todas as faixas de imposto de renda.
• SQL inline (ImpostoRenda_P1.cs)
• Nome: INSERT INTO plataforma.FLH_Imposto_Renda (Dta_Inicio_Vigencia, Dta_Fim_Vigencia, Vlr_Minimo_Retencao, Sta_Imposto_Renda, Flg_Inativo, Dta_Cadastro, Dta_Alteracao) VALUES (@Dta_Inicio_Vigencia, @Dta_Fim_Vigencia, @Vlr_Minimo_Retencao, @Sta_Imposto_Renda, @Flg_Inativo, @Dta_Cadastro, @Dta_Alteracao);SET @Idf_Imposto_Renda = @@IDENTITY;
• Arquivo BLL: ImpostoRenda_P1.cs
• Parâmetros: @Dta_Inicio_Vigencia, @Dta_Fim_Vigencia, @Vlr_Minimo_Retencao, @Sta_Imposto_Renda, @Flg_Inativo, @Dta_Cadastro, @Dta_Alteracao
• Propósito: Insere um novo registro na tabela plataforma.FLH_Imposto_Renda.
• SQL inline (ImpostoRenda_P1.cs)
• Nome: UPDATE plataforma.FLH_Imposto_Renda SET Dta_Inicio_Vigencia = @Dta_Inicio_Vigencia, Dta_Fim_Vigencia = @Dta_Fim_Vigencia, Vlr_Minimo_Retencao = @Vlr_Minimo_Retencao, Sta_Imposto_Renda = @Sta_Imposto_Renda, Flg_Inativo = @Flg_Inativo, Dta_Cadastro = @Dta_Cadastro, Dta_Alteracao = @Dta_Alteracao WHERE Idf_Imposto_Renda = @Idf_Imposto_Renda
• Arquivo BLL: ImpostoRenda_P1.cs
• Parâmetros: @Dta_Inicio_Vigencia, @Dta_Fim_Vigencia, @Vlr_Minimo_Retencao, @Sta_Imposto_Renda, @Flg_Inativo, @Dta_Cadastro, @Dta_Alteracao, @Idf_Imposto_Renda
• Propósito: Atualiza um registro existente na tabela plataforma.FLH_Imposto_Renda.
• SQL inline (ImpostoRenda_P1.cs)
• Nome: DELETE FROM plataforma.FLH_Imposto_Renda WHERE Idf_Imposto_Renda = @Idf_Imposto_Renda
• Arquivo BLL: ImpostoRenda_P1.cs
• Parâmetros: @Idf_Imposto_Renda
• Propósito: Exclui um registro da tabela plataforma.FLH_Imposto_Renda.
• SQL inline (ImpostoRenda_P1.cs)
• Nome: delete from FLH_Imposto_Renda where Idf_Imposto_Renda in (...)
• Arquivo BLL: ImpostoRenda_P1.cs
• Parâmetros: @parm0, @parm1, … (lista dinâmica de IDs)
• Propósito: Exclui múltiplos registros da tabela plataforma.FLH_Imposto_Renda.
• SQL inline (ImpostoRenda_P1.cs)
• Nome: SELECT * FROM plataforma.FLH_Imposto_Renda WHERE Idf_Imposto_Renda = @Idf_Imposto_Renda
• Arquivo BLL: ImpostoRenda_P1.cs
• Parâmetros: @Idf_Imposto_Renda
• Propósito: Recupera um registro específico da tabela plataforma.FLH_Imposto_Renda.
• SQL inline (ImpostoRenda_P1.cs)
• Nome: SELECT ROW_NUMBER() OVER (ORDER BY {colunaOrdenacao} {direcaoOrdenacao}) AS RowID, Imp.Idf_Imposto_Renda, ... FROM FLH_Imposto_Renda Imp
• Arquivo BLL: ImpostoRenda_P1.cs
• Parâmetros: colunaOrdenacao, direcaoOrdenacao (concatenados na string SQL)
• Propósito: Retorna um conjunto de tabelas de imposto de renda com paginação e ordenação.
• SPSELECTIRRF (ImpostoRenda_P2.cs)
• Nome: Select * from plataforma.FLH_Imposto_Renda
• Arquivo BLL: ImpostoRenda_P2.cs
• Parâmetros: Nenhum
• Propósito: Seleciona todas as tabelas de imposto de renda.
• SQL inline (ImpostoRenda_P2.cs)
• Nome: SELECT Imp.Idf_Imposto_Renda, Imp.Dta_Inicio_Vigencia, Imp.Dta_Fim_Vigencia, Imp.Vlr_Minimo_Retencao, Imp.Sta_Imposto_Renda, Imp.Flg_Inativo, Imp.Dta_Cadastro, Imp.Dta_Alteracao, isnull((SELECT 1 FROM plataforma.FLH_Imposto_Renda IR WHERE IR.Idf_Imposto_Renda = Imp.Idf_Imposto_Renda AND Imp.Dta_Inicio_Vigencia <= getdate() AND (Imp.Dta_Fim_Vigencia >= getdate() OR Imp.Dta_Fim_Vigencia IS NULL)),0) as vigente FROM plataforma.FLH_Imposto_Renda Imp ORDER BY {0} {1}
• Arquivo BLL: ImpostoRenda_P2.cs
• Parâmetros: {0} (nomeColuna), {1} (direcaoOrdenacao)
• Propósito: Lista as tabelas de imposto de renda com indicação de vigência, ordenadas dinamicamente.
• SPSELECTPERMISSOESUSUARIO (Usuario_P2.cs)
• Nome: SELECT DISTINCT p.Idf_Permissao as Permissao FROM TAB_Periodo_Permissao pp INNER JOIN TAB_Perfil_Permissao p ON pp.Idf_Perfil = p.Idf_Perfil INNER JOIN plataforma.TAB_Permissao per ON p.Idf_Permissao = per.Idf_Permissao WHERE Idf_Usuario = @idf_usuario AND Dta_Inicio <= GETDATE() AND (Dta_Fim >= GETDATE() OR Dta_Fim IS NULL) AND per.Idf_Categoria_Permissao = @Idf_Categoria_Permissao
• Arquivo BLL: Usuario_P2.cs
• Parâmetros: @idf_usuario, @Idf_Categoria_Permissao
• Propósito: Retorna as permissões ativas de um usuário em uma determinada categoria.

7.3. UserControls incluídos (.ascx)

• UserControls/Paginacao.ascx

• Caminho: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.Web.WebFoPag\UserControls\Paginacao.ascx

• ID: ucPaginacao (no .aspx.cs, referenciado como ucPaginacao e ucPaginacaoPLR para as duas listas)

• Tag: uc1:Paginacao

• Propriedades Expostas:

• CssClass: Estilo CSS do painel de paginação.

• TotalResultados: Número total de registros.

• PaginaCorrente: Página atual sendo exibida.

• TotalPaginas: Número total de páginas.

• TamanhoPagina: Quantidade de itens por página.

• Eventos:

• MudaPagina: Disparado quando a página é alterada.

• Métodos Públicos Chamados pela Tela Pai:

• AjustarPaginacao(): Ajusta a exibição dos botões de navegação e o texto de estado da paginação.

• LimparPaginacao(): Limpa o estado da paginação e desabilita os controles.

• UserControls/TamanhoPaginaGrid.ascx

• Caminho: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.Web.WebFoPag\UserControls\TamanhoPaginaGrid.ascx

• ID: ucTamanhoPaginaGrid (no .aspx.cs, referenciado como ucTamanhoPaginaGrid e ucTamanhoPaginaGridPLR para as duas listas)

• Tag: uc2:TamanhoPaginaGrid

• Propriedades Expostas:

• TamanhoPagina: Retorna o tamanho da página selecionado no dropdown.

• HabilitarDropDownList: Habilita/desabilita o dropdown.

• EsconderSelecao: Controla a visibilidade do controle.

• Eventos:

• MudarTamanhoPagina: Disparado quando o tamanho da página é alterado.

• Métodos Públicos Chamados pela Tela Pai: Nenhum método público é explicitamente chamado pela tela pai, mas o evento MudarTamanhoPagina é assinado.

7.4. WebServices, APIs externas, filas

• SuperCalcAPIWeb.ServiceSupercalcAPIClient
• Endpoint/Serviço: Um serviço web (WCF ou similar) para recuperar faixas de IRRF PLR. O cliente WCF é gerado a partir de uma referência de serviço.
• Métodos Chamados: RecuperarFaixasIRRFPLR()
• Propósito: Obtém os dados das faixas de Imposto de Renda PLR de um sistema externo.

8. Mensagens ao Usuário

• “Exibindo página {0} de {1}” (uc1:Paginacao): Exibida no controle de paginação para indicar a página atual e o total de páginas.
• “Exibindo página 0 de 0” (uc1:Paginacao): Exibida quando não há resultados.
• “Sem itens” (gvFaixaImpostoRenda, gdvFaixaImpostoRendaPLR): Exibida nos GridViews quando não há faixas de imposto de renda para mostrar.

9. Permissões e Perfis

• Enumeradores.Permissoes.ImpostoDeRenda.VisualizarImpostoDeRenda: Controla o acesso à tela. Se o usuário não possuir esta permissão, ele é redirecionado para a página de acesso negado. (Origem: ImpostoRendaLista.aspx.cs, método Inicializar)

10. Aprofundamento — Detalhes Internos de Métodos

Employer.Plataforma.BLL.Usuario

Arquivos:

• C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Usuario_P1.cs
• C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Usuario_P2.cs

Métodos

Detalhamento de Métodos Importantes

GetParameters()

• Lógica:

1. Cria uma nova lista de SqlParameter.
2. Adiciona 10 parâmetros à lista, cada um com seu nome, tipo SQL e tamanho. Os parâmetros são: @Idf_Usuario, @Num_CPF, @Idf_Perfil_Principal, @Idf_Ultima_Empresa, @Idf_Usuario_Gerador, @Idf_Sistema_Gerador, @Idf_Pessoa_Fisica, @Flg_Interno, @Dta_Cadastro, @Flg_Inativo.
3. Retorna a lista de parâmetros.

• Propósito: Este método é um utilitário interno para padronizar a criação dos parâmetros SQL usados nas operações de persistência (Insert, Update).

SetParameters(List parms)

• Lógica:

1. Recebe uma lista de SqlParameter como entrada.
2. Preenche o Value de cada parâmetro na lista com os valores dos atributos da instância atual de Usuario.
3. Define _sistemaGerador como uma nova instância de Sistema com o ID Enumeradores.Sistema.webfopag.
4. Para _ultimaEmpresa, _sistemaGerador e _idPessoaFisica, se forem null ou não tiverem valor, define o valor do parâmetro como DBNull.Value.
5. Condição !this._persisted (para inserção):

• Define a Direction do parâmetro @Idf_Usuario como Output (para receber o ID gerado pelo banco).

6. Condição this._persisted (para atualização):

• Define a Direction do parâmetro @Idf_Usuario como Input.

7. Define _usuarioGerador com o ID do usuário logado (obtido da Session).
8. Define Dta_Cadastro com a data e hora atuais (DateTime.Now).

• Propósito: Este método é um utilitário interno para vincular os dados da instância da classe aos parâmetros SQL antes de executar uma consulta de insert ou update.

Insert()

• Lógica:

1. Chama GetParameters() para obter uma lista de parâmetros SQL vazia.
2. Chama SetParameters(parms) para preencher os parâmetros com os dados da instância atual, configurando @Idf_Usuario como Output.
3. Abre uma nova conexão SQL (SqlConnection) e inicia uma transação (SqlTransaction).
4. Executa a consulta SQL SPINSERT (definida como SQL inline) usando DataAccessLayer.ExecuteNonQueryCmd.
5. Recupera o Idf_Usuario gerado pelo banco de dados (usando SCOPE_IDENTITY()) e atribui à propriedade _idUsuario.
6. Limpa os parâmetros do comando.
7. Gerencia UsuarioPerfil:

• Tenta carregar um UsuarioPerfil existente para o _idUsuario e _perfilPrincipal.IdPerfil.
• Se não existir, cria um novo UsuarioPerfil, associa o Usuario e Perfil e o salva (objUsuarioPerfil.Save(trans)).

8. Gerencia PeriodoPermissao:

• Tenta carregar um PeriodoPermissao existente para o _idUsuario, _perfilPrincipal.IdPerfil e a data atual.
• Se existir, define DataFim como null e o salva (objPeriodoPermissao.Save(trans)).
• Se não existir, cria um novo PeriodoPermissao, define DataInicio como a data atual, associa o UsuarioPerfil e o salva (objPeriodoPermissao.Save(trans)).

9. Define _persisted como true e _modified como false.
10. Comita a transação.
11. Chama AuditoriaEventMapTransaction.IntegrarAuditoriaEventMap(trans) para integrar eventos de auditoria.
12. Em caso de exceção, faz rollback da transação, remove eventos de auditoria pendentes e relança a exceção.

• Stored Procedures chamadas:

• SQL inline: INSERT INTO TAB_Usuario (Num_CPF, Idf_Perfil_Principal, Idf_Ultima_Empresa, Idf_Usuario_Gerador, Idf_Sistema_Gerador, Idf_Pessoa_Fisica, Flg_Interno, Dta_Cadastro, Flg_Inativo) VALUES (@Num_CPF, @Idf_Perfil_Principal, @Idf_Ultima_Empresa, @Idf_Usuario_Gerador, @Idf_Sistema_Gerador, @Idf_Pessoa_Fisica, @Flg_Interno, @Dta_Cadastro, @Flg_Inativo);SET @Idf_Usuario = SCOPE_IDENTITY();
• Parâmetros: @Num_CPF, @Idf_Perfil_Principal, @Idf_Ultima_Empresa, @Idf_Usuario_Gerador, @Idf_Sistema_Gerador, @Idf_Pessoa_Fisica, @Flg_Interno, @Dta_Cadastro, @Flg_Inativo, @Idf_Usuario (output)
• Propósito: Insere um novo registro na tabela TAB_Usuario e retorna o ID gerado.

• Chamadas a outros métodos/classes:

• UsuarioPerfil.CarregarPorUsuarioPerfil(int idUsuario, int idPerfil, SqlTransaction trans, out UsuarioPerfil objUsuarioPerfil)
• UsuarioPerfil.Save(SqlTransaction trans)
• PeriodoPermissao.CarregarPorUsuarioPerfilPeriodo(int idUsuario, int idPerfil, DateTime periodo, SqlTransaction trans, out PeriodoPermissao objPeriodoPermissao)
• PeriodoPermissao.Save(SqlTransaction trans)
• AuditoriaEventMapTransaction.IntegrarAuditoriaEventMap(SqlTransaction trans)
• AuditoriaEventMapTransaction.RemoverAuditoriaEventMap(SqlTransaction trans)

Update(bool auditar = true)

• Lógica:

1. Auditoria: Se auditar for true:

• Carrega o estado atual do objeto Usuario do banco de dados para PreUpdateAuditoria (para comparação na auditoria).
• Chama CompletarInformacoesAuditoria(PreUpdateAuditoria, null, false) para preencher informações de auditoria do estado anterior.

2. Verifica se a instância foi modificada (_modified). Se não foi, não faz nada.
3. Abre uma nova conexão SQL (SqlConnection) e inicia uma transação (SqlTransaction).
4. Chama GetParameters() e SetParameters(parms) para preparar os parâmetros.
5. Executa a consulta SQL SPUPDATE (definida como SQL inline) usando DataAccessLayer.ExecuteNonQuery.
6. Gerencia UsuarioPerfil e PeriodoPermissao: Lógica idêntica à do método Insert(), garantindo que o perfil principal e o período de permissão estejam atualizados.
7. Define _modified como false.
8. Comita a transação.
9. Em caso de exceção, faz rollback da transação e relança a exceção.

• Stored Procedures chamadas:

• SQL inline: UPDATE TAB_Usuario SET Num_CPF = @Num_CPF, Idf_Perfil_Principal = @Idf_Perfil_Principal, Idf_Ultima_Empresa = @Idf_Ultima_Empresa, Idf_Usuario_Gerador = @Idf_Usuario_Gerador, Idf_Sistema_Gerador = @Idf_Sistema_Gerador, Idf_Pessoa_Fisica = @Idf_Pessoa_Fisica, Flg_Interno = @Flg_Interno, Dta_Cadastro = @Dta_Cadastro, Flg_Inativo = @Flg_Inativo WHERE Idf_Usuario = @Idf_Usuario
• Parâmetros: @Num_CPF, @Idf_Perfil_Principal, @Idf_Ultima_Empresa, @Idf_Usuario_Gerador, @Idf_Sistema_Gerador, @Idf_Pessoa_Fisica, @Flg_Interno, @Dta_Cadastro, @Flg_Inativo, @Idf_Usuario
• Propósito: Atualiza um registro existente na tabela TAB_Usuario.

• Chamadas a outros métodos/classes:

• LoadObject(int idUsuario): Para carregar o estado anterior para auditoria.
• CompletarInformacoesAuditoria(Usuario usuario, Usuario atual = null, bool consultarDescricaoReferencia = true): Para preencher informações de auditoria.
• UsuarioPerfil.CarregarPorUsuarioPerfil(...), UsuarioPerfil.Save(...), PeriodoPermissao.CarregarPorUsuarioPerfilPeriodo(...), PeriodoPermissao.Save(...): Mesmas chamadas do Insert().

Save(bool auditar = true)

• Lógica:

1. Verifica a propriedade _persisted.
2. Se _persisted for false (nova instância), chama this.Insert().
3. Se _persisted for true (instância existente), chama this.Update(auditar).
4. Se auditar for true, chama SalvarAuditoria(this).

• Regras de negócio: Decide entre inserir ou atualizar com base no estado de persistência do objeto. Integra a funcionalidade de auditoria.
• Chamadas a outros métodos/classes:

• Insert() ou Update(bool auditar)
• SalvarAuditoria(Usuario auditoria, SqlTransaction trans = null, bool ehDelete = false, AtividadeAuditoriaDTO atividade = null)

Delete(int usuario)

• Lógica:

1. Carrega o objeto Usuario antes da exclusão para fins de auditoria (LoadObject(usuario)).
2. Cria uma lista de SqlParameter e adiciona @Idf_Usuario e @Idf_Usuario_Gerador.
3. Define o valor do parâmetro @Idf_Usuario com o usuario fornecido.
4. Define o valor do parâmetro @Idf_Usuario_Gerador com o ID do usuário logado (obtido da Session).
5. Executa a consulta SQL SPDELETE (definida como SQL inline) usando DataAccessLayer.ExecuteNonQuery.

• Stored Procedures chamadas:

• SQL inline: UPDATE TAB_Usuario SET Idf_Usuario_Gerador = @Idf_Usuario_Gerador WHERE Idf_Usuario = @Idf_Usuario ; DELETE FROM TAB_Usuario WHERE Idf_Usuario = @Idf_Usuario
• Parâmetros: @Idf_Usuario_Gerador, @Idf_Usuario
• Propósito: Atualiza o Idf_Usuario_Gerador e em seguida exclui um registro da tabela TAB_Usuario.

• Chamadas a outros métodos/classes:

• LoadObject(int usuario): Para obter o objeto antes da exclusão (provavelmente para auditoria).

SalvarAuditoria(Usuario auditoria, SqlTransaction trans = null, bool ehDelete = false, AtividadeAuditoriaDTO atividade = null)

• Lógica:

1. Verifica se a auditoria está habilitada (GlobalSettingsSingleton.AuditoriaHabilitada). Se não, retorna.
2. Determina o tipoAcao (Insert, Update, Delete, Inativacao, Ativacao) com base em ehDelete e auditoria.PreUpdateAuditoria. Se for um update e o status de inatividade mudou, ajusta o tipoAcao.
3. Condição tipoAcao != OperacaoEventoMap.Delete:

• Chama CompletarInformacoesAuditoria(auditoria) para garantir que o objeto auditoria tenha todas as informações necessárias.

4. Cria uma nova instância de AuditoriaQueue com todos os detalhes do evento de auditoria (tipo de ação, estado anterior/atual, IDs, descrição, tipo de evento, campos a ignorar, mapeamento de objetos, se é transacional, atividade).
5. Adiciona o auditoriaQueue ao MongoAcessLayer (provavelmente um sistema de log/auditoria baseado em MongoDB).
6. Se uma transação (trans) for fornecida, também adiciona o evento de auditoria à transação (MongoAcessLayer.Instance.AddTransacaoAuditoria).
7. Em caso de exceção, loga o erro usando PlataformaLog.LogError.WriteLog.
8. No bloco finally, limpa as propriedades de auditoria (PreUpdateAuditoria) do objeto auditoria e de seus objetos relacionados (PessoaFisica, LoginUsuario).

• Regras de negócio: Implementa a lógica central de auditoria para a entidade Usuario, registrando as mudanças no banco de dados e em um sistema de log externo (MongoDB).
• Chamadas a outros métodos/classes:

• CompletarInformacoesAuditoria(Usuario usuario, Usuario atual = null, bool consultarDescricaoReferencia = true)
• MongoAcessLayer.Instance.Add(AuditoriaQueue auditoriaQueue)
• MongoAcessLayer.Instance.AddTransacaoAuditoria(AuditoriaQueue auditoriaQueue, SqlTransaction trans)
• PlataformaLog.LogError.WriteLog(...)

CarregarPermissoes(Usuario usuario, Enumeradores.CategoriaPermissao categoria)

• Lógica:

1. Cria uma nova lista de inteiros (permissoes) para armazenar os IDs das permissões.
2. Cria uma lista de SqlParameter e adiciona @Idf_Categoria_Permissao e @Idf_Usuario.
3. Define os valores dos parâmetros com a categoria e usuario.IdUsuario fornecidos.
4. Executa a consulta SQL SPSELECTPERMISSOESUSUARIO (definida como SQL inline) usando DataAccessLayer.ExecuteReader.
5. Itera sobre o IDataReader (while (dr.Read())):

• Para cada linha, adiciona o valor da coluna “Permissao” (convertido para int) à lista permissoes.

6. Fecha e descarta o IDataReader.
7. Retorna a lista de permissoes.

• Stored Procedures chamadas:

• SQL inline (SPSELECTPERMISSOESUSUARIO): SELECT DISTINCT p.Idf_Permissao as Permissao FROM TAB_Periodo_Permissao pp INNER JOIN TAB_Perfil_Permissao p ON pp.Idf_Perfil = p.Idf_Perfil INNER JOIN plataforma.TAB_Permissao per ON p.Idf_Permissao = per.Idf_Permissao WHERE Idf_Usuario = @idf_usuario AND Dta_Inicio <= GETDATE() AND (Dta_Fim >= GETDATE() OR Dta_Fim IS NULL) AND per.Idf_Categoria_Permissao = @Idf_Categoria_Permissao
• Parâmetros: @idf_usuario, @Idf_Categoria_Permissao
• Propósito: Retorna as permissões ativas de um usuário em uma determinada categoria.

Listar(string nomeColuna, string direcaoOrdenacao, int paginaCorrente, int tamanhoPagina, out int totalRegistros)

• Lógica:

1. Cria uma lista de SqlParameter para @SortExpression, @CurrentPage, @PageSize e @WhereExpression.
2. Define os valores dos parâmetros com os argumentos fornecidos. @SortExpression é uma concatenação de nomeColuna e direcaoOrdenacao.
3. Executa a consulta SQL SPSELECTPAG (definida como SQL inline) usando DataAccessLayer.ExecuteReaderDs, que retorna um DataSet.
4. O totalRegistros é obtido da primeira tabela do DataSet (que contém a contagem).
5. Retorna a segunda tabela do DataSet (que contém os dados paginados).

• Stored Procedures chamadas:

• SQL inline (SPSELECTPAG): DECLARE @FirstRec INT ... EXECUTE (@iSelectCount) EXECUTE (@iSelectPag)
• Parâmetros: @CurrentPage, @PageSize, @SortExpression, @WhereExpression
• Propósito: Retorna uma consulta paginada de usuários, incluindo o total de registros.

ListarPermissoesPorUsuario(string pesquisa, int idUsuario, string nomeColuna, string direcaoOrdenacao, int paginaCorrente, int tamanhoPagina, out int totalRegistros)

• Lógica:

1. Cria uma lista de SqlParameter para @CurrentPage, @PageSize, @Idf_Usuario e @Pesquisa.
2. Define os valores dos parâmetros.
3. Constrói a string orderBy com nomeColuna e direcaoOrdenacao.
4. Formata a string SQL SPSELPERMISSOES com a orderBy.
5. Executa a consulta SQL formatada usando DataAccessLayer.ExecuteReader.
6. Lê o primeiro resultado do IDataReader para obter o totalRegistros.
7. Avança para o próximo conjunto de resultados (dr.NextResult()) que contém os dados das permissões.
8. Retorna o IDataReader posicionado nos dados das permissões.

• Stored Procedures chamadas:

• SQL inline (SPSELPERMISSOES): DECLARE @FirstRec INT ... SELECT ROW_NUMBER() OVER (ORDER BY {0}) AS RowID, * INTO #ACESSOTMP FROM (...) AS TAB SELECT COUNT(*) FROM #AcessoTMP SELECT * FROM #AcessoTMP WHERE 1 = 1 AND RowID > @FirstRec AND RowID < @LastRec DROP TABLE #AcessoTMP
• Parâmetros: @CurrentPage, @PageSize, @Idf_Usuario, @Pesquisa
• Propósito: Retorna permissões de acesso de um usuário a diferentes níveis (grupo econômico, empresa, filial, contrato, centro de resultado), com paginação e filtro de pesquisa.

SetInstance(IDataReader dr, Usuario objUsuario, bool bDispose = true)

• Lógica:

1. Tenta ler a primeira linha do IDataReader (dr.Read()).
2. Se houver uma linha:

• Preenche todos os atributos da objUsuario com os valores correspondentes do IDataReader, realizando as conversões de tipo necessárias.
• Para _ultimaEmpresa, _sistemaGerador, _idPessoaFisica e _dataCadastro, verifica DBNull.Value antes de converter.
• Instancia objetos Perfil, Empresa, Usuario e Sistema para as propriedades relacionadas.
• Define _persisted como true e _modified como false.
• Retorna true.

3. Se não houver linha para ler, retorna false.
4. Em caso de exceção durante a leitura/conversão, relança a exceção.
5. No bloco finally, se bDispose for true, descarta o IDataReader (dr.Dispose()).

• Propósito: É um método auxiliar fundamental para mapear os resultados de uma consulta SQL para um objeto Usuario. O parâmetro bDispose permite controlar se o IDataReader deve ser descartado, útil quando o leitor é usado em um loop externo.

Stored Procedures

📌 Status: Em desenvolvimento 👤 Responsável: Equipe de QA