What is an Open Screen Action?

The 

Creating Open Screen Actions

1. Click the 

   Insert excerpt
   _action_screen _action_screen nopanel true

    icon in the toolbar to display existing screens in the application
   1. Existing screens can be dragged from the Repository onto the canvas to automatically create an Open Screen node
2. Alternatively, drag the 

   Insert excerpt
   _action_screen _action_screen nopanel true

    icon from the toolbar onto the canvas and follow the steps to create or open an existing screen

Worked Examples

Here's a worked example using the School Data (available from the Learning Centre).

We want to be able to add and edit the Courses. The first step to doing this is by creating two Open Screen Actionflows. Both will open the same screen containing an input form, but when we are adding a new course we want an empty input form, and when we are editing an existing course, we want the input form to contain course data. SCREENSHOTS?

In this example, we are using:

• The Course Management screen containing a grid of the School Courses data - this screen was created using the Tile with Buttons template
• The Course Form screen containing form fields and associated with School Courses data by a background filter - this screen was created using the Edit Form template

To save the new or edited course, the Save Action on the Course Form screen must be configured. This is covered in 1.09 Save Action Configuration.

Example 1: Open Screen to Add New Data

Create an Open Screen Action that opens an empty input form.

1. On thescreen where the Actionflow will be initiated from, Course Management, right-click on the button and choose 

   Insert excerpt
   _actionflow_add _actionflow_add nopanel true

2. Enter a name for the Actionflow,
   1. Name: Add Course
   2. Select Confirm
3. Click the 

   Insert excerpt
   _action_screen _action_screen nopanel true

    icon in the toolbar to display the existing screens in your application
4. Drag your pre-made 

   Insert excerpt
   _screen_icon_only _screen_icon_only nopanel true

    input form screen, Course Form, from the Repository onto the canvas to create an 

   Insert excerpt
   _action_screen _action_screen nopanel true

    node

5. Select Click to Connect under Connections and for the input, choose the 

   Insert excerpt
   _actionflow_on_click _actionflow_on_click nopanel true

    Action Event, then select Connect Input

6. On the canvas, click and drag the 

   Insert excerpt
   _driving_interface_connection_point _driving_interface_connection_point name icon nopanel true

    icon onto the 

   Insert excerpt
   _action_screen_icon _action_screen_icon nopanel true

    Open Screen action node to connect the input to the action
7. Close the Actionflow to return to the screen

8. Insert excerpt
   _lock _lock nopanel true

    the screen and press the  button to see the Actionflow in action
   1. We can see that the Actionflow is working because it opens an empty form

Example 2: Open Screen to Edit Existing Data

Create an Open Screen Action that opens an input form containing data from the school courses grid.

1. On thescreen where the Actionflow will be initiated from, Course Management, right-click on the  button and choose 

   Insert excerpt
   _actionflow_add _actionflow_add nopanel true

1. Enter a name for the Actionflow,
   1. Name: Edit Course
   2. Select Confirm
2. Click the 

   Insert excerpt
   _action_screen _action_screen nopanel true

    icon in the toolbar to display the existing screens in your application
3. Drag your pre-made 

   Insert excerpt
   _screen_icon_only _screen_icon_only nopanel true

    input form screen, Course Form, from the Repository onto the canvas to create an Open Screen node
4. Select Click to Connect and for the input, choose the School Courses View, then select Connect Input
5. The Mappings window will open:
   1. Drag the CourseID attribute from the left (Grid) to the right (Connection Point Interface), then click Save
   2. 
6. On the canvas, click and drag the 

   Insert excerpt
   _driving_interface_connection_point _driving_interface_connection_point name icon nopanel true

    icon onto the

   Insert excerpt
   _action_screen _action_screen nopanel true

    action node to connect the input to the action
7. Right-click the connector between the

   Insert excerpt
   _input _input nopanel true

    node and

   Insert excerpt
   _action_screen _action_screen nopanel true

    node on the canvas
8. Choose

   Insert excerpt
   _open_mappings _open_mappings nopanel true

    and the Mappings window will open:
   1. Drag the CourseID attribute from the left (Actionflow) to the right (Screen), then click Save
9. Close the Actionflow to return to the screen

10. Insert excerpt
    _lock _lock nopanel true

     the screen and press the button to see the Actionflow in action
    1. We can see that the Actionflow is working because it displays the data from the School Courses grid in the edit form