Você pode incrementar parâmetros de data e definir dinamicamente um nome de arquivo de destino.
Você pode fornecer expressões nos campos de parâmetro de data do relatório.
Se o relatório programado incluir parâmetros de data, quando você inserir valores para as datas da programação, não poderá alterar os valores de data. Cada vez que uma instância programada do relatório for executada, os mesmos parâmetros de data serão usados. Se for necessário alterar os parâmetros de data para cada execução, você poderá digitar uma expressão no campo de parâmetro de data do scheduler para calcular a data cada vez que o job de relatório for executado.
Por exemplo, se você criar uma programação para um relatório que é executado toda segunda-feira para capturar dados da semana anterior, será necessário atualizar os parâmetros de data para que o relatório seja incrementado para o primeiro e último dias da semana anterior.
Especifique uma das funções a seguir usando a mesma sintaxe mostrada para calcular a data apropriada no runtime programado para o relatório:
{$SYSDATE()$} - Data atual; a data do sistema do servidor no qual o BI Publisher está em execução.
{$FIRST_DAY_OF_MONTH()$} - Primeiro dia do mês atual
{$LAST_DAY_OF_MONTH()$} - Último dia do mês atual
{$FIRST_DAY_OF_YEAR()$} - Primeiro dia do ano atual
{$LAST_DAY_OF_YEAR()$} - Último dia do ano atual
As chamadas de função de data nos valores de parâmetro só são avaliadas quando o job de relatório é processado pelo Scheduler.
Você também pode inserir expressões usando os sinais de mais (+) e de menos (-) para somar ou subtrair dias, como se segue:
{$SYSDATE()+1$}
{$SYSDATE()-7$}
Nesse exemplo, para capturar dados da semana anterior, cada vez que a programação for executada, especifique o seguinte nos campos de parâmetro de data do relatório:
Data de Início: {$SYSDATE()-7$}
Data de Encerramento: {$SYSDATE()-1$}
Você pode configurar as funções de data como valores de parâmetro padrão no modelo de dados. Nesse caso, cada vez que um usuário exibir o relatório no visualizador de relatórios, o parâmetro de data será calculado de acordo com a expressão fornecida para o valor padrão.
Ao inserir o nome do arquivo remoto para uma pasta Web ou destino FTP, você pode inserir uma expressão de data para inclusão de forma dinâmica no nome do arquivo. A data é definida durante o runtime, usando o fuso horário do servidor.
As expressões de data são descritas na tabela a seguir.
Expressão | Descrição |
---|---|
%y |
Exibe o ano em quatro dígitos. Exemplo: 2011 |
%m |
Exibe o mês em dois dígitos: 01-12 (em que 01 = Janeiro) |
%d |
Exibe a data em dois dígitos: 01-31 |
%H |
Exibe a hora em dois dígitos, com base no dia de 24 horas: 00-24 |
%M |
Exibe o minuto em dois dígitos: 00 - 59 |
%S |
Exibe o número de segundos em dois dígitos: 00 - 59 |
-l |
Exibe os milissegundos em três dígitos: 000 - 999 |
Use esses exemplos para criar um nome de arquivo que anexe uma data e um nome de arquivo que prefixe uma data e anexe um horário.
Para criar um nome de arquivo que anexe o dia, mês e ano, como:
myfile_01_11_2010.pdf
Especifique o seguinte:
myfile_%d_%m_%y.pdf
Para criar um nome de arquivo que prefixe o dia, mês e ano e anexe a hora e o minuto, como:
01_01_2010_myfile_22_57.pdf
Especifique o seguinte:
%d_%m_%y_myfile_%H_%M.pdf
Se o nome do arquivo incluir uma expressão indefinida, como my_file_%a%b%c.pdf
, o arquivo será criado com o nome my_file_%a%b%c.pdf.