Nesta seção: |
Quando a ferramenta de Agendamento Básico é acessada, as informações para as opções da guia Tarefas são predefinidas com os detalhes do procedimento de relatório (FEX) selecionado. Você pode preencher as opções de tarefa disponíveis, como valores de parâmetro, assim como selecionar se deseja executar o burst do relatório.
A seguinte imagem mostra um exemplo de uma guia Tarefa predefinida na ferramenta de Agendamento Básico.
Observação: Você pode utilizar parâmetros (variáveis amper) quando especificar um valor no campo Salvar Relatório Como de um agendamento. Estes parâmetros podem ser variáveis do sistema, como &YYMD ou qualquer variável ampersand para a qual um valor é obtido pelo Reporting Server quando o procedimento agendado é executado. Para utilizar o separador de extensão de arquivos (ponto) após uma variável, termine a variável com o caractere '|', por exemplo, &YYMD|.htm. De forma parecida, para utilizar o caractere ampersand, insira o caractere '|' após o ampersand (por exemplo, Smith&|Jones). Se o valor para um parâmetro especificado em um agendamento não for retornado pelo Reporting Server quando o procedimento for executado, o agendamento irá falhar e apresentar o erro "Nenhum relatório a distribuir". Se a tarefa agendada for dividida, você também poderá utilizar o símbolo '%BURST' para incluir o valor de divisão no campo Salvar Relatório Como.
As opções disponíveis quando se seleciona a guia Tarefa são:
Selecione uma das seguintes opções da caixa de diálogo Opções de Alerta.
Cuidado: Certifique-se de definir o intervalo de agendamento em um período maior que o tempo em que ele leva para executar o procedimento planejado. Quando o intervalo de agendamento for menor que o tempo de execução do procedimento e a opção Atraso estiver selecionada, um agendamento de alerta irá distribuir (com base na Distribuição que você selecionou) mais frequentemente que o esperado. Para a distribuição por e-mail, isto pode resultar em mensagens desnecessárias, o que pode ter impacto nos objetivos comerciais e operacionais da distribuição de relatórios de alerta.
Observação: Ao agendar um procedimento Graph (.fex) contendo uma declaração PCHOLD que utiliza JPEG, GIF, PNG ou SVG, se você não selecionar um formato no agendamento, a saída será distribuída no formato PNG. Isto somente não acontecerá caso você adicione a extensão JPEG, GIF ou SVG como o valor Salvar Como ou o nome do arquivo na Lista de Distribuição. Opcionalmente, se você necessita que a saída seja distribuída como um arquivo JPEG, GIF ou SVG, especifique o formato no agendamento. Para isso, você pode marcar a caixa de seleção Substituir o Formato Especificado no Procedimento, como descrito acima.
Nesta seção: Como: Referência: |
É possível personalizar um relatório e controlar sua execução com parâmetros. Ao agendar um procedimento um relatório (FEX), a seção de Parâmetros da tarefa de agendamento permite o fornecimento de um valor para os parâmetros especificados no procedimento de relatório ou se adicionar um parâmetro ao agendamento, criando um novo parâmetro e especificando o nome e valor do mesmo.
Para obter informações sobre parâmetros, também conhecidos como variáveis, e como eles utilizam os procedimentos de relatório, consulte o tópico Como Personalizar um Procedimento com Variáveis no manual Como Desenvolver Aplicativos de Relatório.
Se seu Procedimento de Servidor possuir Pré/Pós-procedimentos, consulte Como Utilizar a guia Pré/Pós-Procedimentos ou um Relatório.
Se o procedimento agendado contiver parâmetros para os quais valores devem ser fornecidos no tempo de execução, esses parâmetros serão exibidos na seção parâmetros da ferramenta de agendamento.
Na ferramenta de Agendamento Básico, clique em Parâmetros na faixa para abrir a caixa de diálogo Parâmetros de Tarefa.
Os parâmetros podem ter valores padrão e os que podem ser selecionados a partir de uma lista dinâmica ou estática. Para obter mais informações sobre a seleção de parâmetros na caixa de diálogo Como Agendar Parâmetros de Tarefa, consulte os exemplos fornecidos nesse capítulo. Para obter mais informações sobre como definir parâmetros, consulte o manual Como Desenvolver Aplicativos de Relatório.
Seguem considerações sobre quando especificar valores de parâmetro para um procedimento:
Comunicado:
Como um método alternativo de criação de uma lista selecionável dinâmica de valores de parâmetro, é possível criar um formato HTML com uma opção de agendamento com a ferramenta de Criação de HTML do Developer Studio. Para obter mais detalhes sobre a adição do botão Agendar em um formato, consulte o manual Projetando uma Interface de Usuário para um Aplicativo da Web com o Criador de HTML.
O ReportCaster exibe variáveis globais que são utilizadas em FILTROS definidos nos Arquivos Master e com referência de um procedimento. Por exemplo, se um Arquivo Master contiver
FILENAME=CAR,SUFFIX=FOC VARIABLE NAME=&&COUNTRY1, USAGE=A10, DEFAULT=ENGLAND,$ FILTER FILTER1=COUNTRY EQ '&&COUNTRY1'; $
e o procedimento sendo agendado contém
WHERE FILTER1
Em seguida, o ReportCaster exibe COUNTRY1 na janela Parâmetros.
A especificação de valores de parâmetro padrão pode ser feita com o comando -DEFAULT ou -DEFAULTH ou na instrução WHERE. Os valores-padrão especificados com o comando -DEFAULTH não são solicitados. Para obter mais informações sobre solicitação de parâmetro, consulte o tópico Autossolicitação de Amper no manual Como Desenvolver Aplicativos de Relatório do WebFOCUS.
O seguinte procedimento define um valor-padrão de NY para o parâmetro STATE (2-3 letras para US State). Para obter mais informações sobre criação e especificação de valores para parâmetros, consulte o manual Como Desenvolver Aplicativos de Relatório do WebFOCUS.
-DEFAULT &STATE=NYTABLE FILE GGSALES SUM DOLLARS UNITS BY ST BY CATEGORY BY PRODUCT ON TABLE SUBHEAD "Product Sales Report" WHERE ST EQ '&STATE.2-3 letters for US State.' END
Os parâmetros que possuem valores-padrão definidos no procedimento de relatório (FEX) são listados na guia Parâmetros com o valor-padrão na coluna Valor. Quando os parâmetros são armazenados em um agendamento, o ReportCaster adiciona um -SET para o parâmetro para o procedimento de agendamento enviado ao Reporting Server para execução. Um comando -SET substitui um valor-padrão especificado em um comando -
A imagem a seguir mostra a caixa de diálogo Parâmetros de Tarefa que possui o parâmetro STATE com um valor especificado. O parâmetro STATE possui o valor Sim exibido na coluna Usar Padrão tabela de Parâmetros de Tarefa. O parâmetro STATE é indicado na seção Propriedades de Parâmetro, exibindo um valor de NY no campo Valor.
Para usar um valor diferente do padrão no tempo de execução de agendamento, de modo que ele seja usado mesmo se o procedimento for alterado, clique no parâmetro e altere o valor do parâmetro na seção Propriedades de Parâmetro. Os valores para parâmetros simples são especificados ao inserir um valor para o parâmetro no campo Valor. Também há tipos de parâmetros estático ou dinâmico que permitem a seleção de um ou vários valores que são explicados nos exemplos a seguir.
Quando os parâmetros são armazenados em um agendamento, o ReportCaster adiciona um -SET para o parâmetro para o procedimento de agendamento enviado ao Reporting Server para execução. Um comando -SET substitui um valor-padrão especificado em um comando -DEFAULT.
O seguinte procedimento fornece uma lista de valores estáticos que são válidos para o parâmetro CATEGORY (Categoria).
-DEFAULT &STATE=NY
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE CATEGORY EQ '&CATEGORY.(Coffee,Food,Gifts).Category.'
END A imagem a seguir exibe o parâmetro CATEGORY (Categoria) selecionado na tabela Parâmetros de Tarefa. O valor padrão para este parâmetro é Coffee. A coluna do Parâmetro de Tarefa Usar Padrão fica vazia para CATEGORY e o campo Valor da seção Propriedades de Parâmetro fica vazio para STATE.
Para fornecer um valor para um único parâmetro de seleção, selecione o parâmetro na tabela Parâmetros de Tarefa e selecione o controle da lista no final do campo Valor, localizado na seção de Propriedades do Parâmetro. Na lista de valores, selecione um valor para atribuir ao parâmetro. É possível selecionar apenas um valor para um parâmetro estático de seleção única.
O valor selecionado aparece no campo Valor e na coluna Valor. A seguinte imagem mostra que o valor Alimento foi selecionado.
O seguinte procedimento fornece uma lista de seleção única de valores que são válidos para o campo PRODUCT (Nome do Produto). Essa lista é preenchida dinamicamente com valores da fonte de dados GGSALES.
-DEFAULT &STATE=NY;
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE PRODUCT EQ '&PRODUCT.(FIND PRODUCT IN GGSALES).Product Name.'END A imagem a seguir mostra o parâmetro PRODUCT (Nome do Produto) selecionado na tabela Parâmetros de Tarefa. O parâmetro PRODUCT não possui um valor-padrão especificado para que a coluna Usar Padrão do Parâmetro de Tarefa e o campo Valor-Padrão da seção Propriedades de Parâmetro fiquem em branco.
Para fornecer um valor, clique no parâmetro PRODUCT (Nome do Produto) na tabela e altere o valor do parâmetro na seção de Propriedades do Parâmetro. Selecione o controle da lista no final do campo Valor para listar os valores especificados para o parâmetro. É possível selecionar apenas um valor para uma lista dinâmica de seleção única.
Selecione o valor que será usado. O valor selecionado aparece no campo Valor e na coluna Valor. A seguinte imagem mostra que o valor Latte foi selecionado.
O seguinte procedimento fornece uma lista de multisseleção estática de valores que são válidos para o campo CATEGORY (Categoria).
-DEFAULT &STATE=NY
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE CATEGORY EQ '&CATEGORY.(OR(Coffee,Food,Gifts)).Category.'END A imagem a seguir mostra o parâmetro CATEGORY selecionado na tabela Parâmetros de Tarefa.
Para fornecer valores, clique no parâmetro CATEGORY (Categoria) na tabela e, em seguida, na seção Propriedades do Parâmetro. Clique no botão Valor para abrir a caixa de diálogo de seleção de Valor do Parâmetro. É possível selecionar um ou mais valores da lista, conforme mostrado na imagem a seguir.
Após selecionar os valores da lista, clique em OK. Os valores selecionados aparecem no campo Valor na seção de Propriedades do Parâmetro e na coluna Valor na tabela de parâmetro. A imagem a seguir mostra que os valores Food e Coffee foram selecionados.
O seguinte procedimento fornece uma lista de multisseleção dinâmica de valores que são válidos para o campo PRODUCT (Nome do Produto). Essa lista é preenchida dinamicamente com valores da fonte de dados GGSALES.
-DEFAULT &STATE=NY;
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE PRODUCT EQ '&PRODUCT.(OR(FIND PRODUCT IN GGSALES)).Product Name.'END A imagem a seguir mostra o parâmetro PRODUCT selecionado na tabela Parâmetros de Tarefa.
Para fornecer valores, clique no parâmetro PRODUCT na tabela e, em seguida, na seção Propriedades do Parâmetro. Clique no botão Valor para abrir a caixa de diálogo de seleção de Valor do Parâmetro. É possível selecionar um ou mais valores da lista, conforme exibido na seguinte imagem, ou selecionar a caixa de seleção Sem Seleção se não desejar executar um teste de seleção de dados.
Após selecionar os valores da lista, clique em OK. Os valores selecionados aparecem no campo Valor na seção de Propriedades do Parâmetro e na coluna Valor na tabela de parâmetro.
É importante verificar se os parâmetros que você excluiu ao agendar um procedimento de relatório (FEX) serão tratados conforme segue, de modo que o trabalho agendado seja executado com êxito:
Para excluir um parâmetro a fim de que não seja armazenado com as informações de agendamento, destaque o parâmetro na tabela de parâmetros que deseja excluir e clique no botão Excluir.
Se for necessário que o trabalho do agendamento envie um parâmetro e um valor não definidos no procedimento do relatório sendo planejado, você pode criar um novo parâmetro na caixa de diálogo Parâmetros de Tarefa. Os parâmetros referenciados durante o processamento pelo Reporting Server devem ter um valor atribuído para o trabalho planejado ser executado com êxito. O relatório de log do trabalho de agendamento conterá informações quando os valores dos parâmetros necessários não forem fornecidos.
É possível criar parâmetros para uma tarefa, conforme segue:
A caixa de diálogo Parâmetros de Tarefa é exibida, como mostrado na imagem abaixo.
As caixas Nome e Valor são preenchidas na tabela Parâmetros, localizada na caixa de diálogo Parâmetros de Tarefa.
Use as seguinte diretrizes quando selecionar um formato:
Como: |
Se estiver agendando um Procedimento de Servidor ou procedimento de relatório (FEX), será possível agendar, no máximo, dois procedimentos de pré e pós-processamento. Os procedimentos de pré e pós-processamento planejados devem residir no Reporting Server.
Observação: Todas as variáveis internas do ReportCaster, que iniciam com &DST, são passadas para os procedimentos pré-processamento e pós-processamento para que sejam disponibilizadas para a lógica específica do aplicativo. Para obter mais informações, consulte Variáveis do ReportCaster.
O nome do procedimento (FEX) deve ser inserido com ou sem o caminho do aplicativo. Quando um caminho de aplicativo não é especificado, o caminho de busca do padrão do Reporting Server é usado para localizar o procedimento especificado.
Um ou mais valores de parâmetro podem ser atribuídos usando um par de valor e nome e vários pares devem ser separados por vírgulas, como a seguir:
procedurename name=value, name=value
Não é necessário inserir os pares na ordem em que eles são encontrados no procedimento. Para obter informações adicionais sobre o fornecimento de valores de parâmetro para um procedimento, consulte o tópico Como Fornecer Valores de Variáveis de Outro Procedimento no manual Como Desenvolver Aplicativos de Relatório.
| WebFOCUS |