Criando um relatório para uso em um produto integrado do Rational Reporting for Document Generation

É possível usar o Rational Publishing Engine para projetar relatórios com base em dados fornecidos por produtos e aplicativos que incorporam o componente Rational Reporting for Document Generation, como aplicativos Rational solution for Collaborative Lifecycle Management. Esses modelos podem então ser importados para os produtos ou aplicativos para uso em suas interfaces.

Antes de começar

Antes de começar a usar o Rational Publishing Engine para customizar relatórios, um servidor de chave de licença deve ser configurado com licenças válidas para o uso. Entre em contato com o administrador para verificar se isso foi feito e para obter o caminho do servidor de licença. Se ainda não tiver o Rational Publishing Engine instalado, você ou seu administrador deverá instalá-lo e verificar se é possível conectar-se ao servidor de licenciamento.

Determine a versão do Rational Reporting for Document Generation que é enviada com o produto integrado (ou "provedor de dados"). Essa versão determina qual versão do modelo que você deve usar ao projetar modelos de relatório para o produto. Assegure-se de que você esteja familiarizado com as restrições de compatibilidade para versões mais recentes do Rational Publishing Engine com versões mais antigas do Rational Reporting for Document Generation.

Referência de suporte:

Procedimento

O Rational Publishing Engine fornece a capacidade de criar novos modelos de relatórios em estilo de documento.Você pode projetar modelos que coletam e relatar dados em um produto ou aplicativo, e se esse produto ou aplicativo incluir Rational Reporting for Document Generation, pode importar esses modelos e gerar relatórios de estilo de documento no contexto do produto ou aplicativo.

Uma licença do Rational Publishing Engine é necessária para criar modelos; uma licença do Rational Publishing Engine não é necessária para importar modelos e gerar relatórios a partir do contexto de um produto ou aplicativo que inclua Rational Reporting for Document Generation.

Conceitos de apoio
Para criar relatórios com o Rational Publishing Engine que usam dados do produto ou aplicativo, conclua as seguintes etapas:

1: Conectar-se ao Rational Publishing Engine

Se ainda não tiver o Rational Publishing Engine instalado, você ou seu administrador deverá instalá-lo e e conectá-lo ao servidor de licenciamento. É possível usar o Rational Publishing Engine Document Studio para importar origens de aplicativos e criar modelos de relatórios. É possível também pode usar o Rational Publishing Engine Launcher para criar as especificações do documento, que incorporam modelos de relatórios e geram relatórios.

2: Projetar Modelos de Relatórios

Importante: Você deve usar uma versão de modelo que é suportada pela versão do Rational Reporting for Document Generation, enviado com o produto integrado (ou "provedor de dados"). Para determinar qual versão será enviada, verifique com o administrador de relatório do produto. Para obter detalhes, consulte Compatibilidade de versão.
  1. Inicie o Rational Publishing Engine Document Studio para construir um design de modelo de relatório.
  2. Crie ou importe um design de modelo. Esse design determina o layout do relatório. O Rational Publishing Engine é fornecido com um conjunto de relatórios de amostra e tutoriais que é possível explorar.
    Importante: Atualize o número de versão do modelo em Carregar API do modelo para que use uma versão compatível com o provedor de dados. Se a nova versão do modelo for especificado e um modelo mais antigo for aberto, então a versão do modelo será atualizada para esse modelo.
Suportando conceitos no centro de informações do Rational Publishing Engine:
Suportando tarefas no centro de informações do Rational Publishing Engine:
Metadados e modelos de importação:

3: Conectar-se à Origem de Dados do Aplicativo

Determine o esquema da origem de dados que deseja importar. É possível usar os elementos no esquema para incluir consultas nos dados do aplicativo para o modelo. Essas consultas especificam quais partes das informações são geradas, ultimamente, no relatório.
  1. Revise os esquemas de dados disponíveis que deseja usar no relatório. Cada um dos produtos possui um esquema exclusivo ou um conjunto de esquemas.
  2. Construa uma URL que aponta para o esquema da origem de dados.
  3. Inclua uma nova origem de dados no Document Studio.
Suportando tarefas no centro de informações do Rational Publishing Engine:

4: Incluir Consultas de Dados Baseadas em Aplicativo no Modelo

Use o Document Studio para incluir dados das origens de dados para um modelo de design de relatório existente. As consultas de dados incluídas determinam que as partes dos dados são geradas em várias partes da saída de relatório. Você deve selecionar pontos de dados na visualização Esquemas da Origem de Dados e incluí-los em uma solicitação hierárquica no modelo.
Suportando conceitos no centro de informações do Rational Publishing Engine:
Suportando tarefas no centro de informações do Rational Publishing Engine:

5: Criar Especificação de Documento

Depois que tiver concluído a criação do modelo de relatório e o preenchido com pontos de dados do aplicativo, será possível gerar um relatório em uma variedade de formatos. Ao gerar um relatório, você deverá conectar-se à origem de dados que contém as informações sobre as quais deseja executar o relatório. Faça isso especificando uma URI que aponta para o repositório do aplicativo que contém os dados relevantes.

É possível usar filtros, que são versões mais específicas do URI da origem de dados geral, para apontar para subconjuntos específicos de dados para que Rational Publishing Engine não tente recuperar mais informações do que o necessário do repositório de aplicativo durante a geração do relatório. Esses filtros devem ser amplos o suficiente para recuperar todos os dados necessários referenciados pelo modelo ou o relatório gerado ficará incompleto.

  1. Especifique os modelos a serem incluídos no relatório.
  2. Especifique o formato de saída e o local.
  3. Determine a URI da origem de dados. É possível apontar para uma origem de dados geral, que recupera todos os dados relacionados dentro do repositório ou é possível usar filtros, opcionalmente, que são URIs mais específicas, especificando parâmetros, que recuperam um conjunto menor de dados do repositório.
  4. Insira a URI da origem de dados.
  5. Opcional: insira as credenciais de login para acessar a origem de dados especificada. Se esta especificação do documento estiver sendo compartilhada com outros usuários, você poderá desejar deixar os campos das credenciais em branco. Se as credenciais não forem especificadas e um usuário tentar executar a especificação do documento, as credenciais serão solicitadas. Se as credenciais estiverem especificadas e um usuário tentar executar o relatório, as credenciais salvas serão usadas para acessar o repositório mesmo que elas não sejam as credenciais do usuário.
Suportando conceitos no centro de informações do Rational Publishing Engine:

6: Gerar relatório

É possível gerar relatórios a partir das especificações do documento. Ao gerar um relatório, você deverá conectar-se à(s) origem(ns) de dados que fornecem os dados para o relatório. Para obter informações sobre como gerar documentos usando Rational Publishing Engine, Definindo especificações de documento sem o assistente de geração de documento

7: Importar o Relatório de Estilo de Documento Customizado

É possível importar este relatório para seu aplicativo e, em seguida, os usuários podem gerar relatórios de estilo de documento usando o Assistente para criar um relatório na interface da web. Consulte o centro de informações do produto para obter informações adicionais sobre a importação do relatório.