Projetando Modelos com Rational DOORS 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

Examine o módulo do Rational DOORS que você deseja usar e seu conteúdo. Para localizar a documentação do produto para sua versão do Rational DOORS, consulte Sobre o centro de informações do Rational DOORS.

É possível usar a combinação de propriedades do módulo, atributos do objeto e visualizações armazenadas nos módulos. Revise as visualizações disponíveis em um módulo para colunas calculadas, incluindo visualizações de rastreabilidade ou, possivelmente, colunas DXL de Layout. Essas visualizações não correspondem aos atributos do Rational DOORS, mas podem ser algo que você gostaria de incluir no relatório.

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. Há duas maneiras de incluir uma origem de dados: por meio do Assistente de descoberta de esquema do DOORS ou Assistente de esquema da origem de dados. Para incluir uma origem de dados usando o Assistente de esquema da origem de dados:
    1. No Document Studio, clique em Dados > Incluir esquema da origem de dados.
    2. No campo Predefinido, selecione o esquema do banco de dados Doors.
    3. Em Tipo, selecione o tipo de esquema na lista. Para Rational DOORS, selecione DOORS.
    4. Edite o campo Esquema, se necessário, ou clique em Procurar para selecionar o caminho para o arquivo de esquema.
    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 Rational DOORS, o tipo de autenticação é OAuth-OSLC. Se você não selecionar OAuth-OSLC, 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.

    Para incluir uma origem de dados usando o Assistente de descoberta de esquema do DOORS:

    1. No Document Studio, clique em Dados > Descoberta de Esquema > Descoberta de Esquema do DOORS.
    2. Especifique os detalhes da conexão:
      • Para usar uma instância em execução do Rational DOORS, selecione Usar instância do DOORS em execução.
      • Para executar Rational DOORS em segundo plano, selecione Executar um novo processo do DOORS em segundo plano. Especifique o nome de usuário, senha, banco de dados e caminho para doors.exe.
    3. Selecione uma visualização:
      • Visualização de banco de dados
      • Visualização de Projeto
    4. Clique em Avançar.
    5. Selecione o tipo de atributo:
      • Para incluir atributos nos objetos principais, elementos de esquema Module/Object, selecione Atributos de módulos e objetos.
      • Para incluir atributos para objetos vinculados, elemento de esquema Module/Object/Link/Linked, selecione Atributos de objetos vinculados.
    6. Na janela Seleção do Módulo do DOORS, selecione um módulo na estrutura de banco de dados do Rational DOORS e clique em Avançar.
    7. Na janela Linha de Base do DOORS, selecione uma linha de base para o módulo. A linha de base selecionada determina qual conjunto de atributos usar.
    8. Na janela Atributos do DOORS, as informações sobre o atributo a seguir são exibidas:
      • Nome do Atributo: Lista atributos disponíveis na linha de base selecionada.
      • Escopo: Exibe o escopo do atributo como um módulo ou um objeto.
      • Nome da Elevação: O nome elevado do atributo é o nome usado nas expressões de script. Um nome válido é gerado a partir do nome do atributo do Rational DOORS para evitar a inserção de um valor inválido. Um atributo elevado permite acesso direto a esse valor de atributo a partir de um contexto de Module/Object. Valores de atributos não elevados estão disponíveis somente a partir de um contexto de Module/Object/Attribute.

      Selecione a caixa de seleção para especificar um atributo ou use Selecionar Todos para selecionar todos os atributos. Cancelar Seleção de Todos limpa todos os atributos. Clique em Avançar.

    9. Na janela Visualizações e Colunas do DOORS, selecione a visualização. Em seguida, selecione a caixa de seleção para um nome de coluna para selecionar a coluna ou Selecione Todos para selecionar todos os nomes das colunas. Clique em Avançar.
      Nota: Um nome de elevação da coluna é exibido na coluna Nome de Elevação. É possível elevar colunas de um número qualquer de visualizações. É possível elevar os atributos posteriormente ao projetar o modelo. Os atributos incluem informações declarativas em elementos além das palavras-chave predefinidas usuais. Os atributos do Rational DOORS definidos pelo usuário estão acessíveis somente por meio dos nós Attribute no arquivo de esquema padrão do Rational DOORS. Para usar esses atributos, os valores de atributos podem ser elevados como atributos XML usando o assistente de descoberta de esquema XML. Um atributo pode ter uma única ocorrência, por exemplo, Module Name, e a propriedade Last Modified On. Os atributos podem se aplicar a um objeto, mas ter várias ocorrências, como o Título do Objeto e Texto do Objeto.
    10. Na janela Selecione Opções Esquema, insira os detalhes para os campos a seguir:
      • Selecionar Local de Esquema: Clique em Procurar para selecionar o local para salvar o esquema da origem de dados.
      • ID do Esquema da Origem de Dados: Insira o ID para o esquema da origem de dados.
      • Selecione a caixa de seleção Incluir esquema da origem de dados no modelo atual para incluir esse esquema no modelo aberto. Clique em Avançar.
      • Salve os esquemas para reutilizá-los em outros modelos sem executar o Assistente de Descoberta de Esquema novamente.
    11. Revise as informações na janela de resumo e clique em Concluir.
  4. Trabalhe com atributos. Você pode descobrir quais atributos de objetos estão presentes no módulo do Rational DOORS e então avaliar se eles devem aparecer em seu relatório do Rational Publishing Engine. Use a seleção de menu Editar > Atributos para acessar a lista de atributos incluídos no módulo.
  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 do contêiner
    É possível usar elementos do contêiner em vez de tabelas para diagramas do analista do Rational DOORS contidos em uma tabela 1x1.
    Elementos de imagem
    As imagens são extraídas de um módulo do Rational DOORS com os valores para o atributo. Não é possível consultar para as imagens apenas.
    Para configurar o tamanho das imagens extraídas, especifique as propriedades Largura máxima da imagem e Altura máxima da imagem. Essas propriedades podem ser especificadas em dois locais:
    • Informações de formato de elemento definem o tamanho das imagens contidas nesse elemento do modelo. Disponível para elementos de modelo de texto apenas.
    • Metadados da especificação do documento definem o tamanho para as imagens em todos os modelos. Os valores de formatos de elementos substituem esses valores globais.
    Elementos da tabela
    Você pode não ser capaz de reproduzir uma tabela do Rational DOORS no Rational Publishing Engine exatamente como ela aparece no Rational DOORS; é possível usar atributos da tabela disponíveis do Rational DOORS e gerar uma nova tabela.
    Use o assistente de esquema do Rational DOORS para extrair informações sobre as tabelas do Rational DOORS. Exemplo: TableCellWidthLargura da Célula em pixels de tela. Há duas maneiras de se extrair informações da coluna do Rational DOORS:
    • Usando module/object/column para obter os nomes e valores em uma consulta de objeto. Isso é útil quando os dados do Rational DOORS são iterados por objeto.
    • Usando module/view/column para obter os nomes de colunas da visualização Rational DOORS usada para geração de documento. Iterar por Visualização é útil quando as colunas definidas na visualização atual e suas propriedades são necessárias. É possível usar os modelos de amostra do Rational Publishing Engine para testar esses métodos.
      Nota: Para acessar dados da coluna, use module/object/column/(@Column Text) na consulta.

    Se você tiver células nas tabelas do Rational DOORS que abrangem várias linhas, Rational Publishing Engine gerará a primeira célula e as células restantes na extensão serão removidas.

    Consulte Incluindo um elemento de tabela para obter mais informações sobre tabelas.

  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. Consultas no IBM® Rational DOORS começam com o elemento raiz (module), continuam com seu elemento-filho (object), depois com o atributo-filho Object. Por exemplo, Module/Object/Attribute/Name. Consulte Esquema do Rational DOORS para obter informações adicionais.
  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. Você pode definir filtros nativos em consultas de link. Consulte Exemplo: Filtros nativos do Rational DOORS para obter informações adicionais.
  9. Crie tipos para organizar os dados em seu relatório. Para Rational DOORS, o texto de classificação nativa deve estar no formato de classificação do Rational DOORS. Consulte Exemplo: Classificações nativas no Rational DOORS para obter informações adicionais.

O que Fazer Depois

Se você visualizar dados a partir do aplicativo Document Studio, a linha de base padrão e a visualização serão usadas para recuperar os dados.