Datasets, Pricing & Flow Logic

Published Updated
Author option datasets, tabular data grids, live pricing formulas, multi-step buyer flows, and no-code event triggers in Aircada Studio.

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#

Create reusable option datasets and capture 1:1 3D swatch thumbnails directly from the viewport.

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.

Dataset Panel Workflows
WorkflowHow to UseOutput
Create DatasetClick New Dataset in the Dataset PanelCreates a structured .airpds table inside your project.
Bind to 3D SceneMap dataset columns to material or mesh propertiesUpdates textures, colors, or parts when a row is selected.
Capture 3D ThumbnailClick the camera icon inside an Image cellCrops and saves a 1:1 square viewport render for swatch UI.

Spreadsheet DataGrid & Option Matrix Editor | Aircada Docs#

Edit product swatches, SKUs, and typed option columns in a spreadsheet-style matrix editor.

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.

Supported DataGrid Column Types
Column TypeCell EditorTypical Use Case
StringText inputOption display names, SKU codes, and finish labels.
NumberNumeric inputPrice surcharges, dimensions, roughness values, or weights.
BooleanCheckbox / ToggleIn-stock flags, part visibility toggles, or default selection.
ColorHex / Spectrum pickerPaint colors, anodized metal tints, and stitching shades.
ImageThumbnail upload / capture2D swatch thumbnails, PBR texture maps, or decal icons.

Visual Pricing Builder & Checkout Simulator | Aircada Docs#

Build drag-and-drop option sets, conditional pricing rules, and test checkout payloads in Studio.

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.

Pricing Builder Controls
ElementPurposeBehavior
Option Set CardGroups related customer choicesDrag to reorder option steps and evaluation priority.
Dataset Price BindingLinks a dataset column to pricingApplies row-level price deltas when a shopper picks a swatch.
Rule Configuration BoxDefines conditional surcharges or discountsAdds flat fees, multipliers, or quantity tier brackets.
Checkout SimulatorIn-editor purchase previewTests live price totals and inspects line-item order metadata.

Flow State Sequencer & Guided Camera Steps | Aircada Docs#

Build step-by-step configurator stages with saved camera angles, visibility rules, and smooth transitions.

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.

Flow State Sequencer Controls
ControlActionBehavior
Add Flow StateClick + in the Flow States barCaptures the current camera angle, visibility, and material state.
Drag State CardReorder horizontallyChanges the step sequence in the guided buying flow.
Select State CardClick card in deckTransitions the 3D viewport smoothly to that stage's saved pose.

Triggers, Actions & Event Trace Debugger | Aircada Docs#

Wire click, hover, and option triggers to 3D actions and inspect live event logs in Studio.

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.

Trigger & Action Concepts
ConceptRoleNotes
TriggerInput condition (click, hover, state change)Fires when the specified viewport or option event occurs.
Action / Property ActuatorTarget mutationPlays animations, toggles visibility, or updates material properties.
Subordinate FlagLoop prevention on child partsPrevents child updates from recursively re-triggering parent rules.
Action TracerLive event log (rolling 1,000 events)Shows exact trigger-to-action execution order for debugging.