Changes for page SMB Connectivity

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -34,7 +34,7 @@
34	34
35	35	* SMB session factory
36	36
37		-[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-support-object.png]]
	37	+[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--ftp-support-objects.png]]
38	38
39	39	=== 3.1 Configuration in eMagiz ===
40	40
...	...	@@ -51,7 +51,7 @@
51	51
52	52	When you have opened the flow, you need to enter "Start Editing" mode. After you have done so, we first add the SMB session factory support object to our flow.
53	53
54		-[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-session-factory-empty.png]]
	54	+[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--default-ftp-session-factory-empty.png]]
55	55
56	56	Here, we need to define the following:
57	57
...	...	@@ -59,61 +59,40 @@
59	59	* Port
60	60	* Username
61	61	* Password
62		-* Share and directory
63	63
64		-{{info}}
65		-The value for the share and directory field is the main folder for your file share. If the main folder is the exchange folder, this should be referenced with a /.
66		-{{/info}}
	63	+As best practise, we also define the share and directory value. The value for this field is the main folder for your fileshare. In case the main folder is the exchange folder, this field should be empty and the main folder should be configured as remote directory in the SMB inbound Channel adapter.
67	67
68		-[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-session-factory-filled-in.png]]
	65	+[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--default-ftp-session-factory-filled-in.png]]
69	69
70	70	The settings on the Advanced tab don't have to be changed in most cases. If your specific setup does require a change to these settings, please consult the help texts on the component level for advice.
71	71
72	72	Now that we have configured the support object adding the SMB inbound channel adapter to the flow has become time.
73	73
74		-[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-inbound-channel-adapter-empty.png]]
	71	+[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--ftp-inbound-channel-adapter-empty.png]]
75	75
76	76	In this component, we need to define the remote directory where the original files are located. We need to specify the local directory used to store the files before they are processed temporarily. Furthermore, we need to link the support object we have just created and define a poller. For that last one, the best practice is the use of a cron trigger.
77	77
78		-[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-inbound-channel-adapter-filled-in.png]]
	75	+[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--ftp-inbound-channel-adapter-filled-in.png]]
79	79
80		-Apart from these configurations, you could also add a filter, just as we learned in the [[Crash Course Messaging on file-based connectivity>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Messaging.WebHome||target="blank"]]. Finishing things off, we should consider the delete behavior we will use. Based on the filter and the business requirements, whether to delete and when to delete could differ. So please consider all your options in that regard. In case there are multiple readers from the folder and/or there are legal requirements to store source files for a certain time period, you should not use the delete remote files option. However, not deleting files read files can cause overloading the machine if no alternative delete policies is in place.
	77	+-----------------------------------------------------------------------------------------------------------------------------------
81	81
	79	+Apart from these configurations, you could also add a filter, just as we learned in the Crash Course Messaging on file-based connectivity. Finishing things off, we should consider the delete behavior we will use. Based on the filter and the business requirements, whether to delete and when to delete could differ. So please consider all your options in that regard. This concludes our microlearning, in which we learned how to set up the connectivity with an FTP.
	80	+
82	82	=== 3.2 SMB Gateway ===
83	83
84		-The SMB Gateway is an additional component that can be used to interact with your SMB share. It enables the use of a set of pre-configured commands to for example delete files. The reply messages depend on the selected command. Every command option is explained within the helptext. An example configuration to send files is shown below.
85		-
86		-[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-outbound-gateway-filled-in.png]]
87		-
88		-{{info}}
89		-Please note that for some commands an SpEL expression is required to respresent a path. This setting can be found in the advanced settings. An example for the mget command could be *.txt to get only text files from the directory.
90		-{{/info}}
91		-
92		-All available options are:
93		-
94		-* List files
95		-* List file names
96		-* Retrieve file
97		-* Retrieve multiple files
98		-* Remove file(s)
99		-* Move/rename file
100		-* Send file
101		-* Send mulitple files
102		-
103		-This concludes our microlearning, in which we learned how to set up the connectivity with an SMB.
104		-
105	105	== 4. Key takeaways ==
106	106
107		-* SMB (Server Message Block) is a network protocol for transmitting files between computers over Transmission Control Protocol/Internet Protocol (TCP/IP) connections.
108		-* In an SMB transaction, the end user's computer is typically called the localhost. The second computer involved in SMB is a remote host, which is usually a server.
109		-* Servers must be set up to run SMB services, and the client must have SMB software installed to access these services.
110		-* eMagiz provides several components to set up the SMB connection
	85	+* FTP (File Transfer Protocol) is a network protocol for transmitting files between computers over Transmission Control Protocol/Internet Protocol (TCP/IP) connections.
	86	+* In an FTP transaction, the end user's computer is typically called the localhost. The second computer involved in FTP is a remote host, which is usually a server.
	87	+* Servers must be set up to run FTP services, and the client must have FTP software installed to access these services.
	88	+* eMagiz provides several components to set up the FTP connection
111	111
112	112	== 5. Suggested Additional Readings ==
113	113
114	114	If you are interested in this topic and want more information, please read the release notes provided by eMagiz. Furthermore, check out these links:
115	115
116		-* [[SMB Support>>https://docs.spring.io/spring-integration/reference/smb.html||target="blank"]]
117		-* [[SMB Overview>>https://learn.microsoft.com/en-us/windows-server/storage/file-server/file-server-smb-overview||target="blank"]]
	94	+* [[FTP Inbound>>https://docs.spring.io/spring-integration/docs/2.1.x/reference/html/ftp.html#ftp-inbound||target="blank"]]
	95	+* [[FTP Session Factory>>https://docs.spring.io/spring-integration/docs/4.3.x/reference/html/ftp.html#ftp-session-factory||target="blank"]]
	96	+* [[FTP Explained>>https://searchnetworking.techtarget.com/definition/File-Transfer-Protocol-FTP||target="blank"]]
118	118
119	119	)))((({{toc/}}))){{/container}}{{/container}}