Importing Store Items - Create

Last modified by Erik Bakker on 2024/08/26 11:51

In this microlearning, we'll explore how to import store items into your eMagiz model. The eMagiz Store is a content library offering reusable solutions that can be easily integrated into your projects. There are several methods available for importing these items, each tailored to different needs. We'll guide you through these options, showing you how to seamlessly bring store items into your work and configure them to fit your specific requirements.

Should you have any questions, please get in touch with academy@emagiz.com.

1. Prerequisites

  • Basic knowledge of the eMagiz platform

2. Key concepts

This microlearning centers around importing store items With eMagiz Store, we mean: A content library that is available to the community for the selection of re-usable solutions within the eMagiz platform

There are several ways of importing a store item:

  • Drag and drop on the canvas (with or without selecting a specific variant)
  • Via Details -> Add store item
  • Via Details -> Version & Variants

3. Importing Store Items - Create

After you have found the store item of your liking, it has become time to import the store item so you can use it within your eMagiz model. To do so, we offer three options in eMagiz. These options are:

  • Drag and drop on the canvas (with or without selecting a specific variant)
  • Via Details -> Add store item
  • Via Details -> Version & Variants

In the remainder of the microlearning, we will discuss each of these solutions in detail. While doing so, we will highlight the added value of each option. Note that for each option to work, you need to be in "Start Editing" mode on flow level in Create.

3.1 Drag and Drop

The first option we will discuss is the drag and drop option available when importing store items. Hover over the item you want to drag, right-click to grab it, and move your mouse over the canvas to drop it. Note that the position of where you drop the store item matters. The position you drop the store item on will be where the left-most item will be placed. After you have dropped the store item on the canvas, you will either be presented with a pop-up asking you which variant of the store item you want, or you will be presented with the configuration pop-up. We will discuss the latter in the next microlearning. The former pop-up will look something as follows.

novice-emagiz-store-importing-store-items--select-variant-pop-up.png

As a result of the drag and drop, you will ultimately end up in the configuration wizard to finish the import process. More on that in the next microlearning. Note that when you opt for the drag and drop option, you will always get the latest version of the store item.

3.2 Details -> Add store item

A second option for importing a store item is to press the button Add store item on the Details pop-up. In essence, this button yields the same results as the drag and drop we discussed earlier. However, this option is preferable over the drag and drop option when you are unsure which store item you need exactly and want to check out the details. This way, you do not have to close the pop-up and subsequently drag and drop but press the button to achieve the same result.

novice-emagiz-store-importing-store-items--details-add-store-item.png

As a result of this option (just as with the drag and drop option), you will ultimately end up in the configuration wizard to finish the import process. More on that in the next microlearning. Note that you will always get the latest version of the store item when you opt for this option.

3.3 Details -> Version & Variants

The third and final option to import a store item is to navigate to Details and select the tab called version & variants. Contrary to the previous two options, this option provides you with the alternative of choosing an older version of a store item. This could be useful in cases where the system you are connecting with is not yet working with the latest version of a store item. In those situations, you want to opt for this route to select the specific version that will work for your solution.

novice-emagiz-store-importing-store-items--details-versions-and-variants.png

Note that after selecting the correct flow fragment of a particular version, you will be shown the configuration wizard to finish the import process. More on that in the next microlearning.

3.4 End result

Regardless of which option you choose, the last step is to configure various parts of the components (such as values, properties, and resources) in such a way that they suit your specific use case. For this, we have the configuration wizard that finishes the import process.

novice-emagiz-store-importing-store-items--configuration-wizard.png

For all the details on this wizard, please check out the following microlearning

4. Key takeaways

  • eMagiz offers several import options that all have a specific use case
  • As a result of your import, eMagiz will show a configuration wizard so you can configure everything before the import is finalized.

5. Suggested Additional Readings