Skip to main content

Products

The product management allows for the structured organization and configuration of products.
A Product represents the top hierarchy level of a configurable element and acts as a container that consolidates all relevant information.

This guide describes the steps to add, update, and delete products, as well as their properties and configurations.

Creating a Product​

By clicking the “Create” button within the CRUD component, a new Product can be created.
Existing Products can be edited or viewed via the “inline icons”.

Fields​

  • Code (mandatory)
    → Technical name of the Product.
    Should match the technical name of the KMat (configurable material) if an interaction is required.
    Helper products (used only in 3D-Customizing) can be freely named, but must follow naming conventions and be unique.
    Example: NWG_KMAT_CUBE

  • ConfigMaterial (optional)
    → Technical name of the KMat, if interaction is needed.
    Example: NWG_KMAT_CUBE

  • Descriptions (optional)
    → Multilingual product description

    • de_de = Würfel
    • en_en = Cube
    • …

Product-Information Tab (Create)​

When creating a new Product:

  • Code is required.
  • ConfigMaterial can be entered if needed.
  • Description can be maintained in multiple languages.

Actions:

  • Save → Create new Product
  • Save → Save changes

After saving, additional tabs will be activated.

Product-Information Tab (Edit-/View-Mode)​

In Edit-/View-Mode:

  • Base information of the Product can be viewed or modified.
  • Save

Product-ProductCharacteristic-Tab​

Here, existing Characteristics can be assigned to a Product.

Note: Code of Characteristic and ProductCharacteristic does not need to be identical.
This allows, for example, a color Characteristic to be linked multiple times with different ProductCharacteristics.
This ensures that similar Characteristics only need to be maintained once.

Creating a ProductCharacteristic​

By clicking the “Create” button in the CRUD component, a new ProductCharacteristic can be created.
Existing ProductCharacteristics can be edited or viewed via the “inline icons”.

Fields​

  • Code (mandatory)
    → Technical name of the ProductCharacteristic.
    Should match the SAP characteristic if SAP integration is used.
    Otherwise, must be unique and follow naming conventions.

  • Characteristic (mandatory)
    → Assign an existing, predefined Characteristic.

  • Descriptions (optional)
    → Multilingual description

    • de_de = Basis Farbe
    • en_en = Base Color
    • …

ProductCharacteristic-Tab (Create)​

  • Code is required.
  • Select a Characteristic.
  • Description can be multilingual.

Actions:

  • Save → Create new ProductCharacteristic
  • Save → Save changes

ProductCharacteristic-Tab (Edit-/View-Mode)​

In Edit-/View-Mode:

  • Base information of the ProductCharacteristic can be viewed or modified.
  • Save

Product-ProductConfigurations Tab​

Here, the 3D-Product can be assigned an SAP-KMat (or external configuration model).
→ A Product can have n KMat’s assigned.

Creating a ProductConfiguration​

By clicking the “Create” button in the CRUD component, a new ProductConfiguration can be created.
Existing ProductConfigurations can be edited or viewed via the “inline icons”.

Fields​

  • Code (mandatory)
    → Technical name of the ProductConfiguration.
    Should match the KMat name if SAP integration is used.
    Otherwise, must be unique and follow naming conventions.
    Example: NWG_KMAT_CUBE

  • ConfigMaterial (optional)
    → Technical name of the KMat (for SAP integration).

  • Parent (optional)
    → Define Parent (for Sub-Product).

  • Product Categories (optional)
    → Assign one or more ProductCategories.

  • Snap Points (optional)
    → Assign one or more SnapPoints for docking.

  • Descriptions (optional)
    → Multilingual description

    • de_de = Würfel
    • en_en = Cube
    • …

ProductConfiguration-Tab (Create)​

  • Code is required.
  • ConfigMaterial optional.
  • Define Parent for Sub-Product if needed.
  • Assign ProductCategories.
  • Assign SnapPoints.
  • Multilingual Description.

Actions:

  • Save → Create new ProductConfiguration
  • Save → Save changes

ProductConfiguration-Tab (Edit-/View-Mode)​

In Edit-/View-Mode:

  • Base information of the ProductConfiguration can be viewed or modified.
  • Save

Products-ObjectInformations Tab​

Here, ObjectInformations (e.g. Unity GameObjects or Prefabs) can be assigned to a Product.

→ A Product can have n ObjectInformations assigned.

Creating an ObjectInformation​

By clicking the “Create” button, a new ObjectInformation can be created.
Existing ObjectInformations can be edited or viewed via the “inline icons”.

Fields​

  • Code (mandatory)
    → Technical name, must match the Prefab-/GameObject name in Unity.
    For Primitives: "Cube", "Sphere", "Capsule", "Cylinder", "Plane", "Quad".

  • Primitive (mandatory)
    → Select Primitive or Prefab/GameObject.

  • Default (mandatory)
    → Indicates if this ObjectInformation should be preselected.

  • Descriptions (optional)
    → Multilingual description

    • de_de = Cube
    • en_en = Cube
    • …

  • Position (optional)
    → Position relative to Snap-/SpawnPoint.

  • Rotation (optional)
    → Rotation relative to Snap-/SpawnPoint.

  • Scale (optional)
    → Scaling.

ObjectInformations-Tab (Create)​

  • Code is required.
  • Select Primitive or Prefab/GameObject.
  • Select Default.
  • Multilingual Description.
  • Define Position (X,Y,Z).
  • Define Rotation (X,Y,Z).
  • Define Scale (X,Y,Z).

Actions:

  • Save → Create new ObjectInformation
  • Save → Save changes

ObjectInformations-Tab (Edit-/View-Mode)​

In Edit-/View-Mode:

  • Base information of the ObjectInformation can be viewed or modified.
  • Save

Products-ObjectInformationInteractions Tab​

Here, Interactions can be assigned to an ObjectInformation.
(Interactions = predefined functions in the Unity backend).

→ An ObjectInformation can have n Interactions assigned.

This defines how a visualization object responds to user choices or characteristic evaluations.

Creating an ObjectInformationInteraction​

By clicking the “Create” button, a new ObjectInformationInteraction can be created.
Existing Interactions can be edited or viewed via the “inline icons”.

Fields​

  • Code (mandatory)
    → Technical name, unique and follows naming conventions.

  • Interaction (mandatory)
    → Select one of the available Interactions (Unity functions).

  • Descriptions (optional)
    → Multilingual description

    • de_de = Würfelfarbe wechseln
    • en_en = Cube Change Color
    • …

ObjectInformationInteraction-Tab (Create)​

  • Code is required.
  • Select the desired Interaction.
  • Multilingual Description.

Actions:

  • Save → Create new ObjectInformationInteraction
  • Save → Save changes

ObjectInformationInteraction-Tab (Edit-/View-Mode)​

In Edit-/View-Mode:

  • Base information of the ObjectInformationInteraction can be viewed or modified.
  • Save

Products-ObjectInformationInteractionParameters Tab​

Here, parameters can be assigned to an ObjectInformationInteraction.

Example:
Define which Characteristic the values come from and which object (within the GameObject/Prefab) they should be applied to.
(Choice = NWG_COLOR / GameObjectName = Cube)

→ An ObjectInformationInteraction can have n Parameters assigned.

Creating an ObjectInformationInteractionParameter​

By clicking the “Create” button, a new ObjectInformationInteractionParameter can be created.
Existing Parameters can be edited or viewed via the “inline icons”.

Fields​

  • Code (mandatory)
    → Technical name, unique and naming-convention compliant.

  • Type (mandatory)
    → Select parameter type:

    • Choice → Define value or ProductCharacteristic.
    • GameObjectName → Define object path/hierarchy inside the Prefab.

  • Parameter (mandatory)
    → Value for the selected type:

    • For Choice → ProductCharacteristic (e.g. "NWG_COLOR").
    • For GameObjectName → GameObject name in the prefab (e.g. "Cube").

  • Descriptions (optional)
    → Multilingual description

    • de_de = Würfelfarbe wechseln
    • en_en = Cube Change Color
    • …

ObjectInformationInteractionParameter-Tab (Create)​

  • Code is required.
  • Select Type.
  • Define corresponding Parameter.
  • Multilingual Description.

Actions:

  • Save → Create new ObjectInformationInteractionParameter
  • Save → Save changes

ObjectInformationInteractionParameter-Tab (Edit-/View-Mode)​

In Edit-/View-Mode:

  • Base information of the ObjectInformationInteractionParameter can be viewed or modified.
  • Save