Confirmación de objetos Entity en la base de datos

Acerca de esta tarea

Procedimiento

La confirmación de un objeto Entity en la base de datos es un proceso de dos pasos:

  1. Validar el registro que se ha cambiado.
  2. Confirmar el cambio.

Resultados

Nota: En el contexto de un enganche, no puede confirmar los cambios del registro actual. Sin embargo, si se escribe una aplicación externa y se desea mantener los cambios que se han llevado a cabo en un registro, el usuario debe confirmar los cambios en la base de datos.

Para validar un registro, llame al método Validate del objeto Entity correspondiente. Este método ejecuta los scripts de validación del esquema y devuelve un valor String que contiene todos los errores de validación. Si el String no está vacío, puede utilizar el método GetInvalidFieldValues para devolver una lista de campos que contiene datos que no son correctos. Una vez que haya arreglado los valores de dichos campos, debe volver a llamar a Validate. Si el método Validate devuelve un valor String vacío, significa que no existen más errores.

Después de validar el registro, y que la validación sea satisfactoria, debe confirmar los cambios en la base de datos llamando al método Commit del objeto Entity correspondiente. Cuando llama al método Commit, los cambios se escriben en la base de datos y se invoca al enganche de confirmación de la acción. Si la confirmación es satisfactoria, se lanza el enganche de notificación de la acción.

Nota: Para obtener información sobre el orden en el que se lanzan los enganches, consulte el apartado que trata sobre el orden de ejecución de enganches de acción y campos de la ayuda del desarrollador de esquemas.

Si decide que no desea confirmar los cambios en la base de datos, puede revertir los cambios llamando al método Revert del objeto Entity. Al revertir un conjunto de cambios, se devuelve el registro al estado que tenía antes de llamar al método EditEntity. Si revierte los cambios que ha llevado a cabo en un objeto Entity que ha creado el método BuildEntity, el registro se descarta por completo.

Nota: Rational ClearQuest no recicla los ID visibles asociados a registros. Si se revierte un registro que el método BuildEntity ha convertido en editable, se descarta el registro, pero no su ID visible, de modo que futuros registros no pueden utilizar dicho ID.

Feedback