Gerador de Relatório

Transcrição

1 Gerador de Relatório O Gerador de Relatórios do Sistema Finanças permite criar relatórios personalizados com os dados da classificação financeira. Como funciona Você define o formato do seu relatório e o sistema faz o processamento necessário para a emissão do relatório. O texto fora dos colchetes são impressos no mesmo local em que é definido. O texto dentro dos colchetes (expressão) é processado e o resultado é impresso com o número de caracteres estipulados na mesma posição em que é definido. Linhas começadas com o caractere "$" representam macros ou comandos. Exemplo: Linha de definição: TOTAL DE RECEITAS NO PERÍODO: [<G1>,20] Linha impressa: TOTAL DE RECEITAS NO PERÍODO: ,00 Note que o valor foi impresso alinhado à direita com 20 caracteres. Expressão Existem dois tipos de expressões: cálculo e conteúdo. Expressão de Cálculo A expressão de cálculo permite você informar uma expressão matemática e a largura para impressão. Opcionalmente podem ser informadas variáveis para armazenar o valor calculado. A sintaxe é a seguinte (o que está entre "aspas" representa uma seqüência de caracteres e o que está entre colchetes representa a parte opcional: CALCULO::= "[" EXPRESSAO_MATEMATICA [ "," VARIAVEIS ] "," LARGURA "]" ou seja, CALCULO::= "[" EXPRESSAO_MATEMATICA "," LARGURA "]" ou CALCULO::= "[" EXPRESSAO_MATEMATICA "," VARIAVEIS "," LARGURA "]" Exemplos: [1000*5,20] [<G1>-<G2>,20] [1000*5,+TOTAL,20] [<G1>-<G2>,=RESULTADO,20] [<G1>,=RECEITAS +LUCRO,20] [<G2>,=DESPESAS -LUCRO,20] [RECEITAS-DESPESAS,=RESULTADO,20] [LUCRO,20] Os valores são atribuídos para as variáveis utilizando os operadores "+" (soma ao valor da variável), "-" (subtrai do valor da variável) ou "=" (atribui o valor para a variável). Podem ser especificas uma ou mais variáveis.

2 OBSERVAÇÃO: As variáveis são iniciadas com valor igual a zero. O nome da variável deve ser iniciado por uma letra e deve conter apenas letras, números ou "_" (exemplo: TOTAL, TOTAL_JANEIRO, TOTAL_01). Como seria processado o exemplo acima Vamos supor que o total de receitas é $ 1.500,00 e o total de despesas são $ 1.000,00: Expressão matemática A expressão matemática pode conter operadores ("*", "/", "-" e "+"), parênteses ("(" e ")"), valores, variáveis e contas. _ Valores: valor numérico sem separador de milhar e com as casas decimais separadas por.". Exemplo: 1000, , _ Variáveis: nome da variável (o valor atual da variável é utilizado para o cálculo). Exemplo: RECEITAS, DESPESAS, TOTAL_JANEIRO, TOTAL_01 _ Contas: expressão utilizada para obter o total da conta financeira (veja como a expressão é definida abaixo). Contas

3 DEFINICAO ::= PERIODO CONTA [CR] PERIODO ::= ( "G" "P" "R" ) [ "(" <INTEIRO> [ ":" <INTEIRO> ] ")" ] CONTA ::= <DIGITO> <DIGITO>"."<DIGITO><DIGITO> <DIGITO>"."<DIGITO><DIGITO>"."<DIGITO><DIGITO> <DIGITO>"."<DIGITO><DIGITO>"."<DIGITO><DIGITO>"."<DIGITO><DIGITO><DIGITO> CR ::= "(" NUMERO_CR ")" Explicação: Exemplo:

4 Expressão de conteúdo A expressão de conteúdo permite você obter valores especiais e a largura para impressão. A sintaxe é a seguinte (o que está entre "aspas" representa uma seqüência de caracteres e representa OU): CONTEUDO ::= "[" DESCRICAO "," LARGURA "]" DESCRICAO ::= "#" <TIPO> "(" FORMATO "," VALOR ")" TIPO ::= "CONTA" "CR" "DATA" FORMATO ::= <IDENTIFICADOR> VALOR ::= <INTEIRO> <TEXTO> Exemplos: [#DATA(DFDD_MM_AAAA,0),20] [#CONTA(DN,' ',20] DEFINIÇÃO EXEMPLO EXPLICAÇÃO PERIODO G Obtém o total da conta no período usando a data de geração. G(1) Obtém o total da conta no mês anterior (1) a data base usando a data de geração. G(1:2) Obtém o total da conta dos dois meses anteriores à data base usando a data de geração. G(4:6) Obtém o total da conta do quarto ao sexto meses anteriores à data base usando a data de geração. "G" "P" "R" A data a ser utilizada pode ser a data de geração, a data prevista (vencimento) ou data de realização. CONTA

5 1 A conta pode ser especificada com um único nível. Isto é equivalente à 1.00 ou ou A conta pode ser especificada com dois níveis. Isto é equivalente à ou A conta pode ser especificada com três níveis. Isto é equivalente à A conta pode ser especificada com quatro níveis. CR (VENDAS) Opcionalmente pode ser especificado o centro de resultado. Deve ser informado o código do centro de resultado entre parênteses. Note que o código pode ser composto por letras. Neste caso serão totalizadas as classificações para a conta e centro de resultados especificados. EXEMPLO EXPLICAÇÃO <G1> Total no período da conta considerando a data de geração; <G1 (VENDAS)> Total no período da conta considerando o centro de resultado; "VENDAS" e a data de geração; <G(0)> Total no mês base da conta considerando a data de geração; <G(4:6)2> Obtém o total da conta do quarto ao sexto meses anteriores à data base usando a data de geração; <R(10:12) (VENDAS)> Obtém o total da conta considerando o centro de resultado; "VENDAS". O período considerado será do décimo ao décimo - segundo meses anteriores à data base usando a data de realização. [#CONTA(DN,' ',20] [#CR(DN,25),20] DATA Possibilita a impressão de datas relativas ao período do relatório.

6 VALOR representa o número de meses em relação a data considerada. CONTA Possibilita a impressão do código e do nome da conta. CR Possibilita a impressão do código e do nome do centro de resultado. VALOR representa o código do centro de resultado. MACROS Macros são diretivas para o gerador efetuar uma operação especial. Abaixo são descritos e explicados os macros existentes. $REPETE: O macro $REPETE é utilizado para repetir o comando para cada conta ou para cada par (conta, centro de resultado). O campo entre colchetes são opcionais. As linhas serão repetidas:

7 FORMATO ::= A T [DIA] ["_"] [MES] ["_"] [ANO]. A ::= "E" "D" Indica se o conteúdo deve ser alinhado à ESQUERDA ou DIREITA. T ::= "I" "F" "B" Indica se deve ser considerada a DATA DE INICIO, FINAL ou a DATA BASE. DIA ::= "DD" Dia da data com dois dígitos. "_" substitui por uma "/". MES ::= "MMM" "MM" "M". "MMM" mês da data com três caracteres (JAN, FEV, MAR,..., DEZ). "MM" mês da data com dois dígitos. "M" mês da data completo (JANEIRO, FEVEREIRO, MARÇO,..., DEZEMBRO). "_" substitui por uma "/". ANO ::= "AA" "AAAA". "AA" ano da data com dois dígitos. "AAAA" ano da data com quatro dígitos. FORMAT ::= A T A ::= "E" "D" Indica se o conteúdo deve ser alinhado à ESQUERDA ou DIREITA. T ::= "N" "C" NOME CODIGO Indica se será impresso o nome ou o código da conta. FORMAT ::= A T A ::= "E" "D" Indica se o conteúdo deve ser alinhado à ESQUERDA ou DIREITA. T ::= "N" "C" NOME CODIGO Indica se será impresso o nome ou o código do centro de resultado (conta, centro de resultado). Os campos entre colchetes são opcionais. As linhas serão repetidas até ser encontrado o macro $REPETE_FIM. Funcionamento: para cada repetição, todo o texto encontrado até o macro $REPETE_FIM será pré-processado. _ A sequência #CONTA# será substituída pelo código da conta. _ A seqüência #CR# será substituída pelo código do centro de resultado. Sintaxe: REPETE ::= "$REPETE" [CONTA] [CR] [ZEROS] Estrutura do Macro CONTA ::= "CONTA" CODIGO GRAU Indica quais contas serão processadas. Sua omissão é equivalente à: CONTA TODAS 4. CODIGO ::= "TODAS" NR_PLANFIN Filtra as contas a serem processadas. Por exemplo, 1 implica que todas as contas começadas com 1 serão processadas indicam as contas começadas com "TODAS" é uma diretiva especial para indicar que todas as contas devem ser processadas. GRAU ::=

8 Grau indica o nível de detalhamento do relatório. 1 indica as contas com a forma X indica as contas com a forma X.YY indica as contas com a forma X.YY.WW indica as contas com a forma X.YY.WW.ZZZZ CR ::= "CR" Indica para efetuar a repetição para cada centro de resultado cadastrado. ZEROS ::= "ZEROS" Indica para imprimir linhas totalmente zeradas. Sua omissão indica que linhas totalmente zeradas não serão impressas. Exemplos: $REPETE_FIM Indica o final do comando repete. EXEMPLO EXPLICAÇÃO $REPETE Semelhante à $REPETE CONTA TODAS 4 $REPETE CONTA TODAS 4 Repete o corpo do comando para todas as contas até grau 4. $REPETE CONTA TODAS 3 Repete o corpo do comando para todas as contas até grau 3. $REPETE CONTA TODAS 4 CR ZEROS Repete o corpo do comando para todas as contas até grau 4 e centro de resultados. As linhas zeradas serão impressas. $REPETE CONTA 1 4 CR ZEROS Repete o corpo do comando para todas as contas começadas com "1" até grau 4 e centro de resultados. As linhas zeradas serão impressas. $REPETE CONTA CR ZEROS Semelhante à $REPETE CONTA 1 4 CR ZEROS

9 $REPETE_CABECALHO, $REPETE_CABECALHO_FIM, $REPETE_RODAPE, $REPETE_RODAPE_FIM Opcionalmente pode haver comandos à serem repetidos por centro de resultado ao invés de serem repetidos à cada conta. Os comandos a serem impressos no cabeçalho são delimitados por: $REPETE_CABECALHO... $REPETE_CABECALHO_FIM Os comandos a serem impressos no rodapé são delimitados por: $REPETE_RODAPE... $REPETE_RODAPE_FIM Exemplo de um balancete por data de geração para cada centro de resultado: Explicação:

10