🛠️ Documentação Técnica: Integração Financeira

[!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 IntegracaoFinanceiraCliente.aspx é uma página ASP.NET WebForms que permite aos usuários pesquisar e gerar lotes de integração financeira para verbas de holerite. Ela interage com diversas BLLs para carregar dados, validar entradas e iniciar processos assíncronos de integração.

👁️ 1. Visão Geral

• Propósito da tela: Pesquisar holerites pagos pendentes de integração e gerar lotes de integração financeira com base nas verbas selecionadas e grupos de pagamento.
• Contexto no sistema: Faz parte do módulo financeiro do WebFopag, permitindo a exportação de dados de pagamento para sistemas financeiros externos.
• Usuários que utilizam: Usuários com permissão para “Realizar Integração Financeira Cliente” no sistema.

🗂️ 2. Tipos/Modalidades

A tela possui diferentes modalidades de integração financeira, definidas pelo campo “Formato” (lsTipoIntegracao), que influenciam a visibilidade de campos e o comportamento da geração do lote. Os tipos de integração incluem:

• Integração Financeira - RM (código 218)
• Integração Financeira - DATASUL (código 219)
• Integração Financeira - DEALERNET (código 227)
• Integração Financeira - Italtel INTANAG (código 258)
• Integração Financeira - Italtel CEDOLINO (código 259)
• Integração Financeira - Italtel CUD (código 260)
• Integração Financeira - Italtel CUD1 (código 261)
• Integração Financeira (código 262)
• Integração Financeira - Oracle (código 343)
• Integração Financeira - SAP (código 345)
• Integração Financeira SAP - Crasa (código 350)
• Integração Financeira SAP - SYNGENTACOM (código 352)
• Integração Financeira - SOLUTION (código 355)
• Integração Financeira - SyngentaCom JANGADA (código 353)
• Integração Financeira - SyngentaCom DIPAGRO (código 356)
• Integração Financeira SAP - JMalucelli (código 408)

A visibilidade dos campos “Grupo Pagamento” e “Período de Leitura de Retorno” e a obrigatoriedade dos campos de período de pagamento variam conforme o NomeCentroServico (jmalucelli, pagus, nutrientes, syngentacom, crasa) e o tipo de integração selecionado.

🖥️ 3. Interface — Campos e Controles

📑 4. Abas e Seções

A tela possui as seguintes seções principais:

• Abas de Navegação:
• “Integração Financeira” (ativa por padrão)
• “Configuração Financeira” (link para IntegracaoFinanceiraClienteConfiguracao.aspx)
• Seção de Filtros (pnlIntegracaoFinanceira): Contém os campos para filtrar os lançamentos de holerite.
• Painel de Botões de Pesquisa: Contém os botões “Pesquisar”, “Limpar” e “Voltar”.
• Seção “Lançamentos Pendentes” (divIntegracaoFinanceiraLote): Exibe a grid de holerites pendentes e os totalizadores.
• Painel de Botões de Geração de Lote: Contém o botão “Gerar Lote Lançamentos Selecionados”.
• Seção “Situação Atividades Integração” (divGridAtiviade): Contém o UserControl GridIntegracaoFinanceiraClienteLote e SolicitacoesAssincronas.
• Modal de Confirmação (modalConfirmacaoGeracaoLote): Usado para confirmar a geração do lote.

🛡️ 5. Regras de Negócio

5.1. Validações de Campos

• Período Pagamento (txtDe, txtAte):
• Se NomeCentroServico for “jmalucelli”: A data inicial não pode ser maior que a data final. (Origem: IntegracaoFinanceiraCliente.aspx.cs - ValidarFiltros())
• Se NomeCentroServico não for “jmalucelli”:
• É obrigatório preencher pelo menos um dos pares de campos: Período Pagamento (De/Até) ou Período de Leitura de Retorno (De/Até). (Origem: IntegracaoFinanceiraCliente.aspx.cs - ValidarFiltros())
• Se um campo do par Período Pagamento (De ou Até) for preenchido, o outro também deve ser. (Origem: IntegracaoFinanceiraCliente.aspx.cs - ValidarFiltros())
• A data inicial do Período Pagamento não pode ser maior que a data final. (Origem: IntegracaoFinanceiraCliente.aspx.cs - ValidarFiltros())
• Período de Leitura de Retorno (txtInicioLeituraRetorno, txtFimLeituraRetorno):
• Se um campo do par Período de Leitura de Retorno (De ou Até) for preenchido, o outro também deve ser. (Origem: IntegracaoFinanceiraCliente.aspx.cs - ValidarFiltros())
• A data inicial do Período de Leitura de Retorno não pode ser maior que a data final. (Origem: IntegracaoFinanceiraCliente.aspx.cs - ValidarFiltros())
• Formato de Integração (lsTipoIntegracao): Deve ser selecionado antes de transmitir um lote. (Origem: IntegracaoFinanceiraCliente.aspx.cs - gvwLote_RowCommand())
• Seleção de Empregados: Pelo menos um empregado deve ser selecionado para gerar o lote. (Origem: IntegracaoFinanceiraCliente.aspx.cs - ValidarParaGerar())
• Campo Formato (lsTipoIntegracao): Não pode ser inválido ao gerar lote. (Origem: IntegracaoFinanceiraCliente.aspx.cs - modalConfirmacaoGeracaoLote_OnConfirmar())
• Processo de Integração: Se o formato selecionado não tiver um processo de integração cadastrado, uma mensagem de erro é exibida. (Origem: IntegracaoFinanceiraCliente.aspx.cs - modalConfirmacaoGeracaoLote_OnConfirmar())

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

• Campos de Período de Pagamento (txtDe, txtAte) e Período de Leitura de Retorno (plhCamposPeriodoLeituraRetorno):
• Se NomeCentroServico for “jmalucelli”, “pagus”, “nutrientes”, “crasa” ou “syngentacom” (e não for SyngentaComJangada):
• ucModalGruposAdicionados é invisível.
• txtGrupoPagamento tem o ValidationGroup do botão “Pesquisar” e é obrigatório (exceto para “pagus”).
• txtDe e txtAte são obrigatórios.
• plhCamposPeriodoLeituraRetorno é invisível. (Origem: IntegracaoFinanceiraCliente.aspx.cs - Inicializar())
• Para outros NomeCentroServico ou se for “syngentacom” e SyngentaComJangada:
• ucModalGruposAdicionados é visível.
• txtDe e txtAte não são obrigatórios.
• plhCamposPeriodoLeituraRetorno é visível. (Origem: IntegracaoFinanceiraCliente.aspx.cs - Inicializar())
• Divisão de Contrato/Departamento vs. Centro de Resultado:
• Se TipoEstruturaGerencial for CentroResultado: divContrato e divDepartamento são invisíveis, divCentroResultado é visível.
• Caso contrário: divContrato e divDepartamento são visíveis, divCentroResultado é invisível. (Origem: IntegracaoFinanceiraCliente.aspx.cs - ConfigurarEstrutura())
• Botões e DropDownList de Seleção: btnGerarLoteIntegracao, ddlSelecaoHolerite e divTotalizador são visíveis apenas se houver itens na grid de pendências. (Origem: IntegracaoFinanceiraCliente.aspx.cs - CarregarGrid())
• Coluna “Pensionista” na Grid (gvwPendenciaPagamentoIntegracao.Columns[2]): A coluna “Pensionista” é visível se houver algum pensionista nos dados retornados. (Origem: IntegracaoFinanceiraCliente.aspx.cs - CarregarGrid())
• Botão Transmitir (btiTransmitir) na Grid de Lotes: Visível apenas se o status de integração do lote for “Não Transmitido”, “Transmitido Com Erro” ou “Erro WebService Não Transmitido”. (Origem: IntegracaoFinanceiraCliente.aspx.cs - gvwLote_RowDataBound())
• Visibilidade de campos baseada no tipo de integração selecionado (lsTipoIntegracao_ValueChanged):
• Para IntegracaoFinanceiraSYNGENTACOMDipagro, IntegracaoFinanceiraSYNGENTACOMJangada, 353, 356, 262, 263:
• ucModalGruposAdicionados é visível.
• plhCamposPeriodoLeituraRetorno é visível.
• txtDe e txtAte não são obrigatórios.
• txtGrupoPagamento tem o ValidationGroup de ucModalGruposAdicionados e não é obrigatório.
• Para IntegracaoFinanceiraSAPSYNGENTACOM e outros padrões:
• ucModalGruposAdicionados é invisível.
• plhCamposPeriodoLeituraRetorno é invisível.
• txtDe e txtAte são obrigatórios.
• txtGrupoPagamento tem o ValidationGroup de btnPesquisar e é obrigatório. (Origem: IntegracaoFinanceiraCliente.aspx.cs - lsTipoIntegracao_ValueChanged())

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

Não há regras de inativação ou exclusão explícitas na tela principal.

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

• Geração de Lote:
• Ao confirmar a geração do lote (modalConfirmacaoGeracaoLote_OnConfirmar), uma nova atividade assíncrona é iniciada.
• Os parâmetros para a atividade assíncrona incluem: pDta_De, pDta_Ate, pTipo_Estrutura_Gerencial, pIdf_Contrato, pIdf_Departamento, pIdf_Centro_Resultado, pIdf_Empresa, pIdf_Filial, pIdf_Empregado, pIdf_Usuario, pAcao (“Gerar Lote Integração Financeira”).
• Dependendo do NomeCentroServico e do tipo de integração, parâmetros adicionais como pCod_Grupo_Pagamento, pListaGruposPagamentos, pListaHoleritesRPAs, pIdf_Formato_Integracao_Financeira, pNomeCS e pTipoArquivo são adicionados.
• O plugin de entrada para o processo assíncrono é determinado pelo lsTipoIntegracao.ValorInt e PluginsCompatibilidade.CarregarPorMetadata.
• O tipo de saída do processo assíncrono pode ser Excel ou ArquivoTextoDownload.
• Para integrações Ponte Azul, o método IntegracaoPonteAzul é chamado, que executa uma transformação assíncrona via PonteAzul.WsIntegracaoClient. (Origem: IntegracaoFinanceiraCliente.aspx.cs - modalConfirmacaoGeracaoLote_OnConfirmar())

5.5. Outras Regras Específicas da Tela

• Seleção de Holerites na Grid (gvwPendenciaPagamentoIntegracao):
• O ddlSelecaoHolerite permite marcar/desmarcar todos os itens, todos os itens da página, ou desmarcar todos. (Origem: IntegracaoFinanceiraCliente.aspx.cs - ddlSelecaoHolerite_OnSelectedIndexChanged())
• A seleção individual de holerites é feita via ControlCheckBox na grid, atualizando a lista LstIdfHoleritesSelecionados. (Origem: IntegracaoFinanceiraCliente.aspx.cs - ckbSelecionar_CheckedChanged())
• Atualização de Campos de Localização:
• Ao alterar o contrato (txtContrato_ValorAlterado), a filial gestora do contrato (objContrato.FilialGestora.IdFilial) é preenchida em txtFilial.IdFilialSelecionada e txtContrato.IdFilial. O txtDepartamento é habilitado e o foco é movido para ele. (Origem: IntegracaoFinanceiraCliente.aspx.cs - txtContrato_ValorAlterado())
• Ao alterar o departamento (txtDepartamento_ValorAlterado), o ID do departamento é setado em txtEmpregado.IdDepartamento e o foco é movido para o empregado. (Origem: IntegracaoFinanceiraCliente.aspx.cs - txtDepartamento_ValorAlterado())
• Ao alterar o centro de resultado (txtCentroResultado_ValorAlterado), a filial do centro de resultado (objCentroResultado.Filial.IdFilial) é preenchida em txtFilial.IdFilialSelecionada e txtCentroResultado.IdFilial. O ID do centro de resultado é setado em txtEmpregado.IdCentroDeResultado. (Origem: IntegracaoFinanceiraCliente.aspx.cs - txtCentroResultado_ValorAlterado())
• Ao alterar a filial (txtFilial_ValorAlterado), o ID da filial é setado em txtCentroResultado.IdFilial e txtEmpregado.IdFilial. O foco é movido para o contrato ou centro de resultado, dependendo do TipoEstruturaGerencial. (Origem: IntegracaoFinanceiraCliente.aspx.cs - txtFilial_ValorAlterado())
• SyngentaComJangada: A propriedade SyngentaComJangada verifica se o NomeCentroServico é “syngentacom” e se o NumeroCNPJ da empresa está em uma lista específica de CNPJs (1960475000192, 1960475000273, 1960475000354, 1960475000435, 1960475000516, 1960475000605, 6338993001407, 10211971000134). Isso afeta a visibilidade de campos e a lógica de carregamento da grid. (Origem: IntegracaoFinanceiraCliente.aspx.cs - SyngentaComJangada propriedade)
• Exceção SAP: A lógica de carregamento da lista de sugestões de tipo de integração verifica um parâmetro de dicionário (ItemDicionario.ExcecaoSAP) para determinar se a integração SAP JMalucelli deve ser adicionada. (Origem: IntegracaoFinanceiraCliente.aspx.cs - CarregarListasSugestoes())

🔄 6. Fluxos Principais

6.1. Inicialização da Tela (Page_Load)

1. Page_Load é executado.
2. Se não for um postback, Inicializar() é chamado.
3. Inicializar():

• Chama ConfigurarPermissoesTela() para carregar as permissões do usuário.
• Chama ConfigurarEstrutura() para ajustar a visibilidade dos campos de estrutura gerencial (Contrato/Departamento ou Centro de Resultado).
• Configura o UserControl SolicitacoesAssincronas com os IDs dos plugins de integração financeira relevantes (IntegracaoFinanceiraRMClienteJM, IntegracaoFinanceiraDatasulClienteJM, IntegracaoFinanceiraDealerNetClienteJM, RelatorioIntegracaoFinanceiraItaltel, IntegracaoFinanceira, IntegracaoFinanceiraOracleSeguradora, IntegracaoFinanceiraSAP, IntegracaoFinanceiraSAPCRASA, IntegracaoFinanceiraSAPSYNGENTACOM, IntegracaoFinanceiraSYNGENTACOMJangada, IntegracaoFinanceiraSYNGENTACOMDipagro, IntegracaoFinanceiraSolutionJMalucelliCliente, IntegracaoFinanceiraSAPJMalucelli), ID do usuário, empresa e sistema.
• Chama CarregarListasSugestoes() para popular o dropdown de tipos de integração.
• Chama CarregarParametros() para carregar parâmetros específicos da tela.
• Configura as propriedades IdEmpresa e IdGrupoEconomico para txtGrupoPagamento.
• Configura IdEmpresa para txtFilial, txtCentroResultado, txtEmpregado.
• Define a obrigatoriedade de txtDe e txtAte e a visibilidade de plhCamposPeriodoLeituraRetorno com base no NomeCentroServico e na propriedade SyngentaComJangada.

6.2. Pesquisar Lançamentos (btnPesquisar_OnClick)

1. btnPesquisar_OnClick é acionado.
2. As listas de holerites selecionados (LstIdfHoleritesSelecionados) e pendentes (LstIdfHoleritesPendentes) são limpas.
3. ValidarFiltros() é chamado para verificar as condições dos filtros.
4. Se os filtros forem válidos:

• O índice da página da grid (gvwPendenciaPagamentoIntegracao.MockPageIndex) é resetado para 0.
• Se o tipo de integração selecionado for Italtel (INTANAG, CEDOLINO, CUD, CUD1), um modal de confirmação (modalConfirmacaoGeracaoLote) é exibido antes de carregar a grid.
• Caso contrário, CarregarGrid() é chamado.

6.3. Carregar Grid de Lançamentos (CarregarGrid)

1. CarregarGrid() é chamado.
2. Determina a lógica de carregamento baseada no NomeCentroServico (jmalucelli, nutrientes, syngentacom, crasa) e na propriedade bSyngentaComJangada.
3. Chama IntegracaoFinanceiraClienteLoteHoleriteVerba.ListarHoleriteVerbas() com os filtros da tela para obter os dados.

• Para “jmalucelli”, “nutrientes”, “crasa” ou “syngentacom” (e não bSyngentaComJangada): usa txtGrupoPagamento.IdGrupoPagamentoSelecionado.
• Para outros casos: usa a lista de grupos de pagamento do ucModalGruposAdicionados.

4. UIHelper.CarregarGridView() preenche a gvwPendenciaPagamentoIntegracao com os dados retornados.
5. TotalizadorItensSelecionados() e TotalizadorGeral() atualizam os totalizadores de valores.
6. A visibilidade da coluna “Pensionista” na grid é ajustada com base na existência de pensionistas nos dados.
7. A visibilidade dos botões de geração de lote, dropdown de seleção e totalizador é ajustada com base na existência de itens na grid.
8. A lista de holerites pendentes (LstIdfHoleritesPendentes) é populada.
9. Em caso de erro, registra no log e exibe mensagem de erro.

6.4. Gerar Lote de Integração (btnGerarLoteIntegracao_OnClick)

1. btnGerarLoteIntegracao_OnClick é acionado.
2. ValidarParaGerar() é chamado para verificar se há itens selecionados.
3. Se válido, Gerar() é chamado.
4. Gerar() exibe um modal de confirmação (modalConfirmacaoGeracaoLote) para a geração do lote.

6.5. Confirmação de Geração de Lote (modalConfirmacaoGeracaoLote_OnConfirmar)

1. modalConfirmacaoGeracaoLote_OnConfirmar é acionado.
2. Uma ParametroExecucaoCollection é criada e preenchida com os dados dos filtros da tela (Data Inicial, Data Final, Estrutura Gerencial, Contrato, Departamento, Centro de Resultado, Empresa, Filial, Empregado, Usuário, Ação “Gerar Lote Integração Financeira”).
3. A lógica para adicionar parâmetros específicos de grupo de pagamento e holerites selecionados é aplicada, dependendo do NomeCentroServico e do tipo de integração.
4. ProcessoAssincrono.IniciarAtividade() é chamado para iniciar o processo assíncrono de geração do lote, utilizando o plugin de compatibilidade e tipo de saída apropriados (Excel ou ArquivoTextoDownload).
5. Para integrações Ponte Azul, IntegracaoPonteAzul() é chamado.
6. Uma mensagem de sucesso é exibida.

6.6. Limpar Tela (btnLimparTela_OnClick)

1. btnLimparTela_OnClick é acionado.
2. A página é redirecionada para si mesma (IntegracaoFinanceiraCliente.aspx), efetivamente limpando todos os campos e redefinindo o estado.

6.7. Voltar (btnVoltar_OnClick)

1. btnVoltar_OnClick é acionado.
2. O usuário é redirecionado para a tela MenuMaisOpcoes.aspx.

🔌 7. Integrações e Dependências

7.1. Classes BLL e Service utilizadas

• Employer.Plataforma.BLL.CentroResultado

• Arquivos: Employer.Plataforma.BLL\CentroResultado_P1.cs, Employer.Plataforma.BLL\CentroResultado_P2.cs

• Métodos chamados:

• LoadObject(int idCentroResultado): Carrega um objeto CentroResultado pelo seu ID. Usado para obter informações do centro de resultado selecionado nos filtros e para configurar o txtFilial e txtEmpregado.

• Employer.Plataforma.BLL.Contrato

• Arquivos: Employer.Plataforma.BLL\Contrato_P1.cs, Employer.Plataforma.BLL\Contrato_P2.cs, Employer.Plataforma.BLL\Contrato_P3.cs

• Métodos chamados:

• LoadObject(int idContrato): Carrega um objeto Contrato pelo seu ID. Usado para obter informações do contrato selecionado nos filtros, como a filial gestora.

• Employer.Plataforma.BLL.Dicionario

• Arquivos: Employer.Plataforma.BLL\Dicionario_P1.cs, Employer.Plataforma.BLL\Dicionario_P2.cs, Employer.Plataforma.BLL.Login\Dicionario_P1.cs, Employer.Plataforma.BLL.Login\Dicionario_P2.cs, Employer.Plataforma.BLL.STS\Dicionario_P1.cs, Employer.Plataforma.BLL.STS\Dicionario_P2.cs

• Métodos chamados:

• RecuperaValorDicionario(ItemDicionario item): Recupera um valor de dicionário. Usado para obter a lista de empresas com exceção SAP (ItemDicionario.ExcecaoSAP).

• Employer.Plataforma.BLL.Empresa

• Arquivos: Employer.Plataforma.BLL\Empresa_P1.cs, Employer.Plataforma.BLL\Empresa_P2.cs, Employer.Plataforma.BLL\Empresa_P3.cs

• Métodos chamados:

• LoadObject(CodigoEmpresa codigoEmpresa): Carrega um objeto Empresa pelo seu código. Usado para obter o GrupoEconomico da empresa.

• CarregarPorIdEmpresa(string idEmpresa, out Empresa objEmpresa): Carrega um objeto Empresa pelo seu ID. Usado para verificar o CNPJ da empresa ao aplicar a exceção SAP.

• Employer.Plataforma.BLL.FormatoIntegracaoFinanceira

• Arquivos: Employer.Plataforma.BLL\FormatoIntegracaoFinanceira_P1.cs, Employer.Plataforma.BLL\FormatoIntegracaoFinanceira_P2.cs

• Métodos chamados:

• ListarAtivos(): Retorna uma lista de formatos de integração financeira ativos. Usado para popular o dropdown lsTipoIntegracao.

• LoadObject(int idFormatoIntegracaoFinanceira): Carrega um objeto FormatoIntegracaoFinanceira pelo seu ID. Usado para obter detalhes do formato selecionado, como IdProcessoPonteAzul e DescricaoFormatoIntegracaoFinanceira.

• Employer.Plataforma.BLL.IntegracaoFinanceiraClienteGrupoPagamento

• Arquivos: Employer.Plataforma.BLL\IntegracaoFinanceiraClienteGrupoPagamento_P1.cs, Employer.Plataforma.BLL\IntegracaoFinanceiraClienteGrupoPagamento_P2.cs

• Métodos chamados:

• LoadObject(int idGrupoPagamento): Carrega um objeto IntegracaoFinanceiraClienteGrupoPagamento pelo seu ID. Usado para obter o CodigoGrupoPagamento e outros detalhes do grupo de pagamento selecionado.

• Employer.Plataforma.BLL.IntegracaoFinanceiraClienteLote

• Arquivos: Employer.Plataforma.BLL\IntegracaoFinanceiraClienteLote_P1.cs, Employer.Plataforma.BLL\IntegracaoFinanceiraClienteLote_P2.cs

• Métodos chamados:

• LoadObject(int idIntegracaoFinanceiraClienteLote): Carrega um objeto IntegracaoFinanceiraClienteLote pelo seu ID. Usado para atualizar o status do lote após a integração Ponte Azul.

• Save(): Salva as alterações no objeto IntegracaoFinanceiraClienteLote.

• Employer.Plataforma.BLL.IntegracaoFinanceiraClienteLoteHoleriteVerba

• Arquivos: Employer.Plataforma.BLL\IntegracaoFinanceiraClienteLoteHoleriteVerba_P1.cs, Employer.Plataforma.BLL\IntegracaoFinanceiraClienteLoteHoleriteVerba_P2.cs

• Métodos chamados:

• ListarHoleriteVerbas(CodigoEmpresa codigoEmpresa, int? idfFilial, int? idfCentroResultado, int? idfEmpregado, DateTime? dtaDe, DateTime? dtaAte, int codGrupoPagamento, int numPagina, int numLinhasPagina, string nmeColunaOrdenacao, string desDirecaoOrdenacao, out DataTable dtTotal): Lista as verbas de holerite pendentes de integração para centros de serviço específicos.

• ListarHoleriteVerbas(CodigoEmpresa codigoEmpresa, int? idfFilial, int? idfContrato, int? idfDepartamento, int? idfCentroResultado, int? idfEmpregado, DateTime? dtaDe, DateTime? dtaAte, DateTime? dtaInicioLeituraRetorno, DateTime? dtaFimLeituraRetorno, List<int> lstCodigoGrupoPagamentoIntegracao, int numPagina, int numLinhasPagina, string nmeColunaOrdenacao, string desDirecaoOrdenacao, out DataTable dtTotal): Lista as verbas de holerite pendentes de integração para outros centros de serviço, incluindo filtros de contrato, departamento e período de leitura de retorno.

• Employer.Plataforma.BLL.ParametroEspecifico

• Arquivos: Employer.Plataforma.BLL\ParametroEspecifico_P1.cs, Employer.Plataforma.BLL\ParametroEspecifico_P2.cs

• Métodos chamados:

• RecuperarParametroEspecifico(NomeParametro nomeParametro, Empresa empresa, Filial filial, Contrato contrato, CentroResultado centroResultado): Recupera o valor de um parâmetro específico. Usado para verificar o parâmetro HabilitaConfirmacaoSenhaMaster.

• Employer.Plataforma.BLL.PluginsCompatibilidade

• Arquivos: Employer.Plataforma.BLL\PluginsCompatibilidade_P1.cs, Employer.Plataforma.BLL\PluginsCompatibilidade_P2.cs

• Métodos chamados:

• CarregarPorMetadata(PluginEntradaIntegracao pluginEntrada, PluginSaidaRelatorio pluginSaida): Carrega informações de compatibilidade de plugins. Usado para determinar o plugin de saída para o processo assíncrono.

• Employer.PlataformaServices.ProcessosAssincronos.ProcessoAssincrono

• Arquivo: C:\Webfopag\Etec.WebFopag\Employer.PlataformaServices\ProcessosAssincronos\ProcessoAssincrono.cs

• Métodos chamados:

• IniciarAtividade(PluginsCompatibilidade plugin, string nomeCentroServico, ParametroExecucaoCollection parametros, string nomeArquivo, TipoSaida tipoSaida, string email, string urlRetorno, DateTime dataExecucao, CodigoEmpresa codigoEmpresa, Enumeradores.Sistema sistema): Inicia uma nova atividade assíncrona.

• Employer.Plataforma.BLL.Usuario

• Arquivos: Employer.Plataforma.BLL\Usuario_P1.cs, Employer.Plataforma.BLL\Usuario_P2.cs, Employer.Plataforma.BLL.Login\Usuario_P1.cs, Employer.Plataforma.BLL.Login\Usuario_P2.cs, Employer.Plataforma.BLL.STS\Usuario_P1.cs, Employer.Plataforma.BLL.STS\Usuario_P2.cs

• Métodos chamados:

• CarregarPermissoes(Usuario usuario, CategoriaPermissao categoria): Carrega as permissões de um usuário para uma categoria específica. Usado para configurar as permissões da tela.

• Employer.Plataforma.BLL.Filial

• Arquivos: Employer.Plataforma.BLL\Filial_P1.cs, Employer.Plataforma.BLL\Filial_P2.cs

• Métodos chamados:

• LoadObject(int idFilial): Carrega um objeto Filial pelo seu ID.

• Employer.Plataforma.BLL.IntegracaoFinanceiraAPI

• Arquivos: Employer.Plataforma.BLL\IntegracaoFinanceiraAPI_P1.cs, Employer.Plataforma.BLL\IntegracaoFinanceiraAPI_P2.cs

• Métodos chamados:

• EhIntegracaoFinanceira262API(int idFormatoIntegracaoFinanceira, int? idIntegracaoFinanceiraClienteGrupoPagamento, string nomeCS): Verifica se é uma integração financeira do tipo 262 API.

• Employer.PlataformaServices.ProcessosAssincronos.ParametroExecucaoCollection

• Arquivo: C:\Webfopag\Etec.WebFopag\Employer.PlataformaServices\ProcessosAssincronos\ParametroExecucao.cs

• Métodos chamados:

• Add(string nomeParametro, string descricaoParametro, string valorParametro, string valorExibicao, bool obrigatorio): Adiciona um parâmetro à coleção.

• Employer.PlataformaServices.ProcessosAssincronos.TarefaAssincrona

• Arquivo: C:\Webfopag\Etec.WebFopag\Employer.PlataformaServices\ProcessosAssincronos\TarefaAssincrona.cs

• Não há chamadas diretas a métodos desta classe no aspx.cs, mas é instanciada em gvwPendenciaPagamentoIntegracao_RowDataBound.

• Employer.Plataforma.Web.WebFoPag.IntegracaoFinanceiraCliente.GrupoPagamentoDto

• Arquivo: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.Web.WebFoPag\IntegracaoFinanceiraCliente.aspx.cs

• Classe DTO interna utilizada para representar grupos de pagamento adicionados no ucModalGruposAdicionados.

• Employer.Plataforma.Plugins.WebFopag.PonteAzul.WsIntegracaoClient

• Arquivo: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.Plugins.WebFopag\Service References\PonteAzul\Reference.cs

• Métodos chamados:

• ExecutarTransformacaoAsync(byte[] arquivo, string idProcesso, string nomeCS): Executa uma transformação assíncrona via WebService da Ponte Azul.

7.2. Stored Procedures chamadas

• SP_Integracao_Financeira_Cliente_Lote_Holerite_Verba_Listar
• Arquivo BLL: Employer.Plataforma.BLL\IntegracaoFinanceiraClienteLoteHoleriteVerba_P1.cs (e P2)
• Parâmetros SQL: @Idf_Empresa, @Idf_Filial, @Idf_Centro_Resultado, @Idf_Empregado, @Dta_De, @Dta_Ate, @Cod_Grupo_Pagamento, @Num_Pagina, @Num_Linhas_Pagina, @Nme_Coluna_Ordenacao, @Des_Direcao_Ordenacao, @Idf_Contrato, @Idf_Departamento, @Dta_Inicio_Leitura_Retorno, @Dta_Fim_Leitura_Retorno, @Lista_Idf_Integracao_Financeira_Cliente_Grupo_Pagamento
• Propósito: Lista as verbas de holerite pendentes de integração financeira, com filtros por empresa, filial, centro de resultado, empregado, período de pagamento, código do grupo de pagamento, paginação, ordenação, contrato, departamento e período de leitura de retorno.

7.3. UserControls incluídos (.ascx)

• GridIntegracaoFinanceiraClienteLote

• Caminho: ~/UserControls/GridIntegracaoFinanceiraClienteLote.ascx

• ID: GridIntegracaoFinanceiraClienteLote

• Tag: ucIntegracaoFinanceiraClienteLote:GridIntegracaoFinanceiraClienteLote

• Propriedades expostas: Visible

• Eventos: OnCarregarGrid, OnRowCommand, OnRowDataBound

• Métodos públicos chamados pela tela pai: Nenhum método público é chamado diretamente, mas a tela pai interage com seus eventos.

• ucModalSelecaoMultipla

• Caminho: ~/UserControls/ucModalSelecaoMultipla.ascx

• ID: ucModalGruposAdicionados

• Tag: ucModalSelecaoMultipla:SelecaoMultipla

• Propriedades expostas: Titulo, TextoBotao, DataKeyNames, MockColunaOrdenada, ValidationGroup, Visible, RegistrosAdicionados

• Eventos: OnEventoAdicionarRegistro

• Métodos públicos chamados pela tela pai: ucModalGruposAdicionados_EventoAdicionarRegistro() (para adicionar um registro)

• Employer.SolicitacoesAssincronas

• Caminho: ~/UserControls/SolicitacoesAssincronas.ascx (implícito, pois é um controle Employer)

• ID: SolicitacoesAssincronas

• Propriedades expostas: MostraBotaoExcluirProcessos, MostrarCampoPesquisa, QuantidadeItensPagina, PerfilComponenteAtivo, IdsPlugins, QuantidadeItensPorPlugin, IdUsuario, IdEmpresa, IdSistema, btnGerarNovamenteModalParametros.Visible

• Propósito: Exibe e gerencia o status de processos assíncronos iniciados pelo sistema.

7.4. WebServices, APIs externas, filas

• Ponte Azul WebService (WsIntegracaoClient)
• Endpoint: Configurado no Service References\PonteAzul\Reference.cs
• Método: ExecutarTransformacaoAsync
• Propósito: Realiza a integração com sistemas externos via Ponte Azul, enviando um array de bytes contendo o NomeCentroServico e o IdIntegracaoFinanceiraClienteLote, um ID de processo e o NomeCentroServico.

💬 8. Mensagens ao Usuário

• “Período Pagamento incorreto.” (Erro)
• “Utilize o filtro Período Pagamento ou Período de Leitura de Retorno.” (Erro)
• “Período Pagamento incorreto. Preencha o campo {0}.” (Erro)
• “Período de Leitura de Retorno incorreto. Preencha o campo {0}.” (Erro)
• “Período de Leitura de Retorno incorreto.” (Erro)
• “Selecione o campo Formato.” (Erro)
• “Falha na integração.” (Erro)
• “Lote em processamento.” (Aviso)
• “Falha ao realizar pesquisa. {0}” (Erro)
• “Erro ao efetuar pesquisa.” (Erro)
• “Atenção!” (Título do modal de confirmação)
• “

  Confirma geração do lote de integração financeira?

  ” (Texto do modal de confirmação)
• “

  Confirma geração do lote de integração financeira?

  Observação: {0}.

  
  
  ” (Texto do modal de confirmação com totalizador)
• “Erro ao solicitar integração financeira” (Erro)
• “Não foram selecionados empregados para gerar lote. Favor verificar.” (Erro)
• “Processo de integração não cadastrado. Entre em contato com o suporte.” (Erro)
• “Campo Formato inválido.” (Erro)
• “Solicitação realizada com sucesso.” (Aviso)
• “Não foi encontrado nenhum processo pendente de integração.” (Texto para grid vazia)
• “Não foi encontrado nenhum processo de lote.” (Texto para grid de lotes vazia)

🔐 9. Permissões e Perfis

• Permissão: BLL.Enumeradores.Permissoes.Pagamento.RealizarIntegracaoFinanceiraSOLUTION
• Controla a adição do tipo de integração “Integração Financeira - SOLUTION” na lista de sugestões e nos plugins assíncronos.
• Permissão: BLL.Enumeradores.Permissoes.Pagamento.RealizarIntegracaoFinanceiraSAPJMalucelli
• Controla a adição do tipo de integração “Integração Financeira - SAP” (para JMalucelli) na lista de sugestões e nos plugins assíncronos, com uma exceção baseada no CNPJ da empresa (ItemDicionario.ExcecaoSAP).
• Permissão: BLL.Enumeradores.Permissoes.ContabilidadeWebFopag.RealizarIntegraçãoFinanceiraSyngentaCom
• Controla a adição do tipo de integração “Integração Financeira SAP - SYNGENTACOM” na lista de sugestões.
• Permissão: BLL.Enumeradores.Permissoes.ContabilidadeWebFopag.RealizarIntegraçãoFinanceiraSyngentaComDIPAGRO
• Controla a adição do tipo de integração “Integração Financeira DIPAGRO - SYNGENTACOM” na lista de sugestões.
• Permissão: BLL.Enumeradores.Permissoes.ContabilidadeWebFopag.RealizarIntegraçãoFinanceiraSyngentaComJANGADA
• Controla a adição do tipo de integração “Integração Financeira JANGADA - SYNGENTACOM” na lista de sugestões.
• Permissão: BLL.Enumeradores.Permissoes.Pagamento.RealizarIntegracaoFinanceiraCliente
• Permissão de acesso à tela. Se o usuário não possuir esta permissão, é redirecionado para a página de acesso negado (Configuracao.UrlAcessoNegado).

🔎 10. Aprofundamento — Detalhes Internos de Métodos

Os arquivos foram lidos com sucesso. Agora, vou processar o conteúdo de cada classe para gerar a documentação detalhada, focando nos métodos públicos, sua lógica interna, stored procedures chamadas, parâmetros SQL, validações e exceções.

Começarei com a classe CentroResultado.

CentroResultado

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\CentroResultado_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\CentroResultado_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de CentroResultado já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idCentroResultado)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Centro_Resultado e @Idf_Usuario_Gerador.
  2. Atribui o idCentroResultado e o CodigoUsuario da sessão aos parâmetros.
  3. Executa uma instrução SQL UPDATE para registrar o Idf_Usuario_Gerador antes de realizar o DELETE físico.
  4. Em seguida, executa a instrução DELETE FROM TAB_Centro_Resultado WHERE Idf_Centro_Resultado = @Idf_Centro_Resultado.
• Stored Procedures chamadas:
  • UPDATE TAB_Centro_Resultado SET Idf_Usuario_Gerador = @Idf_Usuario_Gerador WHERE Idf_Centro_Resultado = @Idf_Centro_Resultado (SQL inline)
  • DELETE FROM TAB_Centro_Resultado WHERE Idf_Centro_Resultado = @Idf_Centro_Resultado (SQL inline)
• Parâmetros SQL:
  • @Idf_Centro_Resultado: ID do Centro de Resultado a ser excluído.
  • @Idf_Usuario_Gerador: ID do usuário que está realizando a exclusão (obtido da sessão).

LoadObject(int idCentroResultado)

• Lógica:
  1. Chama o método LoadDataReader(idCentroResultado) para obter um IDataReader com os dados do Centro de Resultado.
  2. Cria uma nova instância de CentroResultado.
  3. Chama o método auxiliar SetInstance(dr, objCentroResultado) para preencher a instância com os dados do IDataReader.
  4. Se a instância for preenchida com sucesso, retorna o objeto.
  5. Caso contrário, lança uma RecordNotFoundException.
• Exceções:
  • RecordNotFoundException: Lançada se nenhum registro for encontrado para o idCentroResultado fornecido.

ListarCRsCadastradosPaginado(int idEmpresa, int pagina, int tamPagina, string ordem, string direcaoOrdem, out int numRegistros)

• Lógica:
  1. Prepara uma lista de SqlParameter com @Idf_Empresa, @PageNumber e @RowspPage.
  2. Constrói uma Common Table Expression (CTE) chamada arvore_cr para listar os Centros de Resultado de forma hierárquica, começando pelos CRs superiores (sem pai) e recursivamente adicionando os filhos.
  3. Executa uma consulta SELECT COUNT(1) FROM arvore_cr para obter o número total de registros (numRegistros).
  4. Constrói a consulta principal para selecionar os dados dos Centros de Resultado, incluindo Idf_Centro_Resultado, Idf_Centro_Resultado_Superior, Centro_Resultado (formatado com descrição da estrutura e nome), Des_Centro_Resultado, Des_Estrutura_Centro_Resultado e Ape_Filial (apelido da filial).
  5. Aplica a ordenação (ordem, direcaoOrdem) e a paginação (OFFSET, FETCH NEXT) à consulta.
  6. Retorna um DataTable com os resultados da consulta paginada.
• Stored Procedures chamadas:
  • arvore_cr (CTE inline)
  • TAB_Centro_Resultado (tabela acessada diretamente)
  • TAB_Filial (tabela acessada diretamente)
• Parâmetros SQL:
  • @Idf_Empresa: ID da empresa para filtrar os Centros de Resultado.
  • @PageNumber: Número da página atual para a paginação.
  • @RowspPage: Número de linhas por página.
  • @colunaOrdenacao: Nome da coluna para ordenação.
  • @direcaoOrdenacao: Direção da ordenação (ASC/DESC).

ExcluirCentroResultado(int idEmpresa, int? idFilial, CentroResultado objCentroResultado, int idUsuarioLogado)

• Lógica:
  1. Abre uma conexão SQL e inicia uma transação.
  2. Completa o objeto objCentroResultado para garantir que todos os dados estejam carregados.
  3. Chama ResponsavelCentroResultado.ExcluirHistoricoCentroResultado para excluir o histórico de responsáveis associado ao CR.
  4. Executa um DELETE na tabela TAB_Centro_Resultado para o IdCentroResultado fornecido.
  5. Recupera a quantidade de níveis de CR da empresa usando QuantidadeNiveisEmpresa.
  6. Chama ApelidoNivelCentroResultado.RemoverApelidosAcimaNivel para remover apelidos de nível acima do nível máximo do CR.
  7. Verifica um parâmetro (UtilizaResponsavelCRSupervisorEmpregado). Se for “1”: a. Carrega o responsável atual do CR usando ResponsavelCentroResultado.CarregarResponsavelAtualCr. b. Chama InativarSupervisorCR para inativar o supervisor e remover registros de empregados supervisores.
  8. Comita a transação. Em caso de erro, faz rollback e relança a exceção.
• Stored Procedures chamadas:
  • ResponsavelCentroResultado.ExcluirHistoricoCentroResultado (método de outra BLL)
  • DELETE FROM TAB_Centro_Resultado WHERE Idf_Centro_Resultado = @Idf_Centro_Resultado (SQL inline)
  • QuantidadeNiveisEmpresa (método da própria classe)
  • ApelidoNivelCentroResultado.RemoverApelidosAcimaNivel (método de outra BLL)
  • ResponsavelCentroResultado.CarregarResponsavelAtualCr (método de outra BLL)
  • InativarSupervisorCR (método da própria classe)
• Parâmetros SQL:
  • @Idf_Centro_Resultado: ID do Centro de Resultado a ser excluído.
• Validações:
  • Verifica o parâmetro UtilizaResponsavelCRSupervisorEmpregado para aplicar lógica de inativação de supervisor.
• Exceções:
  • Captura e relança exceções SQL.

RecuperarCRFilhos(int? idCrSuperior, int? idCrAtual, int idEmpresa, int idUsuario)

• Lógica:
  1. Constrói uma CTE arvore_cr para buscar Centros de Resultado hierarquicamente.
  2. A CTE começa com os CRs que têm Idf_Centro_Resultado_Superior igual a @Idf_Cr_Superior (ou NULL se @Idf_Cr_Superior for NULL).
  3. Recursivamente, adiciona os filhos onde Idf_Centro_Resultado_Superior corresponde ao Idf_Centro_Resultado dos pais.
  4. Filtra para excluir o Idf_Cr_Atual se fornecido.
  5. A consulta final seleciona os CRs da CTE, juntando com TAB_Filial para obter o apelido da filial.
  6. Aplica filtros adicionais: Flg_Permite_Lancamento = 1, Flg_Inativo = 0, data de vigência (GETDATE() BETWEEN Dta_Inicio_Vigencia AND ISNULL(Dta_Fim_Vigencia, GETDATE())), Idf_Empresa e permissão de acesso do usuário (TAB_SF_Usuario_Acesso).
  7. Retorna um DataTable com os resultados.
• Stored Procedures chamadas:
  • arvore_cr (CTE inline)
  • TAB_Centro_Resultado (tabela acessada diretamente)
  • TAB_Filial (tabela acessada diretamente)
  • TAB_SF_Usuario_Acesso (função de tabela)
• Parâmetros SQL:
  • @Idf_Cr_Superior: ID do Centro de Resultado superior.
  • @Idf_Cr_Atual: ID do Centro de Resultado atual a ser excluído da lista.
  • @Idf_Empresa: ID da empresa.
  • @Idf_Usuario: ID do usuário para verificação de acesso.

Dicionario

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Dicionario_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Dicionario_P2.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL.Login\Dicionario_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL.Login\Dicionario_P2.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL.STS\Dicionario_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL.STS\Dicionario_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de Dicionario já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idDicionario)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Dicionario.
  2. Atribui o idDicionario ao parâmetro.
  3. Executa uma instrução DELETE FROM plataforma.TAB_Dicionario WHERE Idf_Dicionario = @Idf_Dicionario.
• Stored Procedures chamadas:
  • DELETE FROM plataforma.TAB_Dicionario WHERE Idf_Dicionario = @Idf_Dicionario (SQL inline)
• Parâmetros SQL:
  • @Idf_Dicionario: ID do dicionário a ser excluído.

RecuperaValorDicionario(Enumeradores.ItemDicionario idDicionario, string valorDicionario = default(string))

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Dicionario.
  2. Atribui o idDicionario (convertido para int) ao parâmetro.
  3. Executa um IDataReader usando a consulta SPSELECTID (SELECT * FROM plataforma.TAB_Dicionario WHERE Idf_Dicionario = @Idf_Dicionario).
  4. Se houver um registro, lê o valor da coluna Vlr_Dicionario e o atribui à variável valorDicionario.
  5. Fecha o IDataReader e o dispõe.
  6. Retorna o valorDicionario.
• Stored Procedures chamadas:
  • SPSELECTID (SQL inline: SELECT * FROM plataforma.TAB_Dicionario WHERE Idf_Dicionario = @Idf_Dicionario)
• Parâmetros SQL:
  • @Idf_Dicionario: ID do item do dicionário a ser recuperado.

Empresa

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Empresa_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Empresa_P2.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Empresa_P3.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de Empresa já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idEmpresa)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Empresa e @Idf_Usuario_Gerador.
  2. Atribui o idEmpresa e o CodigoUsuario da sessão aos parâmetros.
  3. Executa uma instrução SQL UPDATE para registrar o Idf_Usuario_Gerador antes de realizar o DELETE físico.
  4. Em seguida, executa a instrução DELETE FROM TAB_Empresa WHERE Idf_Empresa = @Idf_Empresa.
• Stored Procedures chamadas:
  • UPDATE TAB_Empresa SET Idf_Usuario_Gerador = @Idf_Usuario_Gerador WHERE Idf_Empresa = @Idf_Empresa (SQL inline)
  • DELETE FROM TAB_Empresa WHERE Idf_Empresa = @Idf_Empresa (SQL inline)
• Parâmetros SQL:
  • @Idf_Empresa: ID da empresa a ser excluída.
  • @Idf_Usuario_Gerador: ID do usuário que está realizando a exclusão (obtido da sessão).

UpdateEmpregados(int? pIdFilial, SqlTransaction trans)

• Lógica:
  1. Constrói uma consulta SQL dinâmica com base no TipoEstruturaGerencial da empresa.
  2. Se a estrutura for “Contrato/Departamento” (@UtilizaCR <> 2): a. Cria uma CTE Temp_Fila_Calculo que seleciona empregados ativos e inativos (com lançamentos específicos) associados a contratos e filiais, filtrando por empresa e filial. b. A CTE inclui Idf_Empregado, Idf_Periodo_Calculo, e outros campos para a fila de cálculo.
  3. Se a estrutura for “Centro de Resultado” (ELSE): a. Cria uma CTE Temp_Fila_Calculo similar, mas selecionando empregados associados a Centros de Resultado e filiais.
  4. Adiciona parâmetros para @Idf_Empresa, @Idf_Filial e @UtilizaCR (baseado no TipoEstruturaGerencial).
  5. Executa a consulta SQL para obter os empregados que precisam ser atualizados na fila de cálculo.
  6. Chama FilaCalculoV2Helper.SalvarEnviarParaCalculo(dr, trans) para processar os resultados e enviar os empregados para a fila de cálculo.
• Stored Procedures chamadas:
  • TAB_Empregado, TAB_Contrato, TAB_Periodo_Calculo_Filial, TAB_Lancamento, TAB_Verba_Manual, TAB_Centro_Resultado (tabelas acessadas diretamente em consultas dinâmicas).
• Parâmetros SQL:
  • @Idf_Empresa: ID da empresa.
  • @Idf_Filial: ID da filial (opcional).
  • @UtilizaCR: Indicador do tipo de estrutura gerencial.
• Regras de negócio:
  • A lógica de seleção de empregados para atualização na fila de cálculo varia conforme o tipo de estrutura gerencial da empresa (Contrato/Departamento ou Centro de Resultado).
  • Inclui empregados ativos e inativos com lançamentos específicos (tipos de folha 8, 10, 18) e períodos de cálculo não fechados.

RecuperarProximaMatricula(SqlTransaction trans, out int pNumeroMatricula)

• Lógica:
  1. Verifica se _idEmpresa é maior que 0.
  2. Constrói uma consulta SQL que utiliza um WHILE loop e uma tabela temporária (#T) para: a. Incrementar o Num_Semente da TAB_Empresa (ou inicializá-lo em 1 se for NULL). b. Inserir o novo Num_Semente na tabela temporária. c. Verificar se o Num_Semente - 1 (o valor anterior à atualização) já está em uso como Num_Matricula em TAB_Empregado ou TAB_Empregado_Admissao_Futura para a empresa atual. d. O loop continua até que um número de matrícula “livre” seja encontrado.
  3. Adiciona o parâmetro @Idf_Empresa.
  4. Executa a consulta SQL e tenta converter o resultado para int (pNumeroMatricula).
  5. Retorna true se a conversão for bem-sucedida, false caso contrário.
• Stored Procedures chamadas:
  • TAB_Empresa, TAB_Empregado, TAB_Empregado_Admissao_Futura, TAB_Contrato (tabelas acessadas diretamente em consulta dinâmica).
• Parâmetros SQL:
  • @Idf_Empresa: ID da empresa.
  • @Semente: Variável interna do SQL para o número da semente.
  • @Controle: Variável interna do SQL para controlar o loop.
• Regras de negócio:
  • Garante que o número de matrícula gerado seja único e não esteja em uso por empregados existentes ou futuros.
  • Utiliza uma “semente” (Num_Semente) na tabela TAB_Empresa para gerar números sequenciais.

FormatoIntegracaoFinanceira

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\FormatoIntegracaoFinanceira_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\FormatoIntegracaoFinanceira_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de FormatoIntegracaoFinanceira já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idFormatoIntegracaoFinanceira)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Formato_Integracao_Financeira.
  2. Atribui o idFormatoIntegracaoFinanceira ao parâmetro.
  3. Executa uma instrução DELETE FROM plataforma.TAB_Formato_Integracao_Financeira WHERE Idf_Formato_Integracao_Financeira = @Idf_Formato_Integracao_Financeira.
• Stored Procedures chamadas:
  • DELETE FROM plataforma.TAB_Formato_Integracao_Financeira WHERE Idf_Formato_Integracao_Financeira = @Idf_Formato_Integracao_Financeira (SQL inline)
• Parâmetros SQL:
  • @Idf_Formato_Integracao_Financeira: ID do formato de integração financeira a ser excluído.

ListarAtivos()

• Lógica:
  1. Constrói uma consulta SQL simples: SELECT * FROM plataforma.TAB_Formato_Integracao_Financeira WHERE Flg_Inativo = 0.
  2. Executa a consulta usando DataAccessLayer.ExecuteReader sem parâmetros.
  3. Retorna um SqlDataReader com os resultados.
• Stored Procedures chamadas:
  • SELECT * FROM plataforma.TAB_Formato_Integracao_Financeira WHERE Flg_Inativo = 0 (SQL inline)
• Parâmetros SQL: Nenhum.

IntegracaoFinanceiraClienteGrupoPagamento

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\IntegracaoFinanceiraClienteGrupoPagamento_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\IntegracaoFinanceiraClienteGrupoPagamento_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de IntegracaoFinanceiraClienteGrupoPagamento já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idIntegracaoFinanceiraClienteGrupoPagamento)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Integracao_Financeira_Cliente_Grupo_Pagamento.
  2. Atribui o idIntegracaoFinanceiraClienteGrupoPagamento ao parâmetro.
  3. Executa uma instrução DELETE FROM TAB_Integracao_Financeira_Cliente_Grupo_Pagamento WHERE Idf_Integracao_Financeira_Cliente_Grupo_Pagamento = @Idf_Integracao_Financeira_Cliente_Grupo_Pagamento.
• Stored Procedures chamadas:
  • DELETE FROM TAB_Integracao_Financeira_Cliente_Grupo_Pagamento WHERE Idf_Integracao_Financeira_Cliente_Grupo_Pagamento = @Idf_Integracao_Financeira_Cliente_Grupo_Pagamento (SQL inline)
• Parâmetros SQL:
  • @Idf_Integracao_Financeira_Cliente_Grupo_Pagamento: ID do grupo de pagamento a ser excluído.

ListarAtivosPorEmpresa(int idEmpresa)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Empresa.
  2. Atribui o idEmpresa ao parâmetro.
  3. Executa um IDataReader usando a consulta SPSELECTATIVOS (SELECT * FROM TAB_Integracao_Financeira_Cliente_Grupo_Pagamento WHERE isnull(Flg_Inativo,0) = 0 and isnull(Idf_Empresa,1) = @Idf_empresa).
  4. Itera sobre o IDataReader, criando e preenchendo instâncias de IntegracaoFinanceiraClienteGrupoPagamento usando SetInstance e adicionando-as a uma lista.
  5. Retorna a lista de grupos de pagamento ativos.
• Stored Procedures chamadas:
  • SPSELECTATIVOS (SQL inline: SELECT * FROM TAB_Integracao_Financeira_Cliente_Grupo_Pagamento WHERE isnull(Flg_Inativo,0) = 0 and isnull(Idf_Empresa,1) = @Idf_empresa)
• Parâmetros SQL:
  • @Idf_Empresa: ID da empresa para filtrar os grupos de pagamento.

Salvar(List lstBeneficios, List lstVerbas, List lstIdGrupoPagamementoBeneficioParaExcluir, List lstIdGrupoPagamementoVerbaParaExcluir)

• Lógica:
  1. Abre uma conexão SQL e inicia uma transação.
  2. Chama Save(trans) para salvar a instância atual do grupo de pagamento.
  3. Se houver IDs de verbas para excluir (lstIdGrupoPagamementoVerbaParaExcluir), chama IntegracaoFinanceiraClienteGrupoPagamentoVerba.Excluir(lstIdGrupoPagamementoVerbaParaExcluir, trans).
  4. Se houver IDs de benefícios para excluir (lstIdGrupoPagamementoBeneficioParaExcluir), chama IntegracaoFinanceiraClienteGrupoPagamentoBeneficio.Excluir(lstIdGrupoPagamementoBeneficioParaExcluir, trans).
  5. Itera sobre lstBeneficios: a. Associa o grupo de pagamento atual a cada benefício. b. Chama objBeneficio.Save(trans) para salvar o benefício.
  6. Itera sobre lstVerbas: a. Associa o ID do grupo de pagamento atual a cada verba. b. Chama objVerba.Save(trans) para salvar a verba.
  7. Comita a transação. Em caso de erro, faz rollback e relança a exceção.
• Stored Procedures chamadas:
  • Save(trans) (método da própria classe)
  • IntegracaoFinanceiraClienteGrupoPagamentoVerba.Excluir (método de outra BLL)
  • IntegracaoFinanceiraClienteGrupoPagamentoBeneficio.Excluir (método de outra BLL)
  • objBeneficio.Save(trans) (método de outra BLL)
  • objVerba.Save(trans) (método de outra BLL)
• Exceções:
  • Captura e relança exceções SQL.

IntegracaoFinanceiraClienteLote

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\IntegracaoFinanceiraClienteLote_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\IntegracaoFinanceiraClienteLote_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de IntegracaoFinanceiraClienteLote já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idIntegracaoFinanceiraClienteLote)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Integracao_Financeira_Cliente_Lote.
  2. Atribui o idIntegracaoFinanceiraClienteLote ao parâmetro.
  3. Executa uma instrução DELETE FROM TAB_Integracao_Financeira_Cliente_Lote WHERE Idf_Integracao_Financeira_Cliente_Lote = @Idf_Integracao_Financeira_Cliente_Lote.
• Stored Procedures chamadas:
  • DELETE FROM TAB_Integracao_Financeira_Cliente_Lote WHERE Idf_Integracao_Financeira_Cliente_Lote = @Idf_Integracao_Financeira_Cliente_Lote (SQL inline)
• Parâmetros SQL:
  • @Idf_Integracao_Financeira_Cliente_Lote: ID do lote de integração financeira a ser excluído.

CriarLote(List lstCodGrupoPagamento, string rpaIds, string folhaIds, string pensaoIds, string btoIds, string bdoIds, int idEmpresa, DateTime? dataDe, DateTime? dataAte, int idAtividade, string centroServico)

• Lógica:
  1. Abre uma conexão SQL e inicia uma transação.
  2. Prepara uma lista de SqlParameter com os IDs dos grupos de pagamento, IDs de RPA, IDs de holerites, IDs de pensões, IDs de benefícios de fornecimento, IDs de benefícios fornecidos, ID da empresa, data inicial, data final e ID da atividade.
  3. Determina qual stored procedure chamar (SPGERARLOTEEMPRESAAGRUPADA ou SPGERARLOTE) com base no centroServico e na função SyngentaComJangada.
  4. Chama o método auxiliar PrepareCommand para configurar o SqlCommand com a stored procedure e os parâmetros.
  5. Executa a stored procedure usando um SqlDataAdapter e preenche um DataSet.
  6. Define o CommandTimeout para 600 segundos.
  7. Limpa os parâmetros do comando.
  8. Comita a transação. Em caso de SqlException, faz rollback, fecha e dispõe a conexão, e relança a exceção.
  9. Retorna uma lista de inteiros (IDs) da primeira tabela do DataSet.
• Stored Procedures chamadas:
  • TAB_SP_INTEGRACAO_FINANCEIRA_GERAR (se não for SyngentaComJangada ou Disam)
  • TAB_SP_INTEGRACAO_FINANCEIRA_GERAR_EMPRESA (se for SyngentaComJangada ou Disam)
• Parâmetros SQL:
  • @lstCodGrupoPagamento: Lista de códigos de grupo de pagamento (string concatenada).
  • @lstRpas: IDs de RPA (string concatenada).
  • @lstHolerites: IDs de holerites (string concatenada).
  • @lstPensoes: IDs de pensões (string concatenada).
  • @lstBeneficioFornecimento: IDs de benefícios de fornecimento (string concatenada).
  • @lstBeneficioFornecido: IDs de benefícios fornecidos (string concatenada).
  • @Idf_Empresa: ID da empresa.
  • @DtaDe: Data inicial (opcional).
  • @DtaAte: Data final (opcional).
  • @Idf_Atividade: ID da atividade.
• Regras de negócio:
  • A escolha da stored procedure de geração de lote depende do centro de serviço e de uma verificação específica para “SyngentaComJangada”.
  • O método SyngentaComJangada verifica se o centroServico é “SYNGENTACOM” e se o CNPJ da empresa está em uma lista predefinida de CNPJs da Jangada.
• Exceções:
  • SqlException: Capturada e relançada após rollback.

IntegracaoFinanceiraClienteLoteHoleriteVerba

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\IntegracaoFinanceiraClienteLoteHoleriteVerba_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\IntegracaoFinanceiraClienteLoteHoleriteVerba_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de IntegracaoFinanceiraClienteLoteHoleriteVerba já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idIntegracaoFinanceiraClienteLoteHoleriteVerba)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Integracao_Financeira_Cliente_Lote_Holerite_Verba.
  2. Atribui o idIntegracaoFinanceiraClienteLoteHoleriteVerba ao parâmetro.
  3. Executa uma instrução DELETE FROM TAB_Integracao_Financeira_Cliente_Lote_Holerite_Verba WHERE Idf_Integracao_Financeira_Cliente_Lote_Holerite_Verba = @Idf_Integracao_Financeira_Cliente_Lote_Holerite_Verba.
• Stored Procedures chamadas:
  • DELETE FROM TAB_Integracao_Financeira_Cliente_Lote_Holerite_Verba WHERE Idf_Integracao_Financeira_Cliente_Lote_Holerite_Verba = @Idf_Integracao_Financeira_Cliente_Lote_Holerite_Verba (SQL inline)
• Parâmetros SQL:
  • @Idf_Integracao_Financeira_Cliente_Lote_Holerite_Verba: ID da verba de holerite do lote de integração financeira a ser excluída.

ListarHoleriteVerbas (primeira sobrecarga)

• Lógica:
  1. Prepara uma lista de SqlParameter com os filtros fornecidos (empresa, filial, centro de resultado, empregado, período de data, código do grupo de pagamento).
  2. Adiciona parâmetros para paginação (@inicio, @fim) e ordenação (@nmeColunaOrdenacao, @desDirecaoOrdenacao).
  3. Constrói uma consulta SQL dinâmica complexa (SPSELECTHOLERITEVERBASNOVACONSULTARPA ou SPSELECTHOLERITEVERBASNOVACONSULTAFOLHA dependendo do contexto, mas o código mostra apenas RPA).
  4. A consulta dinâmica inclui: a. Declaração de variáveis SQL para os parâmetros de entrada. b. Lógica para determinar a data de vencimento com base em regras de dia de pagamento (dia útil anterior/posterior, mês atual/posterior/competência). c. Seleção de dados de TAB_RPA, TAB_RPA_verba, TAB_Verba, TAB_filial, TAB_empresa, TAB_centro_resultado, TAB_Integracao_Financeira_Cliente_Grupo_Pagamento_Verba, TAB_Integracao_Financeira_Cliente_Grupo_Pagamento, TAB_Periodo_Calculo, TAB_Arquivo_Gerado_autonomo, TAB_Arquivo_Gerado_Lote, TAB_Arquivo_Gerado, plataforma.TAB_Forma_Pagamento. d. Filtros por período de pagamento, centro de resultado, empresa, filial, grupo de pagamento. e. Exclui verbas já transmitidas (NOT EXISTS em TAB_Integracao_Financeira_Cliente_Lote_RPA_Verba). f. Utiliza tabelas temporárias (#Result, #X, #P) para agregar e paginar os resultados.
  5. Executa a consulta dinâmica para obter o número total de registros (totalRegistros).
  6. Executa a consulta dinâmica paginada para obter os dados.
  7. Retorna um DataTable com os resultados.
• Stored Procedures chamadas:
  • SPSELECTHOLERITEVERBASNOVACONSULTARPA (SQL inline dinâmico)
  • TAB_SF_ProximoDiaUtil (função de tabela)
• Parâmetros SQL:
  • @Idf_empresa, @Idf_Filial, @idf_Centro_Resultado, @Idf_Empregado, @DtaDe, @DtaAte, @Cod_Grupo_Pagamento, @inicio, @fim, @Des_Tipo_Pagamento, @DiaPagamentoDiaUtil.
• Regras de negócio:
  • Lógica complexa para cálculo da data de vencimento baseada em Cod_Tipo_Dia_Pagamento, Cod_Mes_Pagamento, Cod_Dia_Alternativo e DiaPagamentoDiaUtil.
  • Exclui verbas que já foram transmitidas com sucesso.

ParametroEspecifico

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\ParametroEspecifico_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\ParametroEspecifico_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de ParametroEspecifico já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idParametroEspecifico)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Parametro_Especifico e @Idf_Usuario_Gerador.
  2. Atribui o idParametroEspecifico e o CodigoUsuario da sessão aos parâmetros.
  3. Executa uma instrução SQL UPDATE para registrar o Idf_Usuario_Gerador antes de realizar o DELETE físico.
  4. Em seguida, executa a instrução DELETE FROM TAB_Parametro_Especifico WHERE Idf_Parametro_Especifico = @Idf_Parametro_Especifico.
• Stored Procedures chamadas:
  • UPDATE TAB_Parametro_Especifico SET Idf_Usuario_Gerador = @Idf_Usuario_Gerador WHERE Idf_Parametro_Especifico = @Idf_Parametro_Especifico (SQL inline)
  • DELETE FROM TAB_Parametro_Especifico WHERE Idf_Parametro_Especifico = @Idf_Parametro_Especifico (SQL inline)
• Parâmetros SQL:
  • @Idf_Parametro_Especifico: ID do parâmetro específico a ser excluído.
  • @Idf_Usuario_Gerador: ID do usuário que está realizando a exclusão (obtido da sessão).

RecuperarParametroEspecifico(Enumeradores.NomeParametro enumNomeParametro, Empresa objEmpresa, Filial objFilial, Contrato objContrato, Sindicato objSindicato, CentroResultado objCentroResultado, SqlTransaction trans)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Parametro.
  2. Adiciona parâmetros para @Idf_Empresa, @Idf_Filial, @Idf_Contrato, @Idf_Sindicato e @Idf_Centro_Resultado, atribuindo DBNull.Value se os objetos correspondentes forem NULL.
  3. Executa um IDataReader usando a função de tabela TAB_SF_Parametro_Especifico com os parâmetros fornecidos.
  4. Se houver um registro, lê o valor da coluna Vlr_Parametro e o atribui à variável resultado.
  5. Retorna o resultado.
• Stored Procedures chamadas:
  • TAB_SF_Parametro_Especifico (função de tabela)
• Parâmetros SQL:
  • @Idf_Parametro: ID do parâmetro (enum NomeParametro).
  • @Idf_Empresa: ID da empresa (opcional).
  • @Idf_Filial: ID da filial (opcional).
  • @Idf_Contrato: ID do contrato (opcional).
  • @Idf_Sindicato: ID do sindicato (opcional).
  • @Idf_Centro_Resultado: ID do centro de resultado (opcional).
• Regras de negócio:
  • A função de tabela TAB_SF_Parametro_Especifico é responsável por aplicar a hierarquia de parâmetros (empresa, filial, contrato, sindicato, centro de resultado) para retornar o valor mais específico.

PluginsCompatibilidade

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\PluginsCompatibilidade_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\PluginsCompatibilidade_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de PluginsCompatibilidade já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idPluginsCompatibilidade)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Plugins_Compatibilidade.
  2. Atribui o idPluginsCompatibilidade ao parâmetro.
  3. Executa uma instrução DELETE FROM plataforma.TAB_Plugins_Compatibilidade WHERE Idf_Plugins_Compatibilidade = @Idf_Plugins_Compatibilidade.
• Stored Procedures chamadas:
  • DELETE FROM plataforma.TAB_Plugins_Compatibilidade WHERE Idf_Plugins_Compatibilidade = @Idf_Plugins_Compatibilidade (SQL inline)
• Parâmetros SQL:
  • @Idf_Plugins_Compatibilidade: ID da compatibilidade de plugins a ser excluída.

CarregarPorMetadata(String metaPluginEntrada, String metaPluginSaida)

• Lógica:
  1. Cria uma lista de SqlParameter para @Des_Plugin_Metadata_Entrada e @Des_Plugin_Metadata_Saida.
  2. Atribui as strings de metadata aos parâmetros.
  3. Executa um IDataReader usando a consulta SPCARREGARPORMETADATA (SELECT pc.* FROM plataforma.TAB_Plugins_Compatibilidade pc JOIN plataforma.TAB_Plugin pe ON (pc.Idf_Plugin_Entrada = pe.Idf_Plugin) JOIN plataforma.TAB_Plugin ps ON (pc.Idf_Plugin_Saida = ps.Idf_Plugin) WHERE pe.Des_Plugin_Metadata = @Des_Plugin_Metadata_Entrada AND ps.Des_Plugin_Metadata = @Des_Plugin_Metadata_Saida).
  4. Cria uma nova instância de PluginsCompatibilidade.
  5. Chama o método auxiliar SetInstance(dr, objCompatibilidade) para preencher a instância.
  6. Se a instância for preenchida, retorna o objeto; caso contrário, retorna null.
• Stored Procedures chamadas:
  • SPCARREGARPORMETADATA (SQL inline)
• Parâmetros SQL:
  • @Des_Plugin_Metadata_Entrada: Metadata do plugin de entrada.
  • @Des_Plugin_Metadata_Saida: Metadata do plugin de saída.

ProcessoAssincrono

Arquivo: C:\Webfopag\Etec.WebFopag\Employer.PlataformaServices\ProcessosAssincronos\ProcessoAssincrono.cs

Métodos

Detalhamento de Métodos Importantes

IniciarAtividade(…)

• Lógica:
  1. Validação: Verifica se objPluginComp é nulo, lançando ArgumentNullException se for.
  2. Carregamento de Plugin: Completa o objeto PluginEntrada do objPluginComp.
  3. Criação da Atividade: a. Instancia um novo objeto Atividade. b. Atribui objPluginComp, DescricaoParametrosEntrada (convertido de ParametroExecucaoCollection para XML), DescricaoParametrosSaida (convertido para XML), DataAgendamento, Empresa, StatusAtividade (AguardandoExecucao), AtividadeLote (se idLoteAtividade tiver valor), AtividadeOrigem (se origem tiver valor), e IdPlugin. c. Converte parametrosEntrada para JSON e armazena em objAtividade.Parametros. d. Se houver tipoSaida, atribui-o. e. Se houver anexo, chama SalvarArquivoAnexo para salvar o arquivo e armazena o caminho em DescricaoCaminhoArquivoUpload.
  4. Persistência da Atividade: a. Tenta salvar a objAtividade no banco de dados (objAtividade.Save()). b. Em caso de AtividadeAvisoException, retorna um Atividade.AvisoAtividade com o aviso. c. Em caso de outras exceções, registra o erro no log (PlataformaLog.LogError.WriteLog), cria um Atividade.AvisoAtividade com a mensagem de erro e o ID do log, e retorna.
  5. Enfileiramento da Atividade: a. Carrega o pluginEntrada novamente para verificar IdCriticidade. b. Se IdCriticidade tiver valor, chama EnviarRabbitMQ para enviar a mensagem para o RabbitMQ. c. Caso contrário, cria um QueueName com centroServico, tipoAtividade e IdSistema. d. Chama EnfileirarAtividade para enviar a mensagem para a fila do Message Queue. e. Em caso de erro no enfileiramento, chama GravarErroAtividade para registrar o erro na atividade.
  6. Retorno: Retorna um Atividade.AvisoAtividade com o IdAtividade gerado.
• Stored Procedures chamadas:
  • objAtividade.Save() (método da BLL Atividade, que internamente fará INSERT/UPDATE)
  • Plugin.LoadObject (método da BLL Plugin)
  • SalvarArquivoAnexo (método da própria classe ProcessoAssincrono)
  • EnviarRabbitMQ (método da própria classe ProcessoAssincrono)
  • EnfileirarAtividade (método da própria classe ProcessoAssincrono)
  • GravarErroAtividade (método da própria classe ProcessoAssincrono)
• Validações:
  • ArgumentNullException se objPluginComp for nulo.
• Regras de negócio:
  • A atividade é criada com status “Aguardando Execução”.
  • O enfileiramento pode ser via RabbitMQ (se IdCriticidade estiver definido) ou Message Queue tradicional.
  • Anexos são salvos em um diretório configurado (CaminhoAnexosProcAssinc).
• Exceções:
  • ArgumentNullException
  • AtividadeAvisoException
  • Exception (erros gerais de persistência ou enfileiramento)

ExcluirArquivo(String caminhoDiretorio, String nomeArquivo, int IdAtividade) (método privado)

• Lógica:
  1. Tenta excluir o arquivo.
  2. Verifica se é URL: Se nomeArquivo for uma URL, utiliza StorageAzure para excluir o arquivo do Azure Blob Storage.
  3. Exclusão local: Se não for URL, utiliza TxFileManager (transacional) para excluir o arquivo do sistema de arquivos local. a. Verifica se o diretório existe, lançando FileNotFoundException se não. b. Combina caminhoDiretorio e nomeArquivo para obter o caminho completo. c. Chama fileMgr.Delete(caminhoArquivo).
  4. Após a exclusão do arquivo, chama Atividade.Delete2(IdAtividade) para remover o registro da atividade do banco de dados.
  5. Comita a transação (se for local).
  6. Retorna null em caso de sucesso.
  7. Em caso de exceção, registra o erro no log (PlataformaLog.LogError.WriteLog) e retorna a exceção.
• Stored Procedures chamadas:
  • Atividade.Delete2 (método da BLL Atividade)
• Validações:
  • FileNotFoundException se o diretório não existir para exclusão local.
• Exceções:
  • FileNotFoundException
  • Exception (erros gerais de exclusão de arquivo ou banco de dados)

RecuperarAtividadesNaFila(…)

• Lógica:
  1. Instancia uma Collection<TarefaAssincrona>.
  2. Chama Atividade.RecuperaAtividadesGrid para obter um DataTable com as atividades na fila, aplicando paginação, condições e ordenação.
  3. Se o DataTable não for nulo e tiver linhas, chama AjustarDadosBusca para realizar ajustes específicos (ex: para módulo Safra Misto).
  4. Recupera URLs de download de anexos e arquivos gerados do dicionário (Dicionario.RecuperaValorDicionario).
  5. Itera sobre cada DataRow do dtAtividades: a. Chama TarefaAssincrona.LoadFromDataRow para criar uma instância de TarefaAssincrona a partir da linha de dados, passando as URLs de download. b. Adiciona a TarefaAssincrona à coleção tarefas.
  6. Retorna a coleção tarefas.
• Stored Procedures chamadas:
  • Atividade.RecuperaAtividadesGrid (método da BLL Atividade)
  • Dicionario.RecuperaValorDicionario (método da BLL Dicionario)
• Regras de negócio:
  • AjustarDadosBusca pode modificar a descrição do plugin para relatórios específicos.

TipoEstruturaGerencial

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\TipoEstruturaGerencial_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\TipoEstruturaGerencial_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de TipoEstruturaGerencial já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idTipoEstruturaGerencial)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Tipo_Estrutura_Gerencial.
  2. Atribui o idTipoEstruturaGerencial ao parâmetro.
  3. Executa uma instrução DELETE FROM plataforma.TAB_Tipo_Estrutura_Gerencial WHERE Idf_Tipo_Estrutura_Gerencial = @Idf_Tipo_Estrutura_Gerencial.
• Stored Procedures chamadas:
  • DELETE FROM plataforma.TAB_Tipo_Estrutura_Gerencial WHERE Idf_Tipo_Estrutura_Gerencial = @Idf_Tipo_Estrutura_Gerencial (SQL inline)
• Parâmetros SQL:
  • @Idf_Tipo_Estrutura_Gerencial: ID do tipo de estrutura gerencial a ser excluído.

Listar()

• Lógica:
  1. Constrói uma consulta SQL simples: SELECT Idf_Tipo_Estrutura_Gerencial, Des_Tipo_Estrutura_Gerencial FROM plataforma.TAB_Tipo_Estrutura_Gerencial.
  2. Executa a consulta usando DataAccessLayer.ExecuteReaderDs sem parâmetros.
  3. Retorna a primeira tabela do DataSet resultante.
• Stored Procedures chamadas:
  • SPLISTAR (SQL inline: SELECT Idf_Tipo_Estrutura_Gerencial, Des_Tipo_Estrutura_Gerencial FROM plataforma.TAB_Tipo_Estrutura_Gerencial)
• Parâmetros SQL: Nenhum.

UIHelper

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

Métodos

Detalhamento de Métodos Importantes

CarregarGridView(EmployerGrid gv, DataTable dataSource, int itemCount)

• Lógica:
  1. Atribui itemCount à propriedade MockItemCount do EmployerGrid.
  2. Atribui o dataSource ao DataSource do EmployerGrid.
  3. Chama gv.DataBind() para vincular os dados à grid.
  4. Se dataSource não for nulo, chama dataSource.Dispose() para liberar recursos.
• Regras de negócio:
  • O EmployerGrid é um controle customizado que permite definir uma contagem de itens mockada (MockItemCount), útil para paginação customizada.
  • Garante a liberação de recursos do DataTable.

AjustarString(string entrada)

• Lógica:
  1. Remove espaços em branco no início e fim da string (entrada.Trim()).
  2. Substitui múltiplas ocorrências de espaços por um único espaço.
  3. Capitaliza a primeira letra de cada palavra na string (chama FormatarPrimeiraMaiscula).
  4. Substitui palavras auxiliares (“De”, “E”, “Do”, “Dos”, “Da”, “Para”) por suas versões em minúsculas.
  5. Realiza uma tratativa específica para números romanos (II, III, IV, etc.), garantindo que permaneçam em maiúsculas.
  6. Retorna a string ajustada.
• Regras de negócio:
  • Padronização de strings para exibição ou armazenamento, garantindo formatação consistente.
  • Tratamento especial para números romanos.

PrevenirDuploClick(WebControl control, Page page, String validationGroup = null)

• Lógica:
  1. Adiciona um atributo onclick ao controle control.
  2. O script onclick verifica se a validação do cliente (Page_ClientValidate()) é bem-sucedida.
  3. Se a validação for bem-sucedida, desabilita o botão (this.disabled = true;) para prevenir múltiplos cliques.
  4. Dispara o postback do controle (page.ClientScript.GetPostBackEventReference(control, null)).
  5. Retorna false para cancelar o evento padrão do clique.
  6. Se um validationGroup for fornecido, a validação do cliente é restrita a esse grupo.
• Regras de negócio:
  • Previne o envio de múltiplos formulários ou a execução de ações repetidas por cliques rápidos no botão.
  • Integra-se com o sistema de validação de cliente do ASP.NET.

Usuario

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Usuario_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Usuario_P2.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL.Login\Usuario_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL.Login\Usuario_P2.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL.STS\Usuario_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL.STS\Usuario_P2.cs

Métodos

Detalhamento de Métodos Importantes

Save()

• Lógica:
  1. Verifica se a instância de Usuario já foi persistida (_persisted).
  2. Se não foi persistida, chama o método Insert() para inserir um novo registro.
  3. Se já foi persistida, chama o método Update() para atualizar o registro existente.

Save(SqlTransaction trans)

• Lógica:
  1. Similar ao Save() sem transação, mas executa as operações Insert(trans) ou Update(trans) dentro da transação SQL fornecida.
  2. Isso garante que as operações de inserção ou atualização façam parte de uma unidade de trabalho atômica.

Delete(int idUsuario)

• Lógica:
  1. Cria uma lista de SqlParameter para @Idf_Usuario e @Idf_Usuario_Gerador.
  2. Atribui o idUsuario e o CodigoUsuario da sessão aos parâmetros.
  3. Executa uma instrução SQL UPDATE para registrar o Idf_Usuario_Gerador antes de realizar o DELETE físico.
  4. Em seguida, executa a instrução DELETE FROM TAB_Usuario WHERE Idf_Usuario = @Idf_Usuario.
• Stored Procedures chamadas:
  • UPDATE TAB_Usuario SET Idf_Usuario_Gerador = @Idf_Usuario_Gerador WHERE Idf_Usuario = @Idf_Usuario (SQL inline)
  • DELETE FROM TAB_Usuario WHERE Idf_Usuario = @Idf_Usuario (SQL inline)
• Parâmetros SQL:
  • @Idf_Usuario: ID do usuário a ser excluído.
  • @Idf_Usuario_Gerador: ID do usuário que está realizando a exclusão (obtido da sessão).

Autenticar(string enderecoIP, decimal login, string senha, Sistema.Nome sistema, out string aviso, out bool alterarSenha, out string chave)

• Lógica:
  1. Inicializa alterarSenha como false e chave como null.
  2. Abre uma conexão SQL e inicia uma transação.
  3. Verifica Bloqueio Temporário: Chama LoginBloqueado.VerificaBloqueioTemporario(login) para verificar se o login está temporariamente bloqueado. Se sim, define aviso e retorna false.
  4. Carrega Usuário: Tenta carregar o usuário por login e senha usando Usuario.CarregarPorLoginSenha(trans, login, senha, out objUsuario).
  5. Verifica Credenciais: a. Se o login for bem-sucedido: i. Se o usuário estiver bloqueado (objUsuario.FlagBloqueado), define aviso e retorna false. ii. Se o usuário estiver inativo (objUsuario.FlagInativo), define aviso e retorna false. iii. Se o usuário não tiver permissão para o sistema (!UsuarioSistema.Autenticar(trans, objUsuario.IdUsuario, (int)sistema)), define aviso e retorna false. iv. Verifica Histórico de Senha:
• Recupera o último histórico de senha do usuário (HistoricoSenha.UltimoHistorico).
• Calcula o tempo restante para expiração da senha com base em Num_Dias_Expira e Num_Dias_Aviso do AppSettings.
• Define alterarSenha e aviso com base na expiração da senha.
• Se a senha não expirou e não precisa ser alterada, define autentica = true, aviso como mensagem de sucesso e gera uma chave de sessão.
• Se não houver histórico de senha, cria um novo, define autentica = true e aviso como mensagem de sucesso. b. Se o login falhar: i. Define aviso como mensagem de erro de login. ii. Registra a tentativa de login inválida em LoginInvalido.

6. Finaliza Transação: a. Se autentica for true, chama Login.LoginValido(trans, objUsuario, enderecoIP) e comita a transação. b. Se autentica for false, chama Login.LoginInvalido(trans, objUsuario, enderecoIP) e comita a transação.
7. Retorna o status da autenticação.

• Stored Procedures chamadas:
  • LoginBloqueado.VerificaBloqueioTemporario (método de outra BLL)
  • Usuario.CarregarPorLoginSenha (método da própria classe)
  • UsuarioSistema.Autenticar (método de outra BLL)
  • HistoricoSenha.UltimoHistorico (método de outra BLL)
  • objUsuario.Save(trans) (método da própria classe)
  • HistoricoSenha.Save(trans) (método de outra BLL)
  • Recuperacao.Save(trans) (método de outra BLL)
  • LoginInvalido.Save() (método de outra BLL)
  • Login.LoginValido (método de outra BLL)
  • Login.LoginInvalido (método de outra BLL)
• Parâmetros SQL:
  • @Log_Usuario: CPF do usuário.
  • @Sen_Usuario: Senha do usuário (criptografada).
  • @Idf_Usuario: ID do usuário.
  • @Idf_Sistema: ID do sistema.
• Validações:
  • Bloqueio temporário de login.
  • Status do usuário (bloqueado, inativo).
  • Permissão do usuário para o sistema.
  • Expiração da senha.
• Regras de negócio:
  • Gerenciamento de tentativas de login e bloqueio temporário.
  • Controle de expiração de senha e obrigatoriedade de alteração.
  • Registro de histórico de senhas.
  • Geração de chave de sessão para usuários autenticados.
• Exceções:
  • Captura e relança exceções SQL e outras exceções.

Contrato

Arquivos: C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Contrato_P1.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Contrato_P2.cs C:\Webfopag\Etec.WebFopag\Employer.Plataforma.BLL\Contrato_P3.cs

Métodos

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