🛠️ Documentação Técnica: Histórico Alterações via Senha Master

[!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.

A tela AlteracaoSenhaMaster.aspx permite visualizar o histórico de alterações realizadas via Senha Master. Ela exibe um grid com informações sobre as alterações, como empresa, assunto, usuário que alterou, usuário que autorizou, data da autorização, revisor e data da revisão. Também possui funcionalidades para pesquisar, gerar relatório e visualizar detalhes de cada alteração em um modal.

👁️ 1. Visão Geral

• Propósito da tela: Exibir o histórico de alterações realizadas no sistema que exigiram a utilização da Senha Master para autorização. Permite auditar e consultar os detalhes dessas alterações.
• Contexto no sistema: Faz parte do módulo de segurança e auditoria do sistema WebFoPag, permitindo o acompanhamento de ações críticas.
• Usuários que utilizam: Usuários com permissão para auditar alterações de Senha Master.

🗂️ 2. Tipos/Modalidades

• A tela opera em uma única modalidade de consulta e auditoria de alterações de Senha Master.
• O modal de detalhes da alteração pode exibir ou ocultar a “Mensagem de Impacto” através de um botão.
• O painel de revisor (pnlRevisor) é visível apenas se a alteração já tiver sido auditada (DataAuditoria.HasValue).

🖥️ 3. Interface — Campos e Controles

📑 4. Abas e Seções

A tela não possui abas, mas é dividida em seções lógicas:

• Cabeçalho: <h1>Histórico de alterações via Senha Master</h1>
• Área de Pesquisa: Contém o campo txtPesquisa e o botão btnPesquisar.
• Filtro: Contém o filtro lstAuditado.
• Grid de Alterações: div contendo o EmployerGrid (grvAlteracoes) que exibe os resultados.
• Painel de Botões da Seção: div com os botões btnRelatorio e btnVoltar.
• Modal de Detalhes da Alteração: divModal (inicialmente display: none;) que é exibido via ModalPopupExtender.
• Painel Interno do Modal: pnlDetalhes
• Detalhes da Alteração: Seção com informações como Empresa, Assunto, Alterado Por, Autorizado Por, Data Alteração, Justificativa.
• Dados Alterados: Seção que exibe os dados que foram modificados.
• Mensagem de Impacto: pnlModalPreAutorizacao que pode ser expandido/contraído.
• Painel do Revisor: pnlRevisor (visível condicionalmente) com informações de auditoria.
• Botões do Modal: btnCiente e btnModalPreAutorizacao.
• Confirmação de Senha: UserControl cfsAuditoria para auditoria.

🛡️ 5. Regras de Negócio

5.1. Validações de Campos

• txtPesquisa: Não há validação explícita de formato no lado do cliente ou servidor, aceita texto livre.
• cfsAuditoria (UserControl ConfirmacaoSenha):
• A justificativa é obrigatória para a confirmação de auditoria, conforme as propriedades SolicitarJustificativa="true" e ObrigarJustificativa="true" configuradas no controle.

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

• pnlRevisor: Torna-se visível (Visible = true) no modal de detalhes se a alteração já possui uma DataAuditoria (ou seja, já foi auditada).
• btnCiente: Torna-se invisível (Visible = false) no modal de detalhes se a alteração já possui uma DataAuditoria. Caso contrário, é visível.
• pnlModalPreAutorizacao: A visibilidade deste painel é controlada por um script JavaScript (ExibirPreAutorizacao) acionado pelo botão btnModalPreAutorizacao. O botão alterna seu texto entre ”+ Ver Mensagem de Impacto” e ”- Ocultar Mensagem de Impacto” e exibe/oculta o painel.

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

• Não aplicável. A tela é de consulta e auditoria, não permitindo inativação ou exclusão de registros.

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

• Auditoria de Alteração (cfsAuditoria_OnConfirmar):
• Ao confirmar a auditoria, o sistema verifica se hfAlteracao.Value contém um ID de alteração válido.
• Uma instância de AlteracaoMaster é criada com o ID da alteração.
• O objeto AlteracaoMaster é completado (CompleteObject()).
• O UsuarioAuditoria do objeto AlteracaoMaster é definido com base no IdUsuario do controle cfsAuditoria.
• A DescricaoJustificativaAuditoria é preenchida com a justificativa fornecida no cfsAuditoria.
• A DataAuditoria é definida como a data e hora atual (DateTime.Now).
• O objeto AlteracaoMaster é salvo (Save()).
• Uma mensagem de sucesso (MensagemAviso._100001) é exibida.
• O hfAlteracao.Value é limpo, o controle cfsAuditoria é fechado, o modal de detalhes é ocultado e o grid é recarregado.

5.5. Outras Regras Específicas da Tela

• Carregamento do Grid: O grid (grvAlteracoes) é carregado com base no termo de pesquisa (TermoPesquisa) e no filtro de auditado (lstAuditado.ValorBooleano). A ordenação e paginação são gerenciadas pelo próprio grid.
• Geração de Relatório: Ao clicar em btnRelatorio, o ID do relatório Enumeradores.PluginEntradaRelatorio.RelatorioAlteracaoSenhaMaster é armazenado na sessão e o usuário é redirecionado para a tela de geração de relatórios assíncronos.
• Leitura de XML de Alteração: O método LerXMLAlteracaoMaster utiliza ConfirmacaoSenhaUtil.ConfigurarMensagemImpacto para formatar uma string XML (DescricaoAlteracaoMaster) em HTML, exibindo os dados alterados de forma legível no modal.

🔄 6. Fluxos Principais

6.1. Inicialização da Tela

1. Page_Load: Se não for um postback, chama Inicializar().
2. Inicializar():

• Define a coluna de ordenação padrão do grvAlteracoes (grvAlteracoes.Columns[0].SortExpression).
• Chama CarregarListaSugestao() para popular o lstAuditado com opções de sim/não.
• Chama CarregarGrid() para carregar os dados iniciais no grid.
• Configura o UserControl cfsAuditoria com o título “Confirmação de Senha” e associa a permissão Enumeradores.Permissoes.SenhaMaster.Auditar.
• Chama Limpar() para resetar o filtro lstAuditado para o valor false.

6.2. Pesquisa

1. btnPesquisar_Click:

• Atualiza a propriedade TermoPesquisa com o texto digitado em txtPesquisa.
• Reseta o índice da página do grid (grvAlteracoes.MockPageIndex = 0).
• Chama CarregarGrid() para recarregar o grid com o novo termo de pesquisa.

6.3. Filtragem por Auditado

1. lstAuditado_ValorAlterado:

• Chama CarregarGrid() para recarregar o grid com o novo filtro de auditoria.

6.4. Visualização de Detalhes da Alteração

1. grvAlteracoes_RowCommand (quando CommandName é “detalhes”):

• Extrai o idfAlteracao do CommandArgument.
• Chama CarregarModalDetalhes(idfAlteracao) para popular o modal com as informações da alteração.
• Exibe o modal de detalhes (mpeDetalhesAlteracao.Show()).

6.5. Fechamento do Modal de Detalhes

1. imbModalFechar_Click:

• Oculta o modal de detalhes (mpeDetalhesAlteracao.Hide()).

6.6. Auditoria da Alteração

1. cfsAuditoria_OnConfirmar:

• Verifica se hfAlteracao.Value contém um ID de alteração válido.
• Instancia um objeto AlteracaoMaster com o idfAlteracao e chama CompleteObject().
• Define o UsuarioAuditoria do objeto AlteracaoMaster usando o IdUsuario do cfsAuditoria.
• Preenche a DescricaoJustificativaAuditoria com a justificativa do cfsAuditoria.
• Define a DataAuditoria como a data e hora atual (DateTime.Now).
• Salva o objeto AlteracaoMaster (objAlteracao.Save()).
• Exibe uma mensagem de sucesso (MensagemAviso._100001).
• Limpa hfAlteracao.Value, fecha o cfsAuditoria, oculta o modal de detalhes e recarrega o grid.

6.7. Geração de Relatório

1. btnRelatorio_Click:

• Armazena o valor Enumeradores.PluginEntradaRelatorio.RelatorioAlteracaoSenhaMaster.GetHashCode() na Session sob a chave Chave.Temporaria.IdRelatorioSelecionado.
• Redireciona o usuário para a página ~/GeradorDeRelatoriosAssincronos.aspx.

6.8. Voltar

1. btnVoltar_Click:

• Redireciona o usuário para a página ~/MenuMaisOpcoes.aspx?ID=A.

🔌 7. Integrações e Dependências

7.1. Classes BLL e Service utilizadas

• Employer.Plataforma.BLL.AlteracaoMaster

• Arquivos de origem: Employer.Plataforma.BLL\AlteracaoMaster_P1.cs, Employer.Plataforma.BLL\AlteracaoMaster_P2.cs

• Métodos chamados:

• AlteracaoMaster(int idfAlteracao): Construtor que inicializa um objeto AlteracaoMaster com base em seu identificador único.

• CompleteObject(): Carrega todas as propriedades e objetos relacionados (Empresa, Assunto, Usuários) para a instância atual de AlteracaoMaster.

• Save(): Persiste as alterações ou um novo registro de AlteracaoMaster no banco de dados.

• Listar(string colunaOrdenada, string direcaoOrdenacao, int pageIndex, int pageSize, out int totalRegistros, bool? auditado, string termoPesquisa): Retorna uma lista paginada e ordenada de objetos AlteracaoMaster, aplicando filtros por status de auditoria e termo de pesquisa.

• Employer.Plataforma.Web.WebFoPag.Code.ConfirmacaoSenhaUtil

• Arquivo de origem: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.Web.WebFoPag\Code\ConfirmacaoSenhaUtil.cs

• Métodos chamados:

• ConfigurarMensagemImpacto(ref string html, string alteracoes, ConfirmacaoSenhaUtil.EnumTipoEstrutura tipoEstrutura): Método estático que recebe uma string XML contendo detalhes de alterações e a formata em HTML (como uma tabela) para exibição em interfaces de usuário.

• Employer.Plataforma.BLL.PessoaFisica

• Arquivos de origem: Employer.Plataforma.BLL\PessoaFisica_P1.cs, Employer.Plataforma.BLL\PessoaFisica_P2.cs, Employer.Plataforma.BLL\PessoaFisica_P3.cs

• Métodos chamados:

• RecuperarPorCPF(string numeroCPF): Método estático que busca e retorna um objeto PessoaFisica com base no número do CPF fornecido.

• Employer.Plataforma.Web.Code.UIHelper

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

• Métodos chamados:

• CarregarGridView(EmployerGrid grid, object dataSource, int totalRegistros): Método estático utilitário para vincular um DataSource a um EmployerGrid, configurando automaticamente a paginação e o total de registros.

• Employer.Plataforma.BLL.Usuario

• Arquivos de origem: Employer.Plataforma.BLL\Usuario_P1.cs, Employer.Plataforma.BLL\Usuario_P2.cs

• Métodos chamados:

• Usuario(int idUsuario): Construtor que inicializa um objeto Usuario com base em seu identificador único.

• CompleteObject(): Carrega todas as propriedades para a instância atual de Usuario.

7.2. Stored Procedures chamadas

• SP_ALTERACAO_MASTER_LISTAR

• Arquivo BLL onde aparece: Employer.Plataforma.BLL\AlteracaoMaster_P2.cs

• Parâmetros SQL: @COLUNA_ORDENADA, @DIRECAO_ORDENACAO, @PAGE_INDEX, @PAGE_SIZE, @AUDITADO, @TERMO_PESQUISA

• Propósito: Retorna uma lista paginada e ordenada de registros de alteração de senha master, com filtros opcionais para status de auditoria e termo de pesquisa.

• SP_ALTERACAO_MASTER_COMPLETAR_OBJETO

• Arquivo BLL onde aparece: Employer.Plataforma.BLL\AlteracaoMaster_P1.cs

• Parâmetros SQL: @IDF_ALTERACAO_MASTER

• Propósito: Carrega todos os detalhes de uma alteração de senha master específica, incluindo dados de empresa, assunto e usuários relacionados.

• SP_ALTERACAO_MASTER_SALVAR

• Arquivo BLL onde aparece: Employer.Plataforma.BLL\AlteracaoMaster_P1.cs

• Parâmetros SQL: @IDF_ALTERACAO_MASTER, @IDF_EMPRESA, @IDF_ASSUNTO, @IDF_USUARIO_ALTERACAO, @IDF_USUARIO_MASTER, @DTA_ALTERACAO, @DES_ALTERACAO_MASTER, @DES_JUSTIFICATIVA_MASTER, @DES_MENSAGEM_MASTER, @IDF_USUARIO_AUDITORIA, @DES_JUSTIFICATIVA_AUDITORIA, @DTA_AUDITORIA

• Propósito: Insere um novo registro de alteração de senha master ou atualiza um existente no banco de dados, incluindo informações sobre a auditoria.

• SP_PESSOA_FISICA_RECUPERAR_POR_CPF

• Arquivo BLL onde aparece: Employer.Plataforma.BLL\PessoaFisica_P1.cs

• Parâmetros SQL: @NUM_CPF

• Propósito: Recupera os dados cadastrais de uma pessoa física utilizando seu número de CPF.

• SP_USUARIO_COMPLETAR_OBJETO

• Arquivo BLL onde aparece: Employer.Plataforma.BLL\Usuario_P1.cs

• Parâmetros SQL: @IDF_USUARIO

• Propósito: Carrega todas as informações de um usuário específico com base em seu identificador.

7.3. UserControls incluídos (.ascx)

• Employer:ControlAlfaNumerico

• Caminho: Não especificado explicitamente no .aspx, mas é um controle customizado da Employer.

• ID: txtPesquisa

• Tag: <Employer:ControlAlfaNumerico>

• Propriedades expostas: CssClassTextBox, Width

• Eventos: Nenhum evento público diretamente chamado pela tela pai.

• Métodos públicos chamados: Nenhum.

• Employer:ListaSugestoes

• Caminho: Não especificado explicitamente no .aspx, mas é um controle customizado da Employer.

• ID: lstAuditado

• Tag: <Employer:ListaSugestoes>

• Propriedades expostas: CssClassTextBox, ValorBooleano

• Eventos: OnValueChanged="lstAuditado_ValorAlterado" (disparado quando o valor do controle é alterado).

• Métodos públicos chamados: ListaSugestoesExtensions.CarregarListaSugestoes(lstAuditado, BLL.Flag.ListarDictionary()) para popular as opções.

• Employer:EmployerGrid

• Caminho: Não especificado explicitamente no .aspx, mas é um controle customizado da Employer.

• ID: grvAlteracoes

• Tag: <Employer:EmployerGrid>

• Propriedades expostas: SkinID, AutoGenerateColumns, PageSize, AllowSorting, AllowPaging, CssClass, HeaderStyle-CssClass, AlternatingRowStyle-CssClass, CellSpacing, MockColunaOrdenada, MockDirecaoOrdenacao, MockPageIndex (utilizadas para controle de paginação e ordenação).

• Eventos: RowCommand="grvAlteracoes_RowCommand" (disparado ao clicar em botões dentro das linhas do grid), CarregarGrid="grvAlteracoes_CarregarGrid" (disparado para recarregar os dados do grid).

• Métodos públicos chamados: Nenhum.

• Employer:ConfirmacaoSenha

• Caminho: Não especificado explicitamente no .aspx, mas é um controle customizado da Employer.

• ID: cfsAuditoria

• Tag: <Employer:ConfirmacaoSenha>

• Propriedades expostas: NomeSistemaOrigem, TargetControlID, SolicitarJustificativa, ObrigarJustificativa, Titulo, IdPermissao, IdUsuario, RecuperarJustificativa (para obter a justificativa digitada pelo usuário).

• Eventos: OnConfirmar="cfsAuditoria_OnConfirmar" (disparado após a confirmação da senha e justificativa).

• Métodos públicos chamados: Close() (para fechar o modal de confirmação de senha).

7.4. WebServices, APIs externas, filas

• Não há chamadas diretas a WebServices, APIs externas ou filas RabbitMQ identificadas no código-behind da tela AlteracaoSenhaMaster.aspx.cs.

8. Mensagens ao Usuário

• "Pesquise por empresa, escopo, usuário ou data." (Texto do controle Label1)
• "Auditado" (Texto do controle lblAuditado)
• "Não foi encontrado nenhuma Alteração Senha Master" (Mensagem exibida no EmptyDataTemplate do grvAlteracoes quando não há resultados).
• "Relatório Alterações" (Texto do botão btnRelatorio)
• "Voltar" (Texto do botão btnVoltar)
• "Detalhes da Alteração" (Texto do controle lblModalTitulo no modal de detalhes).
• "Empresa" (Texto do controle lblModalEmpresa no modal de detalhes).
• "Assunto" (Texto do controle lblModalAssunto no modal de detalhes).
• "Alterado por" (Texto do controle lblModalAlteadoPor no modal de detalhes).
• "Autorizado por (Master)" (Texto do controle lblModalAutorizadoPor no modal de detalhes).
• "Data Alteração" (Texto do controle lblModalDataAlteracao no modal de detalhes).
• "Justificativa" (Texto do controle lblModalJustificativa no modal de detalhes).
• "Dados Alterados" (Texto do controle lblModalDadosAlterados no modal de detalhes).
• "Auditado por" (Texto do controle lblModalAuditadoPor no painel do revisor no modal).
• "Data Auditoria" (Texto do controle lblModalDataAuditoria no painel do revisor no modal).
• "Justificativa" (Texto do controle lblModalJustificativaAuditava no painel do revisor no modal).
• MensagemAviso._100001: Mensagem de sucesso genérica exibida após a auditoria da alteração. O texto exato dependerá da implementação do recurso de mensagens.
• "+ Ver Mensagem de Impacto" / "- Ocultar Mensagem de Impacto" (Texto do botão btnModalPreAutorizacao, que alterna entre exibir e ocultar o painel de mensagem de impacto).
• "Confirmação de Senha" (Título configurado para o UserControl cfsAuditoria).

9. Permissões e Perfis

• Enumeradores.Permissoes.SenhaMaster.Auditar: Esta permissão é configurada para o UserControl cfsAuditoria (cfsAuditoria.IdPermissao = Enumeradores.Permissoes.SenhaMaster.Auditar.GetHashCode();). Ela controla a capacidade do usuário logado de realizar a ação de auditoria de uma alteração de Senha Master, exigindo a confirmação de senha e justificativa.

10. Aprofundamento — Detalhes Internos de Métodos

A classe UIHelper está em C:\Webfopag\Etec.WebFopag\Employer.Plataforma.Web.Code\UIHelper.cs. Vou ler este arquivo.

Agora que tenho todos os arquivos, vou processá-los e gerar a documentação detalhada.

AlteracaoMaster

Arquivos:

• C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\AlteracaoMaster_P1.cs
• C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\AlteracaoMaster_P2.cs

Métodos

Detalhamento de Métodos Importantes

AlteracaoMaster(int idAlteracaoMaster)

• Lógica: Este construtor é utilizado para criar uma nova instância da classe AlteracaoMaster e inicializar seu identificador (_idAlteracaoMaster) com o valor fornecido. Ele também define a flag _persisted como true, indicando que o objeto já existe no banco de dados (embora seus dados ainda não tenham sido carregados).
• Stored Procedures chamadas: Nenhuma diretamente.
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

GetParameters()

• Lógica: Este método privado cria e retorna uma lista de objetos SqlParameter com os nomes e tipos de dados correspondentes a todas as colunas da tabela TAB_Alteracao_Master. Os valores dos parâmetros não são preenchidos neste método, apenas a estrutura é definida.
• Stored Procedures chamadas: Nenhuma diretamente.
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

SetParameters(List parms)

• Lógica: Este método privado recebe uma lista de SqlParameter (geralmente criada por GetParameters()) e preenche os valores de cada parâmetro com os dados da instância atual de AlteracaoMaster.
• Ele atribui valores para IdAlteracaoMaster, IdRegistroAlterado, UsuarioMaster.IdUsuario, DescricaoAlteracaoMaster, DescricaoJustificativaMaster, Empresa.IdEmpresa, Assunto.IdAssunto.
• Para campos opcionais como DescricaoMensagemMaster, UsuarioAuditoria, DescricaoJustificativaAuditoria, DataAuditoria e IdAlteracaoMasterMae, ele verifica se o valor é nulo ou vazio e, se for, atribui DBNull.Value ao parâmetro SQL.
• Se o objeto não estiver persistido (_persisted é false), o parâmetro @Idf_Alteracao_Master é configurado como ParameterDirection.Output para receber o ID gerado pelo banco de dados. Caso contrário, é ParameterDirection.Input.
• O UsuarioAlteracao é definido com base no IdUsuario da sessão HTTP atual (ou 1 se a sessão for nula).
• A DataAlteracao é definida como DateTime.Now.
• Stored Procedures chamadas: Nenhuma diretamente.
• Validações: Verifica se strings são nulas/vazias para atribuir DBNull.Value.
• Regras de negócio:
• O UsuarioAlteracao é sempre o usuário logado na sessão.
• A DataAlteracao é sempre a data e hora atual.

Insert()

• Lógica: Este método privado é responsável por inserir um novo registro de AlteracaoMaster no banco de dados.

1. Chama GetParameters() para obter a lista de parâmetros.
2. Chama SetParameters(parms) para preencher os parâmetros com os dados da instância.
3. Abre uma conexão SQL e inicia uma transação.
4. Executa a query SPINSERT (um comando INSERT direto) usando DataAccessLayer.ExecuteNonQueryCmd.
5. Recupera o IdAlteracaoMaster gerado pelo banco de dados (usando SCOPE_IDENTITY()) e atribui à propriedade _idAlteracaoMaster.
6. Limpa os parâmetros do comando.
7. Define _persisted como true e _modified como false.
8. Comita a transação.
9. Em caso de erro, a transação é revertida (Rollback()) e a exceção é relançada.

• Stored Procedures chamadas: SPINSERT (string SQL de INSERT)
• @Idf_Registro_Alterado: int
• @Idf_Usuario_Alteracao: int
• @Idf_Usuario_Master: int
• @Des_Mensagem_Master: varchar
• @Des_Alteracao_Master: xml
• @Des_Justificativa_Master: varchar
• @Dta_Alteracao: datetime
• @Idf_Empresa: int
• @Idf_Usuario_Auditoria: int
• @Des_Justificativa_Auditoria: varchar
• @Dta_Auditoria: datetime
• @Idf_Alteracao_Master_Mae: int
• @Idf_Assunto: int
• @Idf_Alteracao_Master: int (OUTPUT)
• Validações: Nenhuma explícita além das do banco de dados.
• Regras de negócio: O Idf_Alteracao_Master é gerado automaticamente pelo banco de dados.

Insert(SqlTransaction trans)

• Lógica: Similar ao Insert() sem transação, mas utiliza uma transação SQL existente fornecida como parâmetro.

1. Chama GetParameters() e SetParameters(parms).
2. Executa a query SPINSERT usando DataAccessLayer.ExecuteNonQueryCmd com a transação fornecida.
3. Recupera o IdAlteracaoMaster gerado.
4. Limpa os parâmetros e atualiza as flags _persisted e _modified.

• Stored Procedures chamadas: SPINSERT (string SQL de INSERT)
• Parâmetros: Mesmos do Insert() sem transação.
• Validações: Nenhuma explícita.
• Regras de negócio: Nenhuma.

Update()

• Lógica: Este método privado atualiza um registro existente de AlteracaoMaster no banco de dados.

1. Verifica se o objeto foi modificado (_modified é true). Se não, não faz nada.
2. Chama GetParameters() e SetParameters(parms).
3. Executa a query SPUPDATE (um comando UPDATE direto) usando DataAccessLayer.ExecuteNonQuery.
4. Define _modified como false.

• Stored Procedures chamadas: SPUPDATE (string SQL de UPDATE)
• @Idf_Registro_Alterado: int
• @Idf_Usuario_Alteracao: int
• @Idf_Usuario_Master: int
• @Des_Mensagem_Master: varchar
• @Des_Alteracao_Master: xml
• @Des_Justificativa_Master: varchar
• @Dta_Alteracao: datetime
• @Idf_Empresa: int
• @Idf_Usuario_Auditoria: int
• @Des_Justificativa_Auditoria: varchar
• @Dta_Auditoria: datetime
• @Idf_Alteracao_Master_Mae: int
• @Idf_Assunto: int
• @Idf_Alteracao_Master: int (WHERE clause)
• Validações: Nenhuma explícita.
• Regras de negócio: A atualização só ocorre se o objeto foi modificado.

Update(SqlTransaction trans)

• Lógica: Similar ao Update() sem transação, mas utiliza uma transação SQL existente.

1. Verifica _modified.
2. Chama GetParameters() e SetParameters(parms).
3. Executa a query SPUPDATE com a transação fornecida.
4. Define _modified como false.

• Stored Procedures chamadas: SPUPDATE (string SQL de UPDATE)
• Parâmetros: Mesmos do Update() sem transação.
• Validações: Nenhuma explícita.
• Regras de negócio: Nenhuma.

Save()

• Lógica: Este método público decide se deve inserir ou atualizar o registro no banco de dados.
• Se o objeto não estiver persistido (_persisted é false), ele chama this.Insert().
• Caso contrário, ele chama this.Update().
• Stored Procedures chamadas: Nenhuma diretamente, mas chama Insert() ou Update().
• Validações: Nenhuma.
• Regras de negócio: Gerencia o ciclo de vida de persistência do objeto.

Save(SqlTransaction trans)

• Lógica: Similar ao Save() sem transação, mas utiliza uma transação SQL existente.
• Se o objeto não estiver persistido, chama this.Insert(trans).
• Caso contrário, chama this.Update(trans).
• Stored Procedures chamadas: Nenhuma diretamente, mas chama Insert(trans) ou Update(trans).
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

Delete(int idAlteracaoMaster)

• Lógica: Este método estático exclui um registro de AlteracaoMaster do banco de dados.

1. Cria uma lista de SqlParameter e adiciona @Idf_Alteracao_Master.
2. Atribui o idAlteracaoMaster fornecido ao parâmetro.
3. Executa a query SPDELETE (um comando DELETE direto) usando DataAccessLayer.ExecuteNonQuery.

• Stored Procedures chamadas: SPDELETE (string SQL de DELETE)
• @Idf_Alteracao_Master: int
• Validações: Nenhuma explícita.
• Regras de negócio: Nenhuma.

Delete(int idAlteracaoMaster, SqlTransaction trans)

• Lógica: Similar ao Delete(int idAlteracaoMaster) sem transação, mas utiliza uma transação SQL existente.

1. Cria e preenche os parâmetros.
2. Executa a query SPDELETE com a transação fornecida.

• Stored Procedures chamadas: SPDELETE (string SQL de DELETE)
• Parâmetros: Mesmos do Delete(int idAlteracaoMaster) sem transação.
• Validações: Nenhuma explícita.
• Regras de negócio: Nenhuma.

Delete(List idAlteracaoMaster)

• Lógica: Este método estático exclui múltiplos registros de AlteracaoMaster do banco de dados.

1. Constrói dinamicamente uma query SQL DELETE com uma cláusula WHERE IN para os IDs fornecidos.
2. Cria parâmetros SQL para cada ID na lista.
3. Executa a query usando DataAccessLayer.ExecuteNonQuery.

• Stored Procedures chamadas: Nenhuma diretamente, mas constrói uma query DELETE dinâmica.
• @parmX: int (para cada ID na lista)
• Validações: Nenhuma explícita.
• Regras de negócio: Nenhuma.

LoadDataReader(int idAlteracaoMaster)

• Lógica: Este método privado retorna um IDataReader contendo os dados de um único registro de AlteracaoMaster.

1. Cria uma lista de SqlParameter e adiciona @Idf_Alteracao_Master.
2. Atribui o idAlteracaoMaster fornecido ao parâmetro.
3. Executa a query SPSELECTID (um comando SELECT * direto) usando DataAccessLayer.ExecuteReader.

• Stored Procedures chamadas: SPSELECTID (string SQL de SELECT)
• @Idf_Alteracao_Master: int
• Validações: Nenhuma explícita.
• Regras de negócio: Nenhuma.

LoadDataReader(int idAlteracaoMaster, SqlTransaction trans)

• Lógica: Similar ao LoadDataReader(int idAlteracaoMaster) sem transação, mas utiliza uma transação SQL existente.

1. Cria e preenche os parâmetros.
2. Executa a query SPSELECTID com a transação fornecida.

• Stored Procedures chamadas: SPSELECTID (string SQL de SELECT)
• Parâmetros: Mesmos do LoadDataReader(int idAlteracaoMaster) sem transação.
• Validações: Nenhuma explícita.
• Regras de negócio: Nenhuma.

LoadDataReader(string colunaOrdenacao, string direcaoOrdenacao, int paginaCorrente, int tamanhoPagina, out int totalRegistros)

• Lógica: Este método público retorna um IDataReader para uma consulta paginada de AlteracaoMaster.

1. Calcula os índices de início e fim para a paginação.
2. Constrói duas queries SQL dinâmicas: SPSELECTPAG para os dados paginados (usando ROW_NUMBER() OVER (ORDER BY ...) e BETWEEN) e SPSELECTCOUNT para o total de registros.
3. Executa SPSELECTCOUNT usando DataAccessLayer.ExecuteScalar para obter o totalRegistros.
4. Executa SPSELECTPAG usando DataAccessLayer.ExecuteReader para obter os dados paginados.

• Stored Procedures chamadas: Nenhuma diretamente, mas constrói queries SELECT dinâmicas.
• @colunaOrdenacao: string (interpolado na query)
• @direcaoOrdenacao: string (interpolado na query)
• Validações: Nenhuma explícita.
• Regras de negócio: Implementa paginação e ordenação no lado do banco de dados.

LoadObject(int idAlteracaoMaster)

• Lógica: Este método estático carrega um objeto AlteracaoMaster completo do banco de dados.

1. Chama LoadDataReader(idAlteracaoMaster) para obter um IDataReader.
2. Cria uma nova instância de AlteracaoMaster.
3. Chama SetInstance(dr, objAlteracaoMaster) para preencher as propriedades do objeto.
4. Se SetInstance retornar true (registro encontrado), retorna o objeto.
5. Caso contrário, lança uma RecordNotFoundException.

• Stored Procedures chamadas: Nenhuma diretamente, mas chama LoadDataReader().
• Validações: Lança RecordNotFoundException se o registro não for encontrado.
• Regras de negócio: Nenhuma.

LoadObject(int idAlteracaoMaster, SqlTransaction trans)

• Lógica: Similar ao LoadObject(int idAlteracaoMaster) sem transação, mas utiliza uma transação SQL existente.

1. Chama LoadDataReader(idAlteracaoMaster, trans).
2. Cria uma nova instância e chama SetInstance.
3. Retorna o objeto ou lança RecordNotFoundException.

• Stored Procedures chamadas: Nenhuma diretamente, mas chama LoadDataReader(trans).
• Validações: Lança RecordNotFoundException se o registro não for encontrado.
• Regras de negócio: Nenhuma.

CompleteObject()

• Lógica: Este método público preenche as propriedades da instância atual de AlteracaoMaster a partir do banco de dados.

1. Chama LoadDataReader(this._idAlteracaoMaster) para obter um IDataReader com os dados do próprio objeto.
2. Chama SetInstance(dr, this) para preencher as propriedades da instância atual.
3. Retorna true se o objeto foi preenchido com sucesso, false caso contrário.

• Stored Procedures chamadas: Nenhuma diretamente, mas chama LoadDataReader().
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

CompleteObject(SqlTransaction trans)

• Lógica: Similar ao CompleteObject() sem transação, mas utiliza uma transação SQL existente.

1. Chama LoadDataReader(this._idAlteracaoMaster, trans).
2. Chama SetInstance(dr, this).
3. Retorna o status da operação.

• Stored Procedures chamadas: Nenhuma diretamente, mas chama LoadDataReader(trans).
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

SetInstance(IDataReader dr, AlteracaoMaster objAlteracaoMaster)

• Lógica: Este método privado é crucial para mapear os dados de um IDataReader para as propriedades de um objeto AlteracaoMaster.

1. Tenta ler a primeira linha do IDataReader.
2. Se houver uma linha:

• Converte e atribui os valores das colunas do IDataReader para os atributos privados do objAlteracaoMaster.
• Para campos que são objetos (ex: Usuario, Empresa, Assunto), ele cria novas instâncias desses objetos passando o ID recuperado do IDataReader.
• Lida com valores DBNull.Value para campos opcionais.
• Define _persisted como true e _modified como false.
• Retorna true.

3. Se não houver linhas, retorna false.
4. Inclui um bloco finally para garantir que o IDataReader seja descartado (Dispose()).

• Stored Procedures chamadas: Nenhuma diretamente.
• Validações: Realiza conversões de tipo (Convert.ToInt32, Convert.ToString, Convert.ToDateTime).
• Regras de negócio: Mapeamento de dados do banco para o objeto BLL.

Listar(string nomeColuna, string direcaoOrdenacao, int paginaCorrente, int tamanhoPagina, out int totalRegistros, bool? auditado, string textoPesquisa)

• Lógica: Este método estático retorna um DataTable com uma lista paginada e filtrada de alterações master.

1. Calcula os índices de início e fim para a paginação.
2. Constrói uma query SQL SPSELECTPAG complexa que inclui JOINs com TAB_Assunto, TAB_Empresa, TAB_Usuario e TAB_Pessoa_Fisica para obter informações detalhadas (Razão Social da Empresa, Descrição do Assunto, Nomes dos Usuários).
3. Filtros:

• Adiciona um parâmetro @Auditado para filtrar por status de auditoria (Dta_Auditoria IS NULL para não auditado, Dta_Auditoria IS NOT NULL para auditado).
• Se textoPesquisa não for vazio:
• Tenta converter textoPesquisa para DateTime. Se conseguir, filtra por Dta_Alteracao ou Dta_Auditoria.
• Caso contrário, filtra por Raz_Social, Nme_Pessoa (usuários), ou Des_Assunto usando LIKE '%textoPesquisa%'.

4. Formata a query SPSELECTPAG com a coluna e direção de ordenação.
5. Constrói SPSELECTCOUNT para contar o total de registros com os filtros aplicados.
6. Executa SPSELECTCOUNT para obter totalRegistros.
7. Executa a query SPSELECTPAG (com ROW_NUMBER() e BETWEEN) usando DataAccessLayer.ExecuteReaderDs e retorna a primeira tabela do DataSet.

• Stored Procedures chamadas: Nenhuma diretamente, mas constrói queries SELECT dinâmicas.
• @Auditado: bit
• @Pesquisa: date ou varchar (dependendo do tipo de pesquisa)
• Validações: Tenta DateTime.TryParse para o textoPesquisa.
• Regras de negócio:
• Paginação e ordenação dos resultados.
• Filtragem por status de auditoria (auditado/não auditado/todos).
• Pesquisa por texto livre em múltiplos campos (empresa, usuário, assunto, data).

Stored Procedures

ConfirmacaoSenhaUtil

Arquivo: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.Web.WebFoPag\Code\ConfirmacaoSenhaUtil.cs

Métodos

Detalhamento de Métodos Importantes

ValidarXML(String pXml, EnumTipoEstrutura pTipoEstrutura, List lstAlteracoes)

• Lógica: Este método privado tenta parsear uma string XML para verificar se ela segue uma estrutura específica, dependendo do pTipoEstrutura (Tabela ou TreeView).
• Ele usa XmlReader para iterar sobre os nós do XML.
• Se encontrar um nó <parametros>, ele chama ValidarItem() para verificar seus atributos.
• Se encontrar um nó <alteracoes>, <cabecalho> ou <alteracao>, ele popula a lista lstAlteracoes com os dados correspondentes (atributos de nome/valor).
• Após o parsing, ele realiza uma verificação adicional para garantir que todos os atributos de alteracao tenham um cabeçalho correspondente.
• Retorna true se o XML for válido, false caso contrário (ou se uma exceção ocorrer durante o parsing).
• Stored Procedures chamadas: Nenhuma.
• Validações:
• Verifica a estrutura geral do XML.
• Chama ValidarItem() para validar nós <parametros>.
• Verifica a consistência entre cabeçalhos e alterações.
• Regras de negócio: Define o formato XML esperado para as mensagens de impacto.

ValidarItem(XmlReader reader, EnumTipoEstrutura pTipoEstrutura)

• Lógica: Este método privado valida os atributos de um nó <parametros> dentro do XML.
• Com base no pTipoEstrutura (Tabela ou TreeView), ele define o número esperado de parâmetros (qtdParametros) e os nomes dos parâmetros (parametros).
• Para EnumTipoEstrutura.Tabela, espera “Campo”, “ValorAnterior”, “NovoValor”.
• Para EnumTipoEstrutura.TreeView, espera “Campo”, “Valor”, “Nivel”.
• Se o número de atributos no nó não corresponder ao esperado, retorna false.
• Itera sobre os atributos do nó e verifica se cada nome de atributo está na lista de parametros esperados e se o atributo “Campo” não está vazio.
• Lança uma Exception se o pTipoEstrutura for inválido.
• Stored Procedures chamadas: Nenhuma.
• Validações:
• Valida o número de atributos.
• Valida os nomes dos atributos.
• Valida que o atributo “Campo” não é vazio.
• Regras de negócio: Impõe a estrutura de atributos para os nós <parametros>.

AdicionarItem(String pXml, String item)

• Lógica: Este método privado é um utilitário simples que insere uma nova string item antes da tag de fechamento </xml> em uma string XML pXml.
• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

ConfigurarAdicionarItemXMLTabela(ref string pXml, string pNomeCampo, string pValorAnterior, string pNovoValor)

• Lógica: Este método público estático constrói um nó XML <parametros> com os atributos “Campo”, “ValorAnterior” e “NovoValor”, e o adiciona à string XML pXml.

1. Valida se pNomeCampo é nulo ou vazio, lançando uma Exception se for.
2. Formata a string no com os valores fornecidos (normalizando caracteres especiais).
3. Se pXml estiver vazio, inicializa-o como <xml></xml>.
4. Chama ValidarXML() para garantir que o pXml existente (ou recém-criado) esteja no formato de tabela. Se não for válido, lança uma Exception.
5. Chama AdicionarItem() para inserir o novo nó na string pXml.

• Stored Procedures chamadas: Nenhuma.
• Validações:
• pNomeCampo não pode ser nulo ou vazio.
• O XML deve estar no formato padrão para EnumTipoEstrutura.Tabela.
• Regras de negócio: Define como os dados de alteração são formatados em XML para exibição em tabela.

ConfigurarAdicionarItemXMLResumo(ref string pXml, string pNomeCampo, string pValorCampo, int pNivel)

• Lógica: Similar a ConfigurarAdicionarItemXMLTabela, mas constrói um nó XML <parametros> com os atributos “Campo”, “Valor” e “Nivel” para uma estrutura de resumo (TreeView).

1. Valida se pNomeCampo é nulo ou vazio.
2. Formata a string no com os valores fornecidos.
3. Se pXml estiver vazio, inicializa-o.
4. Chama ValidarXML() para garantir que o pXml esteja no formato de TreeView. Se não for válido, lança uma Exception.
5. Chama AdicionarItem() para inserir o novo nó.

• Stored Procedures chamadas: Nenhuma.
• Validações:
• pNomeCampo não pode ser nulo ou vazio.
• O XML deve estar no formato padrão para EnumTipoEstrutura.TreeView.
• Regras de negócio: Define como os dados de alteração são formatados em XML para exibição em TreeView.

ToHtml(String pConteudo, EnumTipoEstrutura pEnumTipoEstrutura)

• Lógica: Este método privado atua como um dispatcher, chamando o método ToHtml apropriado com base no pEnumTipoEstrutura.
• Se pEnumTipoEstrutura for Texto, chama ToHtmlTexto().
• Se pEnumTipoEstrutura for TreeView, chama ToHtmlTreeView().
• Se pEnumTipoEstrutura for Tabela, chama ToHtmlTabela().
• Lança uma Exception se o tipo de estrutura for inválido.
• Stored Procedures chamadas: Nenhuma.
• Validações: Valida o pEnumTipoEstrutura.
• Regras de negócio: Nenhuma.

ToHtmlTexto(String pConteudo)

• Lógica: Este método privado gera um fragmento HTML para exibir texto simples.

1. Cria um StringWriter e um HtmlTextWriter.
2. Renderiza uma tag div com a classe textoMaster.
3. Dentro da div, renderiza uma tag label e escreve o pConteudo.
4. Fecha as tags e retorna o HTML gerado.

• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

ToHtmlTabela(String pXml)

• Lógica: Este método privado converte uma string XML (no formato de tabela) em uma tabela HTML.

1. Cria um StringWriter e um HtmlTextWriter.
2. Renderiza uma div com a classe tabelaMaster e uma table.
3. Cria a linha de cabeçalho da tabela (<th>Campo</th><th>Valor Antigo</th><th>Novo Valor</th>) chamando CriarLinhaTabelaHTMl.
4. Usa XmlReader para iterar sobre o XML pXml.
5. Para cada nó <parametros> encontrado:

• Extrai os valores dos atributos “Campo”, “ValorAnterior” e “NovoValor”.
• Chama CriarLinhaTabelaHTMl para adicionar uma linha de dados (<td>) à tabela HTML.

6. Fecha as tags e retorna o HTML gerado.

• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma explícita além do parsing XML.
• Regras de negócio: Formata dados de alteração em uma tabela HTML.

CriarLinhaTabelaHTMl(HtmlTextWriter writer, String pCampo, String pValorAnterior, String pValorNovo, HtmlTextWriterTag tipoColuna)

• Lógica: Este método auxiliar privado renderiza uma linha (<tr>) em uma tabela HTML com três colunas (<th> ou <td>).

1. Renderiza a tag <tr>.
2. Para cada um dos três valores (pCampo, pValorAnterior, pValorNovo):

• Renderiza a tag tipoColuna (Th ou Td).
• Dentro dela, renderiza uma label e escreve o valor.
• Fecha as tags.

3. Fecha a tag <tr>.

• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

ToHtmlTreeView(String pXml)

• Lógica: Este método privado converte uma string XML (no formato de treeview) em uma tabela HTML que simula uma estrutura de árvore.

1. Cria um StringWriter e um HtmlTextWriter.
2. Renderiza uma div com a classe treeViewMaster e uma table.
3. Usa XmlReader para iterar sobre o XML pXml.
4. Para cada nó <parametros> encontrado:

• Extrai os valores dos atributos “Campo”, “Valor” e “Nivel”.
• Chama CriarLinhaTreeViewHTMl para adicionar uma linha de dados (<td>) à tabela HTML, aplicando um margin-left baseado no Nivel para criar a indentação.

5. Fecha as tags e retorna o HTML gerado.

• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma explícita além do parsing XML.
• Regras de negócio: Formata dados de alteração em uma estrutura de treeview HTML.

CriarLinhaTreeViewHTMl(HtmlTextWriter writer, String pCampo, String pValor, int nivel, HtmlTextWriterTag tipoColuna)

• Lógica: Este método auxiliar privado renderiza uma linha (<tr>) em uma tabela HTML com duas colunas (<th> ou <td>), aplicando indentação na primeira coluna.

1. Renderiza a tag <tr>.
2. Renderiza a primeira tipoColuna (<td> ou <th>).

• Adiciona um estilo margin-left calculado como 20 * nivel pixels.
• Renderiza uma label e escreve pCampo.
• Fecha as tags.

3. Renderiza a segunda tipoColuna.

• Renderiza uma label e escreve pValor.
• Fecha as tags.

4. Fecha a tag <tr>.

• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

ConfigurarMensagemImpacto(ref string pMensagemOriginal, string valorAdicionar, ConfirmacaoSenhaUtil.EnumTipoEstrutura pEnumTipoEstrutura)

• Lógica: Este método público estático é o principal ponto de entrada para adicionar mensagens de impacto formatadas.

1. Se valorAdicionar for nulo/vazio e pEnumTipoEstrutura não for Texto, retorna (não há nada para adicionar).
2. Se pEnumTipoEstrutura não for Texto:

• Chama ValidarXML() para validar o valorAdicionar e popular a lista lstAlteracoes. Se a validação falhar, lança uma Exception.

3. Chama ToHtml(valorAdicionar, pEnumTipoEstrutura) para converter valorAdicionar em HTML e concatena o resultado em pMensagemOriginal.
4. Itera sobre a lstAlteracoes (se populada):

• Extrai os cabeçalhos e valores das alterações.
• Chama a sobrecarga de ConfigurarMensagemImpacto(ref string pMensagemOriginal, string[] cabecalho, List<String[]> valores) para adicionar uma tabela HTML formatada com esses dados à pMensagemOriginal.
• Stored Procedures chamadas: Nenhuma.
• Validações:
• valorAdicionar não pode ser nulo/vazio se pEnumTipoEstrutura não for Texto.
• O valorAdicionar (se XML) deve ser válido para o pEnumTipoEstrutura.
• Regras de negócio:
• Formata e adiciona mensagens de impacto ao HTML.
• Suporta diferentes formatos (texto, tabela, treeview).
• Se o valorAdicionar for um XML complexo, ele o processa e adiciona tabelas adicionais.

ConfigurarMensagemImpacto(ref string pMensagemOriginal, string[] cabecalho, List<String[]> valores)

• Lógica: Esta sobrecarga do método ConfigurarMensagemImpacto gera uma tabela HTML a partir de um cabeçalho e uma lista de arrays de strings (valores).

1. Cria um StringWriter e um HtmlTextWriter.
2. Renderiza uma div com a classe tabelaMaster e uma table.
3. Cria Cabeçalho: Itera sobre o array cabecalho, criando uma linha <tr> e tags <th> com label para cada item do cabeçalho.
4. Cria Corpo: Itera sobre a List<String[]> valores, criando uma linha <tr> para cada array e tags <td> com label para cada item dentro do array.
5. Concatena o HTML gerado em pMensagemOriginal.

• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma.
• Regras de negócio: Formata dados tabulares em HTML.

ConfigurarDadosTopo(ref string pMensagemOriginal, string[] cabecalho, List<String[]> valores)

• Lógica: Este método gera uma tabela HTML para exibir dados de “topo” (como Empresa, Assunto, etc.) com uma formatação específica.

1. Cria um StringWriter e um HtmlTextWriter.
2. Renderiza uma div com a classe tabelaDadosTopoModal e uma table.
3. Cria Corpo: Itera sobre a List<String[]> valores. Para cada array (que representa uma linha):

• Renderiza uma linha <tr>.
• A primeira coluna (<th>) exibe o array[0] (o “rótulo”).
• A segunda coluna (<td>) exibe o array[1] (o “valor”).
• Se array[0] for “Período”, adiciona a classe CSS negrito_periodo à label do valor.

4. Concatena o HTML gerado em pMensagemOriginal.

• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma.
• Regras de negócio: Formatação específica para dados de cabeçalho em modais.

Stored Procedures

Nenhuma stored procedure é chamada diretamente por esta classe. Ela manipula strings XML e gera HTML.

PessoaFisica

Arquivos:

• C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\PessoaFisica_P1.cs
• C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\PessoaFisica_P2.cs
• C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\PessoaFisica_P3.cs

Métodos

Detalhamento de Métodos Importantes

GetParameters()

• Lógica: Este método privado cria e retorna uma lista de objetos SqlParameter com os nomes e tipos de dados correspondentes a todas as colunas da tabela TAB_Pessoa_Fisica. Os valores dos parâmetros não são preenchidos neste método, apenas a estrutura é definida.
• Stored Procedures chamadas: Nenhuma diretamente.
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

SetParameters(List parms)

• Lógica: Este método privado recebe uma lista de SqlParameter e preenche os valores de cada parâmetro com os dados da instância atual de PessoaFisica.
• Atribui valores para a maioria das propriedades da PessoaFisica.
• Para propriedades que são objetos (ex: Sexo, Nacionalidade, Cidade, EstadoCivil, Raca, Deficiencia, Escolaridade, UsuarioGerador, PaisNascimento, PaisNacionalidade, InstituicaoEnsino, CursoEstagio), ele atribui o Id do objeto ou DBNull.Value se o objeto for nulo.
• Para propriedades DateTime? (nullable DateTime), ele atribui o valor ou DBNull.Value se não tiver valor.
• Para propriedades string, ele atribui o valor ou DBNull.Value se for nulo ou vazio.
• O Idf_Pessoa_Fisica é configurado como ParameterDirection.Output se o objeto não estiver persistido (para receber o ID gerado), caso contrário, é ParameterDirection.Input.
• A DataCadastro e DataAlteracao são definidas como DateTime.Now se o objeto não estiver persistido.
• O UsuarioGerador é definido com base no IdUsuario da sessão HTTP atual (ou 1 se a sessão for nula).
• Stored Procedures chamadas: Nenhuma diretamente.
• Validações: Verifica se objetos são nulos ou strings são vazias para atribuir DBNull.Value.
• Regras de negócio:
• Gerencia a atribuição de IDs de objetos relacionados.
• Define DataCadastro e DataAlteracao automaticamente.
• Define UsuarioGerador automaticamente.

Insert()

• Lógica: Insere um novo registro de PessoaFisica no banco de dados.

1. Chama GetParameters() e SetParameters(parms).
2. Abre uma conexão SQL e inicia uma transação.
3. Executa a query SPINSERT (um comando INSERT direto) usando DataAccessLayer.ExecuteNonQueryCmd.
4. Recupera o IdPessoaFisica gerado pelo banco de dados e atribui à propriedade _idPessoaFisica.
5. Limpa os parâmetros do comando.
6. Define _persisted como true e _modified como false.
7. Comita a transação.
8. Em caso de erro, a transação é revertida e a exceção é relançada.

• Stored Procedures chamadas: SPINSERT (string SQL de INSERT)
• @Num_CPF, @Nme_Pessoa, @Ape_Pessoa, @Idf_Sexo, @Idf_Nacionalidade, @Idf_Cidade, @Dta_Chegada_Brasil, @Dta_Nascimento, @Nme_Mae, @Nme_Pai, @Num_RG, @Dta_Expedicao_RG, @Nme_Orgao_Emissor, @Sig_UF_Emissao_RG, @Num_PIS, @Num_CTPS, @Des_Serie_CTPS, @Sig_UF_CTPS, @Idf_Estado_Civil, @Idf_Raca, @Idf_Deficiencia, @Idf_Endereco, @Num_DDD_Telefone, @Num_Telefone, @Num_DDD_Celular, @Num_Celular, @Eml_Pessoa, @Flg_Possui_Dependentes, @Dta_Cadastro, @Dta_Alteracao, @Flg_Importado, @Idf_Escolaridade, @Idf_Usuario_Gerador, @Dta_Emissao_CTPS, @Idf_Endereco_Internacional, @Flg_Casado_Brasileiro, @Flg_Filhos_Brasileiros, @Idf_Classificacao_Trabalho_Estrangeiro, @Flg_Deficiencia_Fisica, @Flg_Deficiencia_Visual, @Flg_Deficiencia_Auditiva, @Flg_Deficiencia_Mental, @Flg_Deficiencia_Intelectual, @Flg_Deficiencia_Reabilitado_Readaptado, @Idf_Pais_Nascimento, @Idf_Pais_Nacionalidade, @Num_Telefone_Alternativo, @Eml_Alternativo, @Nme_Social, @Dta_Expedicao_CNH, @Dta_Primeira_CNH, @Num_DDD_Telefone_Alternativo, @Des_Graduacao, @Idf_Instituicao_Ensino, @Idf_Curso_Estagio, @Num_Ano_Formacao, @Nme_Curso_Formacao, @Idf_Pessoa_Fisica (OUTPUT)
• Validações: Nenhuma explícita além das do banco de dados.
• Regras de negócio: O Idf_Pessoa_Fisica é gerado automaticamente.

Update()

• Lógica: Atualiza um registro existente de PessoaFisica no banco de dados.

1. Verifica se o objeto foi modificado (_modified é true). Se não, não faz nada.
2. Chama GetParameters() e SetParameters(parms).
3. Executa a query SPUPDATE (um comando UPDATE direto) usando DataAccessLayer.ExecuteNonQuery.
4. Define _modified como false.

• Stored Procedures chamadas: SPUPDATE (string SQL de UPDATE)
• Parâmetros: Mesmos do SPINSERT, mas @Idf_Pessoa_Fisica é usado na cláusula WHERE.
• Validações: Nenhuma explícita.
• Regras de negócio: A atualização só ocorre se o objeto foi modificado.

Save()

• Lógica: Decide se deve inserir ou atualizar o registro no banco de dados.
• Se o objeto não estiver persistido (_persisted é false), ele chama this.Insert().
• Caso contrário, ele chama this.Update().
• Stored Procedures chamadas: Nenhuma diretamente, mas chama Insert() ou Update().
• Validações: Nenhuma.
• Regras de negócio: Gerencia o ciclo de vida de persistência do objeto.

Delete(int idPessoaFisica)

• Lógica: Exclui um registro de PessoaFisica do banco de dados.

1. Cria uma lista de SqlParameter e adiciona @Idf_Pessoa_Fisica.
2. Atribui o idPessoaFisica fornecido ao parâmetro.
3. Executa a query SPDELETE (um comando UPDATE e DELETE direto) usando DataAccessLayer.ExecuteNonQuery.

• Stored Procedures chamadas: SPDELETE (string SQL de UPDATE e DELETE)
• @Idf_Pessoa_Fisica: int
• @Idf_Usuario_Gerador: int (para o UPDATE)
• Validações: Nenhuma explícita.
• Regras de negócio: Antes de deletar a PessoaFisica, atualiza o Idf_Usuario_Gerador na tabela TAB_Pessoa_Fisica.

LoadObject(int idPessoaFisica)

• Lógica: Carrega um objeto PessoaFisica completo do banco de dados.

1. Chama LoadDataReader(idPessoaFisica) para obter um IDataReader.
2. Cria uma nova instância de PessoaFisica.
3. Chama SetInstance(dr, objPessoaFisica) para preencher as propriedades do objeto.
4. Se SetInstance retornar true (registro encontrado), retorna o objeto.
5. Caso contrário, lança uma RecordNotFoundException.

• Stored Procedures chamadas: Nenhuma diretamente, mas chama LoadDataReader().
• Validações: Lança RecordNotFoundException se o registro não for encontrado.
• Regras de negócio: Nenhuma.

CompleteObject()

• Lógica: Preenche as propriedades da instância atual de PessoaFisica a partir do banco de dados.

1. Chama LoadDataReader(this._idPessoaFisica) para obter um IDataReader com os dados do próprio objeto.
2. Chama SetInstance(dr, this) para preencher as propriedades da instância atual.
3. Retorna true se o objeto foi preenchido com sucesso, false caso contrário.

• Stored Procedures chamadas: Nenhuma diretamente, mas chama LoadDataReader().
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

SetInstance(IDataReader dr, PessoaFisica objPessoaFisica)

• Lógica: Mapeia os dados de um IDataReader para as propriedades de um objeto PessoaFisica.

1. Tenta ler a primeira linha do IDataReader.
2. Se houver uma linha:

• Converte e atribui os valores das colunas do IDataReader para os atributos privados do objPessoaFisica.
• Para campos que são objetos (ex: Sexo, Nacionalidade, Cidade, EstadoCivil, Raca, Deficiencia, Endereco, Escolaridade, Usuario, EnderecoInternacional, PaisEsocial, InstituicaoEnsino, CursoEstagio), ele cria novas instâncias desses objetos passando o ID recuperado do IDataReader.
• Lida com valores DBNull.Value para campos opcionais.
• Define _persisted como true e _modified como false.
• Retorna true.

3. Se não houver linhas, retorna false.
4. Inclui um bloco finally para garantir que o IDataReader seja descartado.

• Stored Procedures chamadas: Nenhuma diretamente.
• Validações: Realiza conversões de tipo.
• Regras de negócio: Mapeamento de dados do banco para o objeto BLL.

SalvarAuditoria(List auditorias, SqlTransaction trans = null, bool ehDelete = false, AtividadeAuditoriaDTO atividade = null)

• Lógica: Este método estático é responsável por salvar registros de auditoria para alterações em objetos PessoaFisica.

1. Itera sobre a lista de auditorias fornecida.
2. Para cada PessoaFisica na lista:

• Se ehDelete for true, cria um registro de auditoria de exclusão.
• Caso contrário, compara o estado atual do objeto com o PreUpdateAuditoria (estado antes da alteração) para identificar as modificações.
• Para cada propriedade alterada, cria um DetalheAuditoriaDTO e adiciona à lista de detalhes.
• Cria um objeto Auditoria e o salva no banco de dados, associando-o à PessoaFisica e aos detalhes da alteração.
• Stored Procedures chamadas: plataforma.TAB_SP_Auditoria_Salvar
• @Idf_Auditoria, @Idf_Usuario, @Idf_Empresa, @Idf_Assunto, @Des_Referencia, @Des_Detalhe_Auditoria, @Dta_Auditoria, @Idf_Tipo_Auditoria, @Idf_Atividade_Auditoria
• Validações: Nenhuma explícita.
• Regras de negócio:
• Registra alterações em PessoaFisica para fins de auditoria.
• Diferencia entre auditoria de exclusão e auditoria de atualização.
• Utiliza DetalhesApresentacaoAuditoria e MapearObjetosAuditoria para formatar os detalhes da auditoria.

CarregarPorCPF(decimal numCPF, SqlTransaction trans)

• Lógica: Carrega um objeto PessoaFisica pelo CPF, utilizando uma transação.

1. Chama ListarPorCPF(numCPF, null) para obter um IDataReader.
2. Cria uma nova instância de PessoaFisica.
3. Chama SetInstance(dr, objPessoaFisica) para preencher as propriedades.
4. Retorna o objeto se encontrado, caso contrário, null.

• Stored Procedures chamadas: Nenhuma diretamente, mas chama ListarPorCPF().
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

RecuperarPorCPF(decimal numCPF)

• Lógica: Recupera um objeto PessoaFisica pelo CPF.

1. Chama ListarPorCPF(numCPF, null) para obter um IDataReader.
2. Cria uma nova instância de PessoaFisica.
3. Chama SetInstance(dr, objPessoaFisica) para preencher as propriedades.
4. Retorna o objeto se encontrado, caso contrário, null.

• Stored Procedures chamadas: Nenhuma diretamente, mas chama ListarPorCPF().
• Validações: Nenhuma.
• Regras de negócio: Nenhuma.

VerificaVinculoExclusao(int idPessoaFisica)

• Lógica: Verifica se a PessoaFisica possui vínculos com outras tabelas que impediriam sua exclusão direta.

1. Cria um parâmetro @Idf_Pessoa_Fisica.
2. Executa a query SPVERIFICAVINCULOEXCLUSAO (que faz LEFT JOIN com TAB_Empregado, TAB_Empregado_Admissao_Futura, TAB_Autonomo, TAB_Pensionista, TAB_Dependente) usando DataAccessLayer.ExecuteScalar.
3. Retorna true se o count for maior que 0 (ou seja, existem vínculos), false caso contrário.

• Stored Procedures chamadas: SPVERIFICAVINCULOEXCLUSAO
• @Idf_Pessoa_Fisica: int
• Validações: Nenhuma explícita.
• Regras de negócio: Impede a exclusão de uma PessoaFisica se ela tiver registros relacionados em outras tabelas.

VerificaEmail(string strEmail)

• Lógica: Verifica se o strEmail já está cadastrado na tabela TAB_Pessoa_Fisica.

1. Cria um parâmetro @Email_Pessoa.
2. Executa a query SPVERIFICAEMAIL usando DataAccessLayer.ExecuteScalar.
3. Retorna true se o count for maior que 0 (email já existe), false caso contrário.

• Stored Procedures chamadas: SPVERIFICAEMAIL
• @Email_Pessoa: varchar
• Validações: Nenhuma explícita.
• Regras de negócio: Garante a unicidade de emails entre pessoas físicas.

VerificaCPFCadastrado(decimal numCPF, int idPessoaFisica)

• Lógica: Verifica se o numCPF já está cadastrado para outra PessoaFisica (excluindo a própria idPessoaFisica se estiver sendo atualizada).

1. Cria parâmetros @Num_CPF e @Idf_Pessoa_Fisica.
2. Executa a query SPVERIFICACPF usando DataAccessLayer.ExecuteScalar.
3. Retorna true se o count for maior que 0 (CPF já existe para outra pessoa), false caso contrário.

• Stored Procedures chamadas: SPVERIFICACPF
• @Num_CPF: decimal
• @Idf_Pessoa_Fisica: int
• Validações: Nenhuma explícita.
• Regras de negócio: Garante a unicidade de CPF entre pessoas físicas.

VerificaPendenciasCPF(decimal numCPF)

• Lógica: Verifica se o numCPF possui registros em tabelas como TAB_Holerite, TAB_RPA, TAB_Empregado_Fechamento ou TAB_Usuario.

1. Cria um parâmetro @Num_CPF.
2. Executa a query SPVERIFICAPENDENCIASCPF (que usa UNION ALL para somar os counts de várias tabelas) usando DataAccessLayer.ExecuteScalar.
3. Retorna true se o count total for maior que 0 (existem pendências), false caso contrário.

• Stored Procedures chamadas: SPVERIFICAPENDENCIASCPF
• @Num_CPF: decimal
• Validações: Nenhuma explícita.
• Regras de negócio: Impede operações em CPF que possuem registros dependentes em outros módulos.

VerificaPISCadastrado(string numPIS, int? idPessoaFisica)

• Lógica: Verifica se o numPIS já está cadastrado para outra PessoaFisica (excluindo a própria idPessoaFisica se fornecida).

1. Cria parâmetros @Num_PIS e @Idf_Pessoa_Fisica.
2. Executa a query SPVERIFICAPIS usando DataAccessLayer.ExecuteScalar.
3. Retorna true se o count for maior que 0 (PIS já existe para outra pessoa), false caso contrário.

• Stored Procedures chamadas: SPVERIFICAPIS
• @Num_PIS: varchar
• @Idf_Pessoa_Fisica: int (nullable)
• Validações: Nenhuma explícita.
• Regras de negócio: Garante a unicidade de PIS entre pessoas físicas.

ExclusaoPessoaFisica(int idPessoaFisica)

• Lógica: Realiza a exclusão de uma PessoaFisica e seus registros relacionados.

1. Cria um parâmetro @Idf_Pessoa_Fisica.
2. Executa a query SPDELETEPESSOAFISICA (que primeiro seleciona os IDs de endereço, depois deleta de TAB_Pessoa_Fisica, TAB_Pessoa_Fisica_Foto, TAB_Pessoa_Fisica_Complemento, TAB_Endereco e TAB_Endereco_Internacional) usando DataAccessLayer.ExecuteNonQuery.

• Stored Procedures chamadas: SPDELETEPESSOAFISICA
• @Idf_Pessoa_Fisica: int
• Validações: Nenhuma explícita.
• Regras de negócio: Exclui em cascata os dados relacionados à pessoa física.

ConsultaEmailPessoaFisica(string prefix)

• Lógica: Consulta emails de pessoas físicas que começam com um determinado prefixo para funcionalidades de autocomplete.

1. Cria um parâmetro @PREFIX.
2. Executa a query SPCONSULTAEMAILPESSOAFISICA usando DataAccessLayer.ExecuteReaderDs e retorna a primeira tabela do DataSet.

• Stored Procedures chamadas: SPCONSULTAEMAILPESSOAFISICA
• @PREFIX: varchar
• Validações: Nenhuma explícita.
• Regras de negócio: Nenhuma.

ValidarLinhaArquivoPF(…)

• Lógica: Este método privado é uma parte complexa do processo de importação de arquivos, responsável por validar uma única linha de dados de pessoa física.
• Inicialização: Cria um objeto CriticaLinha para armazenar erros. Define expressões regulares para telefone e caracteres especiais. Recupera o parâmetro ModoImplantacao.
• Obrigatoriedade e eSocial: Define colunas obrigatórias com base no ModoImplantacao e se o país de nacionalidade é Brasil (para requisitos do eSocial).
• CPF: Limpa e valida o CPF usando ValidacaoUtil.ValidarCPF. Se inválido, adiciona erro. Verifica duplicidade de CPF na lista lstCPF.
• Validação de Regex: Itera sobre uma lista de campos (Nome, Apelido, Nome Mãe, etc.) e verifica se contêm caracteres especiais usando rxValidacaoRegex.
• Remoção de Espaços: Chama RemovendoEspacos para limpar campos específicos.
• Validação de Nomes: Valida Nome, Nome Mãe e Nome Pai usando rxNome (regex para nome e sobrenome) e verifica o comprimento.
• Validação de Nome da Mãe (eSocial): Se pfFlagUtilizaValidacaoDiferenciadaESocial for true e Nome Mãe estiver vazio, adiciona um erro.
• Validação de Sexo, UF, Cidade, Datas: Valida SEXO, UF, Cidade, Data Chegada ao Brasil, Data Nascimento, Data Expedição RG, Data Emissão CTPS, Estado Civil, Raça/Cor, Grau Instrução. Para Cidade e UF, verifica se a cidade existe no estado.
• PIS: Limpa e valida o PIS usando ValidacaoUtil.ValidarPIS. Verifica se é um NIT. Verifica duplicidade de PIS na lista lstPIS e no banco de dados (PessoaFisica.VerificaPISCadastrado).
• CEP: Limpa e valida o CEP. Se não for numérico, adiciona erro. Consulta o CEP usando ConsultaCep.Consultar. Se não encontrado, adiciona erro. Valida a consistência entre CEP, Cidade e UF.
• Telefones/Celulares: Limpa e valida números de telefone e celular usando rxTelefone.
• País de Nascimento/Nacionalidade: Valida os IDs dos países usando PaisEsocial.LoadObject.
• Validações Condicionais por País:
• Se o País de Nascimento for diferente do Brasil, UF e Cidade não devem ser informados.
• Se o País de Nacionalidade for Brasil, Data Chegada ao Brasil, Casado(a) com Brasileira(o), Tem Filhos Brasileiros e Classif. Trab. Estrangeiro não devem ser informados.
• Valida os valores de Casado(a) com Brasileira(o) e Tem Filhos Brasileiros (0 ou 1).
• Valida o Classif. Trab. Estrangeiro contra o enum.
• Deficiências: Valida os campos de deficiência (0 ou 1).
• Endereço Internacional: Valida o País (Endereço Internacional).
• Retorno: Retorna o objeto CriticaLinha contendo todos os erros encontrados.
• Stored Procedures chamadas: Nenhuma diretamente, mas chama métodos que interagem com o banco de dados como PessoaFisica.CarregarPorCPF, PessoaFisica.VerificaPISCadastrado, BLL.Cidade.CarregarPorNome, PaisEsocial.LoadObject.
• Validações:
• Validação de formato (CPF, PIS, Telefone, Email, CEP).
• Validação de existência (Cidade/UF, PIS, CPF).
• Validação de regras de negócio complexas (eSocial, Modo de Implantação, vínculos entre campos).
• Validação de duplicidade dentro do arquivo de importação.
• Regras de negócio:
• Define a lógica de validação para a importação de dados de pessoa física, incluindo regras específicas do eSocial e do sistema.
• Garante a integridade dos dados antes da importação.

Stored Procedures

UIHelper

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

Métodos

Detalhamento de Métodos Importantes

CarregarGridView(EmployerGrid grid, object dataSource, int totalRegistros)

• Lógica: Este método estático é uma sobrecarga que facilita o carregamento de dados em um controle EmployerGrid (um GridView customizado).

1. Define o DataSource do grid com o dataSource fornecido.
2. Define AllowPaging como true e PageSize como 10 (se o grid não tiver um PageSize definido).
3. Define VirtualItemCount como totalRegistros para suportar paginação virtual.
4. Chama grid.DataBind() para vincular os dados.

• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma.
• Regras de negócio: Configura o EmployerGrid para paginação e vinculação de dados.

CarregarGridView(GridView grid, object dataSource, int totalRegistros, bool isPaginacaoManual, bool isLimparSelecao, bool isLimparOrdenacao, bool isLimparFiltro, bool isLimparPageIndex, bool isLimparMockColunaOrdenada, bool isLimparMockDirecaoOrdenacao, bool isLimparMockPageIndex, bool isLimparMockPageSize, bool isLimparMockSortExpression, bool isLimparMockSortDirection, bool isLimparMockSortExpressionDirection, bool isLimparMockSortExpressionDirectionAndPageIndex, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSize, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpression, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirection, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndex, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSize, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSizeAndSortExpression, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirection, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndex, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSize, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSizeAndSortExpression, bool isLimparMockSortExpressionDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirectionAndPageIndexAndPageSizeAndSortExpressionAndSortDirection)`

• Lógica: Esta é a sobrecarga mais completa do método CarregarGridView, oferecendo controle granular sobre o comportamento do GridView.

1. Limpeza de Estado:

• Dependendo dos parâmetros isLimparSelecao, isLimparOrdenacao, isLimparFiltro, isLimparPageIndex, e os vários parâmetros isLimparMock..., ele limpa o estado interno do GridView (seleção de linhas, expressões de ordenação, filtros, índice da página atual, e propriedades “mock” para paginação/ordenação).

2. Configuração de Paginação:

• Define AllowPaging como true.
• Se isPaginacaoManual for true, define VirtualItemCount como totalRegistros e PageSize como 10 (se não definido).
• Se isPaginacaoManual for false, define PageSize como 10 (se não definido).

3. Vinculação de Dados:

• Define o DataSource do grid com o dataSource fornecido.
• Chama grid.DataBind() para vincular os dados.
• Stored Procedures chamadas: Nenhuma.
• Validações: Nenhuma.
• Regras de negócio:
• Centraliza a lógica de carregamento e configuração de GridViews e EmployerGrids.
• Permite redefinir o estado do grid (seleção, ordenação, paginação) antes de carregar novos dados.
• Suporta paginação manual (virtual) e automática.

Stored Procedures

Nenhuma stored procedure é chamada diretamente por esta classe. Ela é uma classe utilitária para manipulação de UI.

📌 Status: Concluído 👤 Responsável: Equipe de QA