Skip to content

Working with the Systems Simulation Component in Adapt

Francis Tourangeau edited this page Mar 17, 2025 · 1 revision

The Systems Simulation Component in Adapt

This document contains background information and instructions for design teams and other Adapt users on how to program the systems simulation component.

Component Background and Uses

This component presents screenshots of systems in an interactive format that allows learners to practice entering information into the systems. Use the systems simulation component when you want to give learners the chance to apply what they’ve learned about the systems they will use and receive real-time feedback on their actions.

Terms

To work with this component, you must understand some key terms:

  • Simulation screens (or simply screens): The screenshot(s) of the system UI that learners will interact with while using this component, and on which elements and forms are placed.
  • Elements: Interactive areas of the screens where learners can perform one of several actions (ex: use a date picker function, enter text, check a box, etc.) to simulate the experience of using the system on the job.
  • Forms: A series or group of interactive areas on a screen, nested within elements, that are resolved by learners submitting or saving information to the system. Each form can contain unlimited elements within it.
  • Regex: An abbreviation of “regular expression,” which refers to a sequence of characters that specifies a match pattern in text. This will be relevant when configuring input fields in the components, as you may need to specify a regex that will be matched against learner entries into a field to determine if learners are correct or incorrect.

If you think of the organization of this component like a tree, the component itself is the trunk. Each screen is a branch, each element is a twig from that branch, and each form is a cluster of leaves.

Before You Begin

Before you start programming the component in Adapt, make sure you:

  • Capture all screenshots of the system.
  • Format all screenshots to the same width with on-screen elements in the same locations (aligns at the top and the width stays the same).
  • Identify which areas of the screenshots you want to be interactive and what type of action is associated with each (ex: click, select, input, date picker, etc.).
  • Determine if you will be presenting the content as an Element or a Form.

It is strongly recommended that you make a thorough plan of the order in which you will present the simulation screens and the actions you want learners to take before programming the component. You will need to identify what areas of the simulation screens need to be interactive to support the learning experience.

Action Types

There are various action types that you can configure in the component. The table below lists action types, and their definitions will help you choose the right action type when configuring your system simulation.

Action Type Definition
Click In this case, click refers to any mouse/cursor action where users click, press, or push a button or link.
Dropdown menu In this case, dropdown menu refers to any action where users are choosing options from a drop down or other menu.
Input Any action type where users must type text into a field or text box on the simulation screen.
Date picker A sub-type of input actions. For simulation screens that require users to enter a date using a calendar feature.
Match regex/match text An action type for text fields/boxes where users must enter a specific string of text to complete the simulation.

Tips for Effective Screen Shots

This section contains information about how to take effective screen shots of your system to use in the systems simulation component and an overview of the possible image editing that may be required.

  • It is important to use scrolling screenshots as much as possible for this component, as they will work best.
  • When taking screenshots, try to make the images as square as possible so the aspect ratio is ideal for Adapt and you can reduce the amount of editing you need to do to the images after the fact.
  • Use a crop tool to ensure your screenshots are focused on the necessary elements.

Overview of Possible Image Editing

Depending on the elements you are adding to your screenshots, you may need to edit the screenshots before uploading them for use in the systems simulation component. You can do these edits in SnagIt. Some examples of this editing include:

  • Editing images to create whitespace for character counters on simulation screens when learners must type into text boxes and fields.
  • Enlarging fields if the space for learners to click is too small (this is especially common with date pickers).
  • Optionally blurring parts of the image to focus on relevant aspect(s) of a screenshot – if you choose to do this, you will need to ensure it is used consistently throughout the simulation screens of the component.

Configuring the Systems Simulation Component

This section will provide instructions on how to configure the component in Adapt, including general set-up, how to configure simulation screens, how to configure elements, and how to configure forms. Note that when you are building the component in Adapt, you can follow the tooltips for the component’s settings and fields to guide your configuration choices by hovering over the info icon.

How To Set Up the Component

  1. Enter the Title and Display Title (if applicable) into the corresponding fields.
  2. Enter text that previews the upcoming simulation into the Body field.
  3. Enter clear and specific instructions on how to navigate the component into the Instructions field, following the guidance in the Adapt Best Practices Guide.
  4. Configure the Set completion on menu to “actionSuccess”.

How To Configure Simulation Screens

  1. Under Simulation Screens, select Add to add your screenshots and interactivities to the component.
  2. Enter the Title and Display Title into the corresponding fields.
    Caution: The Display Title must match the heading of the simulation screen that is visible in the screenshot, as this is the information that screen readers will communicate to learners.
  3. Add your screenshot of the system to the Screen Graphic section.
  4. Check the Force Full Width box.
  5. If you choose to do so, you can enter some additional text that will be displayed to learners before they can interact with the elements on the simulation screen in the Screen Message field. This is optional.
    Note: Screen messages should only be used sparingly to enhance learner comprehension of the simulation. Use screen messages mindfully to avoid disrupting the immersion of the simulation.

How To Configure Elements

Note: The configuration options in the Element editor pane are dynamic – you will only see configuration options that are necessary based on the selections you make as you set up your elements. Refer to the tooltips next to each field (indicated by the info icon) to guide your choices.

  1. In the Elements section of the Simulation Screen editor, select Add.
  2. Enter the Element Name in the field.
  3. Select the Type of navigation action from the drop-down menu.
    The selection you make for navigation type will determine what options will be available in the Element editor pane. Follow the guidance of the tooltips to make the correct selections.
  4. Select the Track as a task button if you want this element to appear in the task list displayed to learners.
  5. Use the Zone editor to locate the element size and position in the simulation screen.
    Note: The Zone editor works similarly to the Pin Positioning feature in the Hot Graphic and Guided Tour components.
  6. Choose your GoTo location to determine what screen learners will see after they complete this Element successfully.

How To Configure Forms

Note: The configuration options in the Form Element editor pane are dynamic – you will only see configuration options that are necessary based on the selections you make as you set up your elements. Refer to the tooltips next to each field (indicated by the info icon) to guide your choices.

  1. In the Elements section of the Simulation Screen editor, select Add.
  2. Enter the Element Name in the field.
  3. Check the This element is a form (element group) box.
  4. Under Form Elements, select Add.
  5. Enter the Form Element Name into the corresponding field.
    Note: The form element name should match what is visible on the simulation screen.
  6. Choose the Type of form action from the drop-down menu.
    The selection you make for the type of form action will determine what options will be available in the Form Element editor pane. Follow the guidance of the tooltips to make the correct selections.
  7. If applicable, enter a clear and specific failure message in the Match Text Failure Message box.
    Tip: Give learners useful feedback in this message so they can understand what went wrong in the simulation!
  8. Use the Zone editor to locate the form element’s size and position on the simulation screen.

How To Configure Drop Down Menus

Drop down menus can be both part of an individual element and part of a form.

If the dropdown menu is not part of a form:

  1. In the Elements section of the Simulation Screen editor, select Add.
  2. Under Type of Navigation Action, select dropdown menu.
  3. Under Select Options, add your dropdown menu options. If an option is correct, check “correct option”. If you would like for an option to be selected by default (meaning, this is the option the learner sees before they interact with the element), check “selected by default”.
  4. Use the Zone editor to locate the dropdown menu element’s size and position on the simulation screen.

If the dropdown menu is part of a form:

  1. Select the form element to which you would like to add a dropdown menu.
  2. Under Type of Form Action, select dropdown menu.
  3. Under Select Options, add your dropdown menu options. If an option is correct, check “correct option”. If you would like for an option to be selected by default (meaning, this is the option the learner sees before they interact with the element), check “selected by default”.
  4. Use the Zone editor to locate the dropdown menu element’s size and position on the simulation screen.

How To Use the Pre-filled Data Feature

  1. Add a form element to the Elements section of the Simulation screen editor.
  2. Under Type of Form Action, select Input.
  3. Under Type of Input Action, choose Text or Multiline, depending on the needs of the simulation.
    Tip: The Text option will display the text on a single line, while the Multiline option will display the text on multiple lines. Use multiline for longer text that will otherwise cut off on a single line.
  4. Under Type of Pre-filled Value, select Text.
  5. Under Pre-filled Value, you can set the pre-filled value with previous user data or with today’s date. As noted in the tooltips, setting the pre-filled value with previous user data will recall the learner’s latest data entered in a field with an identical form element name.
    Tip: You can also set the pre-filled value with today’s date by checking the applicable checkbox under Pre-filled Value.

How To Configure a Date Picker

You can add a date picker as a single element or as part of a form element.

If the date picker is a single element:

  1. Under Type of Navigation Action, select input.
  2. Under Type of Input Action, select datepicker.
  3. If the learner must select a specific date, check the applicable checkbox under Match Items. If there is no applicable preset option, match with regex.

If the date picker is part of a form element:

  1. Add a form element to the Elements section of the Simulation screen editor.
  2. Under Type of Input Action, select datepicker.
  3. If the learner must select a specific date, check the applicable checkbox under Match Items. If there is no applicable preset option, match with regex.

How To Configure Input Fields

  1. Add a form element to the Elements section of the Simulation screen editor.
  2. Under Type of Form Action, select Input.
  3. Under Type of Input Action, select Text or Multiline.
    Tip: The Text option will display the text on a single line, while the Multiline option will display the text on multiple lines. Use multiline for longer text that will otherwise cut off on a single line.
  4. Under Match Items, you can configure the settings to check the learner’s answers against predetermined patterns. In this context, ‘matching’ just means checking whether the learner’s answer is correct or incorrect.
    Tip: If the learner must enter specific text, enter the exact text in the Text to Match field. For example, if Mango is the correct text, type in Mango; if 12345 is the correct text, type in 12345. You can also customize the text to match by selecting one of the preset checkboxes. Use the tooltips to determine the applicable option. If the learner does not have to enter specific text and there is no applicable preset option, you can choose to match with regex.