Nesta seção: |
Com o WebFOCUS Managed Reporting, um desenvolvedor pode facilmente transformar as visões de dados complexos em objetos simples rotulados com terminologia comum de negócios que cada usuário pode entender, como Vendas Semanais ou Receita. Os desenvolvedores criam Objetos do Relatório que apresentam dados disponíveis, usando termos e formatos significativos para os usuários. Os usuários podem então usar os Objetos do Relatório como modelos para a criação de uma vasta gama de relatórios e gráficos.
Os Objetos do Relatório são armazenados em pastas na árvore nas pastas de domínio, sob a pasta de Conteúdo. Podem incluir critérios de seleção (WHEREs), JOINs, campos virtuais (DEFINEs), filtros e outros demonstrativos do WebFOCUS, como também relatórios ou gráficos fornecidos como modelos.
Observação: um Objeto do Relatório não será listado na árvore quando o usuário não puder usar funcionalmente o Objeto do Relatório.
A ferramenta do Objeto do Relatório do navegador permite a criação, edição, teste, execução ou exclução de um Objeto do Relatório ou seus componentes. A interface principal, como exibido na imagem seguinte, consiste de uma Barra de Ferramentas de Início Rápido estática, uma faixa de opções de contexto sensível e uma janela que exibe os componentes do Objeto do Relatório com que está trabalhando.
A Barra de Ferramentas de Início Rápido da Ferramenta do Objeto do Relatório é um menu estático cujos comandos se aplicam ao menu do Objeto do Relatório inteiro, não simplesmento ao determinado componente selecionado. A tebela seguinte descreve cada comando na Barra de Ferramentas de Início Rápido da Ferramenta do Objeto do Relatório.
Botão |
Teclas de Atalho |
Comando |
Descrição |
---|---|---|---|
|
Nenhum |
Menu da Ferramenta do Objeto do Relatório |
Inicializa um menu permitindo Salvar, Salvar Como, Executar e Sair. |
|
Ctrl+S |
Salvar |
Saves o Objeto do Relatório. |
|
Ctrl+Z |
Desfazer |
Desfaz a última a ação. |
|
Ctrl+Y |
Refazer |
Repete a última a ação. |
|
Nenhum |
Visualizar código |
Exibe código do Objeto do Relatório em uma janela somente de leitura. |
|
Ctrl+R |
Executar |
Executa o Objeto do Relatório. |
A faixa de opções da Ferramenta do Objeto do Relatório é um menu cujos comandos se aplicam ao que foi selecionado, seja um Objeto do Relatório inteiro, um determinado componente ou um exemplo individual de um componente. Por exemplo, um filtro determinado ou um grupo de filtro, se selecionou algum, em lugar de selecionar um componente do filtro inteiro.
A tabela seguinte descreve cada comando da faixa de opções da ferramenta do Objeto do Relatório.
Botão |
Comando |
Descrição |
---|---|---|
|
Novo |
Cria uma nova junção, demonstrativo DEFINE, filtro ou demonstrativo WHERE. |
|
Abrir |
Inicializa o InfoAssist para criar ou editar um relatório ou gráfico ou inicializa a ferramenta apropriada para criar ou editar uma junção, demonstrativo DEFINE, filtro ou demonstrativo WHERE. |
|
Editar |
Abre o código-fonte do componente do editor de texto. |
|
Propriedades |
Renomeia o filtro selecionado ou grupo do filtro. |
|
Executar |
Executar o componente selecionado. |
|
Excluir |
Exclui o item selecionado. |
|
Excluir Tudo |
Exclui todos os itens do tipo selecionado, por exemplo, todos os demonstrativos WHERE, todos os filtros em um determinado grupo ou todos os filtros em cada grupo se o próprio componente Filtro for selecionado. |
Para visualizar ou editar as propriedades de um Objeto do Relatório, clique com o botão direito no objeto e selecione Propriedades. A caixa de diálogo de Propriedades do Objeto do Relatório se abre, como mostrado na imagem a seguir.
Na caixa de diálogo de Propriedades, a guia Propriedades Principais exibe informações, como pasta principal (localização), nome do arquivo, tamanho, status e a opção executar do objeto, juntamente com o usuário e a data de criação, último acesso e última modificação do objeto. Os usuários autorizados podem editar o título, nome e ordem de classificação e selecionar as seguintes opções que controlam como o Objeto do Relatório será executado ou accessado:
Observação: esta opção não está disponível para uso no Objetos de Relatório.
Os usuários podem visualizar e editar as regras de accesso, política efetiva ou permissões de compartilhamento ao clicar em Segurança.
A guia Propriedades, mostrada na seguinte imagem, permite o gerenciamento das configurações do caminhos dos aplicativos e do servidor.
Para alterar o servidor, consulte Designar Servidor e selecione um dos servidores disponíveis. Mover caminhos do aplicativos da caixa de Disponíveis para a de Selecionados clicando duas vezes neles ou os selecionando e usando as setas de movimento. Usar as setas para cima e para baixo para alterar a ordem preferida dos caminhos dos aplicativos.
A guia Detalhes, como exibido na imagem seguinte, permite a visualização dos Arquivos Mestres, elementos de dados, classificações, condições, expressões, formatos de saída e junções usados pelo Objeto do Relatório.
A caixa de diálogo de Nova Pasta se abre.
Se não selecionar um servidor ou caminho de aplicativo, cada um é configurado nos caminhos do aplicativo e no servidor padrão para a instalação do WebFOCUS. Para mais informações, consulte o manual Relatório Gerenciado.
A caixa de diálogo Definir Ferramentas se abre, como mostrado na imagem seguinte.
A Caixa de diálogo Abrir se abre, com aviso para selecionar o Arquivo Mestre, como mostrado na imagem a seguir.
A ferramenta do Objeto do Relatório aparece.
Clique com o botão direito em Objeto do Relatório e selecione Editar.
Observação: clicando duas vezes em Objeto do Relatório executa-se o Objeto do Relatório, em lugar de conceder permissão de editá-lo.
A caixa de diálogo de Salvar se abre.
De agora em diante, ao clicar em Salvar ou pressionar Ctrl+S salva-se o Objeto do Relatório sem inicializar a caixa de diálogo de Salvar.
Pode-se executar um Objeto do Relatório ou qualquer componente particular dele a partir do navagador. Pode-se executar um Objeto do Relatório das seguintes maneiras:
A opção Executar na janela da ferramenta do Objeto do Relatório está ativada, independentemente da configuração da propriedade Executar somente como um Relatório Adiado.
Quando se selecionar e executa um objeto de relatório, o comportamento esperado é o seguinte:
Your request did not return any output to display.
Possible causes: - No data rows matched the specified selection criteria. - Output was directed to a destination such as a file or printer. - An error occurred during the parsing or running of the request.
Uma Objeto do Relatório pode conter quaisquer dos seguintes tipos de componentes, que são executados na ordem de precedência, como listado aqui:
Os usuários usando o Objeto do Relatório para criar um relatório não veem os demonstrativos DEFINE, WHERE ou comandos JOIN definidos no Objeto do Relatório, que são emitidos automaticamente toda vez que um usuário acessa o Objeto do Relatório. No entanto, os componentes relatório ou gráfico, inclusive os recursos de cabeçalhos, rodapés e estilo, são visíveis aos usuários autorizados que podem usá-los para criar seus próprios relatórios personalizados.
Os filtros definidos no componente Filtro são aplicados somente se o usuário do Objeto do Relatório ativá-los quando o relatório ou gráfico com base no Objeto do Relatório for executado.
O pré-processamento do componente Outro contém um código personalizado que precisa executar antes de todos os outros componentes. Pode-se usar o editor de texto no componente para criar e editar o código ou colar aquele que copiou de outro aplicativo.
Para criar ou editar um Componente Pré-processamento de Outro, execute uma das seguintes tarefas:
O editor de texto de Pré-processamento de Outro aparece.
Consulte o Como criar relatórios com WebFOCUS Language manual para obter mais informações sobre como utilizar a WebFOCUS Language para procedimentos de código.
Observação:
As visualizações do InfoAssist nos componentes do Relatório e Gráfico serão desativadas se o Componente Pré-processamento de Outro contiver a sintaxe:
-OLAP ON
Para evitar este problema, ative o OLAP através das propriedades do Objeto do Relatório, ao invés do Componente Pré-processamento de Outro. Para mais informações sobre as propriedades do Objeto do Relatório, consulte Propriedades de um Objeto do Relatório.
Ao usar o Aviso Automático Amper, os usuários podem ser solicitados a fornecer valores variáveis de amper para parâmetros que o conteúdo do usuário particular não faz referência. Esses cenários estão diretamente relacionados a processamento interno dos relatórios criados através do Objeto do Relatório.
As considerações de aviso automático e comportamento esperado devem ser entendidas quando se referem às variáveis amper em um Objeto do Relatório. Para obter informações sobre as instalações de Aviso Automático de Amper, consulte o manual Como Desenvolver Aplicativos de Relatórios. A especificação de valores para as variáveis amper no Componente Outro do Objeto do Relatório utilizando os comandos –DEFAULT, –DEFAULTH ou –SET irá atribuir um valor padrão para variáveis amper em um pedido de relatório para evitar um erro FOC por não especificar um valor. Uma consideração para -DEFAULTH e -SET é que o Aviso Automático Amper não solicita variáveis amper que possuem valores atribuídos através de DEFAULTH e -SET.
Se um usuário é solicitado pelas instalações de Aviso Automático de Amper por variáveis amper atribuiu um valor padrão usando o comando –DEFAULT é dependente do parâmetro de configuração do Cliente WebFOCUS, IBIMR_prompting. Quando IBIMR_prompting é definido para XMLPROMPT, os usuários são solicitados por valores variáveis amper e os valores padrão são exibidos nos campos onde foram especificados. Quando IBIMR_prompting é definido para XMLRUN, os usuários não são solicitados para valores, quando todas as variáveis amper foram atribuídas um valor padrão. Para mais informações sobre como configurar o parâmetro IBIMR_prompting , consulte o manual Segurança e Administração do WebFOCUS .
Suponhamos que sua empresa tenha um depósito de dados e você necessite um Objeto do Relatório que use um extrato do mesmo. Em seu componente de Pré-processamento Outro, você cria um arquivo HOLD do depósito de dados e, em seguida, o usa em cada componente do Objeto do Relatório. Pode-se limpar o camando JOIN e excluir o arquivo HOLD no componente de Pós-processamento Outro para que não seja usado por engano novamente na próxima vez que o Objeto do Relatório seja usado.
Esta tarefa tem as seguintes etapas:
Para mais informações sobre como criar um Objeto do Relatório, consulte Propriedades de um Objeto do Relatório.
APP HOLD IBISAMP TABLE FILE EMPLOYEE PRINT EMPLOYEE.EMPINFO.DEPARTMENT AS 'NEWDEP' EMPLOYEE.EMPINFO.CURR_SAL AS 'NEWCURR_SAL' BY EMPLOYEE.EMPINFO.EMP_ID AS 'EMP_ID' BY EMPLOYEE.EMPINFO.HIRE_DATE AS 'NEWHIRE_DATE' ON TABLE HOLD AS WINFILE FORMAT FOCUS INDEX EMP_ID END
A seguinte saída é produzida:
0 NUMBER OF RECORDS IN TABLE= 12 LINES= 12
O componente Junção é previamente preenchido com a tabela EMPLOYEE.
O seguinte código do componente Junção é exibido:
-*COMPONENT=Join_J001 JOIN EMPLOYEE.EMPINFO.EMP_ID IN EMPLOYEE TO MULTIPLE WINFILE.SEG01.EMP_ID IN WINFILE TAG J001 AS J001 END -*COMPONENT=Join_J002 JOIN EMPLOYEE.PAYINFO.JOBCODE IN EMPLOYEE TO MULTIPLE JOBFILE.JOBSEG.JOBCODE IN JOBFILE TAG J002 AS J002 END
O InfoAssist é inicializado.
O relatório é exibido como uma tabela com quatro colunas, classificado por EMP_ID.
O relatório criado no InfoAssist é exibido no navegador.
JOIN CLEAR * ? JOIN
O relatório criado no InfoAssist é exibido no navegador.
O seguinte comentário é exibido:
<!-- 0 NUMBER OF RECORDS IN TABLE= 12 LINES= 12 0 NUMBER OF RECORDS IN TABLE= 12 LINES= 12 0 HOLDING HTML FILE ON PC DISK ... JOINS CURRENTLY ACTIVE HOST CROSSREFERENCE FIELD FILE TAG FIELD FILE TAG AS ALL WH ----- ---- --- ----- ---- --- -- --- -- EMPLOYEE.EM>EMPLOYEE WINFILE.SEG> WINFILE J0 J0 Y N EMPLOYEE.PA>EMPLOYEE JOBFILE.JOB> JOBFILE J1 J1 Y N 0 NO JOINS CURRENTLY IN EFFECT -->
Uma junção é uma conexão temporária entre duas ou mais fontes de dados que compartilham pelo menos um campo comum. Depois de juntar duas fontes de dados, cada vez que o WebFOCUS recupera um registro da primeira fonte de dados (arquivo host), também recupera os registros correspondentes a partir da segunda fonte de dados (arquivo de destino).
Para mais informações sobre a junção de fontes de dados, consulte Manual do Usuário do InfoAssist do WebFOCUS.
Observação:
A ferramenta Junção se abre, exibindo a fonte de dados associada com o Objeto do Relatório.
Para mais informações sobre como usar a ferramenta Junção, consulte Join Group no Manual de Usuário do WebFOCUS InfoAssist .
Clique com o botão direito na junção e selecione Excluir ou selecione a junção e clique em Excluir na Barra de Ferramentas de Início Rápido.
A caixa de diálogo Editar Junção se abre.
A nova descrição aparece sob o componente Junção na ferramenta de Objeto do Relatório. O nome interno usado para a junção permanece o mesmo de quando é criada.
O código da junção é exibido em um editor de texto.
Um campo virtual é um campo cujo valor não é armazenado na fonte de dados, mas pode ser calculado a partir dos dados que estão lá. Um campo virtual não ocupa espaço de armazenamento. É criado apenas quando um usuário acessa o Objeto do Relatório que inclui o campo virtual.
Usa-se a ferramenta Definir para criar um campo virtual. Usando esta ferramenta, especifica-se o nome e o formato do campo virtual, além da expressão que difine o campo. Uma expressão permite a combinação de campos, constantes, funções pré-definidas e os operadores em uma operação que produz um único valor. Ao definir um campo virtual, deve-se especificar um tipo de formato de campo, comprimento e as opções de visualização apropriadas.
Para mais informações sobre como definir campos, consulte Guia Dados no Manual de Usuário do WebFOCUS InfoAssist .
A caixa de diálogo da ferramenta Definir se abre, como mostrado na imagem a seguir.
Para mais informações sobre a ferramenta Definir, consulte Guia Dados no Manual de Usuário do WebFOCUS InfoAssist .
O campo virtual agora aparece na lista de campo quando um utilizador acessa a este Objeto do relatório.
Observação:
Para salvar o campo virtual, sair da ferramenta Definir clicando em OK. Reabrir a ferramenta Definir para criar o segundo campo. Como alternativa, pode-se digitar o nome do primeiro campo virtual na expressão, ao invés de selecioná-la da lista de campo. Neste caso não é necessário sair e reabrir a ferramenta Definir.
Campos virtuais existentes aparecem sob o nó Define, como mostrado na imagem a seguir.
A caixa de diálogo da ferramenta Definir se abre, exibindo o campo selecionado.
Os filtros possibilitam os usuários de selecionar rapidamente os critérios pré-definidos que limitam os dados incluídos no relatório ou gráfico. Os filtros são critérios de seleção (demonstrativos WHERE) que se cria para usuários, que em seguida selecionarão os filtros necessários para limitar os dados em um relatório ou gráfico, sem ter ter de criar seus próprios critérios de seleção.
A fim de criar um filtro, deve-se criar o grupo filtro e definir os filtros que compõem o grupo.
Observação: As funções Desfazer e Refazer não estão disponíveis para o componente Filtro até a criação de pelo menos um filtro.
Para mais informações sobre filtros, consulte Guia Dados no Manual de Usuário do WebFOCUS InfoAssist .
Torne o nome do grupo filtro o mais explícito possível, já que os usuários dependem deste nome para selecionar o filtro correto para aplicar a seus relatórios.
Você retornou à ferramenta do Objeto do Relatório. A pasta do grupo filtro aparece abaixo do nó do componente Filtro.
A caixa de diálogo Novo Filtro é aberta.
Torne o nome dos filtros o mais explícito possível, já que os usuários dependem deste nome para selecionar o filtro correto para aplicar a seus relatórios.
A caixa de diálogo Filtro Avançado se abre, como mostrado na imagem a seguir.
Para mais informações sobre como definir filtros, consulte Guia Dados no Manual de Usuário do WebFOCUS InfoAssist .
Se clicou em Adicionar Novo na etapa 2, a caixa de diálogo Novo Filtro se abre. Se clicou emOK na etapa 2, você returnou à ferramenta do Objeto do Relatório.
Os filtros existentes aparecem sob o grupo Filtro abaixo do nó de Filtros, como mostrado na imagem a seguir.
A caixa de diálogo Filtro Avançado se abre, exibindo o filtro selecionado.
The editor de texto se abre, exibindo o filtro selecionado.
Quando o Aviso Automático de Amper for usado (Aviso para Parâmetros é selecionado nas propriedades do Objeto do Relatório), há cenários em que os usuários são solicitados a prover variáveis amper nos critérios de seleção (demonstrativos WHERE) no Objeto do Relatório que o usuário não salvou com o relatório. Isso se deve ao processamento interno dos relatórios criados dos Objetos do Relatório. Pode-se evitar este problema, usando o componente Filtro para pré-definir os critérios de seleção para os usuários incluirem nos relatórios. Somente o filtro ou filtros que os usuários selecionam para inclusão em seus relatórios são avaliados pelas instalações de Aviso Automático de Amper do WebFOCUS.
Os demonstrativos WHERE ou critérios de seleção, restringem os dados recuperados apenas aos registros que satisfizeram as condições especificadas. Os filtros são critérios de seleção que executam quando o usuário seleciona o filtro no WebFOCUS. Outros critérios de seleção executam quando o usuário abre o Objeto do Relatório, evitando que os valores de dados que não satisfazem os critérios de estarem disponíveis ao usuário.
Para mais informações sobre demonstrativos WHERE, consulte Guia Campo no Manual de Usuário do WebFOCUS InfoAssist .
A caixa de diálogo Novo Filtro se abre, como mostrado na imagem a seguir.
Para mais informações sobre como criar critérios de seleção, consulte Como usar a janela de aplicativos InfoAssist no Manual de Usuário do WebFOCUS InfoAssist .
O componente do Relatório cria um modelo de relatório e o salva em um Objeto do Relatório. Os usuários autorizados podem usar o modelo de relatório para criar um relatório que satisfaça suas necessidades e, em seguida, salva o novo relatório.
Para criar um modelo de relatório, clique duas vezes no componente Relatório ou clique com o botão direito no componente e selecioneAbrir. O InfoAssist se abre, permitindo a criação de um modelo de relatório.
Para mais informações sobre como usar InfoAssist, consulte Manual do Usuário do InfoAssist do WebFOCUS.
Observação:
O componente Gráfico funciona exatamente como o componente Relatório. O componente Gráfico cria um modelo de gráfico e o salva em um Objeto do Relatório. Os usários podem usar o modelo de gráfico para criar um gráfico que satisfaça suas necessidades e, em seguida, salva o novo gráfico.
Para criar um modelo de gráfico, clique duas vezes no componente Gráfico ou clique com o botão direito no componente e selecioneAbrir. O InfoAssist se abre, permindo a criação de um modelo gráfico.
Para mais informações sobre como usar InfoAssist, consulte Manual do Usuário do InfoAssist do WebFOCUS.
Observação:
O pós-processamento do componente Outro contém um código personalizado que deve executar depois de todos os outros componentes. Pode-se usar o editor de texto no componente para criar e editar o código ou colar aquele que copiou de outro aplicativo.
Para criar ou editar um Pós-processamento do componente Outro, clique duas vezes no componente, ou selecione o componente e clique em Editarna faixa de Opções. Como alternativa, clique com o botão direito no componente e selecione Editar. A caixa de diálogo do pós-processamento do componente Outro se abre.
Consulte o Como criar Relatórios com o WebFOCUS Language manual para obter mais informações sobre como utilizar a WebFOCUS Language para procedimentos de código.
Observação:
-OLAP ON
Para evitar este problema, ative o OLAP através das propriedades do Objeto do Relatório, ao invés do Pós-processamento do componente Outro. Para mais informações sobre as propriedades do Objeto do Relatório, consulte Propriedades de um Objeto do Relatório.
Para informações sobre o Aviso Automático de Amper, consulte Considerações de Aviso Automático Amper com os componentes Pré-processamento e Pós-processamento de Outro .
WebFOCUS |