Projetando modelos com o aplicativo Requirements Management como uma origem de dados

Os designers de relatório podem usar o Document Studio para importar esquemas de origem de dados e construir modelos de relatórios. Os recursos que são fornecidos pelo aplicativo Requirements Management (RM) são licenciados como IBM® Rational DOORS Next Generation. As informações sobre a integração de aplicativos RM se aplica ao Rational DOORS Next Generation e a versões específicas de IBM Rational Requirements Composer.

Antes de Iniciar

Dica: O Rational Publishing Engine inclui um conjunto de relatórios de amostra. Antes de começar a publicar documentos, você pode explorar este cenário de geração de documento de exemplo. Consulte Criando o modelo de amostra REST.
Familiarize-se com o serviço REST do aplicativo RM e as várias URLs necessárias para extrair dados do aplicativo RM quando você estiver usando Rational Publishing Engine. Para localizar o centro de informações para sua versão do aplicativo RM, consulte Sobre o centro de informações do Rational Requirements Composer.

Sobre Esta Tarefa

Os dados são extraídos usando a API REST. Esta interface é instalada e implementada com o aplicativo de origem de dados e funciona de forma independente do Rational Publishing Engine. Para obter informações adicionais sobre a API REST para uma origem de dados, consulte a documentação para essa origem de dados.

Procedimento

  1. Revise Projetando Modelos de Documentos para obter uma visão geral do processo de desenvolvimento do modelo. Inicie o planejamento da estrutura de seu documento e dos dados que podem ser incluídos. Por exemplo, decida se o documento final será gerado a partir de um modelo ou de arquivos de múltiplos modelos, cada um contendo partes reutilizáveis de conteúdo.
  2. No aplicativo Document Studio, crie um modelo de documento.
  3. Identifique um esquema de origem de dados da sua origem de dados. Para incluir partes de dados específicas do projeto do aplicativo RM, insira a URL neste formato:
    • https://server:port/rm/publish/artifact
    Por exemplo:
    • https://server:port/rm/publish/resources
  4. Inclua um esquema de origem de dados em seu modelo de documento. Para o aplicativo RM, você pode concluir as seguintes etapas:
    1. No Document Studio, clique em Dados > Incluir esquema da origem de dados.
    2. Em Tipo, selecione o tipo de esquema na lista. Para o aplicativo RM, selecione XML genérico.
    3. No campo Arquivo de esquema, cole na URL que você identificou como o esquema da origem de dados.
    4. Anexe ?metadata=schema ao final da URL.
      • Exemplo: https://server:port/rm/publish/artifact?metadata=schema
    5. Se o recurso estiver em um servidor protegido, especifique o nome de Usuário.
    6. Se o recurso estiver em um servidor protegido, especifique a Senha.
    7. Selecione o Tipo de autenticação na lista. Para o aplicativo RM, o tipo de autenticação é OAuth. Se você não selecionar OAuth, cada tipo de autenticação será testado até que o tipo correto seja localizado, o que pode aumentar o tempo de geração do documento.
  5. Inclua elementos no modelo. O Rational Publishing Engine tem um conjunto abrangente de elementos de modelo que podem ser usados para estruturar seu documento. É possível arrastar elementos para o editor de conteúdo do modelo. Por exemplo, é possível incluir um elemento do contêiner para manter vários parágrafos. Cada parágrafo pode ser controlado por uma condição de teste que o associa apenas com dados específicos. Para obter informações adicionais, consulte Elementos do Modelo na Visualização Paleta e Incluir elementos em um modelo.
    Elementos da tabela
    Quando os dados da tabela são a entrada do aplicativo RM, larguras devem ser especificadas no nível da coluna, como em cada célula, e não no nível de tabela, para que sejam processadas pelo Rational Publishing Engine.
  6. Use consultas, atributos e variáveis para incluir dados em um modelo. Esses itens especificam quais partes das informações são geradas no relatório.
  7. Inclua formatação e estilo para os elementos para controlar como eles são exibidos na saída.
  8. Crie filtros para restringir os dados que são extraídos no relatório. É possível usar filtros, que são versões detalhadas do URI da origem de dados geral, para apontar para subconjuntos específicos de dados de forma que o Rational Publishing Engine não tente recuperar mais informações do que as necessárias da origem de dados durante a geração de relatórios. Esses filtros devem ser amplos o suficiente para recuperar todos os dados necessários referidos pelo modelo ou o relatório gerado não poderá incluir os dados completos. Consulte Origens de dados de Rational Requirements Composer para obter mais informações.
  9. Crie tipos para organizar os dados em seu relatório.