Gerando um documento com o Assistente de geração de documento

É 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:

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

  1. No Launcher ou Document Studio, clique em Especificação do documento > Gerar > Configurar e gerar documento.

    Você também pode clicar no ícone Configurar e gerar documento 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.
  2. Na seção Modelos, os modelos já listados na especificação do documento são exibidos. Para incluir um modelo:
    1. 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.
    2. 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.
    3. Opcional: Repita para incluir modelos adicionais de outros locais.
    4. Opcional: Reordene os modelos na especificação do documento selecionando um modelo e clicando em Para cima ou Para baixo.
    5. 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.
  3. 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.
    1. 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
    2. 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.
    3. Insira um nome de usuário e senha para autenticar com o aplicativo de origem de dados.
    4. 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
    5. Opcional: Insira um cabeçalho de aceitação. O valor padrão é application/xml, */ *.
    6. 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).
    7. 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.
    8. Clique em Avançar.
  4. 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.
    1. 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
    2. Insira ou selecione um valor para a configuração.
    3. Clique em Avançar.
  5. Na seção Saída, selecione os tipos de saída para gerar:
    • Microsoft Word
    • PDF
    • HTML
    • XSL-FO
    1. 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.
    2. 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.
    3. Opcional: Saída do Microsoft Word apenas: Para Macro, insira o nome da macro que está contido na folha de estilo.
    4. 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.
    5. Clique em Avançar.
  6. Verifique se as informações de modelo e saída na janela de resumo estão corretas.
  7. 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.
  8. 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 Especificação de documento > Gerar > Gerar documento para gerar o documento sem concluir o Assistente de configuração.