RAMP-TSAD06 Step 4. Review and Understand the Targets List
You should now have a junction screen (UFRTS03_R1) and three destination screens (UFRTS03_D1, UFRTS03_D2 and UFRTS03_D3) defined and scripted.
Open RAMP Tools and click on each of the screen definitions to review their Targets lists.
Their respective Targets lists will look like this:
| Screen Name | Type of Screen | Targets |
|
UFRTS03_R1 |
Junction |
UFRTS03_D1 |
|
UFRTS03_D1 |
Destination |
UFRTS03_R1 UFRTS03_D2 |
|
UFRTS03_D2 |
Destination |
UFRTS03_R1 UFRTS03_D3 |
|
UFRTS03_D3 |
Destination |
UFRTS03_R1 |
If your target lists do not look like this, you should continue to manually demonstrate screen navigations via RAMP Tools until they do.
The Targets associated with a screen definition are very important. They tell the RAMP navigation planner what screens a particular screen can navigate to (ie: target). Normally the Targets are automatically updated when you manually demonstrate a navigation to the RAMP Tools editor.
As you become more experienced with RAMP you may decide to just update the Targets list manually and add the appropriate code to the screen's navigation handler function. In effect this is exactly what demonstrating a navigation via RAMP Tools does.
The Targets lists used here are simple to understand:
- The junction UFRTS03_R1’s target list effectively says "My vHandle_NAVIGATETO function contains scripts that can navigate to destination UFRTS03_D1".
- The destination UFRTS03_D1’s target list effectively says "My vHandle_NAVIGATETO function contains scripts that can navigate to junction UFRTS03_R1 or to destination UFRTS03_D2".
- The presence of junction UFRTS03_R1 in the target lists of all 3 destinations is significant. The first junction in a destination’s target list is called the exit junction. The exit junction is used to get out of the destination and back on to the junction "freeway or motorway" (ie: the network of identified junctions that are used to rapidly move between destinations). If a destination screen is on display, it will be asked to navigate to its nominated "exit junction" before a navigation to another destination (including itself).