Show/Hide Toolbars

Inventu Viewer+ Developer's Learning Guide

Navigation: The Web Service Tutorial

Screen Mapping Wizard Application Screen

Scroll Prev Top Next More

The Application screen is the most common type--using the wizard for this kind of screen builds on what was learned in the Signon Screen example.

 

Provided Help:

 

Import Wizard Help: Viewer Studio Screen Mapping Wizard

 

 

Tutorial for Application Screen Mapping Wizard:

 

 

1.Start the Screen Mapping Wizard as before, but for a standard application screen with no multiple row areas:
clip0067
 

2.Select the default screen type (Application):
clip0068
 

3.Additional Wizard panels are introduced Application type in addition to the Detail field map(s): Title, Messages and Function Keys with the Title first. While not used for Web services, the Title area is given a Label type with a Title CSS class for UI generation.  Even if you are only planning web services, having the title defined is useful should you decide in the future to go with a UI (and defining it is very quick).  With the left mouse button, the area is dragged and defined:        clip0069
 

4.After clicking Next, the Detail area is to be mapped.  Initially, the mouse pointer is "loaded" with the area defining tool, ready for you to define the first block of fields to be captured for the default screen map.  You can capture from more than one area, but first you will drag with the left mouse button to define the area.  Here is the wizard panel at the start:
clip0070
Here is the mapping, press and hold mouse left button in one corner, drag to the opposite corner and release:
clip0071
Note that labels are in BLACK and Fields are in Red...some of the above labels are incorrectly identified as fields...
 

5.Adjust the Parsing Options...these are retained between uses of the Wizard so sometimes they need to be tuned for a particular type of screen in your application.  First, click on the Parsing Options button:
clip0072
Then adjust the settings.  Here, the requirement that every label end in a special character affected the 1. Account Status and other labels in that part of the screen, so it was unchecked...
clip0073
Which will immediately affect the capture coding--visible in the mapping area:
clip0074
Note the 1., 2., 3. options are now black and no longer considered fields.  This is simply an example of parsing option adjustment--at any time you can play with the options to obtain better results on a global screen basis.
 

6.While the Parsing Options can help with bulk field / label captures, the individual mouse tools provide individual control.  You can load the mouse the the Label tool so that each token clicked will be forced to a Label.  Same goes for fields using the Field tool.  In this example, we do not want as many fields as have been identified, so will delete a number of fields using the Delete tool:
clip0075
Clicking one of the tools sets the mode of the mouse to that tool.  This is the Delete Tool.  Clicking on a token removes it:
clip0076
And the next:
clip0077
Until all fields not wanted have been clicked:
clip0078
 

7.At this time, another block of labels and fields can be defined with an additional detail area by clicking on the:
clip0079
But for this example we will click Next in the Wizard panel to move to the Field Naming and Properties panel:
clip0080
The above needs the Company and AccountOrPolicy set as keyVariables (they fit that navigation type) and the name for the selection is not clear, and it should be set as a Literal navigation type.  After these changes:
clip0081
 

8.That completes the definition of the default FieldMap fields and the Labels for the screen.  Next is the definition of the Messages area.  By uniquely defining where Messages reside, the wizard names each output field found starting with "Message" which is used at code generation and runtime as a simple way to identify program messages from the host:
clip0082
You may need to run the application a bit or use the Heatmap tool to identify where the messages appear, since it may not always be obvious.  You can add Message fields later using simple field mapping; just remember to start the name with "Message".
 

9.After messages comes the Function Key definitions.  By identifying those Function keys you would like to capture, the Screen Definitions Actions property will be populated with Button definitions that are also tied to requests to the Viewer framework to run that action (which will be associated with the corresponding Function Key):
clip0083
 

10.After clicking Next, the wizard generates the Labels and Fields:
clip0084
 

11.Next, if Function keys were defined, you will be prompted if you would like to hook real keyboard keys to the buttons--you are recommended to click on Yes, but if you never expect to enable users to keep using the same keys, you can click No and it will slightly reduce a few properties if a UI is later generated for this screen:
clip0086
 

12.That completes the tutorial for Application Screen Mapping.
 

 

Next step: Screen Mapping Wizard for Multirow Screens