How to add a Panel which can be opened from an Action Menu

From Tygron Support wiki
Jump to navigation Jump to search

Panels can easily be given a location in the project area, making them accessible via a Popup in the 3D Visualization. However, Panels do not necessarily need to be related to anything spatial. For example, a Panel may display information about a specific Stakeholder, or information on policies encoded as values of Globals. Although not as trivial as setting a geographical location, it is possible to make a Panel accessible via an Action Menu.

This can be done for any Panel, and doing so consists of three steps. First, create the Panel which should be opened. Next, add an Event Bundle which triggers the appearance of the Panel. Finally, add the Event Bundle to an Action Menu.

Creating a Panel

The left panel for panels in the editor.

Panels form a (custom) interface element for the end-user. To use a Panel, it must first be added to the Project.

Editor → Current Situation (Ribbon tab) → Panels (Ribbon bar)
How to add a Panel:
  1. Open the list of Panels.
  2. At the bottom of the left panel, select the desired type of Panel.
  3. Click on "Add Panel".
  4. The Panel is now added.

Creating an Event Bundle

Editor → Future Design (Ribbon tab) → Event Bundles (Ribbon bar)
How to create an Event Bundle to open a Panel:
  1. Open the list of Event Bundles.
  2. At the bottom of the left panel, select "Add".
  3. The Event Bundle is now added. Make sure it is selected.
  4. At the bottom of the right panel, select "Add Client Event".
  5. In the right panel, set the name of the Event Bundle to something like "Open panel".
  6. Select the now added "NO_DEF" Event.
  7. In the bottom panel, select the SHOW_CUSTOM_PANEL Event.
  8. In the bottom panel, for the "Panel ID", select the Panel which should open.
  9. In the bottom panel, ensure the "Visible" box is checked.
  10. In the bottom panel, click on "Commit".
  11. The Event Bundle is now ready to open the specific panel configured.

Adding the Event Bundle to an Action Menu

Editor → Future Design (Ribbon tab) → Actions (Ribbon bar)
How to create an Action Menu to trigger an Event Bundle:
  1. Open the list of Action Menus.
  2. At the bottom of the left panel, select "Add".
  3. The Action Menu is now added. Make sure it is selected
  4. In the right panel, on the "general" tab, set the name of the Action Menu to something like "Show information".
  5. In the right panel, on the "general" tab, ensure all the Stakeholders which should be able to open the Panel this way are checked.
  6. In the right panel, on the "actions" tab, open the "Event Bundles" listing, and select the "Open panel" Event Bundle. (The name should match the name set for the Event Bundle earlier.)
  7. The Action Menu is now ready. Clicking on it will open the desired Panel.

Notes