Skip to Content

Changes for page eMagiz SFTP Connectivity

Last modified by Danniar Firdausy on 2024/09/18 20:23
From version 7.1
edited by Erik Bakker
on 2022/04/21 14:15
Change comment: There is no comment for this version
To version 53.1
edited by Erik Bakker
on 2022/06/02 09:22
Change comment: Deleted image "advanced-active-monitoring-determining-cause-of-log-entry--current-faulty-check.png"

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -From Business to IT
1 +eMagiz SFTP Connectivity
Content
... ... @@ -1,76 +1,67 @@
1 -(% class="row" %)
1 +{{container}}
2 +{{container layoutStyle="columns"}}
2 2  (((
3 -(% class="col-xs-12 col-sm-8" %)
4 -(((
5 -(% class="jumbotron" %)
6 -(((
7 -(% class="container" %)
8 -(((
9 -In this microlearning, we will learn what you should consider determining the impact of business logic within your integration solution. An eMagiz model is most useful when exchanging data between systems while taking care of data and protocol transformations. For example, an eMagiz model is generally less suited for incorporating business logic as these rules cannot be defined dynamically and are relatively complex. Filling your eMagiz model with a lot of business logic opens you up for a continuous discussion about data and interpretations of business rules. As that is not the core goal of an eMagiz model, you should always ask yourself what the most suitable place is to incorporate pieces of logic.
10 -)))
11 -)))
4 +In some cases, there is no communication possible with a local file directory. Or there is a requirement from the external party to place the files somewhere else. Mainly the somewhere else is either an FTP or an SFTP. This microlearning will look at the eMagiz SFTP and learn how to set up the connection between eMagiz and the eMagiz SFTP. In the following microlearning, we will take a more general approach and look how to connect to other SFTP hosts via eMagiz.
12 12  
13 -== 1. Prerequisites ==
14 -
15 -* Advanced knowledge of the eMagiz platform
16 -
17 17  Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
18 18  
19 -* Last update: April 6th, 2021
8 +* Last update: June 2nd, 2022
20 20  * Required reading time: 4 minutes
21 21  
22 -== 2. Key concepts ==
11 +== 1. Prerequisites ==
23 23  
24 -This microlearning centers around considering the impact of business logic
13 +Advanced knowledge of the eMagiz platform
25 25  
26 -By business logic, we mean: Rules that determine what should happen to a message
15 +== 2. Key concepts ==
27 27  
28 -The most interesting point when talking about business logic is:
17 +This microlearning is about the eMagiz SFTP (connectivity).
29 29  
30 -* Where to draw the line?
19 +By the eMagiz SFTP, we mean: A specific SFTP offered by the eMagiz platform on which you can securely store and read messages.
31 31  
32 -== 3. Considering the impact of business logic ==
21 +Considerations when connecting to the eMagiz SFTP
33 33  
34 -In this microlearning, we will learn what you should consider determining the impact of business logic within your integration solution. An eMagiz model is most useful when exchanging data between systems while taking care of data and protocol transformations. For example, an eMagiz model is generally less suited for incorporating business logic as these rules cannot be defined dynamically and are relatively complex. Filling your eMagiz model with a lot of business logic opens you up for a continuous discussion about data and interpretations of business rules. As that is not the core goal of an eMagiz model, you should always ask yourself what the most suitable place is to incorporate pieces of logic.
23 +* Did you read the connect guide and made sure that all requirements are met?
24 +* Did you use the store component made available in the eMagiz store to set up the connection?
25 +* Did you verify that the indicator for temporary file name is set to false?
35 35  
27 +== 3. eMagiz SFTP Connectivity ==
36 36  
37 -The most exciting point when talking about business logic is:
29 +In some cases, there is no communication possible with a local file directory. Or there is a requirement from the external party to place the files somewhere else. Mainly the somewhere else is either an FTP or an SFTP. This microlearning will look at the eMagiz SFTP and learn how to set up the connection between eMagiz and the eMagiz SFTP. In the following microlearning, we will take a more general approach and look how to connect to other SFTP hosts via eMagiz.
30 +
31 +Considerations when connecting to the eMagiz SFTP
38 38  
39 -* Where to draw the line?
33 +* Did you read the connect guide and made sure that all requirements are met?
34 +* Did you use the store component made available in the eMagiz store to set up the connection?
35 +* Did you verify that the indicator for temporary file name is set to false?
40 40  
41 -What is acceptable and what is not acceptable in eMagiz then quickly becomes the question. You could argue that any business rule is too much in eMagiz. However, that is a bit too strict of a definition as there are scenarios in which it is pretty helpful to manipulate the destination of messages while transporting them between systems. One example of this would be logic in the asynchronous routing that allows you to develop functionality within the routing and ensure that each piece of the functionality comes with an on/off switch. This way, you reduce problems when deploying and make it clear to all that data can be sent (or not sent) to certain offramps.
37 +To connect to the eMagiz SFTP eMagiz offers multiple options in the eMagiz store. Depending on whether you want to read or write data you need to select the SFTP Inbound Connectivity or the SFTP Outbound Connectivity option in the store.
42 42  
39 +(% class="wikigeneratedid" %)
40 +[[Invalid check>>image:intermediate-file-based-connectivity-emagiz-sftp-connectivity--store-alternatives.png||alt="Store components" id="Iintermediate-file-based-connectivity-emagiz-sftp-connectivity--store-alternatives.png"]]
43 43  
44 -Another valid scenario would be to filter messages based on a single criterion to reduce the data load sent to specific systems. For example, when you have one system that sends out employee information that needs to be sent to ten different systems, you could use the messaging pattern and filter out the relevant information in the offramp. However, you could also publish all employee information on a topic, let all those systems consume from it, and do the filtering themselves. Both are possible. The most interesting question in this scenario would be whether it can hurt if all systems access all employee information. If that is the case, then filtering in eMagiz becomes highly relevant suddenly.
42 +Within each of the options you can select between the default connection or the caching connection. Depending on the frequency with which you want to connect to the SFTP you need to select the default or the caching variant. In cases were you have a lot of interaction with the SFTP we advise to use the caching variant. In cases were there is infrequent interaction with the SFTP we advise to use the default variant.
45 45  
44 +(% class="wikigeneratedid" %)
45 +[[Invalid check>>image:intermediate-file-based-connectivity-emagiz-sftp-connectivity--store-options.png||alt="Store alternatives" id="Iintermediate-file-based-connectivity-emagiz-sftp-connectivity--store-alternatives.png"]]
46 46  
47 -On the flip side, you should not implement business logic in eMagiz if the rules consist of multiple criteria and are dependent on other (tables of) information. So gathering all that and making the decision will become so complex that you should consider moving the logic to the business application itself. That way, you reduce the complexity of the integration. This reduces the risks of things going wrong and reduces the time needed to develop and maintain the integration.
48 -
49 -
50 -The main takeaway should be that adding business logic comes at a price. Depending on the specific requirements, you have to decide whether the pros outweigh the cons. The most crucial part of using business logic is proper documentation. That way, it is clear what the business logic does, why it is there, and how it can be controlled.
51 -
52 52  == 4. Assignment ==
53 53  
54 -See if you can determine which business logic is implemented in your project and whether that was a wise decision. This assignment can be completed with the help of the (Academy) project that you have created/used in the previous assignment.
49 +Configure an exit that holds the logic needed to write a file to the eMagiz SFTP. This assignment can be completed with the help of the (Academy) project that you have created/used in the previous assignment.
55 55  
56 56  == 5. Key takeaways ==
57 57  
58 -* Check out the pros and cons to determine whether business logic in eMagiz makes sense
59 -* Documentation is key
53 +* Did you read the connect guide and made sure that all requirements are met?
54 +* Did you use the store component made available in the eMagiz store to set up the connection?
55 +* Did you verify that the indicator for temporary file name is set to false?
60 60  
61 61  == 6. Suggested Additional Readings ==
62 62  
63 -* [[Asynchronous Routing>>doc:Main.eMagiz Academy.Microlearnings.WebHome]]
59 +* [[Connect Guide eMagiz SFTP>>doc:Main.eMagiz Academy.Microlearnings.WebHome]]
64 64  
61 +
65 65  == 7. Silent demonstration video ==
66 66  
67 -There is no video for this microlearning.
68 -)))
64 +{{video attachment="intermediate-file-based-connectivity-emagiz-sftp-connectivity.mp4"/}})))
69 69  
70 -(% class="box" %)
71 -(((
72 -**Contents**
73 -
74 -{{toc/}}
75 -)))
76 -)))
66 +((({{toc/}}))){{/container}}
67 +{{/container}}
image.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ebakker
Size
... ... @@ -1,1 +1,0 @@
1 -40.8 KB
Content
advanced-active-monitoring-determining-cause-of-log-entry.mp4
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ebakker
Size
... ... @@ -1,0 +1,1 @@
1 +15.6 MB
Content