ExecutaRelatorio
Permite que sejam executados relatórios através das regras.
Existem algumas funções de programador desenvolvidas para esta situação, elas devem ser utilizadas em conjunto. São elas:
- SetaNumeroTelaEntrada(Alfa NomeCampo, Numero Valor);
- SetaDataTelaEntrada(Alfa NomeCampo, Numero Valor);
- SetaAlfaTelaEntrada(Alfa NomeCampo, Alfa Valor);
- EscondeCampoTelaEntrada(Alfa NomeCampo);
- ExecutaRelatorio(Alfa NomeModelo, Alfa ExibirTelaEntrada);
O funcionamento depende da seguinte combinação:
- Utilizar as funções SetaNumeroTelaEntrada, SetaDataTelaEntrada e SetaAlfaTelaEntrada, de acordo com o tipo de variável que contém o parâmetro passado.
- Função EscondeCampoTelaEntrada deve ser utilizada quando esconder apenas alguns campos.
- ExecutaRelatorio, especifica o nome do relatório e se a tela de entrada será exibida (S) ou não (N).
Observação
Ao parametrizar a função ExecutaRelatorio para não exibir a tela de entrada (parâmetro ExibirTelaEntrada igual a "N – Não"), caso alguma entrada não seja informada via regra (através das funções listadas acima) e na entrada esteja marcada a opção Relacionar SQL, o relatório será gerado utilizando os valores salvos na propriedade "Salvar Entrada" do modelo.
Além disso, o valor da propriedade "Salvar Entrada" precisa estar definido como "Verdadeiro".
Sintaxe: ExecutaRelatorio(Alfa NomeModelo, Alfa ExibirTelaEntrada);
Parâmetros:
Nome | Tipo | Descrição |
---|---|---|
NomeModelo | Alfa | Nome do modelo. |
ExibirTelaEntrada | Numérico | Indica se deverá ser mostrada ou não a tela de entrada do modelo (S - Sim, N - Não). |
Exemplo: Na regra da ação que o botão irá executar digite:
SetaDataTelaEntrada("EDatFim",DatSis); @ passa um valor para campo do tipo Data - sintaxe (alfa NomeDoCampo, data valor);
SetaAlfaTelaEntrada("EMosUsu","S"); @ passa um valor para campo do tipo Alfa - sintaxe (alfa NomeDoCampo, alfa valor);
SetaNumeroTelaEntrada("ESeqImp",5); @ passa um valor para campo do tipo Numero - sintaxe (alfa NomeDoCampo, Numero valor);
EscondeCampoTelaEntrada("EMosUsu"); @ o campo será escondido
EscondeCampoTelaEntrada("EDatFim");
ExecutaRelatorio("HRAC001.GER","N"); @ o relatório HRAC001.GER será gerado mas a tela de entrada não será exibida
Executar o modelo 26 da categoria "CL" do módulo Controle de Ponto e Refeitório, exibindo sua tela de entrada:
ExecutaRelatorio("HRCL026.GER", "S");
Utilização: Regras e Processos Automáticos.
Observação: Quando um relatório é chamado por esta função, o botão Repetir é escondido automaticamente na tela de Visualização do Relatório. Isto acontece porque muitas vezes a execução do modelo depende de valores que são alterados através da regra. Por isso não é possível executar o relatório novamente pelo botão Repetir, sendo necessário executar a regra novamente. Ao executar esta função em módulos Web 5.0 ou processos automáticos, a tela de entrada do relatório não será apresentada. Neste caso, o relatório deverá estar configurado com a saída para arquivo e, caso for necessário, especificar algum valor da tela de entrada. Será necessário definir os parâmetros via regra, através das funções SetaAlfaTelaEntrada, SetaDataTelaEntrada e SetaNumeroTelaEntrada. Além disso, o parâmetro ExibirTelaEntrada deve ser configurado com o valor "N – Não" quando executada na Web 5.0.
Em decorrência da compilação do relatório ser específica para cada módulo, um relatório de um determinado módulo pode não funcionar em outro. Portanto, recomendamos que esta função não seja utilizada para executar um relatório de outro módulo.
O relatório Relação INSS - FPRE001.PRE não pode ser listado por esta função, por se tratar de um relatório não padrão que não funciona de maneira convencional.