Last modified by Erik Bakker on 2023/01/24 15:12
Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2 Apart from having components in the flow editor that ensure the message is received, validated, transformed, and sent, you can also use so-called support objects while building your flow.
3 There are many support objects in various categories. As this is an introduction, we are not going to discuss all of them in detail.
4
5 In this microlearning, we will focus on what they conceptually mean and discuss a couple of them so you get a sense of what they can help you with.
6
7 Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
8
9 == 1. Prerequisites ==
10
11 * Basic knowledge of the eMagiz platform
12
13 == 2. Key concepts ==
14
15 This microlearning focuses on support objects.
16
17 With support objects, we mean: Component that help the functional components do the work they are supposed to do
18
19 == 3. Support objects Introduction ==
20
21 Apart from having components in the flow editor that ensure the message is received, validated, transformed, and sent, you can also use so-called support objects while building your flow.
22 There are many support objects in various categories. As this is an introduction, we are not going to discuss all of them in detail.
23
24 Support objects can be linked to a functional component to aid the working of that component. Some areas in which a support object could help:
25
26 * Connectivity (i.e. JDBC, FTP, SFTP)
27 * Authentication (i..e Basic, OAuth2.0, Metacom, Azure)
28 * Headers (i.e., XPath expression)
29 * Message Format Transformation (i.e., JSON result factory, JSON result transformer, JSON source factory)
30 * Security (i.e., Merlin crypto, WSS4J Security Interceptor, WS-addressing action callback)
31 * File handling (i.e., Composite file list filter, FTP composite file list lifter)
32
33 Aside from the areas mentioned above, other less frequently used support objects for particular cases exist.
34
35 Support objects are not displayed on the flow designer but have a particular place within the right panel. Here you can view, add and edit support objects.
36
37 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--support-objects-location.png]]
38
39 In the remainder of this microlearning, we will zoom in on two of these support objects as illustrative examples of what all support objects conceptually do for you.
40
41 === 3.1 File handling ===
42
43 When retrieving (pulling) files from a specific directory, you might want to determine criteria based on which you will either retrieve (or not retrieve) the files in that directory.
44 To register such a list, you can add a support object called a Composite file list filter.
45
46 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--composite-file-list-filter-selection.png]]
47
48 Opening the support object will give you the following pop-up. In this pop-up, you have a myriad of options you can use for filtering files.
49
50 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--composite-file-list-filter-pop-up.png]]
51
52 The combination that is most used and is effective in most cases becomes a best practice within eMagiz when using this filter option to retrieve files.
53 This combination is:
54
55 * Regular files only filter
56 * Size list filter (minimum bytes is 1, maximum bytes is 1048575)
57 * Age file list filter (minimum age is 10000)
58 * Simple pattern file list filter (property reference)
59
60 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--composite-file-list-filter-pop-up-filled-in.png]]
61
62 By ordering the filters in this way, you make optimal use of the functionality in eMagiz and ensure that every time you check for new files, all new and existing files will get another shot.
63
64 If you use other filter options or start mixing up the order of filter options, a file could get stuck in limbo.
65
66 This way, a file that has been checked previously will not be processed anymore (even though it would have passed the second time around).
67
68 This behavior is the direct consequence of an internal list being kept on the flow level (in cache). This internal list references all files that have been checked before.
69 Once you are on the list and try to enter again, eMagiz will deny you access.
70
71 An example of a filter option with memory is the Accept Once option. As the name suggests, this will only allow a file once.
72 If this is the first thing you check for (before other checks) and the further checks fail the first time around, eMagiz will never retrieve the file anymore because the file is already on the list.
73
74 So be careful experimenting with this one without consulting another team member.
75
76 To ensure that your file inbound channel adapter considers the filter, you have to link the support object to the file inbound channel adapter.
77
78 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--link-to-file-inbound-channel-adapter.png]]
79
80 === 3.2 Authentication ===
81
82 Almost all cases, some form of Authentication is needed when calling a REST web service. One type of Authentication is Basic Authentication.
83 This is the most straightforward form of Authentication and the least complex one. To ensure that the Authentication is sent correctly to the REST web service, you can use a support object in eMagiz called a REST Template.
84
85 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--rest-template.png]]
86
87 Opening the support object will give you the following pop-up. This pop-up has several options that could add authorization to your call to the HTTP endpoint.
88
89 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--rest-template-pop-up.png]]
90
91 For now, we will focus on the Basic access authorization.
92 After you select this option, you can fill in property references to the username and password you need to execute the basic Authentication.
93
94 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--rest-template-basic-access.png]]
95
96 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--rest-template-basic-access-filled-in.png]]
97
98 After saving this setting, you will see that an Interceptor has been added to the REST Template.
99
100 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--rest-template-input.png]]
101
102 You can press Save here; the only thing remaining to make it work in combination with the HTTP outbound gateway is to link it to the HTTP outbound gateway.
103
104 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-create-support-objects-introduction--link-to-http-outbound-gateway.png]]
105
106 == 4. Key takeaways ==
107
108 * Support objects help other functional components in executing their functional
109 * Support objects can help in various categories
110 * Each support object has a specific task and uses a case
111
112 == 5. Suggested Additional Readings ==
113
114 If you are interested in this topic and want more information, please read the help text provided by eMagiz.
115 )))((({{toc/}}))){{/container}}{{/container}}