Estendendo o Rational DOORS com Serviços OSLC

Open Services for Lifecycle Collaboration (OSLC) é uma comunidade que está padronizando a maneira como as ferramentas de ciclo de vida trabalham juntas. O IBM® Rational DOORS suporta a especificação de compartilhamento de dados do OSLC como um fornecedor para o domínio de Gerenciamento de Requisitos e como um consumidor de outros domínios no portfólio do Rational.

O compartilhamento de dados de OSLC entre domínios é baseado em um conjunto comum de recursos, formatos e serviços de arquitetura do REST.

O compartilhamento de dados suporta as transações a seguir:
  • Vinculação baseada em protocolo HTTP
  • Identificação de recursos por URIs
  • Recuperação de informações usando tipos de mídia padrão de mercado

Guia Rápido para Rational DOORS Versão 9.3

A tabela a seguir lista os serviços e domínios OSLC que o Rational DOORS versão 9.3 consome e as operações que podem ser realizadas com recursos desses domínios.
Tabela 1. Domínios e Operações do OSLC com Rational DOORS Versão 9.3
DOORS 9.3 Seleção Criação Visualização (renderização compacta)
Change Management V1 Suportado Suportado Suportado

A tabela a seguir lista os relacionamentos do OSLC usados durante a vinculação de artefatos em várias disciplinas:

Tabela 2. Vinculação em várias Disciplinas com Change Management V1 no DOORS Versão 9.3
Links do Change Management V1
Link de Saída Link de Entrada
http://jazz.net/xmlns/prod/jazz/calm/1.0/implementedBy http://jazz.net/xmlns/prod/jazz/calm/1.0/implementsRequirement

Guia Rápido para Rational DOORS Versão 9.4

A tabela a seguir lista os domínios e serviços do OSLC que o Rational DOORS versão 9.4 consome e as operações que podem ser realizadas com recursos desses domínios.

Tabela 3. Domínios e Operações do OSLC com Rational DOORS Versão 9.4
DOORS 9.4 Seleção Criação Visualização (renderização compacta)
Change Management V1 Suportado Suportado Suportado
Change Management V2 Suportado Suportado Suportado
Quality Management V1 Suportado Suportado Suportado
Quality Management V2 Suportado Suportado Suportado
Requirements Management V1* Suportado Suportado Suportado
Requirements Management V2* Suportado Suportado Suportado
Architecture Management V2 Suportado Suportado Suportado
*DOORS 9.4 não deve ser configurado para consumir sua própria interface OSLC. O suporte é apenas para comunicação entre repositórios.

As tabelas a seguir listam os relacionamentos do OSLC usados durante a vinculação de artefatos em várias disciplinas:

Tabela 4. Vinculação em várias Disciplinas com Change Management V1
Links do Change Management V1
Link de Saída Link de Entrada
Implementado por

http://jazz.net/xmlns/prod/jazz/calm/1.0/implementedBy

Implementa

http://jazz.net/xmlns/prod/jazz/calm/1.0/implementsRequirement

Tabela 5. Vinculação em várias Disciplinas com Change Management V2
Vinculação no Change Management V2
Link de Saída Link de Entrada
Afetado por

http://open-services.net/ns/rm#affectedBy

Afeta

http://open-services.net/ns/cm#affectsRequirement

Implementado por

http://open-services.net/ns/rm#implementedBy

Implementa

http://open-services.net/ns/cm#implementsRequirement

Controlado por

http://open-services.net/ns/rm#trackedBy

Controla

http://open-services.net/ns/cm#tracksRequirement

Tabela 6. Vinculação em várias Disciplinas com Quality Management V1
Vinculação no Quality Management V1
Link de Saída Link de Entrada
Validado por

http://jazz.net/xmlns/prod/jazz/calm/1.0/validatedBy

Valida

http://jazz.net/xmlns/prod/jazz/calm/1.0/validatesRequirement

Tabela 7. Vinculação em várias Disciplinas com Quality Management V2
Vinculação no Quality Management V2
Link de Saída Link de Entrada
Validado por

http://open-services.net/ns/rm#validatedBy

Valida

http://open-services.net/ns/qm#validatesRequirement

Validado por

http://open-services.net/ns/rm#validatedBy

Valida

http://open-services.net/ns/qm#validatesRequirementCollection

Tabela 8. Vinculação em várias Disciplinas com Requirements Management V1
Vinculação no Requirements Management V1
Link de Saída Link de Entrada
Elaborado por

http://jazz.net/xmlns/prod/jazz/calm/1.0/elaboratedBy

Elabora

http://jazz.net/xmlns/prod/jazz/calm/1.0/elaboratesRequirement

Tabela 9. Vinculação em várias Disciplinas com Requirements Management V2
Vinculação no Requirements Management V2
Link de Saída Link de Entrada
Elaborado por

http://open-services.net/ns/rm#elaboratedBy

Elabora

http://open-services.net/ns/rm#elaborates

Especificado por

http://open-services.net/ns/rm#specifiedBy

Especifica

http://open-services.net/ns/rm#specifies

Tabela 10. Vinculação em várias Disciplinas com Architecture Management V2
Vinculação no Architecture Management V2
Link de Saída Link de Entrada
Não Aplicável Elabora

http://jazz.net/ns/dm/linktypes#elaborates

Não Aplicável Especifica

http://purl.org/dc/terms/relation

Os elementos e as operações da interface com o usuário (UI) a seguir do domínio de Gerenciamento de Requisitos são suportados por e disponibilizados a partir do Rational DOORS.

Elementos e Operações da UI do OSLC RM V1

A interface do OSLC RM V1 está disponível no DOORS 9.3 e posterior.

Os elementos da UI a seguir são implementados para RM V1:
  • Interface com o Usuário Delegada para a seção de recursos do requisito.
  • Interface com o Usuário Delegada para a criação de recursos do requisito.
  • Interface com o Usuário Delegada para a seleção de recursos de coleção de requisito (visualizações).
  • Renderização Compacta (texto de ajuda) de recursos do requisito.
  • Renderização Compacta (texto de ajuda) de recursos de coleção de requisito (visualizações).
  • Recurso Factory para a criação programática de recursos do requisito.
As operações a seguir são implementadas para RM V1:
  • Descoberta de Serviço.
  • POST para criação de requisito. O Post criará um novo requisito como o primeiro objeto no módulo.
  • GET em uma Coleção de Requisito.
  • PUT em uma Coleção de Requisito.
  • GET em um Requisito.
  • PUT em um Requisito.

O POST não está disponível no nível de banco de dados da árvore de descoberta de serviço.

Uma URI de Coleção de Requisito faz referência a um módulo ou a um módulo com uma visualização aplicada.

Os links internos do DOORS (dentro e fora) não são expostos nos resultados de GET da V1.

Os links externos do DOORS não são expostos nos resultados de GET da V1.

Para obter mais informações, consulte Especificação OSLC RM V1.

Elementos e Operações da UI do OSLC RM V2

A interface do OSLC RM V2 está disponível no DOORS 9.4 e posterior.

Os elementos da UI a seguir são implementados para RM V2:
  • Interface com o Usuário Delegada para a seção de recursos do requisito.
  • Interface com o Usuário Delegada para a criação de recursos do requisito.
  • Interface com o Usuário Delegada para a seleção de recursos de coleção de requisito (visualizações).
  • Renderização Compacta (texto de ajuda) de recursos do requisito.
  • Renderização Compacta (texto de ajuda) de recursos de coleção de requisito (visualizações).
  • Recurso Factory para a criação programática de recursos do requisito.
As operações a seguir são implementadas para RM V2:
  • Descoberta de Serviço.
  • Formato de Recurso.
  • POST para criação de requisito. O Post criará um novo requisito como o primeiro objeto no módulo.
  • GET em uma Coleção de Requisito.
  • PUT em uma Coleção de Requisito.
  • GET em um Requisito.
  • PUT em um Requisito.
  • QUERY também é suportado em um nível de módulo.

O POST não está disponível no nível de banco de dados da árvore de descoberta de serviço.

Uma URI de Coleção de Requisito faz referência a um módulo ou a um módulo com uma visualização aplicada.

Os links de saída internos do DOORS são expostos nos resultados de GET da V2. Eles são representados com o uso da URI do recurso do módulo de link como URI do namespace seguida por "references". Por exemplo:
http://localhost:8080/dwa/rm/urn:rational::1-46dd5d7806b96973-M-0001cc43/linkTypes/references
Os links externos do DOORS são expostos nos resultados de GET da V2. Eles são representados por:
  • Links de Entrada - http://purl.org/dc/terms/isReferencedBy
  • Links de Saída - http://purl.org/dc/terms/references
Para obter mais informações, consulte Especificação OSLC RM V2.

Serviços Raiz

Se o DOORS Web Access Server estiver instalado em {SERVER}, por exemplo, http://doors.example.com/, o documento Serviços Raiz poderá ser localizado no seguinte local:
  • Para DWA com versões anteriores à 1.4.0.2, o local é {SERVER}/rm/discovery/rootservices
  • Para DWA versão 1.4.0.2 e posterior, o local é {SERVER}/public/rootservices
O documento Serviços Raiz não faz parte da especificação OSLC, mas fornece o ponto de entrada para documentos Descoberta de Serviço do OSLC, bem como algumas outras URLs de configuração que são necessárias para se consumir serviços OSLC.

Segurança

A segurança é obrigatória e é fornecida com o uso de OAuth 1.0a. OAuth é um protocolo aberto para permitir autorização de API segura em um método simples e padrão de aplicativos da web e desktop.

Quase todas as URIs do OSLC (Descoberta de Serviço, Requisitos, Coleções de Requisito) só podem ser acessadas por um usuário autenticado. A URI Serviços Raiz é uma exceção para essa regra. Para obter mais informações, consulte Especificação OAuth 1.0a.

Para obter informações sobre como estender o Rational DOORS usando serviços DXL, consulte Serviços OSLC DXL para Rational DOORS 9.4.


Feedback