Magidoc

How to ingest product groups

Product Groups in Cloudshelf are essentially a way to group products together. They are intended to be used in a similar way to how you would use an Asile in a store.

Therefore, you need to ingest the Product Group (the parent object), and then add products to those groups.

First, call the UpsertProductGroups Mutation ; optionally provide your own GlobalIds or, make a note of the IDs returned to you; you’ll need to know one of these for the next step.

Second, call the UpdateProductsInProductGroup Mutation ; again optionally provide your own GlobalIds or the ones that have been provided to you during Product Group & Product Creation.

That's it! You’ve ingested product data correctly, and you should be able to call the ProductGroup Query and see the products in the group.

The Product Group and Product Relationship

#

A Product Group can be thought of as a parent container for a collection of Products. Product Groups have very limited data as they are intended to work a bit like an Asile in a store. However, it's important to remember that a Single Product can be part of many groups which can make understanding the relationship hard.

Therefore, using the above information we could see a relationship that looks something like this: (These two relationships are identical, but showing them from different points of view)

  • Product Group One
    • Product One
    • Product Two
    • Product Three
  • Product Group Two
    • Product Two
    • Product Three
  • Product One
    • Product Group One
  • Product Two
    • Product Group One
    • Product Group Two
  • Product Three
    • Product Group One
    • Product Group Two

A real world example here might look like:

  • All Soda
    • Coca Cola
    • Fanta
  • Fruit Flavored Soda
    • Fanta
    • Sprite
  • Coca Cola
    • All Soda
  • Fanta
    • All Soda
    • Fruit Flavored Soda
  • Sprite
    • All Soda
    • Fruit Flavored Soda