Skip to main content

Simulating an external data source

3 Tasks

10 mins

Visible to: All users
Beginner Pega Platform 8.7 Data Integration English
Verify the version tags to ensure you are consuming the intended content or, complete the latest version.


During roadside assistance, a service provider performs minor mechanical repairs. Requests for roadside assistance must identify the vehicle so that the service provider can prepare for the service call. For example, certain vehicles might require a flat-bed tow truck or a higher octane fuel blend.

To allow service providers to prepare for a service call, stakeholders want to ensure that users enter only a valid combination of make, model, and year for a vehicle. As part of the initial application release, a listing of vehicle models is sourced from an external system. Before the external source is configured and tested, stakeholders want to simulate the process of providing the year, make, and model of a vehicle.

Configure a simulated data source for vehicle model data to validate the Identify vehicle view. A separate developer has configured the layout and behavior of the view. You create a simulated data source for the drop-down list of vehicle models to use until the external system with the data source is configured and tested.

Note: For this exercise, two models of vehicles are sufficient to test the view. The list of models is filtered based on the year and make.

The following table provides the credentials you need to complete the challenge.

Role User name Password
Application Developer author@gogoroad pega123!
Note: Your practice environment may support the completion of multiple challenges. As a result, the configuration shown in the challenge walkthrough may not match your environment exactly.

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Challenge Walkthrough

Detailed Tasks

1 Simulate a data source to the data object

  1. In the navigation pane of App Studio, click Data to open the Data objects and integrations landing page.
  2. On the Data objects and integrations landing page, click the Vehicle models data object to configure a simulated data source.
  3. Click the Data pages tab.
  4. Click Create simulated sources to add a simulated data source to the data object. The Rule generation status dialog box is displayed.
  5. In the Rule generation status dialog box, click OK to acknowledge that a set of data pages with simulated sources is successfully created. The updated Data pages with simulated data sources are listed. 
    Data pages for the Vehicle Models data object
    Note: Refresh the browser to view the data pages if they are not automatically displayed.

2 Add simulated data to the data object

  1. In the Vehicle models data object, click the Records tab to add data records to the data object.
  2. Click Add record to add a row to the list of data records.
  3. In the empty row, in the Vehicle type field, enter Truck.
  4. In the Model field, enter Ridgeline.
  5. In the Make field, enter Honda.
  6. Repeat steps 2-5 to add a second record to the data object, using the information in the following table.
    Field Value
    Vehicle type Passenger car
    Model Accord
    Make Honda
  7. In the upper right, click Save to complete the configuration of the simulated data source. 

3 Reference the simulated data source

  1. In the header of App Studio, click Preview to open the User portal.
  2. In the Landing pages menu on the left, click Create > Assistance Request to create a new case.
  3. Advance the case to the Identify vehicle step, entering information in any required fields.
  4. In the top taskbar, click Design to enable design mode. 
  5. On the Identify vehicle form, hover over the vehicle information fields, and then click Edit this section to configure the view to access the simulated data source.
  6. In the section properties pane on the right, to the right of the Model field, click Edit this "Dropdown" to display the Dropdown properties, which contains the configuration options for the source of the list that populates the control.
    Edit this "Dropdown" icon to the right of the Model field
  7. In the List source section, in the Type drop-down list, select Data page to populate the drop-down by using one of the data pages you configured. The properties pane displays additional fields to configure access to the data page.
  8. In the Data page field, enter or select D_VehiclemodelsList to access a list of the records from the simulated source.
  9. In the Property for value field, enter or select .Model to use the model name as the value of the field in the form. The Property for display text field automatically updates to reference the .Model property.
  10. Select the Group items check box to group the list items in the drop-down field. The properties pane updates to display the Group by field.
  11. In the Group by field, enter or select .VehicleType to group the drop-down entries by vehicle type. 
    Auto population setting
  12. Click Apply to complete the configuration of the Identify vehicle form.
  13. Click the Design to exit design mode.

Confirm your work

  1. In the Make field, enter or select Honda.
  2. Click the Model drop-down list to display the entries defined for the simulated data source. 
    Model field simulated data source

This Challenge is to practice what you learned in the following Module:

Available in the following missions:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

100% found this content useful

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice