Puede crear REST URI para modificar registros en la base de datos de usuario enlazando directamente a los registros.
Acerca de esta tarea
Para crear un REST URI para
modificar 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á el asistente Nuevo REST URI.
- Seleccione Modificar un registro en la lista Tipo de REST URI.
- Seleccione un tipo de registro en la lista Tipo de registro.
- Seleccione una acción en la lista Tipo de acción. Los tipos de acción disponibles vienen determinados por el 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 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 modificar un registro se ha creado utilizando el asistente Nuevo REST URI. En este ejemplo ALMActivity se ha seleccionado en la lista Tipo de registro, Activate se ha seleccionado en la lista Tipo de acción y los recuadros Guardar cambios automáticamente, Iniciar sesión automáticamente y 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&action=Activate&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 del sistema host del servidor de 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}}
- Marcador para el ID de inicio de sesión.
- {{password}}
- Marcador para la 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.