Gerando documentos com o Rational DOORS como uma origem de dados

Depois de concluir a criação do modelo de relatório e de preenchê-lo com pontos de dados, poderá gerar um relatório em vários formatos.

Antes de Iniciar

Se você visualizar dados do aplicativo Launcher, a linha de base padrão e a visualização serão usadas para recuperar os dados.

É possível extrair Object Linking and Embedding (OLEs) de uma origem de dados do Rational DOORS. Consulte Objetos OLE.

Gerando um documento usando o suplemento

Se você tiver o suplemento do Rational DOORS instalado, poderá gerar documentos diretamente a partir da interface com o usuário do Rational DOORS.

Sobre Esta Tarefa

  • Quando uma geração de documento local é iniciada do suplemento Rational Publishing Engine pela interface com o usuário ou pela linha de comandos, uma licença é consumida no computador. A licença é retirada quando a geração de documento remoto é iniciada. Em seguida, a licença é registrada depois que a geração do documento está concluída.
  • Quando uma geração de documento remoto é iniciada do suplemento Rational Publishing Engine pela interface com o usuário ou pela linha de comandos, uma licença é consumida no servidor. A licença é retirada quando a geração de documento remoto é iniciada. Em seguida, a licença é registrada depois que a geração do documento está concluída.
Nota: Não é possível acessar as interfaces com o usuário do Document Studio ou do Launcher enquanto usa o suplemento do Rational Publishing Engine para publicar um documento.

Procedimento

Na visualização Banco de dados ou Módulo, clique em Publish.
  • Quando você clica em Publish na visualização Banco de dados, é solicitado quanto às configurações de especificação de modelo e documento da mesma forma que seria ao clicar em Especificação do documento > Gerar > Configurar e gerar documento no Rational Publishing Engine.
  • Quando você clica em Publish na visualização Módulo, pode selecionar uma nova especificação de documento e incluir modelos nela, ou pode selecionar uma especificação de documento existente que já possua modelos incluídos. Em seguida, se o modelo usar uma origem de dados Rational DOORS, o Rational Publishing Engine configura a origem de dados com as informações do Módulo aberto para gerar o documento. Se qualquer informação de configuração existente na especificação do documento não corresponder às informações do Módulo aberto, as informações existentes serão sobrescritas pelas informações do Módulo aberto. Concluir é ativado quando pelo menos um modelo e um formato de saída é selecionado.
    Importante: Para geração de documento local, o Rational Publishing Engine pode conectar a um cliente do Rational DOORS em execução, no entanto, para geração remota de documento, essa opção não está disponível. Se estiver publicando usando o mecanismo de geração remota a partir da visualização Banco de Dados ou Módulo, você deve inserir as credenciais de autenticação na especificação do documento antes de gerar seu documento de forma que o serviço do Rational Publishing Engine remoto possa instanciar um novo cliente do Rational DOORS sem interface com o usuário para efetuar pull dos dados do relatório.

Gerando um documento usando o assistente de geração de documentos do Rational Publishing Engine

É possível usar o assistente de geração de documentos para configurar os requisitos de relatório.

Procedimento

  1. No aplicativo Document Studio ou Launcher, abra o assistente de geração de documentos clicando em Especificação de documento > Gerar > Configurar e gerar documento.
  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. Banco de dados: Insira o nome do banco de dados ao qual se conectar. Por padrão, -data 36677@localhost é usado. Se -data não for especificado, ele será automaticamente anexado para você. Se nenhum valor for especificado, Rational Publishing Engine recuperará o valor padrão do registro sempre que possível.
    2. Caminho para doors.exe: Insira o caminho completo para doors.exe. Se o caminho for inválido ou não puder ser acessado, o assistente corrigirá o caminho para você quando possível. Exemplo: C:\Program Files\IBM\Rational\DOORS\version\bin\doors.exe
    3. URI do móduloVisualização, e Linha de base: É possível digitar esses valores ou clicar em Descobrir para usar um assistente para selecionar de uma lista de valores. Se você optar por usar o Assistente de descoberta, clique em Avançar e conclua uma das etapas a seguir:
      • Clique em Avançar para selecionar valores para o URI de módulo, Visualizar e Linha de base. Se você clicar em Avançar, na janela Selecionar uma visualização a partir do banco de dados DOORS, poderá selecionar a partir de listas de módulos, visualizações e linhas de base. Em seguida clique em Concluir.
      • Insira um URI de módulo. Depois que um URI de módulo for inserido, Concluir será ativado e você poderá clicar nele para usar os valores padrão para visualização e linha de base. Para usar uma visualização e linha de base diferentes dos padrões, insira os valores Visualizar e Linha de base e clique em Concluir.
        Nota: Se você editar manualmente o valor URI de módulo e inserir um valor incorreto, poderá evitar que a saída seja gerada. Quando você fornecer um valor incorreto ou nulo para Visualizar ou Linha de base, a saída será gerada a partir da visualização padrão da versão do módulo atual. A saída é gerada, mas os dados podem não estar corretos.
    4. Nome de usuário: Insira o nome da conta do Rational DOORS.
    5. Senha: Insira a senha de conta do Rational DOORS.
    6. Escolha se deseja usar a opção Usar a instância do DOORS em execução durante a geração de documento:
      • Se o Rational DOORS precisar estar em execução no local especificado para o campo Caminho para doors.exe quando você gerar um documento a partir desta especificação de documento, selecione a opção Usar instância DOORS em execução durante a geração do documento. O tempo de processamento pode ser mais rápido quando você usa a instância do Rational DOORS em execução.
      • Se Rational DOORS não precisar estar em execução no local especificado para o campo Caminho para doors.exe quando você gerar um documento a partir desta especificação do documento, limpe a opção Usar a instância DOORS em execução durante a geração do documento para iniciar uma nova instância.
        Nota: Se o aplicativo de serviços remotos for usado, as propriedades doors_home e new_instance serão sempre regravadas pelo aplicativo de serviços remotos. Depois que a especificação do documento for transferida por upload, o Rational Publishing Engine regravará as propriedades para corresponder à configuração do servidor.

    Quando valores incorretos são substituídos pelo Rational Publishing Engine no assistente, eles também são atualizados na visualização Propriedades da origem de dados e nos valores de sinalizadores de tempo de execução.

  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.
    Nota: Se você estiver usando o Assistente de geração de documento do suplemento do Rational DOORS, selecionar Salvar e fechar este assistente sem gerar o documento fechará o assistente e o aplicativo Launcher.