Script: Class dw.catalog.Product

Class Product

Represents a product in Commerce Cloud Digital. Products are identified by a unique product ID, sometimes called the SKU. There are several different types of product:

  • Simple product
  • Master products: This type of product defines a template for a set of related products which differ only by a set of defined "variation attributes", such as size or color. Master products are not orderable themselves. The variation information for a master product is available through its ProductVariationModel.
  • Variant: Variants are the actual orderable products that are related to a master product. Each variant of a master product has a unique set of values for the defined variation attributes. Variants are said to be "mastered" by the corresponding master product.
  • Option products: Option products define additional options, such as a warranty, which can be purchased for a defined price at the time the product is purchased. The option information for an option product is available through its ProductOptionModel.
  • Product-sets: A product-set is a set of products which the merchant can sell as a collection in the storefront, for example an outfit of clothes. Product-sets are not orderable and therefore do not define prices. They exist only to group the products together in the storefront UI. Members of the set are called "product-set-products".
  • Products bundles: A collection of products which can be ordered as a single unit and therefore can define its own price and inventory record.

Product price and availability information are retrievable through getPriceModel() and getAvailabilityModel() respectively. Attribute information is retrievable through getAttributeModel(). Products may reference other products, either as recommendations or product links. This class provides the methods for retrieving these referenced products.

Products belong to a catalog (the "owning" catalog) and are assigned to categories in other catalogs. Products assigned to categories in the site catalog are typically orderable on the site.

Any API method which returns products will return an instance of a Variant for variant products. This subclass contains methods which are specific to this type of product.

All Known Subclasses

Variant, VariationGroup

Properties

activeData : ProductActiveData Read Only

The active data for this product, for the current site.

allCategories : Collection Read Only

A collection of all categories to which this product is assigned.

allCategoryAssignments : Collection Read Only

All category assignments for this product in any catalog.

allIncomingProductLinks : Collection Read Only

All incoming ProductLinks.

allProductLinks : Collection Read Only

All outgoing ProductLinks.

assignedToSiteCatalog : boolean Read Only

Returns true if the product is assigned to the current site (via the site catalog), otherwise false is returned.

In case of the product being a variant, the variant will be considered as assigned if its master, one of the variation groups it is in or itself is assigned to the site catalog. In case this is triggered for a variation group the variation group is considered as assigned if its master or itself is assigned.

attributeModel : ProductAttributeModel Read Only

Returns this product's ProductAttributeModel, which makes access to the product attribute information convenient. The model is calculated based on the product attributes assigned to this product's classification category (or any of it's ancestors) and the global attribute definitions for the system object type 'Product'. If this product has no classification category, the attribute model is calculated on the global attribute definitions only. If this product is a variant, then the attribute model is calculated based on the classification category of its corresponding master product.

availabilityModel : ProductAvailabilityModel Read Only

The availability model, which can be used to determine availability information for a product.

available : boolean Read Only

Identifies if the product is available.

Deprecated:

Use getAvailabilityModel().isInStock() instead

availableFlag : boolean

Identifies if the product is available.

Deprecated:

Use getAvailabilityModel() instead.

brand : String Read Only

The Brand of the product.

bundle : boolean Read Only

Identifies if this product instance is a product bundle.

bundled : boolean Read Only

Identifies if this product instance is bundled within at least one product bundle.

bundledProducts : Collection Read Only

A collection containing all products that participate in the product bundle.

bundles : Collection Read Only

A collection of all bundles in which this product is included. The method only returns bundles assigned to the current site.

categories : Collection Read Only

A collection of all categories to which this product is assigned and which are also available through the current site.

categorized : boolean Read Only

Identifies if this product is bound to at least one catalog category.

categoryAssignments : Collection Read Only

A collection of category assignments for this product in the current site catalog.

classificationCategory : Category Read Only

The classification category associated with this Product. A product has a single classification category which may or may not be in the site catalog. The classification category defines the attribute set of the product. See getAttributeModel() for how the classification category is used.

EAN : String Read Only

The European Article Number of the product.

facebookEnabled : boolean Read Only

Identifies if the product is Facebook enabled.

ID : String Read Only

The ID of the product.

image : MediaFile Read Only

The product's image.

Deprecated:

Commerce Cloud Digital introduces a new more powerful product image management. It allows to group product images by self-defined view types (e.g. 'large', 'thumbnail', 'swatch') and variation values (e.g. for attribute color 'red', 'blue'). Images can be annotated with pattern based title and alt. Product images can be accessed from Digital locations or external storage locations.

Please use the new product image management. Therefore you have to set up the common product image settings like view types, image location, default image alt and title for your catalogs first. After that you can group your product images by the previously defined view types in context of a product. Finally use getImages(String) and getImage(String, Number) to access your images.

incomingProductLinks : Collection Read Only

Returns incoming ProductLinks, where the source product is a site product.

longDescription : MarkupText Read Only

The product's long description in the current locale.

manufacturerName : String Read Only

The name of the product manufacturer.

manufacturerSKU : String Read Only

The value of the manufacturer's stock keeping unit.

master : boolean Read Only

Identifies if this product instance is a product master.

minOrderQuantity : Quantity Read Only

The minimum order quantity for this product.

name : String Read Only

The name of the product in the current locale.

online : boolean Read Only

The online status of the product. The online status is calculated from the online status flag and the onlineFrom onlineTo dates defined for the product.

onlineCategories : Collection Read Only

A collection of all currently online categories to which this product is assigned and which are also available through the current site. A category is currently online if its online flag equals true and the current site date is within the date range defined by the onlineFrom and onlineTo attributes.

onlineFlag : boolean Read Only

The online status flag of the product.

onlineFrom : Date Read Only

The date from which the product is online or valid.

onlineTo : Date Read Only

The date until which the product is online or valid.

optionModel : ProductOptionModel Read Only

The product's option model. The option values selections are initialized with the values defined for the product, or the default values defined for the option.

optionProduct : boolean Read Only

Identifies if the product has options.

orderableRecommendations : Collection Read Only

A list of outgoing recommendations for this product. This method behaves similarly to getRecommendations() but additionally filters out recommendations for which the target product is unorderable according to its product availability model.

pageDescription : String Read Only

Returns product's page description in the default locale.

pageKeywords : String Read Only

The product's page keywords in the default locale.

pageMetaTags : Array Read Only

All page meta tags, defined for this instance for which content can be generated.

The meta tag content is generated based on the product detail page meta tag context and rules. The rules are obtained from the current product context or inherited from variation groups, master product, the primary category, up to the root category.

pageTitle : String Read Only

The product's page title in the default locale.

pageURL : String Read Only

The product's page URL in the default locale.

pinterestEnabled : boolean Read Only

Identifies if the product is Pinterest enabled.

priceModel : ProductPriceModel Read Only

The price model, which can be used to retrieve a price for this product.

primaryCategory : Category Read Only

The primary category of the product within the current site catalog.

primaryCategoryAssignment : CategoryAssignment Read Only

The category assignment to the primary category in the current site catalog or null if no primary category is defined within the current site catalog.

product : boolean Read Only

Returns 'true' if the instance represents a product. Returns 'false' if the instance represents a product set.

productLinks : Collection Read Only

All outgoing ProductLinks, where the target product is also available in the current site. The ProductLinks are unsorted.

productSet : boolean Read Only

Returns 'true' if the instance represents a product set, otherwise 'false'.

productSetProduct : boolean Read Only

Returns true if this product is part of any product set, otherwise false.

productSetProducts : Collection Read Only

A collection of all products which are assigned to this product and which are also available through the current site. If this product does not represent a product set then an empty collection will be returned.

productSets : Collection Read Only

A collection of all product sets in which this product is included. The method only returns product sets assigned to the current site.

recommendations : Collection Read Only

The outgoing recommendations for this product which belong to the site catalog. If this product is not assigned to the site catalog, or there is no site catalog, an empty collection is returned. Only recommendations for which the target product exists and is assigned to the site catalog are returned. The recommendations are sorted by their explicitly set order.

retailSet : boolean Read Only

Identifies if this product instance is part of a retail set.

Deprecated:

Use isProductSet() instead

searchable : boolean Read Only

Identifies if the product is searchable.

searchableFlag : boolean Read Only

Returns, whether the product is currently searchable.

searchableIfUnavailableFlag : boolean Read Only

The searchable status of the Product if unavailable. Besides true or false, the return value null indicates that the value is not set.

searchPlacement : Number Read Only

The product's search placement classification. The higher the numeric product placement value, the more relevant is the product when sorting search results. The range of numeric placement values is defined in the meta data of object type 'Product' and can therefore be customized.

searchRank : Number Read Only

The product's search rank. The higher the numeric product rank, the more relevant is the product when sorting search results. The range of numeric rank values is defined in the meta data of object type 'Product' and can therefore be customized.

shortDescription : MarkupText Read Only

The product's short description in the current locale.

siteMapChangeFrequency : String Read Only

The product's change frequency needed for the sitemap creation.

siteMapIncluded : Number Read Only

The status if the product is included into the sitemap.

siteMapPriority : Number Read Only

The product's priority needed for the sitemap creation.

siteProduct : boolean Read Only

Returns 'true' if the product is assigned to the current site (via the site catalog), otherwise 'false' is returned.

Deprecated:

Use isAssignedToSiteCatalog() instead

stepQuantity : Quantity Read Only

The steps in which the order amount of the product can be increased.

storeReceiptName : String Read Only

The store receipt name of the product in the current locale.

storeTaxClass : String Read Only

The store tax class ID.

This is an optional override for in-store tax calculation.

taxClassID : String Read Only

The ID of the product's tax class, by resolving the Global Preference setting selected. If the Localized Tax Class setting under Global Preferences -> Products is selected, the localizedTaxClassID attribute value will be returned, else the legacy taxClassID attribute value will be returned.

template : String Read Only

The name of the product's rendering template.

thumbnail : MediaFile Read Only

The product's thumbnail image.

Deprecated:

Commerce Cloud Digital introduces a new more powerful product image management. It allows to group product images by self-defined view types (e.g. 'large', 'thumbnail', 'swatch') and variation values (e.g. for attribute color 'red', 'blue'). Images can be annotated with pattern based title and alt. Product images can be accessed from Digital locations or external storage locations.

Please use the new product image management. Therefore you have to set up the common product image settings like view types, image location, default image alt and title for your catalogs first. After that you can group your product images by the previously defined view types in context of a product. Finally use getImages(String) and getImage(String, Number) to access your images.

unit : String Read Only

The product's sales unit.

unitQuantity : Quantity Read Only

The product's unit quantity.

UPC : String Read Only

The Universal Product Code of the product.

variant : boolean Read Only

Identifies if this product instance is mastered by a product master.

variants : Collection Read Only

A collection of all variants assigned to this variation master or variation group product. All variants are returned regardless of whether they are online or offline. If this product does not represent a variation master or variation group product then an empty collection is returned.

variationGroup : boolean Read Only

Identifies if this product instance is a variation group product.

variationGroups : Collection Read Only

A collection of all variation groups assigned to this variation master product. All variation groups are returned regardless of whether they are online or offline. If this product does not represent a variation master product then an empty collection is returned.

variationModel : ProductVariationModel Read Only

The variation model of this product. If this product is a master product, then the returned model will encapsulate all the information about its variation attributes and variants. If this product is a variant product, then the returned model will encapsulate all the same information, but additionally pre-select all the variation attribute values of this variant. (See ProductVariationModel for details on what "selected" means.) If this product is neither a master product or a variation product, then a model will be returned but will be essentially empty and not useful for any particular purpose.

Constructor Summary

This class does not have a constructor, so you cannot create it directly. To get an instance of this class, use one of the subclass constructors.

Method Summary

assignedToCategory(category : Category) : boolean

Identifies if this product is bound to the specified catalog category.

getActiveData() : ProductActiveData

Returns the active data for this product, for the current site.

getAllCategories() : Collection

Returns a collection of all categories to which this product is assigned.

getAllCategoryAssignments() : Collection

Returns all category assignments for this product in any catalog.

getAllIncomingProductLinks() : Collection

Returns all incoming ProductLinks.

getAllIncomingProductLinks(type : Number) : Collection

Returns all incoming ProductLinks of a specific type.

getAllProductLinks() : Collection

Returns all outgoing ProductLinks.

getAllProductLinks(type : Number) : Collection

Returns all outgoing ProductLinks of a specific type.

getAllRecommendations(catalog : Catalog) : Collection

Returns the outgoing recommendations for this product which belong to the specified catalog.

getAllRecommendations(catalog : Catalog, type : Number) : Collection

Returns the outgoing recommendations for this product which are of the specified type and which belong to the specified catalog.

getAttributeModel() : ProductAttributeModel

Returns this product's ProductAttributeModel, which makes access to the product attribute information convenient.

getAvailabilityModel() : ProductAvailabilityModel

Returns the availability model, which can be used to determine availability information for a product.

getAvailabilityModel(list : ProductInventoryList) : ProductAvailabilityModel

Returns the availability model of the given inventory list, which can be used to determine availability information for a product.

getAvailableFlag() : boolean

Identifies if the product is available.

getBrand() : String

Returns the Brand of the product.

getBundledProductQuantity(aProduct : Product) : Quantity

Returns the quantity of the specified product within the bundle.

getBundledProducts() : Collection

Returns a collection containing all products that participate in the product bundle.

getBundles() : Collection

Returns a collection of all bundles in which this product is included.

getCategories() : Collection

Returns a collection of all categories to which this product is assigned and which are also available through the current site.

getCategoryAssignment(category : Category) : CategoryAssignment

Returns the category assignment for a specific category.

getCategoryAssignments() : Collection

Returns a collection of category assignments for this product in the current site catalog.

getClassificationCategory() : Category

Returns the classification category associated with this Product.

getEAN() : String

Returns the European Article Number of the product.

getID() : String

Returns the ID of the product.

getImage() : MediaFile

Returns the product's image.

getImage(viewtype : String, index : Number) : MediaFile

The method calls getImages(String) and returns the image at the specific index.

getImage(viewtype : String) : MediaFile

The method calls getImages(String) and returns the first image.

getImages(viewtype : String) : List

Returns all images assigned to this product for a specific view type, e.g.

getIncomingProductLinks() : Collection

Returns incoming ProductLinks, where the source product is a site product.

getIncomingProductLinks(type : Number) : Collection

Returns incoming ProductLinks, where the source product is a site product of a specific type.

getLongDescription() : MarkupText

Returns the product's long description in the current locale.

getManufacturerName() : String

Returns the name of the product manufacturer.

getManufacturerSKU() : String

Returns the value of the manufacturer's stock keeping unit.

getMinOrderQuantity() : Quantity

Returns the minimum order quantity for this product.

getName() : String

Returns the name of the product in the current locale.

getOnlineCategories() : Collection

Returns a collection of all currently online categories to which this product is assigned and which are also available through the current site.

getOnlineFlag() : boolean

Returns the online status flag of the product.

getOnlineFrom() : Date

Returns the date from which the product is online or valid.

getOnlineTo() : Date

Returns the date until which the product is online or valid.

getOptionModel() : ProductOptionModel

Returns the product's option model.

getOrderableRecommendations() : Collection

Returns a list of outgoing recommendations for this product.

getOrderableRecommendations(type : Number) : Collection

Returns a list of outgoing recommendations for this product.

getPageDescription() : String

Returns product's page description in the default locale.

getPageKeywords() : String

Returns the product's page keywords in the default locale.

getPageMetaTag(id : String) : PageMetaTag

Returns the page meta tag for the specified id.

getPageMetaTags() : Array

Returns all page meta tags, defined for this instance for which content can be generated.

getPageTitle() : String

Returns the product's page title in the default locale.

getPageURL() : String

Returns the product's page URL in the default locale.

getPriceModel() : ProductPriceModel

Returns the price model, which can be used to retrieve a price for this product.

getPriceModel(optionModel : ProductOptionModel) : ProductPriceModel

Returns the price model based on the specified optionModel.

getPrimaryCategory() : Category

Returns the primary category of the product within the current site catalog.

getPrimaryCategoryAssignment() : CategoryAssignment

Returns the category assignment to the primary category in the current site catalog or null if no primary category is defined within the current site catalog.

getProductLinks() : Collection

Returns all outgoing ProductLinks, where the target product is also available in the current site.

getProductLinks(type : Number) : Collection

Returns all outgoing ProductLinks of a specific type, where the target product is also available in the current site.

getProductSetProducts() : Collection

Returns a collection of all products which are assigned to this product and which are also available through the current site.

getProductSets() : Collection

Returns a collection of all product sets in which this product is included.

getRecommendations() : Collection

Returns the outgoing recommendations for this product which belong to the site catalog.

getRecommendations(type : Number) : Collection

Returns the outgoing recommendations for this product which are of the specified type and which belong to the site catalog.

getSearchableFlag() : boolean

Returns, whether the product is currently searchable.

getSearchableIfUnavailableFlag() : boolean

Returns the searchable status of the Product if unavailable.

getSearchPlacement() : Number

Returns the product's search placement classification.

getSearchRank() : Number

Returns the product's search rank.

getShortDescription() : MarkupText

Returns the product's short description in the current locale.

getSiteMapChangeFrequency() : String

Returns the product's change frequency needed for the sitemap creation.

getSiteMapIncluded() : Number

Returns the status if the product is included into the sitemap.

getSiteMapPriority() : Number

Returns the product's priority needed for the sitemap creation.

getStepQuantity() : Quantity

Returns the steps in which the order amount of the product can be increased.

getStoreReceiptName() : String

Returns the store receipt name of the product in the current locale.

getStoreTaxClass() : String

Returns the store tax class ID.

getTaxClassID() : String

Returns the ID of the product's tax class, by resolving the Global Preference setting selected.

getTemplate() : String

Returns the name of the product's rendering template.

getThumbnail() : MediaFile

Returns the product's thumbnail image.

getUnit() : String

Returns the product's sales unit.

getUnitQuantity() : Quantity

Returns the product's unit quantity.

getUPC() : String

Returns the Universal Product Code of the product.

getVariants() : Collection

Returns a collection of all variants assigned to this variation master or variation group product.

getVariationGroups() : Collection

Returns a collection of all variation groups assigned to this variation master product.

getVariationModel() : ProductVariationModel

Returns the variation model of this product.

includedInBundle(product : Product) : boolean

Identifies if the specified product participates in this product bundle.

isAssignedToCategory(category : Category) : boolean

Returns 'true' if item is assigned to the specified category.

isAssignedToSiteCatalog() : boolean

Returns true if the product is assigned to the current site (via the site catalog), otherwise false is returned.

isAvailable() : boolean

Identifies if the product is available.

isBundle() : boolean

Identifies if this product instance is a product bundle.

isBundled() : boolean

Identifies if this product instance is bundled within at least one product bundle.

isCategorized() : boolean

Identifies if this product is bound to at least one catalog category.

isFacebookEnabled() : boolean

Identifies if the product is Facebook enabled.

isMaster() : boolean

Identifies if this product instance is a product master.

isOnline() : boolean

Returns the online status of the product.

isOptionProduct() : boolean

Identifies if the product has options.

isPinterestEnabled() : boolean

Identifies if the product is Pinterest enabled.

isProduct() : boolean

Returns 'true' if the instance represents a product.

isProductSet() : boolean

Returns 'true' if the instance represents a product set, otherwise 'false'.

isProductSetProduct() : boolean

Returns true if this product is part of any product set, otherwise false.

isRetailSet() : boolean

Identifies if this product instance is part of a retail set.

isSearchable() : boolean

Identifies if the product is searchable.

isSiteProduct() : boolean

Returns 'true' if the product is assigned to the current site (via the site catalog), otherwise 'false' is returned.

isVariant() : boolean

Identifies if this product instance is mastered by a product master.

isVariationGroup() : boolean

Identifies if this product instance is a variation group product.

setAvailableFlag(available : boolean) : void

Set the availability status flag of the product.

setOnlineFlag(online : boolean) : void

Set the online status flag of the product for the current site.

setSearchableFlag(searchable : boolean) : void

Set the flag indicating whether the product is searchable or not in context of the current site.

setSearchPlacement(placement : Number) : void

Set the product's search placement classification in context of the current site.

setSearchRank(rank : Number) : void

Set the product's search rank in context of the current site.

Methods inherited from class ExtensibleObject

describe, getCustom

Methods inherited from class PersistentObject

getCreationDate, getLastModified, getUUID

Methods inherited from class Object

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

Method Detail

assignedToCategory

assignedToCategory(category : Category) : boolean

Identifies if this product is bound to the specified catalog category.

Deprecated:

Use isAssignedToCategory(Category)

Parameters:

category - the CatalogCategory to check.

Returns:

true if the product is bound to the CatalogCategory, false otherwise.

getActiveData

getActiveData() : ProductActiveData

Returns the active data for this product, for the current site.

Returns:

the active data for this product for the current site.

getAllCategories

getAllCategories() : Collection

Returns a collection of all categories to which this product is assigned.

Returns:

Collection of categories.

getAllCategoryAssignments

getAllCategoryAssignments() : Collection

Returns all category assignments for this product in any catalog.

Returns:

Collection of category assignments of the product in any catalog.

getAllIncomingProductLinks() : Collection

Returns all incoming ProductLinks.

Returns:

a collection of all incoming ProductLinks.

getAllIncomingProductLinks(type : Number) : Collection

Returns all incoming ProductLinks of a specific type.

Parameters:

type - the type of ProductLinks to use.

Returns:

a collection of all incoming ProductLinks of a specific type.

getAllProductLinks() : Collection

Returns all outgoing ProductLinks.

Returns:

a collection of all outgoing ProductLinks.

getAllProductLinks(type : Number) : Collection

Returns all outgoing ProductLinks of a specific type.

Parameters:

type - the type of ProductLinks to fetch.

Returns:

a collection of all outgoing ProductLinks of a specific type.

getAllRecommendations

getAllRecommendations(catalog : Catalog) : Collection

Returns the outgoing recommendations for this product which belong to the specified catalog. The recommendations are sorted by their explicitly set order.

Parameters:

catalog - the catalog containing the recommendations.

Returns:

the sorted collection of recommendations, never null but possibly empty.

getAllRecommendations

getAllRecommendations(catalog : Catalog, type : Number) : Collection

Returns the outgoing recommendations for this product which are of the specified type and which belong to the specified catalog. The recommendations are sorted by their explicitly set order.

Parameters:

catalog - the catalog containing the recommendations.

type - the recommendation type.

Returns:

the sorted collection of recommendations, never null but possibly empty.

getAttributeModel

getAttributeModel() : ProductAttributeModel

Returns this product's ProductAttributeModel, which makes access to the product attribute information convenient. The model is calculated based on the product attributes assigned to this product's classification category (or any of it's ancestors) and the global attribute definitions for the system object type 'Product'. If this product has no classification category, the attribute model is calculated on the global attribute definitions only. If this product is a variant, then the attribute model is calculated based on the classification category of its corresponding master product.

Returns:

the ProductAttributeModel for this product.

getAvailabilityModel

getAvailabilityModel() : ProductAvailabilityModel

Returns the availability model, which can be used to determine availability information for a product.

Returns:

the availability model for a product.

getAvailabilityModel

getAvailabilityModel(list : ProductInventoryList) : ProductAvailabilityModel

Returns the availability model of the given inventory list, which can be used to determine availability information for a product.

Parameters:

list - The inventory list to get the availability model for. Must not be null or an exception will be raised.

Returns:

the availability model of the given inventory list for a product.

getAvailableFlag

getAvailableFlag() : boolean

Identifies if the product is available.

Deprecated:

Use getAvailabilityModel() instead.

Returns:

the availability status flag of the product.

getBrand

getBrand() : String

Returns the Brand of the product.

Returns:

the Brand of the product.

getBundledProductQuantity

getBundledProductQuantity(aProduct : Product) : Quantity

Returns the quantity of the specified product within the bundle. If the specified product is not part of the bundle, a 0 quantity is returned.

Parameters:

aProduct - The product to determine the quantity for.

Returns:

The quantity of the product within the bundle or 0 if the product is not part of the bundle.

getBundledProducts

getBundledProducts() : Collection

Returns a collection containing all products that participate in the product bundle.

Returns:

A collection containing all products of the product bundle.

getBundles

getBundles() : Collection

Returns a collection of all bundles in which this product is included. The method only returns bundles assigned to the current site.

Returns:

Collection of bundles in which this product is included, possibly empty.

getCategories

getCategories() : Collection

Returns a collection of all categories to which this product is assigned and which are also available through the current site.

Returns:

Collection of categories to which this product is assigned and which are also available through the current site.

getCategoryAssignment

getCategoryAssignment(category : Category) : CategoryAssignment

Returns the category assignment for a specific category.

Parameters:

category - the category to use when fetching assignments.

Returns:

The category assignment for a specific category.

getCategoryAssignments

getCategoryAssignments() : Collection

Returns a collection of category assignments for this product in the current site catalog.

Returns:

Collection of category assignments.

getClassificationCategory

getClassificationCategory() : Category

Returns the classification category associated with this Product. A product has a single classification category which may or may not be in the site catalog. The classification category defines the attribute set of the product. See getAttributeModel() for how the classification category is used.

Returns:

the associated classification Category, or null if none is associated.

getEAN

getEAN() : String

Returns the European Article Number of the product.

Returns:

the European Article Number of the product.

getID

getID() : String

Returns the ID of the product.

Returns:

ID of the product.

getImage

getImage() : MediaFile

Returns the product's image.

Deprecated:

Commerce Cloud Digital introduces a new more powerful product image management. It allows to group product images by self-defined view types (e.g. 'large', 'thumbnail', 'swatch') and variation values (e.g. for attribute color 'red', 'blue'). Images can be annotated with pattern based title and alt. Product images can be accessed from Digital locations or external storage locations.

Please use the new product image management. Therefore you have to set up the common product image settings like view types, image location, default image alt and title for your catalogs first. After that you can group your product images by the previously defined view types in context of a product. Finally use getImages(String) and getImage(String, Number) to access your images.

Returns:

the product's image.

getImage

getImage(viewtype : String, index : Number) : MediaFile

The method calls getImages(String) and returns the image at the specific index. If no image for specified index is available the method returns null.

Parameters:

viewtype - the view type annotated to image

index - the index number of the image within image list

Returns:

the MediaFile or null

Throws:

NullArgumentException - if viewtype is null

getImage

getImage(viewtype : String) : MediaFile

The method calls getImages(String) and returns the first image. If no image is available the method returns null. When called for a variant with defined images for specified view type the method returns the first image. When called for a variant without defined images for specified view type the method returns the first master product image. If no master product images are defined, the method returns null.

Parameters:

viewtype - the view type annotated to image

Returns:

the MediaFile or null

Throws:

NullArgumentException - if viewtype is null

getImages

getImages(viewtype : String) : List

Returns all images assigned to this product for a specific view type, e.g. all 'thumbnail' images. The images are returned in the order of their index number ascending. When called for a master the method returns the images specific to the master, which are typically the fall back images.

Parameters:

viewtype - the view type annotated to images

Returns:

a list of MediaFile objects, possibly empty

Throws:

NullArgumentException - if viewtype is null

getIncomingProductLinks() : Collection

Returns incoming ProductLinks, where the source product is a site product.

Returns:

a collection of incoming ProductLinks, where the source product is a site product.

getIncomingProductLinks(type : Number) : Collection

Returns incoming ProductLinks, where the source product is a site product of a specific type.

Parameters:

type - the type of ProductLinks to fetch.

Returns:

a collection of incoming ProductLinks, where the source product is a site product of a specific type.

getLongDescription

getLongDescription() : MarkupText

Returns the product's long description in the current locale.

Returns:

The product's long description in the current locale, or null if it wasn't found.

getManufacturerName

getManufacturerName() : String

Returns the name of the product manufacturer.

Returns:

the name of the product manufacturer.

getManufacturerSKU

getManufacturerSKU() : String

Returns the value of the manufacturer's stock keeping unit.

Returns:

the value of the manufacturer's stock keeping unit.

getMinOrderQuantity

getMinOrderQuantity() : Quantity

Returns the minimum order quantity for this product.

Returns:

the minimum order quantity of the product.

getName

getName() : String

Returns the name of the product in the current locale.

Returns:

The name of the product for the current locale, or null if it wasn't found.

getOnlineCategories

getOnlineCategories() : Collection

Returns a collection of all currently online categories to which this product is assigned and which are also available through the current site. A category is currently online if its online flag equals true and the current site date is within the date range defined by the onlineFrom and onlineTo attributes.

Returns:

Collection of currently online categories to which this product is assigned and which are also available through the current site.

getOnlineFlag

getOnlineFlag() : boolean

Returns the online status flag of the product.

Returns:

the online status flag of the product.

getOnlineFrom

getOnlineFrom() : Date

Returns the date from which the product is online or valid.

Returns:

the date from which the product is online or valid.

getOnlineTo

getOnlineTo() : Date

Returns the date until which the product is online or valid.

Returns:

the date until which the product is online or valid.

getOptionModel

getOptionModel() : ProductOptionModel

Returns the product's option model. The option values selections are initialized with the values defined for the product, or the default values defined for the option.

Returns:

the products option model.

getOrderableRecommendations

getOrderableRecommendations() : Collection

Returns a list of outgoing recommendations for this product. This method behaves similarly to getRecommendations() but additionally filters out recommendations for which the target product is unorderable according to its product availability model.

Returns:

the sorted collection of recommendations, never null but possibly empty.

See Also:

ProductAvailabilityModel.isOrderable()

getOrderableRecommendations

getOrderableRecommendations(type : Number) : Collection

Returns a list of outgoing recommendations for this product. This method behaves similarly to getRecommendations(Number) but additionally filters out recommendations for which the target product is unorderable according to its product availability model.

Parameters:

type - the recommendation type.

Returns:

the sorted collection of recommendations, never null but possibly empty.

See Also:

ProductAvailabilityModel.isOrderable()

getPageDescription

getPageDescription() : String

Returns product's page description in the default locale.

Returns:

The product's page description in the default locale, or null if it wasn't found.

getPageKeywords

getPageKeywords() : String

Returns the product's page keywords in the default locale.

Returns:

The product's page keywords in the default locale, or null if it wasn't found.

getPageMetaTag

getPageMetaTag(id : String) : PageMetaTag

Returns the page meta tag for the specified id.

The meta tag content is generated based on the product detail page meta tag context and rule. The rule is obtained from the current product context or inherited from variation groups, master product, the primary category, up to the root category.

Null will be returned if the meta tag is undefined on the current instance, or if no rule can be found for the current context, or if the rule resolves to an empty string.

Parameters:

id - the ID to get the page meta tag for

Returns:

page meta tag containing content generated based on rules

getPageMetaTags

getPageMetaTags() : Array

Returns all page meta tags, defined for this instance for which content can be generated.

The meta tag content is generated based on the product detail page meta tag context and rules. The rules are obtained from the current product context or inherited from variation groups, master product, the primary category, up to the root category.

Returns:

page meta tags defined for this instance, containing content generated based on rules

getPageTitle

getPageTitle() : String

Returns the product's page title in the default locale.

Returns:

The product's page title in the default locale, or null if it wasn't found.

getPageURL

getPageURL() : String

Returns the product's page URL in the default locale.

Returns:

The product's page URL in the default locale, or null if it wasn't found.

getPriceModel

getPriceModel() : ProductPriceModel

Returns the price model, which can be used to retrieve a price for this product.

Returns:

the price model, which can be used to retrieve a price for this product.

getPriceModel

getPriceModel(optionModel : ProductOptionModel) : ProductPriceModel

Returns the price model based on the specified optionModel. The price model can be used to retrieve a price for this product. Prices are calculated based on the option values selected in the specified option model.

Parameters:

optionModel - the option model to use when fetching the price model.

Returns:

the price model based on the specified optionModel.

getPrimaryCategory

getPrimaryCategory() : Category

Returns the primary category of the product within the current site catalog.

Returns:

The product's primary category or null.

getPrimaryCategoryAssignment

getPrimaryCategoryAssignment() : CategoryAssignment

Returns the category assignment to the primary category in the current site catalog or null if no primary category is defined within the current site catalog.

Returns:

The category assignment to the primary category or null.

getProductLinks() : Collection

Returns all outgoing ProductLinks, where the target product is also available in the current site. The ProductLinks are unsorted.

Returns:

a collection of outgoing ProductLinks where the target product is also available in the current site.

getProductLinks(type : Number) : Collection

Returns all outgoing ProductLinks of a specific type, where the target product is also available in the current site. The ProductLinks are sorted.

Parameters:

type - the type of ProductLinks to fetch.

Returns:

a collection of outgoing ProductLinks where the target product is also available in the current site.

getProductSetProducts

getProductSetProducts() : Collection

Returns a collection of all products which are assigned to this product and which are also available through the current site. If this product does not represent a product set then an empty collection will be returned.

Returns:

Collection of products which are assigned to this product and which are also available through the current site.

getProductSets

getProductSets() : Collection

Returns a collection of all product sets in which this product is included. The method only returns product sets assigned to the current site.

Returns:

Collection of product sets in which this product is included, possibly empty.

getRecommendations

getRecommendations() : Collection

Returns the outgoing recommendations for this product which belong to the site catalog. If this product is not assigned to the site catalog, or there is no site catalog, an empty collection is returned. Only recommendations for which the target product exists and is assigned to the site catalog are returned. The recommendations are sorted by their explicitly set order.

Returns:

the sorted collection of recommendations, never null but possibly empty.

getRecommendations

getRecommendations(type : Number) : Collection

Returns the outgoing recommendations for this product which are of the specified type and which belong to the site catalog. Behaves the same as getRecommendations() but additionally filters by recommendation type.

Parameters:

type - the recommendation type.

Returns:

the sorted collection of recommendations, never null but possibly empty.

getSearchableFlag

getSearchableFlag() : boolean

Returns, whether the product is currently searchable.

Returns:

the searchable status flag of the product.

getSearchableIfUnavailableFlag

getSearchableIfUnavailableFlag() : boolean

Returns the searchable status of the Product if unavailable. Besides true or false, the return value null indicates that the value is not set.

Returns:

The searchable status of the product if unavailable or null if not set.

getSearchPlacement

getSearchPlacement() : Number

Returns the product's search placement classification. The higher the numeric product placement value, the more relevant is the product when sorting search results. The range of numeric placement values is defined in the meta data of object type 'Product' and can therefore be customized.

Returns:

The product's search placement classification.

getSearchRank

getSearchRank() : Number

Returns the product's search rank. The higher the numeric product rank, the more relevant is the product when sorting search results. The range of numeric rank values is defined in the meta data of object type 'Product' and can therefore be customized.

Returns:

The product's search rank.

getShortDescription

getShortDescription() : MarkupText

Returns the product's short description in the current locale.

Returns:

the product's short description in the current locale, or null if it wasn't found.

getSiteMapChangeFrequency

getSiteMapChangeFrequency() : String

Returns the product's change frequency needed for the sitemap creation.

Returns:

The product's sitemap change frequency.

getSiteMapIncluded

getSiteMapIncluded() : Number

Returns the status if the product is included into the sitemap.

Returns:

the value of the attribute 'siteMapIncluded'.

getSiteMapPriority

getSiteMapPriority() : Number

Returns the product's priority needed for the sitemap creation.

Returns:

The product's sitemap priority.

getStepQuantity

getStepQuantity() : Quantity

Returns the steps in which the order amount of the product can be increased.

Returns:

the order amount by which the product can be increased.

getStoreReceiptName

getStoreReceiptName() : String

Returns the store receipt name of the product in the current locale.

Returns:

The store receipt name of the product for the current locale, or null if it wasn't found.

getStoreTaxClass

getStoreTaxClass() : String

Returns the store tax class ID.

This is an optional override for in-store tax calculation.

Returns:

the store tax class id.

getTaxClassID

getTaxClassID() : String

Returns the ID of the product's tax class, by resolving the Global Preference setting selected. If the Localized Tax Class setting under Global Preferences -> Products is selected, the localizedTaxClassID attribute value will be returned, else the legacy taxClassID attribute value will be returned.

Returns:

the ID of the product's tax class depending on the Global Preference setting selected for Products.

getTemplate

getTemplate() : String

Returns the name of the product's rendering template.

Returns:

the name of the product's rendering template.

getThumbnail

getThumbnail() : MediaFile

Returns the product's thumbnail image.

Deprecated:

Commerce Cloud Digital introduces a new more powerful product image management. It allows to group product images by self-defined view types (e.g. 'large', 'thumbnail', 'swatch') and variation values (e.g. for attribute color 'red', 'blue'). Images can be annotated with pattern based title and alt. Product images can be accessed from Digital locations or external storage locations.

Please use the new product image management. Therefore you have to set up the common product image settings like view types, image location, default image alt and title for your catalogs first. After that you can group your product images by the previously defined view types in context of a product. Finally use getImages(String) and getImage(String, Number) to access your images.

Returns:

the product's thumbnail image.

getUnit

getUnit() : String

Returns the product's sales unit.

Returns:

the products sales unit.

getUnitQuantity

getUnitQuantity() : Quantity

Returns the product's unit quantity.

Returns:

the products unit quantity.

getUPC

getUPC() : String

Returns the Universal Product Code of the product.

Returns:

the Universal Product Code of the product.

getVariants

getVariants() : Collection

Returns a collection of all variants assigned to this variation master or variation group product. All variants are returned regardless of whether they are online or offline. If this product does not represent a variation master or variation group product then an empty collection is returned.

Returns:

Collection of variants associated with this variation master or variation group product.

getVariationGroups

getVariationGroups() : Collection

Returns a collection of all variation groups assigned to this variation master product. All variation groups are returned regardless of whether they are online or offline. If this product does not represent a variation master product then an empty collection is returned.

Returns:

Collection of variation groups associated with this variation master product.

getVariationModel

getVariationModel() : ProductVariationModel

Returns the variation model of this product. If this product is a master product, then the returned model will encapsulate all the information about its variation attributes and variants. If this product is a variant product, then the returned model will encapsulate all the same information, but additionally pre-select all the variation attribute values of this variant. (See ProductVariationModel for details on what "selected" means.) If this product is neither a master product or a variation product, then a model will be returned but will be essentially empty and not useful for any particular purpose.

Returns:

the variation model of the product.

includedInBundle

includedInBundle(product : Product) : boolean

Identifies if the specified product participates in this product bundle. If this product does not represent a bundle at all, then false will always be returned.

Parameters:

product - the product to check for participation.

Returns:

true if the product participates in the bundle, false otherwise.

isAssignedToCategory

isAssignedToCategory(category : Category) : boolean

Returns 'true' if item is assigned to the specified category.

Parameters:

category - the category to check.

Returns:

true if item is assigned to category.

isAssignedToSiteCatalog

isAssignedToSiteCatalog() : boolean

Returns true if the product is assigned to the current site (via the site catalog), otherwise false is returned.

In case of the product being a variant, the variant will be considered as assigned if its master, one of the variation groups it is in or itself is assigned to the site catalog. In case this is triggered for a variation group the variation group is considered as assigned if its master or itself is assigned.

Returns:

'true' if product assigned to the site catalog

isAvailable

isAvailable() : boolean

Identifies if the product is available.

Deprecated:

Use getAvailabilityModel().isInStock() instead

Returns:

the value of the attribute 'available'.

isBundle

isBundle() : boolean

Identifies if this product instance is a product bundle.

Returns:

true if the product is a bundle, false otherwise.

isBundled

isBundled() : boolean

Identifies if this product instance is bundled within at least one product bundle.

Returns:

true if the product is bundled, false otherwise.

isCategorized

isCategorized() : boolean

Identifies if this product is bound to at least one catalog category.

Returns:

true if the product is bound to at least one catalog category, false otherwise.

isFacebookEnabled

isFacebookEnabled() : boolean

Identifies if the product is Facebook enabled.

Returns:

the value of the attribute 'facebookEnabled'.

isMaster

isMaster() : boolean

Identifies if this product instance is a product master.

Returns:

true if the product is a master, false otherwise.

isOnline

isOnline() : boolean

Returns the online status of the product. The online status is calculated from the online status flag and the onlineFrom onlineTo dates defined for the product.

Returns:

the online status of the product.

isOptionProduct

isOptionProduct() : boolean

Identifies if the product has options.

Returns:

true if product has options, false otherwise.

isPinterestEnabled

isPinterestEnabled() : boolean

Identifies if the product is Pinterest enabled.

Returns:

the value of the attribute 'pinterestEnabled'.

isProduct

isProduct() : boolean

Returns 'true' if the instance represents a product. Returns 'false' if the instance represents a product set.

Returns:

true if the instance is a product, false otherwise.

See Also:

isProductSet()

isProductSet

isProductSet() : boolean

Returns 'true' if the instance represents a product set, otherwise 'false'.

Returns:

true if the instance is a product set, false otherwise.

See Also:

isProduct()

isProductSetProduct

isProductSetProduct() : boolean

Returns true if this product is part of any product set, otherwise false.

Returns:

true if the product is part of any product set, false otherwise.

isRetailSet

isRetailSet() : boolean

Identifies if this product instance is part of a retail set.

Deprecated:

Use isProductSet() instead

Returns:

true if the product is part of a retail set, false otherwise.

isSearchable

isSearchable() : boolean

Identifies if the product is searchable.

Returns:

the value of the attribute 'searchable'.

isSiteProduct

isSiteProduct() : boolean

Returns 'true' if the product is assigned to the current site (via the site catalog), otherwise 'false' is returned.

Deprecated:

Use isAssignedToSiteCatalog() instead

Returns:

'true' if product assigned to site.

isVariant

isVariant() : boolean

Identifies if this product instance is mastered by a product master.

Returns:

true if the product is mastered, false otherwise.

isVariationGroup

isVariationGroup() : boolean

Identifies if this product instance is a variation group product.

Returns:

true if the product is a variation group, false otherwise.

setAvailableFlag

setAvailableFlag(available : boolean) : void

Set the availability status flag of the product.

Deprecated:

Don't use this method anymore.

Parameters:

available - Availability status flag.

setOnlineFlag

setOnlineFlag(online : boolean) : void

Set the online status flag of the product for the current site. If current site is not available (i.e. in case this method is called by a job that runs on organization level) the online status flag is set global, which can affect all sites.

In previous versions this method set the online status flag global, instead of site specific.

API Versioned:

From version 10.6. In prior versions this method set the online status flag global, instead of site specific.

Parameters:

online - Online status flag.

setSearchableFlag

setSearchableFlag(searchable : boolean) : void

Set the flag indicating whether the product is searchable or not in context of the current site. If current site is not available (i.e. in case this method is called by a job that runs on organization level) the searchable flag is set global, which can affect all sites.

In previous versions this method set the searchable flag global, instead of site specific.

API Versioned:

From version 10.6. In prior versions this method set the searchable flag global, instead of site specific.

Parameters:

searchable - The value of the attribute 'searchable'.

setSearchPlacement

setSearchPlacement(placement : Number) : void

Set the product's search placement classification in context of the current site. If current site is not available (i.e. in case this method is called by a job that runs on organization level) the search placement is set global, which can affect all sites.

In previous versions this method set the search placement classification global, instead of site specific.

API Versioned:

From version 10.6. In prior versions this method set the search placement classification global, instead of site specific.

Parameters:

placement - The product's search placement classification.

setSearchRank

setSearchRank(rank : Number) : void

Set the product's search rank in context of the current site. If current site is not available (i.e. in case this method is called by a job that runs on organization level) the search rank is set global, which can affect all sites.

In previous versions this method set the search rank global, instead of site specific.

API Versioned:

From version 10.6. In prior versions this method set the search rank global, instead of site specific.

Parameters:

rank - The product's search rank.