Skip to Content

Changes for page Pick up Files

Last modified by Danniar Firdausy on 2024/08/21 16:48
From version 20.1
edited by Erik Bakker
on 2022/08/15 08:18
Change comment: There is no comment for this version
To version 15.1
edited by eMagiz
on 2022/05/10 11:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,0 @@
1 -Pick up Files
Parent
... ... @@ -1,1 +1,0 @@
1 -WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.marijn
Default language
... ... @@ -1,1 +1,0 @@
1 -en
Content
... ... @@ -1,8 +1,20 @@
1 -{{container}}{{container layoutStyle="columns"}}(((
1 +{{html wiki="true"}}
2 +<div class="ez-academy">
3 + <div class="ez-academy_body">
4 +
5 +<div class="doc">
6 +
7 +
8 +
9 += Pick up Files =
10 +
2 2  In this microlearning, we will explain the basics of retrieving files from a local directory (i.e. a directory that is directly accessible within the network where the eMagiz process is running)
3 3  
4 -Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
13 +Should you have any questions, please contact academy@emagiz.com.
5 5  
15 +* Last update: February 25th, 2021
16 +* Required reading time: 8 minutes
17 +
6 6  == 1. Prerequisites ==
7 7  
8 8  * Basic knowledge of the eMagiz platform
... ... @@ -20,6 +20,8 @@
20 20  * Has eMagiz the appropriate rights to read from the directory where the messages are to be retrieved from
21 21  * What is the format (i.e. XML, JSON, EDI, TXT, CSV, etc.) of the files that eMagiz needs to retrieve
22 22  
35 +
36 +
23 23  == 3. Pick up Files ==
24 24  
25 25  One of the easiest connectivity methods to implement within eMagiz is the retrieval of files from a local directory.
... ... @@ -34,7 +34,7 @@
34 34  
35 35  By default, eMagiz has a filter that will only accept each file once. This option is called prevent duplicates
36 36  
37 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-pick-up-files--prevent-duplicates.png]]
51 +<p align="center">[[image:crashcourse-messaging-pick-up-files--prevent-duplicates.png||]]</p>
38 38  
39 39  As the eMagiz help text clearly states this option will ensure that eMagiz will keep a list in memory and files are only to be passed once.
40 40  This check is done before any other filtering is done. So be aware when mixing these settings.
... ... @@ -50,7 +50,7 @@
50 50  
51 51  To filter which messages need to be retrieved from a local directory we use a composite file list filter.
52 52  
53 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-pick-up-files--composite-file-list-filter-component.png]]
67 +<p align="center">[[image:crashcourse-messaging-pick-up-files--composite-file-list-filter-component.png||]]</p>
54 54  
55 55  In this filter, we use the following four criteria to filter our messages:
56 56  
... ... @@ -61,12 +61,12 @@
61 61  
62 62  The result of this configuration should be:
63 63  
64 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-pick-up-files--composite-file-list-filter.png]]
78 +<p align="center">[[image:crashcourse-messaging-pick-up-files--composite-file-list-filter.png||]]</p>
65 65  
66 66  The next step would be to link this support object to the file inbound channel adapter (the starting point of our flow). To do so open the component and navigate to the Advanced tab.
67 67  Here you need to select the correct filter to reference your support object.
68 68  
69 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-pick-up-files--composite-file-list-filter-linked.png]]
83 +<p align="center">[[image:crashcourse-messaging-pick-up-files--composite-file-list-filter-linked.png||]]</p>
70 70  
71 71  === 3.2 Frequency ===
72 72  
... ... @@ -79,7 +79,7 @@
79 79  * Fixed-Rate
80 80  * Cron Trigger
81 81  
82 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-pick-up-files--frequency-options.png]]
96 +<p align="center">[[image:crashcourse-messaging-pick-up-files--frequency-options.png||]]</p>
83 83  
84 84  Both the Fixed Delay and the Fixed Rate are static. This means that when you want to change the frequency with which you look you will have to make a new version of the flow.
85 85  
... ... @@ -107,18 +107,20 @@
107 107  
108 108  There is a component in eMagiz called the file to string transformer. You should place this directly after receiving the file from the external source
109 109  
110 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-pick-up-files--file-to-string-component.png]]
124 +<p align="center">[[image:crashcourse-messaging-pick-up-files--file-to-string-component.png||]]</p>
111 111  
112 112  Configuration wise you need to select the option Delete files to ensure that the files are deleted
113 113  
114 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-pick-up-files--file-to-string-configuration.png]]
128 +<p align="center">[[image:crashcourse-messaging-pick-up-files--file-to-string-configuration.png||]]</p>
115 115  
116 116  The result of linking the components together will lead to the following solution
117 117  
118 -[[image:Main.Images.Microlearning.WebHome@crashcourse-messaging-pick-up-files--simple-solution.png]]
132 +<p align="center">[[image:crashcourse-messaging-pick-up-files--simple-solution.png||]]</p>
119 119  
120 120  With all this in mind, you have successfully learned how to set up your first connectivity via a messaging flow in eMagiz!
121 121  
136 +===== Practice =====
137 +
122 122  == 4. Assignment ==
123 123  
124 124  Build an entry that retrieves files from an external source and ensures that the data is delivered on the onramp queue.
... ... @@ -132,6 +132,8 @@
132 132   * Has eMagiz the appropriate rights to read from the directory where the messages are to be retrieved from
133 133   * What is the format (i.e. XML, JSON, EDI, TXT, CSV, etc.) of the files that eMagiz needs to retrieve
134 134  
151 +
152 +
135 135  == 6. Suggested Additional Readings ==
136 136  
137 137  If you are interested in this topic and want more information on it please read the help text provided by eMagiz.
... ... @@ -140,6 +140,10 @@
140 140  
141 141  This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
142 142  
143 -{{video attachment="crashcourse-messaging-pick-up-files.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
161 +<iframe width="1280" height="720" src="../../vid/microlearning/crashcourse-messaging-pick-up-files.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
144 144  
145 -)))((({{toc/}}))){{/container}}{{/container}}
163 +</div>
164 +</div>
165 +</div>
166 +
167 +{{/html}}