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
Rational Rhapsody
e as várias URLs necessárias para extrair dados do
Rational Rhapsody
usando o
Rational Publishing Engine. Para localizar o centro de informações para sua versão do
Rational Rhapsody, consulte
Sobre o Centro de Informações do Rational Rhapsody.
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.
- Inclua um esquema de origem de dados em seu
modelo de documento. Para
Rational Rhapsody,
você pode concluir as seguintes etapas:
- No Document Studio, clique em
.
- No campo Predefinido, selecione
Rhapsody.
- Em Tipo, selecione o
tipo de esquema na lista. Para
Rational Rhapsody,
selecione REST.
- Edite o campo Esquema, se necessário, ou
clique em Procurar para selecionar o caminho
para o arquivo de esquema. A URL base para
Rational Rhapsody
é:
https://server:port/Rational/Rhapsody/.
Junto com ?metadata=schema, a URL é:
https://server:port/Rational/Rhapsody/?metadata=schema
O
local padrão para o esquema do
Rational Rhapsody
é Rational_Rhapsody_HOME\RPE\Schemas. Exemplo:
Rational_Rhapsody_HOME\RPE\Schemas\default.xsd
Ao escolher um esquema de um modelo com perfis aplicados e novos
termos, certifique-se de que o modelo com perfis e novos termos seja
carregado no Rational Rhapsody.
- 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.
- Clique em Concluir. O esquema da origem de dados que você selecionou é
exibido na Visualização de origem de dados.
- 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. Rational Rhapsody
suporta origens de dados Rest v1 relatáveis para uso em
filtros nativos. 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. Consulte também Condições de filtro suportadas pelos filtros nativos REST para obter informações adicionais.
- É possível usar um filtro de consulta cast para refinar os resultados de uma consulta. O recurso de conversão de tipo funciona como um filtro
alternativo para elementos de origem de dados, consulte
Tipo que sofre coerção
para obter detalhes.
- Crie
tipos
para organizar os dados em seu relatório.