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
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 Rational Change REST e as várias URLs necessárias para extrair dados do
Rational Change usando o
Rational Publishing Engine.
Para localizar o centro de informações para sua versão do
Rational Change, consulte
Sobre o centro de
informações do Rational
Change.
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 Rational Change,
construa uma URL que use o argumento artifacts. Você sempre usa este esquema e o configura dinamicamente para partes
específicas de dados em seu modelo do projeto Rational Change.
- Exemplo:
https://server:port/ibm/report/com.ibm.change.project.artifacts.xsd
- Inclua um esquema de origem de dados em seu
modelo de documento. Para Rational
Change, você pode concluir as seguintes etapas:
- No Document Studio, clique em
.
- Em Tipo, selecione o
tipo de esquema na lista. Para Rational
Change, selecione XML genérico.
- No campo Arquivo de esquema, cole na URL
que você identificou como o esquema da origem de dados.
- Anexe ?metadata=schema ao final da URL.
- Exemplo:
https://server:port/ibm/report/com.ibm.change.project.artifacts.xsd?metadata=schema
- 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. Se não selecionar um tipo, cada tipo 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.
- 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.
- Crie
tipos
para organizar os dados em seu relatório.