Tópicos Avançados

Pode incrementar os parâmetros da data e definir dinamicamente um nome do ficheiro de destino.

Incrementar Parâmetros de Datas

Pode fornecer expressões nos campos de parâmetros da data do relatório.

Se o relatório agendado incluir parâmetros da data, quando introduz valores para as datas da agenda, não pode alterar os valores da data. Sempre que uma instância agendada do relatório é executada, são utilizados os mesmos parâmetros da data. Se a alteração dos parâmetros da data for obrigatória para cada execução, pode introduzir uma expressão no campo de parâmetro da data do gestor da agenda para calcular a data sempre que a tarefa do relatório for executada.

Por exemplo, se criar uma agenda para um relatório que seja executado todas as segundas-feiras para capturar dados da semana anterior, é necessário atualizar os parâmetros da data para que o relatório seja incrementado nos primeiros e últimos dias da semana anterior.

Introduza uma das seguintes funções utilizando a sintaxe mostrada para calcular a data apropriada no runtime agendado para o relatório:

  • {$SYSDATE()$} - Data atual, a data do sistema do servidor em que o BI Publisher está a ser executado.

  • {$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 anterior

  • {$LAST_DAY_OF_YEAR()$} - Último dia do ano anterior

As chamadas de função de data nos valores dos parâmetros não são avaliadas até a tarefa do relatório ser processada pelo Gestor da Agenda.

Também pode introduzir expressões utilizando o sinal de mais (+) e o sinal de menos (-) para acrescentar ou subtrair dias da seguinte maneira:

  • {$SYSDATE()+1$}

  • {$SYSDATE()-7$}

Para este exemplo, para capturar dados da semana anterior, sempre que a agenda seja executada, introduza o seguinte nos campos dos parâmetros da data do relatório:

  • Da Data: {$SYSDATE()-7$}

  • À Data: {$SYSDATE()-1$}

Pode configurar as funções de data como valores de parâmetro por omissão no modelo de dados. Neste caso, sempre que um utilizador visualizar o relatório do visualizador do relatório, o parâmetro da data é calculado de acordo com a expressão fornecida para o valor por omissão.

Definir Dinamicamente um Nome de Ficheiro de Destino com uma Expressão de Data

Ao introduzir o nome do ficheiro remoto para uma pasta na Web ou destino de FTP, pode introduzir uma expressão de data para incluir dinamicamente no nome do ficheiro. A data é definida em runtime, utilizando o fuso horário do servidor.

As expressões de data são descritas na tabela seguinte.

Expressão Descrição

%y

Apresenta o ano em quatro dígitos: Exemplo: 2011

%m

Apresenta o mês em dois dígitos: 01-12 (onde 01 = janeiro)

%d

Apresenta a data em dois dígitos: 01-31

%H

Apresenta a hora em dois dígitos com base no formato de 24 horas: 00-24

%M

Apresenta o minuto em dois dígitos: 00 - 59

%S

Apresenta o número de segundos em dois dígitos: 00 - 59

%l

Apresenta os milésimos de segundo em três dígitos: 000 - 999

Exemplos

Utilize estes exemplo para criar um nome de ficheiro que anexa uma data e um nome de ficheiro que inclui uma data como prefixo e anexa uma hora.

Para criar um nome de ficheiro que anexa o dia, mês e ano, tal como:

myfile_01_11_2010.pdf

Introduza as seguintes informações:

myfile_%d_%m_%y.pdf

Para criar um nome de ficheiro que inclui o dia, mês e ano como prefixo e anexa a hora e minuto, tal como:

01_01_2010_myfile_22_57.pdf

Introduza as seguintes informações:

%d_%m_%y_myfile_%H_%M.pdf

Se o nome do ficheiro incluir uma expressão não definida tal como my_file_%a%b%c.pdf, o ficheiro é criado e nomeado como my_file_%a%b%c.pdf.