Exemplo: Recuperando Artefatos de Aplicativos que Suportam a API do RESTful

Este exemplo descreve como recuperar os artefatos do aplicativo Requirements Management do Rational solution for Collaborative Lifecycle Management e criar elementos no IBM® Rational Focal Point.

Propósito

Se você tiver requisitos no aplicativo Requirements Management e desejar priorizá-los no Rational Focal Point, será possível usar o Comando de Visualização do Cliente REST para recuperar os requisitos.
Pré-requisito:
  • Configure o endereço IP e o nome do host do servidor Rational solution for CLM no arquivo host do computador a partir do qual você está configurando a integração. Para Windows, o arquivo host está geralmente localizado em C:\Windows\System32\drivers\etc, e para Linux, o arquivo host está localizado em /etc/hosts.
  • Inclua o aplicativo Requirements Management como Amigos (Saída) no Rational Focal Point. Para obter informações adicionais, consulte Conectando-se ao Servidor de Aplicativos do Rational Solution para Collaborative Lifecycle Management.
  • Esteja ciente da estrutura XML dos artefatos do aplicativo Requirements Management artefatos e tenha os direitos para acessá-los.

Amostra

Este exemplo presume que o Rational Focal Point possui uma área de trabalho FP-RRC e uma visualização Visualizar Requisitos de RRC. A tabela mostra alguns dos atributos disponíveis no Rational Focal Point e no aplicativo Requirements Management.
Tabela 1. Atributos para o Rational Focal Point e o Aplicativo Requirements Management
Atributos do Rational Focal Point Atributos do aplicativo Requirements Management
Opção de combustível rrm:description
Eficiência de combustível rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
Link de Integração rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
Título ds:location/ds:project/rrm:title
  1. No Rational Focal Point, abra a área de trabalho FP-RRC na qual você deseja recuperar os artefatos.
  2. Clique em Configurar > Comando de Visualização do Cliente REST e clique em Incluir Comando de Visualização.
  3. Em Nome do Conector do Cliente REST, digite um Conector RRC para identificar a conexão.
  4. Em Método de Solicitação do REST, selecione o método GET.
  5. Em Lista de Amigos, selecione RRC.
  6. Em URL de Solicitação de Aplicativo do REST, digite a URL do aplicativo que contém os artefatos que você deseja recuperar. Por exemplo, para obter os artefatos do aplicativo Requirements Management, digite https://<hostName>:<portNumber>/rm/<projectName>/<collectionName>
    Dica: Abra um navegador da web e digite a URL que você usou ao incluir o aplicativo Requirements Management como um amigo. Uma lista de artefatos de alto nível é exibida. Descubra o artefato que você deseja recuperar e copie sua URL em URL de Solicitação de Aplicativo do REST.
  7. Clique em Conectar.
  8. Clique em Selecionar XPath Raiz para restringir sua procura por artefatos a uma coleção. Selecione /ds:dataSource/ds:artifact. O XPath é usado para limitar a procura para os artefatos. Os XPaths são a estrutura XML hierárquica de um aplicativo.
  9. Para assegurar que os artefatos não sejam duplicados, na seção ID de Mapeamento, clique em Incluir e mapeie Opção de Combustível do Rational Focal Point e rrm:description do aplicativo Requirements Management. É possível mapear apenas um atributo.
  10. No Mapeamento de Atributos seção, clique em Incluir para mapear os atributos a seguir entre o aplicativo Requirements Management e o Rational Focal Point. Os atributos mapeados são exibidos com relação ao elemento recuperado do aplicativo. Assegure-se de que os atributos sejam editáveis.
    Nota: O atributo que você selecionou na seção Mapeamento de ID não é exibido na seção Mapeamento de Atributos porque esse atributo é mapeado internamente e está disponível para os elementos buscados.
    Tabela 2. Mapear Atributos entre o Rational Focal Point e o Aplicativo Requirements Management
    Atributos do Rational Focal Point Atributos do aplicativo Requirements Management
    Eficiência de combustível rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
    Link de Integração rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
    Título ds:location/ds:project/rrm:title
  11. No campo Formato de Data Suportado pelo Aplicativo REST, digite 2012-08-18.
  12. No campo Separador do Focal Point, mantenha , no estado em que se encontra.
  13. Clique em Salvar.
  14. Abra a visualização Visualizar Requisitos de RRC e selecione Conector RRC na lista suspensa. Uma lista de requisitos e atributos é recuperada e criada como elementos na visualização.

Feedback