Execução de um Procedimento de Relatório ou Arquivo de Folha de Estilo Utilizando o - INCLUDE

Como:

Ao utilizar o comando -INCLUDE, você pode inserir um procedimento de relatório (FEX) ou um arquivo de folha de estilo (STY) dentro de outro procedimento de relatório (FEX). Para obter mais informações sobre como criar solicitações de relatórios e arquivos de folha de estilo, consulte o manual Como Criar Relatórios com a Linguagem WebFOCUS.

Quando você cria um procedimento de relatório no caminho da pasta de conteúdo do repositório, um caminho único e uma referência de nome de arquivo são criados, com base na pasta em que o relatório é criado e no nome e tipo de arquivo especificados. Observe que há regras para a nomenclatura de arquivos que substituem a maioria dos caracteres não alfanuméricos e modificam o nome do arquivo quando necessário.

O caminho completo é o valor a ser especificado quando se referir a um procedimento de relatório ou arquivo de folha de estilo em um comando --INCLUDE. As informaões completas do caminho IBFS, incluindo o nome do arquivo, podem ser obtidas selecionando o relatório e, em seguida, escolhendo a opção Propriedades.

Observação: Os procedimentos de relatórios do WebFOCUS 7.x migrados com comandos --INCLUDE e codificados com os HREFs Internos do Repositório do Managed Reporting 7.x são suportados no WebFOCUS 8. Isto acontece porque as referências de HREF Interno do WebFOCUS 7.x são migradas com as informações de propriedades de um item (por exemplo, um relatório ou arquivo de folha deestilo). Os itens criados no WebFOCUS 8 devem ser referenciados por seus caminhos IBFS completos.

A imagem a seguir exibe a caixa de diálogo Propriedades para um procedimento de relatório (FEX) com o caminho completo.


Topo da página

x
Sintaxe: Como Incorporar um Procedimento de Relatório (FEX) ou Arquivo de Folha de Estilo (STY) Com o Comando -INCLUDE

O código a seguir ilustra como incorporar um procedimento de relatório (FEX) utilizando o caminho IBFS com o comando -INCLUDE.

Observação: Em releases anteriores ao WebFOCUS 8, um procedimento ou arquivo de folha de estilo localizado em um Servidor de Relatórios pode ser incorporado dentro de um procedimento do Managed Reporting, utilizando o comando -INCLUDE. O comando -MRNOEDIT -INCLUDE possui suporte no WebFOCUS 8.

-INCLUDE IBFS:/path/filename

onde:

IBFS:/path/filename

É o caminho completo, incluindo o nome do arquivo, do relatório de procedimento (FEX) ou do filename.sty do arquivo da folha de estilo. A extensão do arquivo é opcional ao se fazer referência a um procedimento de relatório (FEX).

Para incorporar um procedimento em um Servidor de Relatório utilizando o -MRNOEDIT e o -INCLUDE, insira as informações a seguir:

-MRNOEDIT -INCLUDE appname/filename.ext

onde:

appname

É o caminho do diretório de aplicativo no Servidor de Relatório no qual o procedimento do servidor (FEX) ou arquivo de folha de estilo (STY) está localizado. Se não estiver especificado, o arquivo deve estar no caminho do aplicativo do Servidor de Relatório.

filename.ext

É o nome do procedimento localizado no Servidor de Relatórios. A extensão do arquivo é opcional ao se fazer referência a um procedimento de relatório (FEX). Ao incorporar um arquivo de folha de estilo, especifique a extensão STY.


Topo da página

x
Referência: Como Incluir um Procedimento de Servidor de Relatório ou Arquivo de Folha de Estilo em um Procedimento do Managed Reporting Utilizando um Caminho IBFS

Para incorporar um procedimento localizado em um diretório de aplicativo em um Servidor de Relatórios utilizando o caminho IBFS do WebFOCUS, insira:

-INCLUDE IBFS://EDA/nodename/appname/filename.ext

onde:

nodename

É o nó do Servidor de Relatórios definido na configuração do Cliente do WebFOCUS. O caminho IBFS://EDA/ especifica que o procedimento ou arquivo de folha de estilo está localizado em um Servidor de Relatório. O processo do Managed Reporting remove o IBFS://EDA/nodename a partir da solicitação do Managed Reporting ao submeter a solicitação para o Servidor de Relatórios, pois o processo deste servidor irá utilizar seu caminho de aplicativo para localizar o procedimento ou arquivo de folha de estilo.

appname

É o diretório de aplicativo no Servidor de Relatório no qual o procedimento do servidor ou arquivo de folha de estilo está localizado. Se não estiver especificado, o arquivo deve estar no caminho do aplicativo do Servidor de Relatório.

filename.ext

É o nome do procedimento ou arquivo de folha de estilo localizado no Servidor de Relatórios. A extensão do arquivo é opcional ao se fazer referência a um procedimento de relatório (FEX). Ao incorporar um arquivo de folha de estilo, especifique a extensão STY.


Topo da página

x
Referência: Como Incluir um Procedimento de Servidor de Relatório ou Arquivo de Folha de Estilo em um Procedimento do Managed Reporting Utilizando -MRNOEDIT e -INCLUDE

A melhor prática no desenvolvimento do aplicativo WebFOCUS 8 é centralizar as configurações do estilo do relatório e do ambiente, como JOINs e DEFINEs, armazenando-as em um domínio comum e definindo as permissões de segurança para permitir que usuários as leiam e executem, mas não as editem ou alterem. No entanto, os aplicativos de legado podem exigir procedimentos de relatórios de referência e arquivos de folha de estilo que estão localizados em um diretório de aplicativo do Servidor de Relatório. As informações nesta seção são para aplicativos de legado que foram migrados.

O exemplo a seguir é uma incorporação deum procedimento de Servidor de Relatórios ou arquivo de folha de estilo dentro de um procedimento do Managed Reporting utilizando o comando -MRNOEDIT e o -INCLUDE.

O procedimento salesrptsetup, que contém os seguintes comandos para a criação de um campo frequentemente utilizado nos relatórios de vendas de produto, está localizado no diretório /ibi/apps/ibisamp do Servidor de Relatórios.

DEFINE FILE GGSALES
PROFIT/D12.3= DOLLARS - BUDDOLLARS;
INVENTORY/D12 = UNITS - BUDUNITS;
END 

A folha de estilo salesrptstyle.sty que contém os comandos de estilo a seguir está localizada no Servidor de Relatórios no diretório /ibi/apps/ibisamp.

TYPE=REPORT,COLOR=NAVY,FONT='ARIAL',SIZE=9,GRID=OFF,$
TYPE=HEADING,LINE=1,STYLE=BOLD,SIZE=12,JUSTIFY=CENTER,$
TYPE=TITLE,BACKCOLOR=RGB(45 111 205),COLOR=WHITE,STYLE=UNDERLINE+BOLD, $
TYPE=DATA,BACKCOLOR=(WHITE RGB(235 235 255)),$
TYPE=SUBTOTAL,BACKCOLOR=RGB(163 200 236),STYLE=BOLD,$

O procedimento do Managed Reporting incorpora o procedimento salesrptsetup e a folha de estilo salesrptsetup localizados no Servidor de Relatório.

-MRNOEDIT -INCLUDE ibisamp/salesrptsetup 
TABLE FILE GGSALES
"Regional Inventory and Profit Report"
SUM BUDUNITS UNITS INVENTORY AS 'Inventory'
BUDDOLLARS DOLLARS PROFIT AS 'Profit'
BY REGION
BY CATEGORY 
-MRNOEDIT -INCLUDE ibisamp/salesrptstyle.sty
END


Topo da página

x
Referência: Considerações ao Utilizar o --INCLUDE com o ReportCaster

A partir do Servidor de Relatórios, para cada tarefa dentro de um agendamento, o ReportCaster suporta o recebimento de um único conjunto de respostas, como relatório, gráfico ou arquivo HTML. Portanto, ao utilizar o comando -INCLUDE para incorporar um procedimento emoutro que será agendado com o ReportCaster, apenas um conjunto de respostas deve ser criado. Caso necessite distribuir diversos relatórios dentro de um único documento, utilize o recurso Relatório Composto. Para obter mais informações, consulte o manual Como Criar Relatórios com a Linguagem do WebFOCUS.


WebFOCUS