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 a
documentação
do
produto
Rational DOORS Next Generation.
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
- 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. 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
- Inclua um esquema de origem de dados em seu
modelo de documento. Para o aplicativo RM, você pode concluir as seguintes etapas:
- No Document Studio, clique em
.
- No campo Predefinido, selecione
Texto de DNG ou Módulo de DNG.
- Em Tipo, selecione o
tipo de esquema na lista. Para o aplicativo RM, selecione XML
genérico.
- Edite o campo Esquema,
se necessário, ou clique em Procurar para
selecionar o caminho para o arquivo de esquema. Exemplo:
https://server:port/rm/publish/artifact?metadata=schema.
Para CLM 6.0.2 e posterior, é possível obter o link permanente
clicando no ícone Mostrar permalink no final da trilha de navegação
para o artefato no
Rational DOORS Next Generation. A URL é exibida na janela Mostrar permalink. Cole a URL no
campo Esquema e anexe
&metadata=schema ao final da URL.
- Clique em Avançar e, em seguida, em Concluir.
- 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 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.
- 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.
- 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.
- 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. Consulte
Origens
de
dados de
Rational Requirements Composer para obter mais informações.
- Crie
tipos
para organizar os dados em seu relatório.