Package br.com.intersys.systextil.function

Class GeraContab

java.lang.Object

br.com.intersys.systextil.function.GeraContab

Direct Known Subclasses:

GeraLancContab

public class GeraContab
extends Object

Implementa a função gera_contab do Vision.

Este classe foi toda refatorada para fornecer métodos mais específicos para serem usados conforme a necessidade. Estes novos métodos sugerem melhoria de desempenho, por não refazer validações que a aplicação já fez, e também por reaproveitar objetos que a aplicação já possui - p. ex. Exercicio.

Nas situações mais triviais, simplesmente chame o método executar(br.com.intersys.systextil.connection.AppConnection, br.com.intersys.systextil.global.Mdi, java.lang.String, java.lang.String, int, int, int, int, java.util.Date, int, java.lang.String, int, int, int, double, int, double, int, int, java.util.Date, int) e trate as mensagens de retorno.

Onde a aplicação estiver sendo refatorada para melhor qualidade, dê preferência a invocar o construtor e o método mais apropriado para a situação.

Field Summary

Fields

Modifier and Type	Field	Description
int	versao_systextilweb_f

Constructor Summary

Constructors

Constructor	Description
GeraContab(br.com.intersys.systextil.connection.AppConnection conn, Mdi mdi, String nome_form, int cod_empresa, Exercicio exercicio, Date data_lancto)	Construtor a ser usado por programas normais que usam MDI.
GeraContab(br.com.intersys.systextil.connection.AppConnection conn, String nome_form, int cod_empresa, Exercicio exercicio, Date data_lancto)	Construtor a ser usado por programas de integração que não usam MDI.

Method Summary

Modifier and Type	Method	Description
void	cancelarDocumentos(int num_lanc, int hist_contabil)	Executa a rotina correspondente a estorno = 3.
static int	executar(br.com.intersys.systextil.connection.AppConnection conn, Mdi mdi, String nome_form, String usuario, int cod_empresa, int origem, int num_lanc, int centro_custo, Date data_lancto, int hist_contabil, String compl_histor1, int estorno, int transacao, int conta_debito, double valor_debito, int conta_credito, double valor_credito, int banco_func, int conta_func, Date data_func, int docto_func)	Este é o método estático original convertido diretamente do Vision para Java.
int	gerarContab(int origem, int num_lanc, int centro_custo, int hist_contabil, String compl_histor1, int estorno, int transacao, int conta_debito, double valor_debito, int conta_credito, double valor_credito, ContaBancaria contaFunc, Date data_func, int docto_func)	Gera contabilização pelo processo normal.
TagWarning	getErrors()	Retorna as mensagens com os problemas ocorridos nos lançamentos, ou nulo se não houver.

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

Constructor Details

GeraContab

public GeraContab(br.com.intersys.systextil.connection.AppConnection conn,
 Mdi mdi,
 String nome_form,
 int cod_empresa,
 Exercicio exercicio,
 Date data_lancto)

Construtor a ser usado por programas normais que usam MDI.

GeraContab

public GeraContab(br.com.intersys.systextil.connection.AppConnection conn,
 String nome_form,
 int cod_empresa,
 Exercicio exercicio,
 Date data_lancto)

Construtor a ser usado por programas de integração que não usam MDI.

Method Details

executar

public static int executar(br.com.intersys.systextil.connection.AppConnection conn,
 Mdi mdi,
 String nome_form,
 String usuario,
 int cod_empresa,
 int origem,
 int num_lanc,
 int centro_custo,
 Date data_lancto,
 int hist_contabil,
 String compl_histor1,
 int estorno,
 int transacao,
 int conta_debito,
 double valor_debito,
 int conta_credito,
 double valor_credito,
 int banco_func,
 int conta_func,
 Date data_func,
 int docto_func)
                    throws TagWarning

Este é o método estático original convertido diretamente do Vision para Java. Costuma ser usado onde a conversão para Java foi feita sem refatoração. Está aqui por razões históricas.

Quando possível, é melhor utilizar outras formas mais exatas de gerar contabilidade, usando os construtores e os métodos mais apropriados para a situação.

Este método não valida o exercício encontrado (pressupõe que a aplicação já o validou antes). Aplica regras diferentes conforme o formulário chamador e o código de transação informado. Dependendo dos parâmetros, executa o processo de cancelamento de documentos ou o processo normal. Muitos dos parâmetros deste método não são usados no processo de cancelamento de documentos.

Este método não retorna o valor de num_lanc se tiver ocorrido problema em algum lançamento, pois lança uma mensagem. Mais uma razão para dar preferência a usar um dos outros métodos mais específicos desta classe.

Funções não devem executar COMMIT. Por isso, a aplicação deve efetuar COMMIT após invocar este método.

Parameters:

usuario - não é usado, pois o usuário é obtido da Mdi ou do programa gerador

hist_contabil - no Vision pode ser nulo, mas em Java não; por isso, em Java trata o caso de ser zero em vez de null, se for cancelamento de documentos.

estorno - se for 3, executa o processo de cancelamento de documentos. Caso contrário, executa o processo normal.

Returns:

o valor de num_lanc usado por último

Throws:

TagWarning - informando quais foram os lançamentos mal sucedidos, e a causa

cancelarDocumentos

public void cancelarDocumentos(int num_lanc,
 int hist_contabil)
                        throws TagWarning

Executa a rotina correspondente a estorno = 3. O valor de num_lanc não é alterado; por isto este método retorna void.

Funções não devem executar COMMIT. Por isso, a aplicação deve efetuar COMMIT após invocar este método.

Parameters:

hist_contabil - no Vision pode ser nulo, mas em Java não; por isso, em Java trata o caso de ser zero em vez de null. Será que isto está certo?

Throws:

TagWarning - informando quais foram os lançamentos mal sucedidos, e a causa

gerarContab

public int gerarContab(int origem,
 int num_lanc,
 int centro_custo,
 int hist_contabil,
 String compl_histor1,
 int estorno,
 int transacao,
 int conta_debito,
 double valor_debito,
 int conta_credito,
 double valor_credito,
 ContaBancaria contaFunc,
 Date data_func,
 int docto_func)

Gera contabilização pelo processo normal. Pressupõe que o exercício, o período contábil, a transação e o programa chamador já foram validados para a empresa em questão.

Não lança TagWarning, pois, da maneira como o Systêxtil funciona atualmente, é necessário retornar o num_lanc encontrado, mesmo que algum dos lançamentos tenha falhado. Talvez isso realmente não seja necessário, mas, por via das dúvidas, está feito assim. Para saber se ocorreu algum problema nos lançamentos, consultar getErrors().

Funções não devem executar COMMIT. Por isso, a aplicação deve efetuar COMMIT após invocar este método.

Returns:

o valor de num_lanc usado por último

getErrors

public TagWarning getErrors()

Retorna as mensagens com os problemas ocorridos nos lançamentos, ou nulo se não houver. Só é útil após invocar gerarContab(int, int, int, int, java.lang.String, int, int, int, double, int, double, systextil.dao.ContaBancaria, java.sql.Date, int)