Package br.com.intersys.systextil.function

Class ChecaData

java.lang.Object
br.com.intersys.systextil.function.ChecaData
public class ChecaData extends Object
Contém métodos usados para obter o exercício contábil a ser usado para contabilização em certa data.

Esta classe foi refatorada para disponibilizar métodos que retornem Exercicio em vez de retornar simplesmente o código de um exercício. Isso tem a vantagem de fornecer um objeto pronto que pode ser reutilizado, em vez de ter que consultar seus dados novamente depois disso no processo. Esses métodos devem ser usados somente depois de validar se a empresa e a transação geram contabilização.

Poderia haver métodos que retornassem Exercicio já validando todas as regras, mas para isso eles teriam que lançar TagException. Como as mensagens de validação variam conforme o contexto nos programas do sistema, isto ainda não foi feito.

No caso mais geral, deve-se usar o método executar(br.com.intersys.systextil.connection.AppConnection, java.lang.String, int, java.sql.Date, int), que aplica regras específicas conforme o formulário chamador. No entanto, a maior parte das chamadas ainda utiliza o método executar(br.com.intersys.systextil.connection.AppConnection, int, java.util.Date, int) que utiliza as regras mais comuns.

Author:
sergio

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    ERROR_CODE
     
    int
    versao_systextilweb_f
     

  • Constructor Summary

    Constructors
    Constructor
    Description
    ChecaData()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static int
    executar(br.com.intersys.systextil.connection.AppConnection conn, int cod_empresa, Date data_lanc, int transacao)
    Método original da conversão da função checa_data para Java.
    static int
    executar(br.com.intersys.systextil.connection.AppConnection conn, String nome_form, int cod_empresa, Date data_lanc, int transacao)
    Executar este método em programas que possuem regras específicas, diferentes do padrão usado em executar(br.com.intersys.systextil.connection.AppConnection, int, java.util.Date, int).
    static Exercicio
    getExercicio(br.com.intersys.systextil.connection.AppConnection conn, String form_name, int empresa_matriz, Date data_lanc)
    Retorna um exercício validando sua situação zero e a do período contábil, conforme as regras informadas.
    static boolean
    transacaoGeraContabilizacao(br.com.intersys.systextil.connection.AppConnection conn, String nome_form, int transacao)
    Informa se a transação informada gera contabilização conforme atualiza_contabi igual a 1 ou 3.
    static boolean
    transacaoGeraContabilizacao(br.com.intersys.systextil.connection.AppConnection conn, Transacao transacao)
    Informa se a transação informada gera contabilização conforme atualiza_contabi igual a 1 ou 3.
    static boolean
    transacaoGeraContabilizacao(br.com.intersys.systextil.connection.AppConnection conn, Transacao transacao, boolean validarPorContabCardex)
    Informa se a transação informada gera contabilização.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • versao_systextilweb_f

      public int versao_systextilweb_f

    • ERROR_CODE

      public static final int ERROR_CODE
      See Also:

  • Constructor Details

    • ChecaData

      public ChecaData()

  • Method Details

    • executar

      public static int executar(br.com.intersys.systextil.connection.AppConnection conn, int cod_empresa, Date data_lanc, int transacao)
      Método original da conversão da função checa_data para Java. É o método usado na grande maioria dos programas do Systêxtil. Internamente, retorna o resultado de executar(br.com.intersys.systextil.connection.AppConnection, java.lang.String, int, java.sql.Date, int) para um formulário qualquer, que significa que é retornado um exercício aberto com um período contábil aberto, desde que a transação gere contabilização conforme o valor do campo atualiza_contabi.

    • executar

      public static int executar(br.com.intersys.systextil.connection.AppConnection conn, String nome_form, int cod_empresa, Date data_lanc, int transacao)
      Executar este método em programas que possuem regras específicas, diferentes do padrão usado em executar(br.com.intersys.systextil.connection.AppConnection, int, java.util.Date, int).
      Parameters:
      nome_form - o nome do programa chamador, para saber que regras aplicar
      cod_empresa - o código da empresa, usado para saber se gera contabilização e para saber o código da matriz
      data_lanc - a data do lançamento
      transacao - o código da transação, a ser usado em transacaoGeraContabilizacao(br.com.intersys.systextil.connection.AppConnection, int, boolean)
      Returns:
      0 para não gerar contabilidade, ERROR_CODE (-99) se não é encontrado um exercício válido, ou o código do exercício válido encontrado.

    • transacaoGeraContabilizacao

      public static boolean transacaoGeraContabilizacao(br.com.intersys.systextil.connection.AppConnection conn, String nome_form, int transacao)
      Informa se a transação informada gera contabilização conforme atualiza_contabi igual a 1 ou 3.
      Parameters:
      nome_form - o nome do formulário chamador, para ver se a validação é feita por contab_cardex ou atualiza_contabi
      transacao - o código da transação a validar; se for zero, o retorno é true
      Returns:
      se a transação gera contabilização conforme a regra do formulário

    • transacaoGeraContabilizacao

      public static boolean transacaoGeraContabilizacao(br.com.intersys.systextil.connection.AppConnection conn, Transacao transacao)
      Informa se a transação informada gera contabilização conforme atualiza_contabi igual a 1 ou 3.
      Parameters:
      transacao - a transação a validar; se for null, o retorno é false
      Returns:
      se a transação gera contabilização conforme atualiza_contabi

    • transacaoGeraContabilizacao

      public static boolean transacaoGeraContabilizacao(br.com.intersys.systextil.connection.AppConnection conn, Transacao transacao, boolean validarPorContabCardex)
      Informa se a transação informada gera contabilização. Considera atualiza_contabi igual a 1 ou 3.
      Parameters:
      transacao - a transação a validar; se for null, o retorno é false
      validarPorContabCardex - se a validação é feita por contab_cardex ou atualiza_contabi
      Returns:
      se a transação gera contabilização conforme a regra informada

    • getExercicio

      public static Exercicio getExercicio(br.com.intersys.systextil.connection.AppConnection conn, String form_name, int empresa_matriz, Date data_lanc) throws TagException
      Retorna um exercício validando sua situação zero e a do período contábil, conforme as regras informadas. Este método só deve ser usado quando se tem certeza de que a empresa gera contabilização, e a transação também, se não for zero. Portanto, tem que retornar um exercício válido.
      Parameters:
      form_name - o nome do formulário chamador, que define se vai validar exercício e/ou período contábil
      empresa_matriz - o código da empresa matriz, conforme configurado para a empresa.
      Returns:
      o exercício encontrado. Nunca retorna nulo.
      Throws:
      TagException - com mensagem padrão avisando que o exercício não foi encontrado:
      # ATENÇÃO! Exercício e/ou periodo não encontrado ou fechado.
      # Esta transação não será permitida.
      # Avise ao contador.