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.
Catalog Item Listing
When logging into the Threekit Platform, the user is presented with the paginated Item Listing page.
The listing is sortable by Name and Date, and may be filtered by Tag. Mutiple Tags will return results using AND logic.
From the Products listing, a JSON file may be used to import Product Information by way of the Import 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 Page
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 totem, 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.
The Name (character limit: 255) of the Item, also reflected at the top of an individual product's page.
Contains the Description (character limit: 5000) of the Catalog Item.
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 are used externally for such things as Search-Engine Optimization (SEO).
Any additional Metadata relevant to the Product is diplayed in this panel. Metadata can be used by any connector. The panel contains no fields out of the box. At present, String and Number values are supported.
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.
Attributes represent the configurable qualities of a Product. Currently, String, Number, and Part References are supported. Part references may be literal, or leverage shared tags amongst Catalog Items to present configuration options to the user.
Rules leverage Attributes to control Attribute visiblity and set default Attribute Values.