How to Deploy Accelerator Package

Make sure the correct account and partition are selected and you have defined a user who will connect to the partition (in Partition Access Entitlement).

2. Select and Configure Package

1. Go to PlatformManager at https://platform.pricefx.com/

2. In the Marketplace find the package you want to deploy and click its tile. At the detail screen, set the following:

3. Select the Target Partition where the package should be deployed.

4. Select Accelerator Version to deploy. The latest valid version is recommended.

5. (Optionally) Run Version Integrity Check to see whether the previous accelerator/package version at the partition was changed by anyone (e.g. the logic was modified). Then it is up to you whether to continue with the deployment and overwrite these changes or whether to cancel the deployment and verify and back up the changes first.
   Example of a result: 

   

6. Click Deploy.

3. Review Warnings & Acknowledge Risks

There is a warning displayed that installing a new Accelerator may have a harmful impact on the selected partition. See the Accelerators documentation to understand which files and configuration will be deployed and thus overridden. Once you acknowledge the risks, you can proceed. 

4. (If applicable) Data Upload

(This step is not common and is used here for the purpose of illustration.)

Some Accelerators start the deployment with uploading your data in the CSV format (zipped or unzipped). It could be, for example, customers, products, transactions, dependency configuration, product segmentation. For details of a specific Accelerator see the Accelerators documentation. 

You can choose between two options:

• Upload new File – upload a CSV, XLSX, or ZIP file.

• Select from recent uploaded – reuse a previously uploaded file. A list of available files displays with the file Name and Upload date.

 Steps shown at top right can be different for each package.

5. (If applicable) Configure Parsing Options

A sample from your data is displayed and you can specify the parsing options – what is used in your data file as a separator, quote and escape character, decimal separator and the date format. (The most common separators can be selected from a drop-down menu.)

You can also specify whether your CSV file has a header or not using the option Uploaded file contains header. If there is no header, generic header names “column1”, “column2”, etc. will be used.

The file is validated for correct types before the upload begins.

6. (If applicable) Data Mapping, Meta Descriptions and Field Data Types

What follows with many Accelerators is to define Data Mapping – which fields from your CSV file correspond to the Pricefx mandatory fields.

In the data sample table in the header row, you can see information on the data type which PlatformManager detected using the first 3 rows. In some cases there can be a warning icon and hints: 

When uploading data during Accelerator deployment, the Data Mapping screen now shows a preview of both:

• Original values from the uploaded CSV file (left column)

• Converted values after applying the selected mapping rules or converters (right column)

This live preview helps you immediately detect if a converter has been wrongly applied (e.g., a number field converted to text, incorrect currency formatting, etc.).

Mandatory Fields Mapping

• Map each required Pricefx field (e.g., Product Id, Product Name) to a field from your CSV file.

• Generate mappings using AI (Optional):

  • Click Map fields with AI assistance.

  • Wait until the system finishes generating the mapping.

  • When the mapping applies, review the suggested mappings.

  • Note: If the AI service is unavailable, continue with manual mapping.

• For every mapped field, you can enter a Meta Description - a free-text explanation (max. 1000 characters) describing the field's meaning, context, or business purpose.
  📈 Including a meta description helps AI tools interpret your data more effectively, resulting in better outcomes and higher value for customers.

  • Example: For “Price Volatility,” your description might be:
    "Metric indicating how much the price changes seasonally. Range 0–100, where 0 means stable prices and 100 means prices always change."

Field Data Types and Converters

Field Data Types are read directly from the Accelerator definition (steps.json). PlatformManager applies the correct converter automatically (e.g., INTEGER, MONEY).

• If the data type exists in the Accelerator: PlatformManager uses that type, and the data type cannot be changed on the UI.

• If the data type does not exist in the Accelerator: PlatformManager uses the type recognized by IntegrationManager (IM). In this case, the data type can be set manually by the user.

  • If a field is detected as String, you cannot change it to Number.

You can change the automatically applied converter in case it has been applied incorrectly.
This is done via the Advanced Field Editor, where you can select or replace a converter for any field and all data formats.

Pricefx significant fields

• It's recommended to map significant fields such as Currency or UOM, and add a meta description where possible as it will improve your results.

Meta Description (for Entire Dataset)

• At the bottom of the mapping screen, provide a Meta Description for the dataset as a whole. Use this field to explain the scope, content, or business intent of the entire uploaded file.
  Including a meta description helps AI tools interpret your data more effectively, resulting in better outcomes and higher value for customers.

• Where the metadata is stored depends on the partition version. For partitions running 15.3.3 or later, dataset-level and field-level meta descriptions for Product, Customer, and Seller master data are stored in dedicated Master Data > Meta Data tables and are directly available to AI features such as Copilot.

For older partitions, the metadata continues to be stored in Advanced Configuration Options to preserve backward compatibility.

8. (Optional) Additional Configuration

Depending on the Accelerator, the wizard may guide you through additional setup, including:

• Mapping other optional fields: Which fields from your CSV file correspond to the Pricefx optional fields.

Adding Custom Fields

You can add your own custom fields to the target Data Source during the mapping step.

Create a custom field

1. In Map your fields to Pricefx optional fields, select Add custom field.

2. In Create New Custom Field, provide:

   • Label (required): The user-facing field label (can contain spaces).

   • Name (required): The technical field name.

     • It is prefilled from the Label by removing spaces (and any unsupported characters).

     • You can edit it, but it must follow the same naming rules as on the partition (for example, it must start with a letter and contain only supported characters; expected pattern like [a-zA-Z]\w*).

     • Example: Label = Sales Manager > Name = SalesManager

   • Data type (required): Select the field type (Number, Quantity, Text, Date, Money, Currency, UOM, LOB, DateTime, Boolean, Integer).

   • Optional fields (if applicable): Measure (Per Unit, Extended, Fixed), Dimension (true for Text fields, false for Date fields), Function (Key).

3. Select Create.

Notes

• In the target table (e.g., Data Sources > Data tab) the column is shown using the Label. The technical Name is visible (in a tooltip, shown in parentheses).

• Currency Settings: Define base/reporting currencies.

• Other configuration: Dashboard selection, dependency setup, product segmentation, simulation, rebate types, rounding rules, etc.

8. Complete Any Remaining Steps

Depending on the Accelerator, there can be other steps to go through. Just follow the deployment wizard. 

Examples of such steps: 

• Data source mapping

• Dashboard selection

• Waterfall configuration

• Dependency configuration

• Product segmentation

• Simulation setup

• Rebate types selection

• Rounding rules configuration

For details follow the links at the bottom of this page.

 Some of the steps can be optional. You can skip them by clicking the link in the message. If you click Continue, you will proceed with the step.

9. Deployment Progress

The deployment process will upload the content of the Accelerator and the data to the partition. The duration is different for each Accelerator. If it takes too long, you can choose to be notified by email about the completed upload, and once you enable this option, you can close the browser. 

10. Finish & Access Your Partition

Once deployment completes, a confirmation screen is displayed with a link to your partition. Click the Go to partition button to access and begin using your newly initialized Pricefx partition.