JeeWiz Modeler's Help File for RSA/RSM - How to Model a Dataview Field


	The Model-Driven System Builder

JeeWiz Modeler's Help File for RSA/RSM

Contents > 4. Service Data and Operations

4.3 How to Model a Dataview Field

Dataview fields are the name for fundamental data objects on the dataview, linking to attributes in the entity and generating data items on the screen. To add a field to an dataview, right-click on the dataview, either in the diagram editor or the model explorer, add UML, attribute. Alternatively, select the dataview, go to the attributes tab on the properties view and press the small square to the right hand side.

You will need to fill in a name, and stereotype the property as a dataViewField. By selecting the attribute on the diagram or in the model explorer you can add the stereotype in the stereotype tab of the properties view. This will also make the JeeWiz dataview field properties available.

The dataview field name is added on the general tab and the type can be added in much the same way as for an attribute: the selection should always be from the JeeWizScreenMMLibrary selection. However if the field is related to an attribute, it is not necessary to add a type and if you do it should be the same as that of the attribute.

You can divide up the properties on a dataview field into

those associated with attaching to an attribute
those associated with carrying data
those associated with screen display,
those associated with selection or exclusion (mainly in querying)

All these are dealt with in the following help pages.

Two exceptions are those pertaining to security, which are also dealt with in their own How To, and lookups.

Lookups come in two related flavours, as a style of relationship and as a group of dataview fields. The idea is that information can be input on the screen from any table, whether there is a related dataview or not.

By setting up the lookupDataView, the field is rendered with a lookup button, which on pressing will take you to a search screen based on the specified dataview. On return, the field will be populated with the looked up value of whatever field is specified in the lookupField of the lookupDataView. This can be edited or overwritten, and if you only want the values from the table to be used, you also need to set the accessStyle of the field to readonly, which suppresses editing. It is possible to set multiple field values with a single lookup. You do this by setting the lookupGroup with the same name on all the fields you want filled in, along with the lookupField whose value you want copied over. You should only set the lookupDataView on one field, the one you want the lookup button to be rendered next to.

Two flags settable on the field are useOnSummary and useOnSearch. The summary list of fields on a dataview are a subset of the full field list, which can be used where a summary of the row contents is required, often to identify it, rather than the full data. If no fields are tagged as useOnSummary all fields are used.

Links: