/
Getting Started with Pricefx Configuration

Getting Started with Pricefx Configuration

This guide walks you through the first steps to begin developing with Pricefx as a configuration engineer – from understanding what you need, to getting a partition, initializing your project, deploying it, and exploring what to do next.

Target Audience

This space (Configuration Knowledge Base) is designed primarily for configuration engineers who are new to developing in the Pricefx environment and need a structured way to move from zero to a running project.

Use this section if you are:

  • A Configuration Engineer, Solution Architect, or Administrator starting with Pricefx configuration

  • A developer who needs to understand the tooling and basic concepts before diving into details

  • Anyone trying to understand the context of content in the Configuration Engineer Knowledge Base

Prerequisites

Before you start using the material in this space, make sure you can answer these questions:

If any of the above is unclear, start with the https://pricefx.atlassian.net/wiki/spaces/KB/pages/4008607912 section before moving on.

First Steps

These are the very first actions to take to get to a working, testable setup.

  1. Get a partition and connect to it

  2. Set up your tooling

  3. Adopt basic naming and structure conventions

To keep your project and this KB consistent, follow naming Conventions – https://pricefx.atlassian.net/wiki/spaces/KB/pages/697696257

  1. Initialize your project

Once you have access to a partition, your next step is to set up a project that connects to it. This usually involves:

  • Selecting or cloning a starter template (for example, a Pricefx starter project).

  • Configuring connection details to your partition.

  • Preparing the project structure so you can begin implementing logic and configuration.

The dedicated https://pricefx.atlassian.net/wiki/spaces/KB/pages/3802202162 documentation contains the up‑to‑date details and recommended steps.

  1. Deploy your project

With a project initialized, you need to deploy it to a partition so that your configuration and logic can run in the Pricefx cloud.

There are several supported ways to deploy Pricefx projects:

  • Pricefx Studio – a graphical interface inside IntelliJ that lets you select exactly which files to deploy, making deployments fast and focused.

  • Pricefx Packaging Tool – a command‑line tool suitable for CI/CD pipelines, so your project can be automatically tested and deployed when you commit to version control.

  • Pricefx Stream Maven Plugin – a Maven plugin capable of deploying (almost) any kind of data, especially useful for sample projects with data. It is used, for example, to deploy the pricefx-starter project – including its sample data – by simply configuring a Maven profile and running the plugin, without requiring IntelliJ or Pricefx Studio.

Quick Start

The goal of this section is to get you from zero to a minimal working solution as fast as possible, in a way that matches this space’s content.

Depending on your focus, you can choose one or more of these quick paths:

Hello World: Basic Logic & Data Access

Objective: Write a simple logic that reads data and returns a result.

Suggested sequence:

  1. Learn how to read data from transactional tables (Products, Customers, etc.):
    General Data Queries – https://pricefx.atlassian.net/wiki/spaces/KB/pages/3499328441

  2. Understand date/time handling in logics:
    Date and DateTime (Quick Reference) – https://pricefx.atlassian.net/wiki/spaces/KB/pages/2471985168

  3. Use queryApi() for new implementations:
    Reference (QueryAPI) – https://pricefx.atlassian.net/wiki/spaces/KB/pages/5707005953

  4. Build a small logic that:

    • Uses api.queryApi() or api.find() to read a product or customer

    • Returns a simple calculated field (e.g., margin %)

This is your “Hello World” for configuration logic.

Hello World: Analytics & Dashboards

Objective: Query analytics data (Datamarts/Data Sources) and show the result, potentially in a dashboard.

  1. Understand Data Source / Datamart queries:
    Data Source Queries – https://pricefx.atlassian.net/wiki/spaces/KB/pages/3499328167

  2. Build a simple Analytics query:

    • Use getDatamartContext()

    • Select a few columns, filter by year, and aggregate (e.g., SUM of InvoicePrice by ProductGroup)

  3. Optionally, convert the result to a ResultMatrix and show it in a dashboard.

  4. When ready, look at On-Demand Dashboards as a more advanced pattern:
    Getting Started with On-Demand Dashboards – https://pricefx.atlassian.net/wiki/spaces/KB/pages/6225559701

Hello World: Integration-Friendly Outputs (Condition Records, Notifications)

If you work on integrations or downstream systems:

Try a minimal example:

  • Configure a logic that, after a document is approved, creates a Condition Record and optionally sends a Notification with a deep link.

Next Steps

Once you have basic connectivity and a couple of working examples, expand in these directions:

Data & Modeling

This helps you understand:

  • Which tables are required (Transactions, Customer Master, Product Master, etc.)

  • What minimal fields are needed to enable insights and optimization

Advanced Querying & Performance

Tooling & Operations

Explore Docs

Once you have a project deployed, the next focus is learning how to extend and customize your solution. The documentation offers several complementary resource types to help you progress: