Yade- Yet Another Data Exchange 

Introduction: -  

• JS7 makes use of the YADE Add-on for transferring files using several protocols such as FTP, FTPS, SFTP, WebDAV, HTTP/HTTPS etc. 

•   JS7 Yade uses three segments to perform file transfer Fragment, Profile, Operation.  

Steps -  

1. Create a workflow (w). 
2.   Create a Job Resource -jr(A Job Resource provides the environment configuration required for executing a job, such as paths, variables, or credentials. It helps decouple script logic from environment-specific settings.  
3. Add arguments (e.g., test) and environment variables (e.g., TEST). 
4. In the workflow, click the job and declare the name, label, agent, and job resource. 
5. Use this script in job.                     

                                            #!/bin/bash 

                                           ##!include YADE-SetOptions 

                                           "$JS7_YADE_BIN"  

                                          --settings="$ENV_name"  

                                          --profile “profile_name”  

6.  At settings, provide the name of the environment variable used in the job resource. In the profile parameter, specify the name of the profile (e.g., p99) that will be used for file transfer. 
7. Go to the File Transfer section and click New. 
8. In the File Transfer section, go to the Configuration column – click on the Action button and add the job resource. 
9. Now configure the Fragment, Profile, and Operation. 
   ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Fragment- 

To understand fragments, compare them to electrical sockets — the details provided in a fragment define how the job will connect to the appropriate server. 

 You can define multiple fragments based on your requirements. 

           → Fragment → Protocol Fragment 
 
Here, you will see several protocol options. This determines which system or server the file will be transferred to. 
 
For example, if you're using SFTP for the transfer: 

1. Click on Fragment. 
2. Click on Protocol Fragment. 
3. Select SFTP Fragment. 
4. Enter the server credentials. 
5. Click on Basic Connection and add Hostname and Port. 
6. Go to SSH Authentication → Authentication Method: Password → Enter Password.  

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Profile- 

  A Profile in YADE defines the configuration for a specific file transfer, including source and target fragments. It acts as a reusable template used in workflows to execute transfers consistently.                                                                                                 

       ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Operation- 

  We can perform multiple operations on the file like copy, remove, move, getlist. 

1. Operation -> copy  
2. Copy Source: Choose the source fragment for reference. There are multiple options — select the one you want to use (e.g., Local Source). 
3. Click on the Copy Source action button and add the source file option. 
4. In the Selection Node, select the type of source: 

   - File Path (exact path) 

   - File Spec (use regex) 

   - File List (list of file paths to be transferred). 

5. Now go to Copy Target → click on Copy Target Fragment, provide the reference — it will show the fragment you created earlier. 
6. Click on Copy Target again, create a Directory Node, and specify the path.