How to set up and edit a product model

Setting up a product model

To start setting up a new product model, click the "+ Create product structure"-button in the top right corner of the Product structures page.

General settings

To create a product model, start by giving it a distinct name. This will make it easier for others with access to the PIM to identify the structure's purpose. A unique alias along with a uid will be generated during the setup.

By clicking the "Has variants" toggle you can choose to enable the setup of variants along with variant groups in the product structure. Variant groups option will appear if "Has variants" is enabled.

Finally you can choose to disable revision logging, preventing any revisions from being logged for entities following the product structure.

When you are happy with the general settings click 'Next'.

Model setup

Proceed with the data model setup by clicking the "+"-button in order to add a tab. The tabs added will define the layout of the model.

Tabs

In order to display information for each entity following the structure we will be adding a dynamic tab in this example.

When adding any tab, you must give it a label to help identify the content of the tab. Afterwards, you can choose to add view and save permissions, which will then be required when a user needs to view or save the tab. The label in this example is set as "General"

While the above is true for every tab, some tabs have specific settings associated with them. This is shown in the image above where we are configuring the tab settings for a dynamic tab. Here, we have the option to show the sidebar. If it was an external tab, an external URL would be required.

When you are done setting up the tab, click 'Submit'.

From here we can proceed to define the content of the dynamic tab by clicking the "+"-button within the tab to add sections.

Sections

From here you will be select between multiple sections. In the following example a dynamic section is added in order to contain the properties that each product with this structure should contain.

When setting up a section you will must give it a Headline to identify the sections content. A description can also be added in order to further define the section. You can choose whether the section should collapse by default.

Similarly to when setting up a tab we can choose to add view and save permission, which will then be required when a user needs to view or edit values in a section.

When you are done setting up the section, click 'Submit'.

With the section added, the properties can now be defined within the section by clicking the "+"-button to add a property.

Properties

When adding a property there are a variety of types to select from. For this example we want to add an attribute to the section so we will be selecting the property type "Attribute".

When setting up the attribute property, you have the option to create or select an attribute. In the example above the attribute "Name" has been selected by clicking on the field and then chosen from the collection of other attributes in the PIM. You can also edit an attribute by clicking the icon after having selected one.

Once an attribute has been selected additional settings can be configured. You will be given the option of making the property read only, mandatory, unchangeable or adding a default value

Like previously you can add view and edit permission for the property.

When you are done setting up the section, click 'Submit'.

You can now proceed to add more sections, tabs or properties by clicking on either of the three "+"-buttons. In the example above another property "Description" has been added.

Once satisfied with the model you can click the "next"-button in the bottom right to proceed to the next step, wizard setup.

Wizard setup

Under the wizard setup, you can create flows for either product creation or copying. These optional flows, guide users through the creation process or when copying a product, that is using this structure.

You can expand or collapse the two segments by clicking on the title "Model creation flow" or "Model copy flow".

To start creating a model creation flow click the "+"-button within the "Model creation flow" segment.

When adding steps to the wizard setup, you can choose between classifications- and dynamic wizard step. Classifications wizard step allow you to classify the product during creation, while dynamic wizard step allows you to choose properties that needs to be set on product creation.

In this example we add a dynamic wizard step.

When setting up the step you must give it a Headline, in order to make each step distinct to the user. You can also add a description which will supply the user with more information for the flow.

When you are done setting up the wizard step, click 'Submit'.

Now you can define which properties should be fulfilled in the current step. You do this by clicking the "+"-button within the step.

When adding a property to the wizard step you will given the option to select between multiple types. Since we currently only have attributes in our product model, we will be using the property type attribute.

When setting up the wizard step property you will be able to select a property, previously added to a section, and add it to the wizard step. You can then specify if it should be mandatory. In the example above you can see we are selecting the previously defined property "name" and making it mandatory in the step.

When you are done setting up the wizard property, click 'Submit'.

From here you can continue configuring the wizard, by either adding more steps or more properties by clicking the "+"-button.

You can also expand the "Model copy flow" segment and begin configuring it just like we previously did with the creation flow.

When satisfied with the wizard setup you can click the "next"-button in the bottom right to proceed to the next step, display settings.

Display settings

When configuring the display settings you can select a media attribute to be used as a thumbnail. This is optional.

In this example we intend to generate thumbnails. For this, we would need to go back and expand the model structure to contain a media attribute. We will give it a separate tab and section as seen in the example below.

In display settings you must define a pattern of one or more attributes which should dictate how the name is rendered on a product.

From the defined attributes in the model we will be using the "name" attribute as the sole attribute to render the name.

When finished configuring the display settings you can click the "next"-button in the bottom right to proceed to the next step, identifiers.

Identifiers

You can add identifiers by clicking the "Add product identifiers"-button. This can be done multiple times.

You will be presented with the option to select one or multiple attributes from the model, and use them to define an identifier. However, we need to have an attribute in the model that is not localized. For this, we go back and add another attribute to the model. In the example below, we added "ModelNumber."

Note that identifiers must be unique, so use a set of attributes that are unique across the product model.

With this done we can now go back and configure identifiers.

Start by selecting the attribute(s) to be used as identifier. Then, set the identifier pattern to {0}, as there is only one attribute. If there were two, it could be {0}-{1}. Next, assign it an alias for identification.

After configuring the identifiers you can click the "save"-button in the buttom right to create the save the product model.

Editing or deleting a product model

To edit your product model hover over the product structure you want to edit. A symbol will appear to the right.

To delete a product structure click the "Trash can"-icon when hovering over it.