Bulk Spreadsheet Import

Published on April 30, 2026 QuoteX


Bulk Upload Scope Data with Add From Spreadsheet

The Add From Spreadsheet feature in the Scope Size Effort section of QuoteX lets you load scope data in bulk instead of entering it record by record. This guide walks you through preparing the official template, following category-specific rules, uploading your data, and mapping spreadsheet columns to QuoteX API fields.

What you will learn
• How to download and prepare the official .xlsx template
• Rules for Integration, Data Migration, Change Enablement and Labor Hours data
• How to paste your data from the clipboard
• Which QuoteX API field each spreadsheet column maps to

1. Getting Started

To ensure the system recognizes your data, always begin by downloading the official template:

  1. Navigate to the Scope Size Effort section and click Add From Spreadsheet Tab.
  2. Click the Download Template (.xlsx) button.
  3. Prepare your data within this file to ensure column headers match system requirements.

Add From Spreadsheet tab and Download Template button

Figure 1: Download the official template from the Add From Spreadsheet tab.

Tip: Always start from the official template. Changing or renaming column headers can cause the system to skip your data.

2. Category-Specific Guidelines

Each category in the template has its own columns and rules. Fill out only the fields that belong to the category you are working on.

▶ Integration

Active Values: For the Integration Type column, ensure the values match the records currently listed in the PSC Integration/Migration Type values custom metadata.

Data Entry: Only fill out fields specific to the Integration category.

Integration columns in the template

Figure 2: Integration columns in the template.

Integration data example

Figure 3: Integration data entered in the spreadsheet.

▶ Data Migration

  1. The system specifically looks for values under the Migration header columns as defined in the template.
  2. Ensure data is placed under the correct headers to avoid upload errors.

Data Migration columns in the template

Figure 4: Data Migration columns and values.

▶ Change Enablement

  1. The system specifically looks for values under the Change Enablement header columns as defined in the template.
  2. Ensure data is placed under the correct headers to avoid upload errors.

Change Enablement columns in the template

Figure 5: Change Enablement columns and values.

▶ Managing Labor Hours

⚠ MANDATORY
To successfully upload hours, a Default Role must be set in the ‘Role’ picklist value set. This allows the system to know which role to assign the hours to within the scope.

Default Role in the Role picklist value set

Figure 6: Setting the Default Role in the Role picklist value set.

Labor hours in the spreadsheet

Figure 7: Labor hours entered in the spreadsheet.

3. The Upload Process

Once your spreadsheet is ready:

  1. Copy the data from your spreadsheet to your clipboard.
  2. Use the Paste from Clipboard feature in QuoteX.
  3. The system will automatically populate the respective sections (Integration, Data Migration, and Change Enablement) with the related field values.

Paste from Clipboard result

Figure 8: Sections populated after pasting from the clipboard.

4. Technical Field Mapping

Use the table below to ensure your spreadsheet columns map to the correct API fields in QuoteX.

Field NameField API Name
Integration Vendor Namepsce__Integration_Vendor_Name__c
Integration Functional Areapsce__Functional_Area__c
Integration Typepsce__ETL_Type__c
Integration Directionpsce__Integration_Direction__c
Migration Sourcepsce__Integration_Vendor_Name__c
Migration Objectpsce__Functional_Area__c
Migration Typepsce__ETL_Type__c
Migration Record Countpsce__Approx_Record_Count__c
Change Enablement Functionpsce__Functional_Area__c
Change Enablement Objectivepsce__Objective__c

Troubleshooting Upload Errors

If your upload fails or data does not appear, check the following:
• Data is placed under the correct headers for its category (Integration, Migration, or Change Enablement).
• Column headers still match the official template.
• Integration Type values match the active records in the PSC Integration/Migration Type values custom metadata.
• A Default Role is set in the Role picklist value set when uploading labor hours.

Key Takeaways

  1. Always download and use the official .xlsx template.
  2. Fill out only the fields that belong to each category.
  3. Set a Default Role before uploading hours.
  4. Use Paste from Clipboard to populate all sections at once.

Knowledge Article Number: KA-00048

View more articles in the knowledge base