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 o Rational DOORS

A tabela a seguir lista os serviços e domínios OSLC que o Rational DOORS consome e as operações que podem ser realizadas com recursos desses domínios. O Change Management V1 foi apresentado no Rational DOORS versão 9.3. Suporte para todos os outros domínios e serviços foi incluído no 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 e posterior consomem e as operações que podem ser realizadas com recursos desses domínios.

Tabela 1. Domínios e Operações do OSLC com o Rational DOORS
Rational DOORS 9.4 e posterior. 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
*O Rational DOORS não deverá 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 2. 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 3. 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 4. 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 5. 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 6. 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 7. 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 8. 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 Refina

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

Não Aplicável Satisfaz

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

Não Aplicável Rastreio

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

Quando um usuário abre um módulo no Rational DOORS, os links OSLC externos para/de outros produtos de ciclo de vida são "descobertos" e os resultados são armazenados em um cache que abrange todo o banco de dados para que os módulos sejam abertos mais rápido no futuro. Esse processo de descoberta de link tem um impacto de desempenho potencial ao abrir um módulo, dependendo do desempenho do produto integrado. O cache tem um valor de tempo limite padrão de 5 minutos. Depois desse tempo, os links precisam ser "redescobertos" para que o cache tenha o status mais atualizado dos links. É possível alterar esse valor de tempo limite usando o DXL perm setCachedExternalLinkLifeTime. Para obter informações adicionais, consulte "OSLC Link Discovery" no DXL Reference Manual, que está disponível como um PDF e a partir do menu Ajuda.

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 Rational DOORS 9.3 e posteriores.

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 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.

Links internos do Rational DOORS (internos ou externos) não são expostos nos resultados de GET de V1.

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

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

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

A interface OSLC RM V2 está disponível no Rational DOORS 9.4 e posteriores.

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 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 Rational DOORS são expostos nos resultados V2 GET. 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 Rational DOORS são expostos nos resultados de GET de 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 o OSLC RM V2 Specification.

Serviços Raiz

Se o Rational DOORS Web Access Server estiver instalado no {SERVER}, por exemplo, http://doors.example.com/, o documento Serviços Raiz poderá ser localizado no seguinte local:
  • Para as versões do Rational DOORS Web Access anteriores à 1.4.0.2, o local é {SERVER}/rm/discovery/rootservices
  • Para o Rational DOORS Web Access versão 1.4.0.2 e posteriores, 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. Consulte também Usando DXL (o Rational DOORS Extension Language).


Feedback