Criando URIs REST para Visualizar Registros

É possível criar URIs REST para visualizar registros no banco de dados do usuário estabelecendo link com os registros diretamente. O URI REST criado para visualizar um registro abre o registro mais rápido do que o URI REST criado para localizar um registro. O motivo é que ao criar um modelo de URI REST para visualizar um registro, é necessário especificar o tipo de registro que limita o escopo da procura.

Sobre Esta Tarefa

Para criar um URI REST para visualizar um registro:

Procedimento

  1. Na barra de ferramentas do Rational ClearQuest Web, clique na seta próxima ao Novo Pedido de Alteração e selecione Novo URI REST. O assistente Novo URI REST é aberto.
  2. Selecione Visualizar um Registro na lista Tipo de URI REST.
  3. Selecione um tipo de registro na lista Tipo de Registro.
  4. Opcional: para incluir os parâmetros de logon do Rational ClearQuest Web no URI REST, selecione a caixa de opção Efetuar Login Automaticamente.
  5. Opcional: para incluir o banner, a árvore da área de trabalho e a barra de ferramentas principal na janela que é aberta quando o URI REST é executado, selecione a caixa de opção Incluir o banner, a árvore da área de trabalho e a barra de ferramentas principal.
  6. Clique em Criar. O modelo de URI REST é exibido no campo Modelo de URI REST.
  7. Copie o modelo em um editor de texto e substitua os sinalizadores de substituição, que estão entre chaves duplas {{ }}, pelos valores apropriados.

    Opcional: altere o formato padrão do pedido de recurso de HTML para XML ou ATOM.

  8. Copie o modelo modificado no aplicativo da Web ou em outra janela do navegador da Web.
  9. Clique em Reconfigurar para criar um novo modelo de URI REST ou em Fechar para sair.

Exemplo

Exemplo

O seguinte modelo de URI REST para visualizar um registro foi criado usando o assistente Novo URI REST. Neste exemplo, o ALMActivity foi selecionado como o valor do Tipo de Registro ao criar o URI REST.

http://CQWebServerHost/cqweb/restapi/YourConnection/YourUserDB/RECORD/{{recordId}}?format=HTML&recordType=ALMActivity&loginId={{loginid}}&password={{password}}
As variáveis e os sinalizadores de substituição de modelo têm os seguintes significados:
CQWebServerHost
Endereço da web do host do servidor da web ClearQuest. Este valor é definido quando o modelo de URI REST é criado.
YourConnection
A conexão do usuário do ClearQuest. Este valor é definido quando o modelo de URI REST é criado.
YourUserDB
O banco de dados do usuário do ClearQuest. Este valor é definido quando o modelo de URI REST é criado.
{{recordId}}
O sinalizador de substituição do ID do registro com o qual você deseja estabelecer link.
format
O formato padrão do pedido de recurso é HTML. É possível alterar o formato para XML ou ATOM, se desejado.
{{loginid}}
Substitua este sinalizador de substituição pelo ID de logon.
{{password}}
Substitua este sinalizador de substituição pela senha.

Feedback