É possível gerar um documento a partir do Launcher e
do Document Studio.
Antes de Iniciar
Cada modelo está associado a uma
especificação de documento em branco por padrão. Ao visualizar ou
publicar um modelo a partir do aplicativo Document Studio, essa
especificação do documento em branco pode ser customizada ou usada
sem customização para gerar a saída.
O Document Studio mantém o
modelo em sincronização com a especificação do documento padrão
quando você abre ou salva o modelo.Nota: Essas instruções se aplicam à maioria das origens de dados, mas não
a todas.
Para obter instruções específicas da origem de dados,
consulte a documentação do
Integrando
para sua origem de dados.
Sobre Esta Tarefa
Há vários métodos diferentes para gerar documentos:
- É possível gerar documentos nos aplicativos Launcher e
Document Studio. A tarefa a seguir descreve como gerar documentos a
partir da interface com o usuário do aplicativo.
- No local de uma especificação do documento em um sistema de
arquivos, é possível clicar com o botão direito no arquivo e
clicar em Publicar com
Rational Publishing Engine.
Todos os erros são suprimidos para gerar o documento.
- Você também pode publicar documentos da interface com o usuário do
Rational DOORS
quando tiver suplementos instalados.
Não há diferença na
geração de documentos do aplicativo Launcher ou do aplicativo Document
Studio. Quando você usa o assistente para gerar documentos, as mesmas
opções são fornecidas em ambos os aplicativos.
No entanto, no
aplicativo Launcher, você tem a capacidade de configurar detalhes
para a geração de documento nas visualizações Especificação do
documento e Propriedades sem usar o assistente.
Procedimento
- No Launcher ou Document Studio, clique em
.
Você também pode clicar no ícone
Configurar e gerar
documento na barra de ferramentas.
Um assistente de configuração é aberto para permitir que
você faça seleções adicionais para a geração de documento antes de
gerar o documento. A barra de progresso exibe as informações que
devem ser configuradas em cinco seções:
- Gabaritos
- Origem de dados
- Variáveis
- Buffer
- Resumo
É possível clicar em uma seção ou um item na barra
de progresso para ir para essa página no assistente.
Dica: Enquanto houver pelo menos uma origem de dados e um formato de saída
selecionado, você pode clicar em Concluir a
qualquer momento para iniciar a geração de documento ou clicar em
Avançar para continuar com o assistente de
configuração.
- Na seção Modelos, os modelos já
listados na especificação do documento são exibidos.
Para incluir um
modelo:
- Selecione o local dos modelos para incluir:
- Na biblioteca central: Para selecionar
modelos armazenados em Document Builder
- No arquivo local ou remoto: Para
selecionar um modelo local ou remoto, você pode inserir uma URL
para um modelo ou clicar em Procurar para
selecionar um modelo.
- Selecione um ou mais modelos para incluir.
- Se você selecionou Da biblioteca central e
modelos selecionados do Document Builder,
clique em Incluir selecionado para incluir os
modelos para a especificação de documento.
- Se você selecionou No arquivo local ou
remoto e inseriu uma URL para um modelo individual,
clique em Incluir URL para incluir o modelo
na especificação do documento.
- Se você selecionou No arquivo local ou
remoto e procurou incluir modelos, clique
em Abrir; os modelos serão incluídos na especificação do documento.
- Opcional: Repita para incluir modelos adicionais de outros locais.
- Opcional: Reordene os modelos na especificação do documento selecionando
um modelo e clicando em Para cima ou
Para baixo.
- Clique em Avançar. Depois de incluir um modelo, as origens de dados e
variáveis que são especificados no modelo também são incluídos no
assistente.
- Na seção Origens de dados, configure cada origem de dados.
Nota: - Se um valor padrão existir para uma origem de dados ou um
valor URI padrão ja tiver sido digitado, a
origem de dados será exibida como configurado e o valor padrão será
usado na saída, a menos que outro valor seja selecionado.
- Se você passar pela seção Origens de dados e, em seguida,
clicar em Voltar para fazer alterações
adicionais para uma origem de dados, a seção sempre abrirá a primeira
origem de dados na lista.
- Selecione uma origem de dados de um dos
seguintes locais:
- Configuração manual: Para selecionar uma
origem de dados local ou remota porque nenhuma outra informação de
configuração existe para esta origem de dados na camada de
configuração
- Carregar da camada de configuração: Para
selecionar um valor de metadados de configuração que foi inserido
para a origem de dados no modelo
- Dependendo de sua seleção feita na etapa anterior,
você pode selecionar um valor para a origem de dados inserindo uma
URL, clicando em Procurar para selecionar uma
ou selecionar um valor da camada de configuração.
- Insira um nome de usuário e senha para autenticar com o
aplicativo de origem de dados.
- Selecione um tipo de autenticação. 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.
- Automático
- Básico
- Formulário
- OAuth
- OAuth-OSLC
- Opcional: Insira um cabeçalho de aceitação. O valor padrão é application/xml, */ *.
- Opcional: No campo Cabeçalhos extras,
selecione um link POX (Plain Old XML), por exemplo
<http://jazz.net/ns/profile#POX >;
rel="profile". Isso é útil ao
criar
documentos de rastreabilidade de aplicativos CLM (CLM
6.0.2 e posterior apenas).
- Opcional: Se você deseja aplicar as credenciais inseridas para cada
origem de dados, selecione a opção Aplicar esses valores
de nome de usuário e senha para cada origem de dados configurada e
não configurada.
- Clique em Avançar.
- Na seção Variáveis, configure cada
variável.
Nota: - Se um valor padrão existir para uma variável, a variável será
exibida como configurada e o valor padrão será usado na saída, a
menos que outro valor seja selecionado.
- Se você passar pela seção Variáveis e, em seguida, clicar em
Voltar para fazer alterações adicionais para
uma variável, a seção sempre abrirá a primeira variável na lista.
- No menu suspenso, selecione uma das opções a seguir:
- Configuração manual: Para inserir qualquer
valor para a variável porque nenhuma informação de configuração
diferente existe para esta variável na camada de configuração
- Na camada de configuração: Para selecionar
um valor a partir de metadados de configuração que você inseriu para
a variável em seu modelo
- Insira ou selecione um valor para a configuração.
- Clique em Avançar.
- Na seção Saída, selecione os
tipos de saída para gerar:
- Microsoft Word
- PDF
- HTML
- XSL-FO
- Opcional: Para Local de salvamento, clique em
Procurar para selecionar um caminho para
salvar o arquivo para cada tipo de saída. É possível editar o caminho para ser um caminho relativo a
partir da especificação do documento. Se um local de salvamento para
a saída não for especificado, o arquivo será gerado em um local
temporário.
- Opcional: Para Folha de estilo, clique em
Procurar para selecionar uma folha de estilo
para usar para cada tipo de saída ao gerar a saída.
- Opcional: Saída do Microsoft Word apenas: Para Macro, insira o nome da macro
que está contido na folha de estilo.
- Opcional: Para inserir metadados adicionais ou configurar outras
propriedades do documento que não estão incluídas no assistente,
clique em Editar propriedades dos metadados.
- Clique em Avançar.
- Verifique se as informações de modelo e saída na janela de
resumo estão corretas.
- Selecione qual ação tomar quando você clica em
Concluir:
- Executar a geração de
documento: Gera os tipos de saída especificados.
- Executar a geração de documento e
encerrar RPE: Gera os tipos de saída especificados e
fecha o aplicativo Rational Publishing Engine
depois de sair da janela Resultados.
- Salvar e fechar esse
assistente sem gerar o documento: O assistente de geração de
documento será fechado e o aplicativo Launcher permanecerá aberto.
- Clique em Concluir.
Dica: Se você estiver gerando o documento remotamente,
poderá fechar o aplicativo Document Studio ou Launcher antes que a
geração de documento seja concluída sem interromper o processo de
geração. Se você estiver gerando o documento localmente, não feche o
aplicativo Document Studio ou Launcher até que a geração de documento
seja concluída.
Resultados
A especificação do documento foi carregada no Launcher e gera
ou salva o documento, dependendo das seleções.
O que Fazer Depois
Revise as informações da geração de
documentos nas visualizações Console ou Problemas para identificar
problemas. Depois de corrigir os problemas, gere a saída novamente.
Depois de configurar a geração de documento uma vez, em gerações de
documento subsequentes, você poderá clicar em
para gerar o documento sem
concluir o Assistente de configuração.