Skip to main content

Importing data from a file

You use Pega Customer Decision Hub™ to manage data entities on the Profile Designer landing page. Use Pega Customer Profile Designer to quickly import, export and modify data in Customer Decision Hub™.



This demo shows you how to manually import data into the Profile Data Sources defined in Customer Decision Hub.

This is the Pega Customer Decision Hub portal. Only users with the DataAdmin role can see the Data menu in the navigation pane. To select an existing data source in Customer Decision Hub, navigate to the Profile Designer landing page. Data sources that are defined in the context dictionary are available here.

Data sources that are defined in the context dictionary


By clicking on a data source link, you can see the details of the underlying data structure. The Fields tab shows the customer attributes.

The Customer data structure with properties


On the Records tab, you can see the values for all the fields defined for that data source.

The records tab with customer id 14


The Default view represents all fields that are defined and mapped in the data source. This view is created automatically for you, but you can also create additional views. Each view is backed by a Report Definition in the entity's data class. To create additional views, you save the Default report and customize it according to your needs.

The default report definition


On the Records tab, you can modify existing records, add and delete records manually, or export and import records in bulk.

For data security reasons, the Import and Export functions are only available in non-production environments. In a production environment, you use the data jobs to import and export data.

To export the data, you click Export. The system then automatically exports all data stored in that data source in a CSV format.

Data export results in CSV file


You can use the exported file as a template when importing records back to Customer Decision Hub.

Start the import process by clicking the Import button. The import process has four steps.

In the first step, you upload the CSV file to Customer Decision Hub and then choose a Purpose. The system uses the file contents to either add new records only, add new records and update existing records, or to delete records from the data source.

Uploading a file


In the second step, you map the columns in the CSV file with the fields in the entity.

Typically, there is no pre-defined template for the initial import. If there is a complicated mapping, you can save the configuration as a template at a later step in the process. This helps to avoid configuration mistakes and reduce preparation time.

You can choose a column in the CSV file as a key by selecting a column that matches existing records in the entity. You then select an Update type for records that already exist in the data source and select the Always update option to update the records in the destination. It is also possible to only update matching records if the values in existing records are blank, or to only update matching records if the values in the CSV file are not blank.

Data mapping


If you clear the Update all fields checkbox, you can select the update type at the field level.

To modify the data that is imported, you can use the Mapping options for each field. By default, the value in the CSV file is used when importing, but it is also possible to use a Lookup, Decision Table or Decision Tree to modify the values.

In the third step, you choose the Import options. Here, you can change the format of date and time values when importing, and define validations. You select the Save import settings as a template checkbox to store the configuration as a template. Data is automatically validated during import.

Select import options


The final step shows a summary of the validation of the records.

Continue importing after validation


The Import progress dialog box shows the duration of the process, and shows the number of processed rows.

Displaying the import progress


For more information, see Managing profile data sources in Customer Profile Designer.


Tip: To practice what you have learned in this topic, consider taking the Importing customer data from a CSV challenge.

This Topic is available in the following Module:

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

Did you find this content helpful?

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