No exemplo de código a seguir, tanto o teste de alerta quanto o relatório a ser executado (Resultado de Alerta) são criados com o InfoAssist. Para manter de código de exemplo simples, as opções de estilo e relatório, tais como cabeçalho de relatório e estilo condicional, não estão incluídas na solicitação.

Observe após a primeira solicitação TABELA, há um demonstrativo -IF que verifica se o número de linhas no relação é maior que zero (-IF &LINES EQ 0). Esta condição de teste determina se a segunda solicitação de TABELA para executar o relatório deve ser disparada (verdade).

Se o número de linhas for maior que zero, há registros que satisfazem o teste de alerta e o relatório é executado. Se o número de linhas for igual a zero, não há registros que satisfazem o teste de alerta e o relatório não é executado.

-* Created by Alert Assist
-* start of the test report
ENGINE INT CACHE SET ON
-DEFAULTH &WF_SUMMARY='Summary';
-DEFAULTH &WF_TITLE='WebFOCUS Report';
TABLE FILE ibisamp/wf_retail
SUM WF_RETAIL.WF_RETAIL_SALES.COGS_US
WF_RETAIL.WF_RETAIL_SALES.REVENUE_US
BY WF_RETAIL.WF_RETAIL_PRODUCT.PRODUCT_CATEGORY
BY WF_RETAIL.WF_RETAIL_PRODUCT.BRAND
WHERE WF_RETAIL.WF_RETAIL_SALES.COGS_US GT WF_RETAIL.WF_RETAIL_SALES.REVENUE_US;
ON TABLE HOLD
ON TABLE NOTOTAL
ON TABLE SET PAGE-NUM NOLEAD
ON TABLE SET SQUEEZE ON
ON TABLE SET EMPTYREPORT ON
ON TABLE SET HTMLCSS ON
ON TABLE SET HTMLENCODE ON
ON TABLE SET CACHELINES 100
END
-* end of the test report

-* start of the test
-RUN
-IF &LINES EQ 0 GOTO ALERTEXIT;
-* end of the test
-* start of the output report
ENGINE INT CACHE SET ON
-*COMPONENT=Define_wf_retail
DEFINE FILE ibisamp/wf_retail
Loss/D12.2=WF_RETAIL.WF_RETAIL_SALES.REVENUE_US - WF_RETAIL.WF_RETAIL_SALES.COGS_US ;
END
-DEFAULTH &WF_SUMMARY='Summary';
-DEFAULTH &WF_TITLE='WebFOCUS Report';
TABLE FILE ibisamp/wf_retail
SUM WF_RETAIL.WF_RETAIL_SALES.QUANTITY_SOLD
Loss
BY WF_RETAIL.WF_RETAIL_PRODUCT.BRAND
ACROSS WF_RETAIL.WF_RETAIL_TIME_SALES.TIME_QTR
WHERE WF_RETAIL.WF_RETAIL_SALES.COGS_US GT WF_RETAIL.WF_RETAIL_SALES.REVENUE_US;
ON TABLE SUBHEAD
"Brand Revenue Loss"
ON TABLE PCHOLD FORMAT HTML
ON TABLE NOTOTAL
ON TABLE SET CACHELINES 100
ON TABLE SET PAGE-NUM NOLEAD
ON TABLE SET SQUEEZE ON
ON TABLE SET HTMLCSS ON
ON TABLE SET HTMLENCODE ON
ON TABLE SET EMPTYREPORT ON
ON TABLE SET GRWIDTH 1
ON TABLE SET STYLE *
INCLUDE=IBFS:/FILE/IBI_HTML_DIR/javaassist/intl/EN/ENIADefault_combine.sty,$
TYPE=REPORT, TITLETEXT=&WF_TITLE.QUOTEDSTRING, SUMMARY=&WF_SUMMARY.QUOTEDSTRING, HFREEZE=OFF, $
TYPE=TABHEADING, LINE=1, JUSTIFY=CENTER, $
TYPE=TABHEADING, LINE=1, ITEM=1, OBJECT=TEXT, SIZE=14, STYLE=BOLD+ITALIC, $
ENDSTYLE
END
-* end of the output report

-* start of the options
-* end of the options
-ALERTEXIT
-* Finished by Alert Assist

1. Conecte-se ao WebFOCUS como administrador ou desenvolvedor.
2. Na árvore de Recursos, clique com o botão direito em uma pasta, posicione o ponteiro do mouse sobre Novo e clique em Alerta.

   A caixa de diálogo Configuração da Ferramenta se abre. Fornece opções para selecionar um servidor de relatórios e caminhos de aplicativos.

   Observação: O acesso do usuário à caixa de diálogo Definir Ferramentas para especificar as propriedades do Reporting Server é controlada pelo privilégio de segurança WebFOCUS. Para mais informações sobre os privilégio de segurança do WebFOCUS, consulte o manual Administração e Segurança do WebFOCUS.

3. Selecione um servidor de relatórios e caminhos de aplicativos, quando não estiver usando o servidor de relatórios padrão especificado na configuração do Cliente WebFOCUS ou do caminho do aplicativo padrão para este servidor de relatórios, como ilustrado na imagem a seguir.

   

4. Clique em OK.
5. O WebFOCUS Alert Assist se abre.

Quando se cria um Alerta no navegador da Web, o Alert Assist e, em seguida o InfoAssist serão invocados. O Alert Assist tem uma interface de usuário similar ao InfoAssist. A imagem a seguir mostra a interface do Alert Assist do WebFOCUS.

Menu Principal do Alert Assist

No canto superior esquerdo da janela do navegador você encontra o botão Aplicativo, que fornece acesso ao Menu Principal do Alert Assist. Este menu contém as opções Salvar, Salvar Como, Executar, Fechar e Sair. Algumas dessas opções estão também na Barra de Ferramentas de Acesso Rápido do Alert Assist.

A imagem seguinte mostra o menu principal do Alert Assist expandido.

Salvar

Salvar o Alerta. Esta opção está desativada até que as duas partes do Alerta sejam criadas.

Salvar Como

Salva a do alerta atual com um novo nome. A caixa de diálogo de Salvar como exibe um campo no qual você digita seu novo nome. Esta opção está desativada até que as duas partes do Alerta sejam criadas.

Executar

Enviar um procedimento de alerta para o servidor de relatórios. Esta opção será ativada quando as duas partes do Alerta estejam criadas. A saída sempre se abre em um novo navegador.

Fechar

Fecha o alerta atual e solicita que se salve qualquer alteração.

Sair

Sai do Alert Assist e solicita que se salve qualquer alteração pendente para o alerta aberto.

Barra de Ferramentas de Início Rápido do Alert Assist

A barra de ferramentas de início rápido do Alert Assist contém os seguinte botões.

Os usuários autorizados podem executar um teste de alerta interativamente e, como opção, agendá-lo para distribuir pelo ReportCaster.

A imagem seguinte mostra como processar um alerta básico.

1. O desenvolvedor do Managed Reporting, usando o Alert Assist ou o Alert Wizard, cria um teste de alerta e o relatório executado, se a condição de alerta for verdadeira.
2. Se o teste de alerta for verdade, o WebFOCUS Reporting Server executa o resultado de alerta.
3. Se o teste de alerta for falso, o resultado de alerta não é executado.

A imagem seguinte mostra como processar um alerta agendado.

1. O desenvolvedor do Managed Reporting, usando o Alert Assist ou o Alert Wizard, cria um teste de alerta e o relatório executado, se a condição de alerta for verdadeira.
2. Se desejar, um agendamento de alerta será criado, através do ReportCaster.
3. O Servidor de Distribuição do ReportCaster verifica os trabalhos agendados no repositório do WebFOCUS.
4. Quando o Servidor de Distribuição ReportCaster processa o procedimento de Alert agendado, envia-se ao servidor de relatórios para avaliar se o teste de alerta é verdade.
   1. Se o teste de alerta for falso, retorna à fila para a próxima hora agendada.
   2. Se o alerta de teste for verdade, o Reporting Server executa o resultado de alerta e retorna os resultados para o servidor de distribuição ReportCaster. O servidor de distribuição ReportCaster distribui o resultado de alerta aos destinatários, segundo especificação no agendamento.

1. Conecte-se ao WebFOCUS como administrador ou desenvolvedor.
2. Na árvore Recurso, clique com o botão direito na pasta na qual você deseja acessar o procedimento do Alerta, vá para Novo e, em seguida, selecione Alerta.
3. Na caixa de diálogo Configuração de Ferramentas, selecione o servidor no qual os dados de exemplo se encontram e atribua o Aplicativo onde seus dados residem.
4. Clique em OK.

   A ferramenta de Alert Assist se abre em uma nova janela do navegador, como mostrado na imagem a seguir.

   

5. Clique no nó Teste.
6. Na guia Início, no grupo Navegação, clique em Novo e, em seguida, em Teste do WebFOCUS.

   O WebFOCUS InfoAssist se abre.

7. Adicione os seguintes campos ao seu relatório:
   • Categoria de Produto
   • Marca
   • Custo de Bens
   • Renda

   Antes de completar seu relatório, é necessário adicionar a condição Where que define os critérios a serem respeitados.

8. Na guia Dados, clique em Filtro Avançado, no grupo Filtro.

   A caixa de diálogo Criar uma condição de filtragem se abre.

9. Clique duas vezes no texto Clique duas vezes ou pressione F2 para editar! texto.

   Os menus suspenso para Campos e Subconsultas, Operadores e Valores se abrem.

10. Faça as seguintes seleções:
    • No menu suspenso Campo, clique em Custo de Produtos.
    • No menu suspenso Operadores, clique em Maior que.
    • No menu suspenso Valor, clique em Campo e selecione Renda.

    A imagem a seguir mostra a condição Where concluída.

    

11. Clique em OK.
12. Salve seu relatório e feche o InfoAssist.

    Seu relatório agora é exibido no nó Teste da janela do navegador do Alert Assist.

13. Clique no nó Resultado. Na guia Início, no grupo Navegação, vá para Novo, clique em Novo Relatório e, em seguida, Relatório.

    O WebFOCUS InfoAssist se abre.

    Já que o seu Teste de Alerta está verificando a perde de renda, neste tutorial você deseja que o relatório final possua um campo que destaque a perda. Este campo não está disponível por padrão. Você pode criá-lo.

14. Na guia Dados, no grupo Cálculo, clique em Detalhe.

    A caixa de diálogo Campo Detalhe (Define) se abre.

15. Na caixa de entrada Campo, digite Perda.
16. No campo de expressões, crie a seguinte expressão, como ilustrado na imagem a seguir:
    WF_RETAIL.WF_RETAIL_SALES.REVENUE_US -
    WF_RETAIL.WF_RETAIL_SALES.COGS_US

    

    É possível digitar a expressão diretamente no campo de expressão ou escolher os campos a partir da árvore de dados.

17. Clique em OK.

    O painel Dados é atualizado e exibe o novo campo, Perda.

18. Adicione os seguintes campos ao seu relatório:
    • Marca
    • Vendida,Quantidade
    • Perda
    • Vendas,Trimestre

    Para garantir que o Resultado do Alerta gere o relatório correto quando os critérios de teste são atendidos, é necessário adicionar a mesma condição Where como a única que a que você adicionou ao Teste de Alerta.

19. Repita as etapas de 8 a 11 para adicionar a condição Where.

    É possível formatar o estilo do relatório que é distribuído adicionando um cabeçalho.

20. Na guia Início, no grupo Relatório, clique em Cabeçalho e Rodapé e, em seguida, clique em Cabeçalho de Relatório.

    A caixa de diálogo Cabeçalho e Rodapé se abre.

21. Digite Perda de Renda de Marca 2015.
22. Clique em OK e feche a janela Cabeçalho e Rodapé.
23. Salve seu relatório e feche o InfoAssist.

    Assim que o Teste e o Resultado forem concluído, é possível salvar o procedimento de Alerta.

24. Na janela do navegador do Alert Assist, clique no botão Salvar.

    A caixa de diálogo de Salvar como se abre.

25. No campo Título, digite Alertas de Perda de Renda de Marca e clique em Salvar.

    Seu novo Alerta é exibido agora na árvore Recurso e pode ser agendado, como ilustrado na imagem a seguir.

    

    É possível agendar o relatório para ser distribuído por e-mail, servidor FTP, biblioteca de relatórios, repositório ou enviado diretamente para uma impressora. Neste tutorial, você enviará um e-mail mensal.

26. Na árvore Recurso, clique com o botão direito no Alerta que você criou, vá para Agendamento e, em seguida, clique em E-mail.

    A ferramenta de Agendamento Básico do ReportCaster se abre, como ilustrado na imagem a seguir.

    

27. Na área Objeto de Agendamento, clique em Alerta.

    A caixa de diálogo Opções de Alerta se abre.

28. Clique em Continuar Após Alerta e, em seguida, em OK. Isto significa que o agendamento continua a ser executado na hora especificada e distribui o relatório toda vez que o teste de alerta for verdade. Outras opções incluem Redefinir Automaticamente, Desativar Agendamento Após Alerta e Atraso. Para obter informações sobre estas opções, consulte o manual ReportCaster.
29. Clique em Propriedades.
30. Na área Resumo, digite Este procedimento de alerta monitora a perda de renda por marca.
31. Clique em Reocorrência. Neste exemplo, você deseja agendar o procedimento de Alerta para ser executado mensalmente no último dia de cada mês, como ilustrado na imagem a seguir.

    

32. Clique em Distribuição.
33. Preencha os campos Para, De e Endereço de Resposta com os endereços de e-mail. Neste tutorial, é possível utilizar o seu próprio e-mail para testar o Alerta. No campo Assunto, digite Alertas de perda de Renda de Marca.

    A imagem a seguir mostra um exemplo de opção de Distribuição.

    

    Além disso, é possível definir notificações de distribuição de Alertas. Clique em Notificação e preencha os campos.

34. Clique em Salvar and Fechar.

    A caixa de diálogo de Salvar como se abre.

35. No campo Título, digite Agendamento de Alerta de Perda de Renda de Marca e clique em OK.

    O Agendamento de Alertas é agora exibido na árvore Recurso, como ilustrado na imagem a seguir.

    

36. Para testar o Alerta, antes do seu agendamento para execução, clique com o botão direito em Agendamento de Alerta e, em seguida, Executar.

    Um aviso irá perguntar se você deseja executar o agendamento.

37. Clique em OK.

    Os endereços de e-mail que você identificou anteriormente receberão o Relatório de Alerta em breve.

    As imagens a seguir exibem exemplos do e-mail de Alerta e do relatório de Alerta.