Puede crear REST URI para enviar registros de la base de datos de usuario.
Acerca de esta tarea
Para crear un REST URI para enviar un registro:
Procedimiento
- En la barra de herramientas de Rational ClearQuest Web, pulse la flecha al lado de Nueva solicitud de cambio y seleccione Nuevo REST URI. Se abrirá la
ventana de plantilla de REST URI nuevo.
- Seleccione Enviar un registro en la lista Tipo de REST URI.
- Seleccione un tipo de registro en la lista Tipo de registro.
- Opcional: seleccione los campos de registro que se deben añadir como parámetros al REST URI en la lista Campos del registro para completar automáticamente.
- Opcional: para guardar todos los cambios en el registro, seleccione el recuadro de selección Guardar cambios automáticamente.
- Opcional: para añadir parámetros de inicio de sesión de Rational ClearQuest Web
al REST URI, seleccione el recuadro de selección Iniciar sesión automáticamente.
- Opcional: para incluir el mensaje de cabecera, el árbol del espacio de trabajo y la barra de herramientas principal en la ventana que se abre cuando se ejecuta el REST URI, seleccione el recuadro de selección Incluir mensaje de cabecera, árbol del espacio de trabajo y barra de herramientas principal.
- Pulse Crear. La plantilla de REST URI aparece en el campo Plantilla de REST URI.
- Copie la plantilla a un editor de texto y sustituya los marcadores, que están entre dobles llaves {{ }}, con los valores correspondientes.
Opcional: cambie el formato predeterminado para la solicitud de recurso de HTML a XML o ATOM.
- Copie la plantilla modificada a su aplicación web o a otra ventana de navegador web.
- Pulse Restablecer para crear una nueva plantilla de REST URI o pulse Cerrar para salir.
Ejemplo
Ejemplos
La siguiente plantilla de REST URI para enviar un registro se ha creado utilizando el asistente Nuevo REST URI. En este ejemplo ALMActivity se ha seleccionado en la lista Tipo de registro y los recuadros de selección Guardar cambios automáticamente, Iniciar sesión automáticamente e Incluir mensaje de cabecera, árbol de espacio de trabajo y barra de herramientas principal se han seleccionado para crear el REST URI.
http://host_servidor_CQWeb/cqweb/restapi/su_conexión/su_BD_usuario/RECORD?format=HTML&recordType=ALMActivity&fieldsXml=&autoSave=true&loginId={{loginid}}&password={{password}}
Las variables y los marcadores de la plantilla tienen los siguientes significados:
- host_servidor_CQWeb
- Dirección web de su sistema host servidor ClearQuest Web.
Este valor se define cuando se crea la plantilla de REST
URI.
- su_conexión
- Su conexión de ClearQuest. Este valor se define cuando se crea la plantilla de REST
URI.
- su_BD_usuario
- Su base de datos de usuario de ClearQuest. Este valor se define cuando se crea la plantilla de REST
URI.
- format
- El formato predeterminado para la solicitud de recurso es HTML.
Puede cambiar el formato a XML o ATOM, si lo desea.
- {{loginid}}
- Sustituya este marcador por su ID de inicio de sesión.
- {{password}}
- Sustituya este marcador por su contraseña.
Los siguientes ejemplos muestran cómo especificar el campo de fecha, el campo de referencia, la lista de referencias y los valores de campos de varias líneas como parámetros en un REST URI.
- Este ejemplo muestra cómo proporcionar un valor de campo de fecha como parámetro en un REST URI para enviar o modificar un registro:
fieldsXML=<Field><Name>f_datetime</Name><Value><![CDATA[2008-09-08%2009%3A44%3A34]]></Value></Field>
Resultado: el campo de registro f_datetime se establece en 08/09/08
09:44:34.
- El siguiente ejemplo muestra cómo proporcionar un campo de referencia o valores de lista de referencias como parámetros en un REST URI para enviar o modificar un registro:
fieldsXML=<Field><Name>customer</Name><Value><!CDATA[Joe%20Lee]]></Value><Value><!CDATA[Jane%20Smith]]></Value></Field><Field><Name>Project</Name><Value><!CDATA[Classics]]></Value></Field>
Resultado: en la lista de referencias customer del registro, se añaden los usuarios Joe Lee y Jane Smith y en el campo de referencia Project, se añade Classics.
- Este ejemplo muestra cómo proporcionar un valor de campo de varias líneas como parámetro en un REST URI para enviar o modificar un registro:
fieldsXML=<Field><Name>Description</Name><Value><![CDATA[firstline%0Asecondline]]></Value></Field>
Resultado: en el campo de registro Description, se da formato al texto firstline y secondline para que aparezcan como líneas separadas.