Skip to main content

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

Creating a data model from a spreadsheet

Updated on November 23, 2022

To simplify automating and digitizing your business process and eliminate the need to reference external spreadsheets, create data objects by importing XLSX and CSV files. For example, users that work on App Factory can import Excel spreadsheet data to automatically track the status of customer data, invoices, and service requests.

  1. In the navigation pane of App Studio, click Data.
  2. In the Data field, click Data objects and integrations.
  3. On the upper right corner, click New.
  4. In the Data objects name field, enter the name for the type of information that you want to model.
  5. In the Define source data field, define where the data is stored:
    • To set a local Pega data object, select Now, and then, in the Systems list, select Pega.
    • To defer defining a source system, for example, if your source system is not yet ready, select Later
      Note: By connecting to a Pega database storage, you can add fields and complete your data model. When your data model is complete, and your external data sources are available, you can optionally connect to the available data storage system. If you select Now, you can add fields later, if you so choose. If you select Later, you can connect to your data source when it becomes available.
  6. Define your data model from a spreadsheet by clicking Create data model using spreadsheet.
  7. Click Next.
  8. On the Select file page, click Browse.
  9. Navigate to your .xlsx or .csv file, and then click Open.
  10. Click Next.
  11. On the Create fields page, edit the following fields to choose and manipulate the data that is included in your final output:
    • To change the columns to include in the final output, in the Column field, select the column headers of the spreadsheet that you want to display.

      By default, all the columns are selected when the page loads.

    • To change the field names for the columns, in the Field name field, make your edits.
    • To change the field types that are configured for the field names, in the Field type field, edit any types that might be inconsistent with the type of information contained in the field.
  12. Click Create.
    Result: The new Data model page loads with information from the uploaded spreadsheet. For more information about the fields available in the new Data model, see Defining the fields in a data object.
  13. Click Save.
  14. Optional: To import the data from a .csv file without recreating the mapping data model process, in the Records tab, launch the data import wizard and select the preexisting data template.
    For more information, see Importing data from a file.
  • Previous topic Best practices for preparing your files and data model for import
  • Next topic Creating a case type from a spreadsheet

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