UpdateCard Function

UpdateCard provides basic functionality for updating a record in a database table.  The UpdateCard pattern is designed to update the fields of a record that has been selected from a Grid table within the same Deck, e.g. by using the SelectCard pattern.  In this way, the UpdateCard pattern expects that all the fields of the view to be updated have been assigned to WML variables.

UpdateCard contains an Update WAP Event Handler function which performs basic validation and calls update processing at the database server.

In the example below, an Update Card is implemented within a Deck Generator based on the SelectDeck pattern.

Example:

In order to use the UpdateCard pattern, it is necessary to incorporate the Update Card Generator in a Deck Generator (e.g. based on SelectDeck) and replace the UIBasic.Update and the UIBasic.Detail views.

When the UpdateCard is called from another Card within the same Deck, the fields in the WsyDetails variable should be omitted and replaced by fields in the WsyUserOutput variable.

If error handling functionality is required, it must be added to the MyUpdateCard.Update Event Handler action diagram by calling an Error Deck function.  The UpdateCard.Update WAP Event Handler pattern already inherits from the EventHandlerWithValidation pattern, which will invoke any validation functions specified as validated by and checked by triples.

After the Update event, a new WML Deck must be displayed.  In this way, a call statement to a Deck Generator must be specified in the 0 call to build of document edit point of the Update WAP Event Handler function

The Update WAP Event Handler as well needs to be declared by a calls-triples from the WAP Dispatcher function.