Projetando Modelos com Design 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.

Antes de Iniciar

Familiarize-se com o serviço REST do Design Management e as várias URLs necessárias para extrair dados do Design Management usando o Rational Publishing Engine. Para localizar o centro de informações para sua versão do Design Management, consulte Centros de informações da família de produtos Rational Software Architect.

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. Inclua um esquema da origem de dados em seu modelo de documento usando o perfil POX (CLM 6.0.2 e posterior): Para obter mais informações sobre o perfil POX, consulte Criando documentos de rastreabilidade de aplicativos CLM usando o perfil POX
    1. No Design Management, copie a URL do artefato clicando no ícone Mostrar permalink na trilha de navegação.
    2. No Document Studio, clique em Dados > Incluir esquema da origem de dados.
    3. No campo Predefinido, selecione DS1.
    4. Em Tipo, selecione REST.
    5. Cole a URL no campo Esquema e anexe & metadata=schema no final da URL.
    6. No campo Cabeçalhos extras, selecione o cabeçalho do perfil POX.
    7. Clique em Avançar e, em seguida, em Concluir. O esquema da origem de dados que você selecionou é exibido na Visualização de origem de dados.
  4. Inclua um esquema da origem de dados em seu modelo de documento usando Descoberta de esquema REST (CLM 6.0.1 e anterior): Para o Design Management, é possível descobrir o esquema da origem de dados inserindo a URL base no aplicativo.
    1. No Document Studio, clique em Dados > Descoberta do esquema > Descoberta de esquema REST.
    2. Insira um Nome para a origem de dados.
    3. Insira uma Descrição para a origem de dados.
    4. Especifique a URL base para o recurso. A URL base para Design Management é: https://server:port/dm/reporting
    5. Selecione o Tipo de autenticação na lista.
      Importante: Para Design Management, você deve especificar um tipo de autenticação para acessar dados para seu relatório. O tipo de autenticação não pode ser automaticamente detectado pelo Rational Publishing Engine.
    6. Se o recurso estiver em um servidor protegido, especifique o nome de Usuário.
    7. Se o recurso estiver em um servidor protegido, especifique a Senha.
    8. Clique em Avançar. A URL base que inseriu é anexa automaticamente com ?metadata=schema. Exemplo: https://server:port/dm/reporting?metadata=schema
    9. Clique em Concluir. O esquema da origem de dados que você selecionou é exibido na Visualização de origem de dados.
  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.
  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. Design Management suporta a filtragem nativa das origens de dados Rest v1 relatáveis. Nos filtros nativos Rest v1 relatáveis, só é necessário digitar o texto entre os colchetes []. O resto do filtro é gerado pelo Rational Publishing Engine. Para obter mais informações, consulte Reportable Rest v1.
  9. Crie tipos para organizar os dados em seu relatório.