Wiki source code of Catalog

Last modified by Erik Bakker on 2025/09/15 13:36

Show last authors
1 {{container}}
2 {{container layoutStyle="columns"}}
3 (((
4 In this microlearning, we will be diving into the catalog for the Event Streaming pattern in eMagiz. This catalog is a key resource, providing all the essential information on the topic and user level for external parties looking to connect with your eMagiz event streaming cluster. Understanding how to navigate and utilize this catalog will streamline the external parties' effort to connect and integrate.
5
6 If you have any questions along the way, feel free to reach out to us at [[academy@emagiz.com>>mailto:academy@emagiz.com]].
7
8 == 1. Prerequisites ==
9
10 * Basic knowledge of the eMagiz platform
11 * Understanding of Event Streaming concept
12 * An active Event Streaming license
13
14 == 2. Key concepts ==
15
16 This microlearning centers around explaining the catalog for event streaming.
17
18 * With catalog we mean: A place within eMagiz that shows all relevant information on the topic and user level for your eMagiz Event Streaming cluster to external parties.
19
20 Knowing what the catalog is and how you can properly communicate with external parties via the catalog is of the utmost importance when dealing with a complex Event Streaming integration model that spans across a multitude of topics that interchange data.
21
22 == 3. Catalog ==
23
24 In this microlearning, we will focus on the catalog that is available for the Event Streaming pattern in eMagiz. The catalog depicts the relevant information on the topic and user level for any external party that is connecting or wants to connect to the eMagiz event streaming cluster. With the help of such a catalog, it will become easy for external parties to connect to your eMagiz event streaming cluster. The catalog provides the following information:
25
26 * Topic overview
27 * Rights overview on user level
28 * Message structure on topic level (if available)
29 * Connection details
30
31 === 3.1 Catalog View ===
32
33 One part of the equation is the catalog view that your external parties will see when logging in. The other part, inviting catalog users, will be discussed later on. When a catalog user logs in he/she sees a different view compared to a regular user. The catalog user only sees the catalog page. So the first thing that is noticeable is the fact that instead of seeing the various ILM phases (Capture, Design, Create, Deploy and Manage) the user only sees the Catalog page.
34
35 [[image:Main.Images.Microlearning.WebHome@crashcourse-eventstreaming-catalog--catalog-top-level-menu.png]]
36
37 Furthermore, on this page, the user will see two levels:
38
39 * Topics
40 * Users
41
42 {{info}}Note that this view is separated per environment.{{/info}}
43
44 [[image:Main.Images.Microlearning.WebHome@crashcourse-eventstreaming-catalog--catalog-second-level-menu.png]]
45
46 ==== 3.1.1 Topics ====
47
48 On the first level, you see relevant information on a per-topic basis. Here you see the topic configuration, such as the produce, consume patterns and the retention time. Furthermore, you see an example of how the message that is placed on the topic will look like (if defined). On top of those, you will see relevant information coming from our Capture phase (in the tab called "Used by").
49
50 [[image:Main.Images.Microlearning.WebHome@crashcourse-eventstreaming-catalog--catalog-topic-info.png]]
51
52 Armed with this information you can easily execute the first steps of the configuration that are needed to connect to a topic.
53
54 ==== 3.1.2 Users ====
55
56 The next step is located in the user section. In here you will see all Event Streaming Users to which you as a catalog user have access. For more info on what Event Streaming users are please check out the previous microlearning. In this tab, you can download the relevant credentials that are to properly authenticate yourself to the cluster in order to produce or consume a message. Furthermore, you will see the corresponding passwords.
57
58 [[image:Main.Images.Microlearning.WebHome@crashcourse-eventstreaming-catalog--catalog-user-info.png]]
59
60 You can either use the "Download All" button or you can download each part needed for the connection one by one.
61
62 [[image:Main.Images.Microlearning.WebHome@crashcourse-eventstreaming-catalog--catalog-user-info-extra.png]]
63
64 {{info}}For an in-depth explanation of how you must to connect to our event streaming broker please check out this [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Event Streaming Connectors.intermediate-event-streaming-connectors-external-application||target="blank"]]{{/info}}
65
66 === 3.2 Configure Catalog Users ===
67
68 In the previous section, we learned what a catalog user will see when he/she logs in. However to allow this the catalog user(s) first need to be configured. This is a two-step process for which you need a company contact to assist you with the first step. To configure a catalog user the first step is to ask your company contact to add one (or more) portal user(s) to your company. This is necessary so you can select said portal user as a catalog user within your specific integration data model. This is what we call linking the catalog user to the event streaming user.
69
70 To link a catalog user to an event streaming user simply navigate to the Deploy phase of your integration data model and select User Management. Here you can select an Event Streaming user. Assuming the Event Streaming user is already configured (if not please press Apply to Environment) you will see the "Share in Catalog" option in the "Event Streaming" tab.
71
72 [[image:Main.Images.Microlearning.WebHome@crashcourse-eventstreaming-catalog--manage-catalog-users-button.png]]
73
74 By pressing the "Share in catalog" button you will be prompted with a pop-up in which you can select which portal user should become a catalog user and with that automatically be linked to the event streaming user.
75
76 [[image:Main.Images.Microlearning.WebHome@crashcourse-eventstreaming-catalog--select-catalog-users-pop-up.png]]
77
78 You can add catalog users by pressing the Add button in this pop-up. After you are satisfied with your work you can press Close.
79
80 [[image:Main.Images.Microlearning.WebHome@crashcourse-eventstreaming-catalog--added-catalog-users-pop-up.png]]
81
82 {{info}}Note that you need to define this link per environment (Test, Acceptance, Production). As a result, this user has received 'catalog rights' on this integration data model.{{/info}}
83
84 This user can now log onto the platform and will see the catalog overview discussed above for this integration data model.
85
86 == 4. Key takeaways ==
87
88 * Portal users can be designated as 'catalog users' at the integration data model level, allowing them to access and view the catalog details relevant to their permissions.
89 * Catalog users will only see the catalog interface, which simplifies their experience by providing a streamlined view without access to other platform features.
90 * The catalog is very useful for external parties to quickly gather the relevant information needed to connect to the eMagiz Event Streaming Cluster
91
92 == 5. Suggested Additional Readings ==
93
94 If you are interested in this topic and want more information on it, please read the help text provided by eMagiz when executing these actions and browse through the following links:
95
96 * [[Fundamentals (Navigation)>>doc:Main.eMagiz Academy.Fundamentals.WebHome||target="blank"]]
97 ** [[eMagiz Event Streaming (Explanation)>>doc:Main.eMagiz Academy.Fundamentals.fundamental-event-streaming-introduction||target="blank"]]
98 * [[Intermediate Level (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.WebHome||target="blank"]]
99 ** [[Key Concepts Event Streaming (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Event Streaming Connectors.WebHome||target="blank"]]
100 *** [[Using Kafka Module in Mendix (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Event Streaming Connectors.intermediate-event-streaming-connectors-mendix-as-producer||target="blank"]]
101 * [[Catalog (Search Results)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22Catalog%22||target="blank"]]
102 )))
103
104 (((
105 {{toc/}}
106 )))
107 {{/container}}
108 {{/container}}