Criando URIs REST para Executar Consultas

É possível criar URIs REST para executar consultas.

Sobre Esta Tarefa

Para criar um URI REST para executar uma consulta:

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 Executar uma Consulta na lista Tipo de URI REST.
  3. Selecione uma consulta na exibição da área de trabalho no campo Selecionar uma Consulta.
  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 executar uma consulta foi criado usando o assistente Novo URI REST. Neste exemplo, a caixa de opção Efetuar Login Automaticamente foi selecionada para criar o URI REST.

http://CQWebServerHost/cqweb/restapi/YourConnection/YourUserDB/QUERY/QuerySpecification?format=HTML&loginId={{loginid}}&password={{password}}&noframes=true
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.
QuerySpecification
A especificação da consulta selecionada no campo Selecionar uma Consulta.
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.
noframes
Se este valor for true, o banner, a árvore da área de trabalho e a barra de ferramentas principal do ClearQuest Web não serão exibidos quando você executar o URI REST para visualizar o recurso. O filtro noframes apenas será relevante, se estiver em format=HTML.

Feedback