Datasets, Pricing & Flow Logic
Data-Driven Rules, Pricing, and Interactive Flows
Aircada Studio separates product catalog data and commercial pricing formulas from 3D scene geometry so teams can update SKUs, option matrices, and buyer journeys without editing code. Build structured option catalogs in Dataset Panel & 3D Swatch Thumbnail Capture and Spreadsheet DataGrid & Option Matrix Editor, attach dynamic price rules in Visual Pricing Builder & Checkout Simulator, and orchestrate guided configuration steps and event actions using Flow State Sequencer & Guided Camera Steps and Triggers, Actions & Event Trace Debugger.
Dataset Panel & 3D Swatch Capture | Aircada Docs#
Creating & Linking Option Datasets
The Dataset Panel manages your project's tabular .airpds datasets for materials, sizes, and hardware catalogs. Columns inside a dataset link directly to 3D material properties, part visibility states, and pricing rules so selecting a row in the configurator updates the 3D scene and price simultaneously.
Capturing 3D Swatch Thumbnails in the Viewport
Instead of rendering swatch icons in external 3D software, click the camera icon inside any Image cell to open the 3D viewfinder overlay. Frame the material or part in the live viewport and click Capture to save a centered 1:1 square thumbnail directly into that dataset row for your storefront swatch carousel.
| Workflow | How to Use | Output |
|---|---|---|
| Create Dataset | Click New Dataset in the Dataset Panel | Creates a structured .airpds table inside your project. |
| Bind to 3D Scene | Map dataset columns to material or mesh properties | Updates textures, colors, or parts when a row is selected. |
| Capture 3D Thumbnail | Click the camera icon inside an Image cell | Crops and saves a 1:1 square viewport render for swatch UI. |
Spreadsheet DataGrid & Option Matrix Editor | Aircada Docs#
Defining Typed Columns
The DataGrid editor lets you manage product options, material swatches, and SKU metadata in a familiar spreadsheet layout. Each column is assigned a specific data type (String, Number, Boolean, Color, or Image) so cells display the appropriate input control, such as a color swatch picker, thumbnail uploader, or numeric input. Changing an existing column's data type validates all existing rows and highlights any incompatible values.
Editing Large Swatch Catalogs & CSV Import
Row rendering is virtualized so catalogs with 500 or more fabric, paint, or hardware rows scroll and edit smoothly in the browser. You can import or update rows in bulk from standard CSV spreadsheets and validate every cell before publishing.
| Column Type | Cell Editor | Typical Use Case |
|---|---|---|
| String | Text input | Option display names, SKU codes, and finish labels. |
| Number | Numeric input | Price surcharges, dimensions, roughness values, or weights. |
| Boolean | Checkbox / Toggle | In-stock flags, part visibility toggles, or default selection. |
| Color | Hex / Spectrum picker | Paint colors, anodized metal tints, and stitching shades. |
| Image | Thumbnail upload / capture | 2D swatch thumbnails, PBR texture maps, or decal icons. |
Visual Pricing Builder & Checkout Simulator | Aircada Docs#
Drag-and-Drop Option Sets & Pricing Rules
The Pricing Modeling panel lets you organize product option sets, link dataset price columns, and stack conditional surcharges or volume discount tiers using drag-and-drop cards. Because rule cards evaluate top-to-bottom in the order shown, save your changes after reordering cards so the updated evaluation sequence is written to your project's .airpm pricing model.
Testing in the Checkout Simulator
Click Preview Checkout at the top of the Pricing Modeling panel to open the interactive checkout simulator. Toggle options, adjust quantities, and inspect the resulting price breakdown and line-item SKU payload before connecting your configurator to Shopify or a headless cart.
| Element | Purpose | Behavior |
|---|---|---|
| Option Set Card | Groups related customer choices | Drag to reorder option steps and evaluation priority. |
| Dataset Price Binding | Links a dataset column to pricing | Applies row-level price deltas when a shopper picks a swatch. |
| Rule Configuration Box | Defines conditional surcharges or discounts | Adds flat fees, multipliers, or quantity tier brackets. |
| Checkout Simulator | In-editor purchase preview | Tests live price totals and inspects line-item order metadata. |
Flow State Sequencer & Guided Camera Steps | Aircada Docs#
Creating & Ordering Flow States
The Flow State Sequencer lets you break a complex product configurator into guided buying steps (such as Frame, Drivetrain, and Accessories) arranged along a horizontal card deck. Each state card captures the camera angle, target focus point, part visibility overrides, and material selections for that stage, and you can drag cards left or right to reorder the customer journey.
Smooth Mid-Transition Blending
If a shopper clicks a new step before the current camera or animation transition finishes, the viewport blends smoothly from its current mid-flight position rather than snapping abruptly. When setting up consecutive steps, preview the transition between cards to ensure the camera path orbits cleanly around the product without passing through interior geometry.
| Control | Action | Behavior |
|---|---|---|
| Add Flow State | Click + in the Flow States bar | Captures the current camera angle, visibility, and material state. |
| Drag State Card | Reorder horizontally | Changes the step sequence in the guided buying flow. |
| Select State Card | Click card in deck | Transitions the 3D viewport smoothly to that stage's saved pose. |
Triggers, Actions & Event Trace Debugger | Aircada Docs#
Wiring Triggers to 3D Actions
Triggers and Actions let you connect user interactions (such as clicking a 3D part, hovering a handle, or selecting an option) to scene changes like playing an animation, swapping a material, or updating a property. When a child part is driven by a parent assembly, mark its action as subordinate so child updates do not loop back and re-trigger the parent event. Deleting a part from the scene automatically cleans up its attached triggers and actions.
Inspecting Events in the Action Tracer
Open the Action Tracer debugger to watch triggers and actions fire in real time as you click through your configurator. The tracer keeps a rolling log of the most recent 1,000 events so you can spot missing bindings or unexpected trigger chains without slowing down long editing sessions.
| Concept | Role | Notes |
|---|---|---|
| Trigger | Input condition (click, hover, state change) | Fires when the specified viewport or option event occurs. |
| Action / Property Actuator | Target mutation | Plays animations, toggles visibility, or updates material properties. |
| Subordinate Flag | Loop prevention on child parts | Prevents child updates from recursively re-triggering parent rules. |
| Action Tracer | Live event log (rolling 1,000 events) | Shows exact trigger-to-action execution order for debugging. |