Product Content Definitions

Most content definitions used in tables are Product content definitions. A common table setup (for a horizontally read table) uses attribute content definitions for columns and product content definitions for rows.

Product content definitions can be applied to pull information from individual products or classifications, from the children or parents of these products / product-overrides / classifications, and more. The available product content definitions are:

  • Current Object
  • First SubProduct, Classification
  • First SubProduct, Family
  • Node Reference
  • Parent
  • Parent Name
  • Product/Classification/Asset
  • SubProducts, Classification
  • SubProducts, Family

Note: Any content definition that applies to products also applies to product-overrides.

In all the images that follow, a drop down for row type is shown. The types will be different if adding a column.

Current Object

The Current Object content definition resolves to the object on which the table is extracted. You cannot point a current object row to a specific object. If you, for example, mount a table on the product 123-123 in InDesign, the current object resolves to 123-123.

In a horizontally read table, a current object row type is typically used with Attribute or Asset Reference column types to display selected attributes for the products in the rows.

First SubProduct, Classification

The First SubProduct, Classification content definition will extract the first product or product family from either a specified classification node or dynamically from where the table is defined.

  1. Select Local Classification to pull the information dynamically from the node on which the table is resolved.
  2. Select Specify to choose a specific node in the classification hierarchy. This makes the content definition static, i.e., information from the specified classification will be pulled regardless of the node on which the table is resolved.
  3. If Specify is chosen, use the Browse or Search tab to either browse to or search for the relevant classification.
  4. In the Classification Level field, specify the level from where the products should be extracted. For example, if you select a product group with three levels below, you can specify 1 - 4 depending on how many levels you want to view.
  5. To also include the intermediate levels, check the Include Intermediate Levels box.
  6. If you only want the first subproduct of a particular object type to appear, select the object type from the Object Type dropdown list.
  7. Click OK to add the definition

Example

  1. The first screenshot below shows how the content definition looks on the table on the Definition tab. The second screenshot shows the table on the Preview tab, which is only pulling the first subproduct.

First SubProduct, Family

The First SubProduct, Family definition will insert the first child product under the family into the table. If you are already on the lowest level in the node, no product will show up in the table.

You are allowed to indicate at which level the products should be extracted and also if the intermediate levels should be included. You can also specify which Object Types should be extracted.

  1. Select Local Product to pull the information dynamically from the node on which the table is resolved.
  2. Select Specify to choose a specific node in the product hierarchy. This makes the content definition static, i.e., information from this specified product will be pulled regardless of the node on which the table is resolved.
  3. If Specify is chosen, use the Browse or Search tab to either browse to or search for the relevant product.
  1. In the Level field, enter specify the level from where the products should be extracted. For example, if you select a product group with three levels below, you can specify 1 - 4 depending on how many levels you want to view.
  2. To also include the intermediate levels, check the Include Intermediate Levels box.
  3. If you only want the first subproduct of a particular object type to appear, select the object type from the Object Type dropdown list.
  4. Click OK to add the definition.

Example

The first screenshot below shows how the content definition looks on the table on the Definition tab. The second screenshot shows the table on the Preview tab, which is only pulling the first subproduct.

Node Reference

The Node Reference will insert a row or column in the table that resolves a reference for a product, classification, or asset.

  1. For Resolve, choose Product, Classification, or Asset from the dropdown list.
  2. Based on the selection you made from the Resolve drop down list, choose a reference type from the Select Reference Type dropdown.
  3. Enter a Reference number to determine how many of the references to show. This field is only relevant if there is more than one object referenced with the selected reference type. To resolve all references, either leave the field empty or enter 0.
  4. Browse or Search for the object from which you want to extract the reference(s). Click OK.

Parent

Pulls information from a Parent object. Enter a number in the Level field to determine how many levels up in the hierarchy to go to locate the parent.

Parent Name

The Parent Name content definition extracts the name of the parent product of the selected product.

The parent name that is displayed comes either from the product or the classification hierarchy. Because product can be linked to both a product hierarchy and a classification hierarchy, the parent name depends on whether the product was inserted as a classification or a product.

To apply a transformation to the parent name value, click the ellipsis button () in the Transformation field. For more information about applying attribute transformations to data in tables, refer to the Applying Attribute Transformations to Table Content topic here.

Example

The first screenshot below shows the table on the Definition tab, with the Parent Name content definition applied in the last column. The second screenshot shows how the table looks resolved, on the Preview tab. The object name is extracted in the first column (1), and the names of the objects' parents are extracted in the fourth column (2).

Product/Classification/Asset

The Product/Classification/Asset content definition enables you to select a specific product, classification, or asset. This selection is not dynamic; the content selection remains the same regardless of where the table is resolved.

In a horizontally read table, a Product/Classification/Asset row type is typically used with Attribute column types. For example, if you want to display the name of the object or selected attributes on the object.

If you select an asset, the asset itself (e.g., image) is not displayed in the target cells. However, if using the Attribute content definition for the column, you can display the name or the ID of the asset in the cell(s). Likewise, if you select a classification, you can let the target cells display the name or ID of the classification.

  1. In the 'Column/Row Content definition' list, select Product/Classification/Asset.
  2. Browse to or search for the relevant product, classification or asset. Click OK. Multiple objects can be selected by holding Ctrl or Shift while making selections. Individual rows / columns will be created for each selected object.

  1. The following is an example of a product object in a row, with Attribute content definitions in the columns pulling the Name and ID of the product.

Referenced Node

The Referenced Node content definition extracts values from a referenced product, classification or asset.

If the product that you have created the table on has a product reference to another product, adding a Referenced Node row type enables you to extract values from the referenced product. For example, a product 'AAA-100' has a product reference to another product, 'AAA-200.' The reference type is 'Accessory Optional.' Creating a table on 'AAA-100' with a row type 'Referenced Node' will allow you to extract values from 'AAA-200.'

Note: Using Reference node in tables will only bring you the referenced products from the current node. You will not be able to fetch the subproduct(s) referenced products using this functionality.

  1. Select the relevant object type from the Resolve list. The available options are Product, Classification, and Asset.
  2. From the Select Reference Type list, select the relevant reference type.
  1. In the Reference Number field, specify the number of the reference type to resolve. This field is only relevant if there is more than one object referenced with the selected reference type. To resolve all references, either leave the field empty or enter 0.

Example

In the below example, the table will be resolved on the 'Heels - High: 3" or higher' product object. On the References tab, three products are linked from a different folder using the 'Accessory Optional' reference type.

A very simple table has been built that will pull the name of the objects that are linked using the Accessory Optional content definition.

The resolved table lists the names of the referenced objects.

SubClassifications, Classification

The SubClassifications, Classification content definition works identically to the 'Subproducts, Classification' definition, except this definition displays sub-classifications instead of subproducts. Refer to the following subsection, 'SubProducts, Classification' for more information.

SubProducts, Classification

The SubProducts, Classification content definition extracts all products that are children within a specific classification, either manually from a specific level in the classification hierarchy, or dynamically from where the table is defined.

When you have selected a level in a classification, a row is inserted in the table for each product that the classification contains. So, if a classification contains three products, three rows are added to the table, unless filtering options such as object type are applied (refer to steps below for more information).

In a horizontally read table, a Subproducts, Classification row type is typically used with Attribute or Asset Reference column types. You can, for example, use the Attribute column type to display selected attributes for the products in the rows.

  1. Select Local Classification to extract the product families dynamically. The subproducts are added to the table depending on where the table is extracted.
  2. Select Specify to choose a specific classification from where to extract the product families. This selection is static, and remains the same regardless of where the table is extracted.
  3. Search or Browse for the relevant classification.
  4. In the Classification Level field, specify the level from where the products should be extracted. For example, if you select a product group with three levels below, you can specify 1 - 4 depending on how many levels you want to view.
  5. To also include the intermediate levels, check the Include Intermediate Levels box.
  6. If you only want the first subproduct of a particular object type to appear, select the object type from the Product Object Type dropdown list.
  7. Click OK to add the definition

Example

The first screenshot below shows the Subproducts, Classification content definition on the Definition tab. The second screenshot shows the resolved table on the Preview tab, with one subproduct per row.

SubProducts, Family

Use this when you want to extract all products contained within the selected level in the product hierarchy.

The Subproducts, Family content definition extracts product families either manually from a specific level in the product hierarchy or dynamically from where the table is defined.

When you have selected a level in the product hierarchy, a row is inserted in the table for each product that the product level contains. So if a product level (family) contains three products, three rows are added to the table, unless filtering options such as object type are applied (refer to steps below for more information).

In a horizontally read table, a SubProducts, Family row type is typically used with Attribute or Asset Reference column types, for example, if you want to display selected attributes or images for the products in the rows.

  1. Select Local Product to extract the product families dynamically. The subproducts are added to the table depending on where the table is extracted.
  2. Select Specify to select a specific product level from where to extract the product families. This selection is static, and remains the same regardless of where the table is extracted.
  3. Optionally, enter the Level from where you want the products to be extracted. This refers to the number of nested subfolders downward in the hierarchy. For example, if 2 is entered for Level, then the objects mounted in the table will be pulled from two levels below where the table is built.

  1. If you want the intermediate levels to be included as well, click the Include Intermediate Levels checkbox.

  1. Optionally, select an object type from the Object Type list, to limit the number of extracted products to a specific object type.

Additional Example

The first screenshot below shows the Subproducts, Family content definition on the Definition tab. The second screenshot shows the resolved table on the Preview tab, with one subproduct per row.