The "Configure" tab allows detailed setup for each category, with each category linked to a unique object type in Jira Assets. This ensures each category has settings tailored to its specific object type.
While it adds some complexity and time to the configuration, it provides greater flexibility at the category level, enabling you to address more complex use cases.
The "Configure" tab is divided into four sections, each offering specific configuration options: Default Attributes, Category Details, Product Settings, and Advanced Settings.
Default Attributes
Two key attributes are selected in this section:
Name (Required): Serves as the product name displayed in the shop.
Price (Optional): Can remain empty. Only float and integer attributes are available for price selection.
Category Details
In Category Details, you can customize options specific to each category:
Name and Icon: These are fetched from Assets but can be changed if needed for any purpose.
Limit to One Item Selection: Restrict the selection to only one item per category if required.
No Price Text: Customize the text displayed for items without a price (e.g., "Free," "No Price," or leave it blank to show nothing). This is relevant when no price is defined for the assets, ensuring users see consistent messaging.
Product Settings
In the Product Settings section, you can configure optional settings that enhance how products are displayed and managed within a category. These options help provide a better user experience and ensure accurate information is shown.
In Stock: Configures an attribute to automatically update stock status, showing information like "Out of Stock," "Pre-order," or "Only 4 left." Provides users with real-time inventory updates.
Recommended Products: Displays related products in the product details view and cart, offering suggestions for complementary items and enhancing the shopping experience.
Advanced Settings
Object schema* → Select an object schema from which the object types will be filtered.
Included object type* → Select an object type to import as a catalog category.
AQL filter → Optional AQL filter to further narrow down the asset selection. e.g owner = currentUser()
Override global AQL filter → This option when turned on will override the configured catalog AQL filter. This is turned ON by default
Custom field to map to → Map category with an existing Assets custom field. Multiple object types can be added to a category. Objects from this category will be saved in this 'Assets' custom field when a customer request is submitted.
Name and icon → You can rename the category name and change the icon. Default value is what is defined in Jira Assets.
No price text → Enter custom text for items without a price.
Item limit →
Only Assets custom fields will be displayed in the dropdown.
Default attributes
Name* → When configuring a catalog in a portal view, the 'Name' attribute is required. It is mandatory to define the 'Name' for each catalog. Without it, you cannot proceed further in the setup process.
Short Description → While the 'Short Description' is optional, it's beneficial for users. It provides a quick insight into the product without delving into the detailed view. When users hover over a product, the short description pops up, offering a glimpse of the product's highlights.
Price → The 'Price' attribute is optional in the catalog. If left undefined, users will see a label marked "No Price" when viewing the product. This ensures clarity for users when browsing products without specified pricing.
Price attribute needs to be FLOAT or INT data type in Assets.