What is a Catalog Item?
A Catalog item may represent any number of things. It may represent a product, it may represent a material used on a product, it may represent a part of a product that is configurable. Regardless, this is simply a list containing all Products and their building blocks, and is meant to reflect the structure of the Product Catalog and its supporting bill of materials.
Catalog Item Listing
When logging into the Threekit Platform, the user is presented with the paginated Item Listing page.
All columns are sortable, and may may be hidden or rearranged as desired.
Columns may also be filtered by name or tag, and can also be pinned.
When Selected, Catalog Items may be Cloned or Deleted.
Columns may also be expanded or contracted as desired.
From the Products listing, a JSON file may be used to import Product Information by way of the Import Items button.
A JSON file with a full listing of Items will be produced upon hitting the Export Items button
A Catalog Item may be created manually by way of the + Add Items button.
The Product Import API may also be used to import Catalog Items.
Catalog Item
Preview
The preview consists of The Threekit Player, and presents a varying view based on the type of asset referenced. Models will appear as expected, Materials are presented on a sphere, and textures appear as a two-dimensional swatch. Configurable Models and Materials will appear with all corresponding, visible Attributes.
This Preview is fully interactive. Any real-time selection of Attribute Values are reflected in the Player (should supporting, corresponding Logic be established on the referenced 3D Asset). Any administrative changes made to the Configuration Form by way of adding/deleting or manipulating Attributes are also reflected in real-time.
Item Details
Name
The Name (character limit: 255) of the Item, also reflected at the top of an individual product's page.
Description
Contains the Description (character limit: 5000) of the Catalog Item.
Assigned Asset
Reference to the visual asset represented by the Catalog Item (only Models, Materials, or Textures should be referenced). The view button opens a new tab displaying the referenced Asset.
Tags
Tags are used to organize Catalog Items in line with the architecture of a given Product Catalog. Tags allow for easily connoting shared Parts and Materials and may be leveraged within Attributes.
Keywords
Keywords are used externally for such things as Search-Engine Optimization (SEO).
Metadata
Any additional Metadata relevant to the Product is displayed in this panel. Metadata can be used by any connector. The panel contains no fields out of the box. String and Number values are supported.
Attributes
Attributes represent the configurable qualities of a Product. Currently, String, Number, Part References, and Image Uploads are supported. Part references may be literal, or leverage shared tags amongst Catalog Items to present configuration options to the user.
Rules
Rules leverage Attributes to control Attribute visibility and set default Attribute Values.
Catalog Item Buttons
In addition to editing a Catalog Item, the buttons along the top of the interface can be used to create a new render job, view existing renderings, create a product variant, delete the Item, or Clone the Item.