Se um aplicativo suportar APIs do RESTful, será possível criar
artefatos nesse aplicativo a partir das necessidades de negócios no IBM® Rational Focal Point.
Por exemplo, é possível criar requisitos no aplicativo Requirements Management
do Rational solution for
Collaborative Lifecycle Management a partir
das necessidades de negócios no Rational Focal Point.
Antes de Iniciar
- Assegure-se de que você tenha acesso apropriado para o aplicativo no
qual está criando artefatos a partir do Rational Focal Point.
- Inclua o aplicativo como um amigo de 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.
- Certifique-se de que o conteúdo do aplicativo que suporta as APIs
do REST esteja no formato XML.
- Esteja ciente da estrutura XML dos artefatos de aplicativos e
tenha os direitos para acessá-los.
Procedimento
- No Rational Focal Point,
abra a área de trabalho.
- Clique em e
clique em Incluir Comando de Visualização.
- Selecione uma visualização na qual você deseja incluir o comando de visualização.
- Na seção Configuração de Comando do Cliente REST, conclua
estas etapas:
- No Nome do Conector do Cliente REST,
digite um nome para identificar a conexão.
- Em Método de Solicitação do REST, selecione
o método POST. Para obter informações
sobre como usar cada método, consulte o tópico "Métodos Suportados para Gerenciar
Recursos".
- Na Lista de Amigos, selecione o aplicativo
que você incluiu como um amigo no Rational Focal Point.
- Em Escolher Atributo Exclusivo para POST,
clique em Selecionar e selecione um atributo. Esse
atributo está vazio. Após a primeira operação POST, ele armazena a
URL da resposta do aplicativo. Portanto, para operações POST subsequentes,
se a URL for a mesma, a operação POST não ocorrerá para essa URL.
- Em URL de Solicitação de Aplicativo do REST,
digite o URL de nível superior da área no aplicativo no qual você está
criando artefatos. Por exemplo, para o aplicativo Requirements Management,
use a URL de factory de criação de requisito. Para obter
essa URL, geralmente você usa a URL de serviços raiz para obter a URL
de RMCatalog. Você usa a URL de RMCatalog para obter a URL da área do projeto; em seguida,
usa a URL da área do projeto para obter a URL de factory de requisito.
- Na seção Configuração XML de Modelo do Cliente REST,
conclua estas etapas:
- Em URL do Aplicativo REST para XML do Modelo,
digite a URL que aponta para um artefato no aplicativo e clique em Obter
XML do Modelo. O XML é carregado na caixa de texto XML de
Modelo de Aplicativo REST. Se você não desejar
que o XML seja carregado dinamicamente, será possível copiar o XML na caixa de texto XML
de Modelo de Aplicativo REST.
Nota: Para a operação POST,
você deve saber a estrutura XML do aplicativo no qual está postando
artefatos. Assim, você obtém o XML dinamicamente ou manualmente. Depois
de obter o código, esse XML deve suportar a postagem de novos dados no
aplicativo. Em alguns aplicativos, se o XML não suportar isso,
você terá que criar ou editar o XML manualmente.
- Em XPath Raiz para o Artefato de Aplicativo REST,
clique em Selecionar e selecione o XPath raiz para os
atributos. O botão Selecionar será
ativado apenas se o XML em XML de Modelo de Aplicativo REST estiver
correto.
- Na seção Mapeamento de Atributo,
clique em Incluir e mapeie os atributos do Rational Focal Point com
os atributos do aplicativo. Por exemplo, se
você mapear o atributo Título do Rational Focal Point com
o atributo Nome do aplicativo, após a operação POST, o
atributo Nome no aplicativo será alterado para Título.
- Na seção Resposta, conclua estas etapas:
- Em XML de Modelo de Aplicativo REST,
especifique o XML que é recebido em resposta ao método GET ou
especifique qualquer outro XML do aplicativo. No XPath Raiz
para Artefato de Aplicativo REST, especifique o XPath raiz para
os atributos e, em seguida, em Mapeamento de Atributo de Resposta, clique em Incluir para
mapear os atributos.
- Na seção Mapeamento de Cabeçalho de Resposta, clique em Incluir para
mapear o cabeçalho do aplicativo com um atributo do Rational Focal Point. O cabeçalho do aplicativo armazena o XML desse aplicativo. Normalmente,
o cabeçalho dos aplicativos Rational solution for CLM
é Local.
- Na seção Configuração, conclua estas etapas:
- Em Formato de Data Suportado pelo Aplicativo REST,
digite o formato de data que o aplicativo externo usa.
- Em Separador de Ponto Focal, digite
um valor de separador, como uma vírgula (,) ou um
ponto e vírgula (;). Os itens MultiChoice e LinkedList serão separados pelo
separador especificado.
- Para mapear os IDs dos atributos entre o Rational Focal Point e
o aplicativo, na seção Tabela de Parâmetros de Solicitação, clique em Incluir e
selecione um atributo do Rational Focal Point.
Digite o ID do aplicativo na coluna Chave. Por exemplo, se você selecionar ID do Projeto para o Rational Focal Point,
na coluna Chave, digite o ID que é usado
para o ID do projeto no aplicativo.
- Na seção Mapeamento de Cabeçalho da Solicitação, clique em Incluir e
digite o nome e valor do cabeçalho. Para os aplicativos Rational solution for CLM,
os cabeçalhos são os seguintes:
| Nome do cabeçalho |
Valor do cabeçalho |
| Accept |
application/rdf+xml |
| Content-Type |
application/rdf+xml |
| OSLC-Core-Version |
2.0 |
- Clique em Salvar.
- No menu Exibir, selecione a
visualização cujos elementos você deseja criar no outro aplicativo.
- Para criar todos os artefatos que estão disponíveis na visualização,
a partir da barra de ferramentas da visualização, clique na lista suspensa e selecione o
comando de visualização POST e, em seguida, clique no ícone Ir
.
- Para criar um artefato, a partir da barra de ferramentas do artefato, selecione
o comando de visualização POST e, em seguida, clique no ícone Ir
.