Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Importing updates from a file

Updated on November 23, 2022

To make changes to your data more quickly, update data records in bulk by importing updates from a .csv file.

If your operator ID has Allow rule checkout enabled, import performance might be impacted. Use an operator ID that does not have Allow rule checkout enabled, or disable this option for your operator ID. For more information, see Defining security information for an operator.
  1. Upload the file.
    1. In the navigation pane of App Studio, click Data.
    2. Click Data objects and integrations.
    3. Click a data object.
    4. Click the Records tab, and then click Import.
    5. In the Purpose list, select Add or update.
    6. Click Choose File.
    7. Navigate to your .csv file, and then click Open.
    8. Click Next.
  2. Map a column in your file to the key field in the data object.
    For example, your file may identify employees by Staff ID but your data object stores this information in the Employee ID field. If your data object has multiple key fields, repeat the following steps for each field.
    1. In the Match existing records by field, press the Down Arrow key, and then select the column in your file that uniquely identifies each data record.
    2. Click Select, and then double-click the field in the data object that corresponds to the column.
      Tip: To narrow the list of fields, enter text in the Search field, and then click outside the field.
    3. Optional: To ignore the case of column and field names, select the Case insensitive matching check box.
  3. Optional: To select how to handle blank data in the target or source field, select Update all fields and select one of the following choices:
    • Always update – updates all fields in the data object.
    • Update if target is blank – updates data for the empty fields in the data object.
    • Update if source is not blank – updates data for the fields in the data object that correspond to non-empty fields in the .csv file.
    Note: The update options are not applicable when you are adding data records to a data object. The system adds new records irrespective of the update option you select.
  4. Map the rest of the columns in your file to the fields in the data object.
    Tip: To make mapping faster, select a template from the Template type list to use to define the mapping between the fields in your data object and the fields in the .csv file and skip the rest of this step.
    1. In the Target field column, select the fields in your data object that correspond to the fields in the .csv file shown in the Source field column, or click Select to display a dialog box for searching and filtering fields.
      Note: You can select top level and embedded properties as targets for import.
    2. Optional: If you are importing fields from an external system, you can apply business logic, such as lookups, decision trees, and decision tables to translate the external data into fields that are understood by Pega Platform. In the Mapping options column, click the Mapping options icon to select the type of business logic to use for translation, and click Submit. For more information, see Applying business logic when importing data.
    3. Optional: Enter a default value. For new records, the default value is used if the source field is blank. For existing records, the default value is used if both the source and target fields are blank. If you use a lookup, decision tree, or decision table, the source value is the value obtained from the lookup, tree, or table. It is not the value in the .csv file.
    4. Optional: Set defaults for fields that do not have matching source columns in the .csv file.
      1. Click View custom defaults.
      2. Click Add default value.
      3. Enter the target field or click Select to choose the target field from a list of fields.
      4. Enter the default value. For new records, the default value is used if it is provided. For existing records, the default value is used if the target value is blank.
      5. Click Next if you are finished mapping fields, or click Back to mapping to finish mapping fields.
    5. If you are not using the same method to update data for all the fields in your data object, in the Update type list, select the method for each field.
  5. Click Next.
  6. Select a validation option.
    • To skip validataion, Skip validation step entirely.
    • To perform basic validation, Skip running validate rules.
  7. Click Start validation.
  8. Click Continue import.
  9. Click Finish

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us