Criando documentos de rastreabilidade de aplicativos CLM usando o perfil POX

Agora está mais fácil do que nunca criar documentos de rastreabilidade de aplicativos CLM. Você pode configurar URLs OSLC para retornar dados de representação REST relatáveis se um cabeçalho especial for incluído na solicitação usando POX (Plain Old XML).

Antes de Iniciar

Você deve ter o Rational Publishing Engine 2.1.0 ou posterior e o Rational solution for CLM 6.0.2 ou posterior instalados.

Sobre Esta Tarefa

Anteriormente, era difícil criar documentos de rastreabilidade porque alguns aplicativos, por exemplo Rational Quality Manager eRational Team Concert, usam as URLs OSLC, e Rational Publishing Engine requer URLs REST relatáveis. Este era um design de modelo complicado, pois as URLs precisavam ser convertidas de OSLC para REST relatável. Às vezes a representação OSLC de um artefato não contém informações suficientes necessárias para geração de documento, por exemplo, rich text.

O perfil POX permite utilizar URLs OSLC como se fossem APIs REST relatáveis. Você pode usar o perfil POX no Rational Publishing Engine para solicitar e receber dados REST relatáveis diretamente fornecendo um cabeçalho extra. Você não precisa mais converter as URLs ou executar solicitações duplicadas. O serviço de geração de documento retornará o XML adicional na presença do cabeçalho.

Exemplo: Criando um documento de rastreabilidade do Rational DOORS Next Generation para Design Management

Procedimento

  1. No Document Studio, inclua um esquema de Rational DOORS Next Generation Incluindo um esquema da origem de dados .
  2. Crie elementos de modelo para imprimir as informações de um artefato.
    Elemento DNG
  3. Repita as informações do link no requisito.
    Link DNG
  4. No Design Management, copie a URL do artefato clicando no ícone Mostrar permalink na trilha de navegação.
  5. No Document Studio, abra o Assistente para incluir esquema de origem de dados.
  6. (Novo) Cole a URL no campo Esquema e anexe & metadata=schema no final da URL.
  7. (Novo) No campo Cabeçalhos extras, selecione o cabeçalho do perfil POX.
    Incluindo uma origem DM com perfil POX
  8. Clique em Avançar e, em seguida, em Concluir.
  9. Em seu modelo, crie elementos de modelo que seguem o link de volta para Rational DOORS Next Generation. Abra a Configuração de origem de dados na visualização Propriedades e clique na guia Configuração dinâmica:
    1. (Novo) No campo URI , insira o href do Rational DOORS Next Generation.
    2. (Novo) No campo Aceitar cabeçalho, insira application/xml.
    3. (Novo) No campo Cabeçalhos extras, selecione o link do perfil POX. Os cabeçalhos extras solicitam ao aplicativo que respondam com informações REST relatáveis, mesmo que uma URL OSLC seja usada.
      Configuração de origem de dados para perfil POX
  10. Criar elementos de modelo para imprimir as informações de Design Management.
    Elemento DM
  11. Alterne para RPE Launcher para gerar o documento.
  12. Na visualização Especificação do documento, clique com o botão direito na origem de dados do Rational DOORS Next Generation e selecione Configurar origem de dados.
    1. URL: Insira a URL de permalink a partir de Rational DOORS Next Generation.
    2. Se necessário, insira um nome de usuário e senha.
    3. Autenticação: Selecione OAuth.
    4. Aceitar cabeçalho: Insira application/xml.
    5. (Novo) Cabeçalhos extras: Selecione o link do perfil POX para solicitar dados REST relatáveis do Rational DOORS Next Generation.
  13. Na barra de ferramentas principal, clique em Gerar documento. Na visualização Console, você pode ver que o Rational Publishing Engine solicita dados de Design Management e Rational DOORS Next Generation usando as URLs OSLC. Design Management e Rational DOORS Next Generation são redirecionadas para URLs REST relatáveis. O documento de saída contém o requisito de Rational DOORS Next Generation e os dados de modelo associados de Design Management.
    Resultado mostrando dados DNG e dados DM