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
- 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.
- No aplicativo Document Studio,
crie
um modelo de documento.
- 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:
- No Document Studio, clique em
.
- No campo Predefinido, selecione o
esquema do banco de dados Doors.
- Em Tipo, selecione o
tipo de esquema na lista. Para Rational DOORS, selecione DOORS.
- Edite o campo Esquema, se necessário, ou
clique em Procurar para selecionar o caminho
para o arquivo de esquema.
- Se o recurso estiver em um servidor protegido,
especifique o nome de Usuário.
- Se o recurso estiver em um servidor protegido,
especifique a Senha.
- 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:
- No Document Studio, clique em .
- 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.
- Selecione uma visualização:
- Visualização de banco de dados
- Visualização de Projeto
- Clique em Avançar.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Revise as informações na janela de resumo e clique em Concluir.
- 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
para acessar a lista de atributos incluídos no módulo.
- 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:
TableCellWidth –
Largura da Célula em pixels de tela. Há duas maneiras de se extrair informações da coluna do
Rational DOORS:
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.
- 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.
- Inclua formatação
e estilo para os elementos para controlar como eles são
exibidos na saída.
- 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.
- 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.