Page Comparison

An FTP Event enables you to specify when and how frequently a process flow should be executed based on either creation of a new file or existence of a file(s) on an FTP Server or upon its modification. To

Steps to create an a FTP Event:

1. Go to Accounts > Manage Objects > Event.Click Create New to create a new FTP eventAccount and click Manage Objects.
   
   Image Added
   
   
2. Click EVENTS > FTP Event.
   
   Image Added
   
   
3. Click CREATE FTP Event.
4. On the New Create FTP Event window, type the name and description of the new FTP event in the Name and Description fields respectively.
   
   Image Added
   
   
5. Type the Host name and port number  and Port on which FTP Server is running in the Host name and Port.
6. Type the username and password required to access FTP Server in the User ID and Password. Confirm  
7. Re-enter the password in the the textbox Confirm Password.
8. Select the transfer type (ACTIVE or PASSIVE) from the Transfer Type.  ACTIVE
   1. ACTIVE transfer is more secure since the client only initiates communication to the server on one port
   whereas in case of PASSIVE
   1. .
   2.  PASSIVE transfer the client initiates communication with the server over two ports. PASSIVE mode is useful when you are behind a firewall or a proxy.

9. Select the trigger from the Trigger Type . Following are the available options - On FileCreated, On FileExists, and On FileModifieddrop-down list. 

   On FileModified	To configure the FTP event to check for any modification in the file(s).
   On FileExists	To configure the FTP event to check for the existence of the file(s).
   On FileCreated	To configure the FTP event to check for the creation of a new file(s).
   Trigger Name	Description

   
   

10. Select Run Initial Load check box  checkbox to process the files created when the event is not active. This option is enabled only if On FileCreated option is selected in the Trigger Type. 

     

    Info
    After the activation of the event, for the first time, the system processes all the files that exist in the base folder location, irrespective whether they were processed earlier or not. However, for subsequent

    activations

    activation, only the unprocessed files are processed each time

    .

    
    

11. Select Don't Process Duplicate Files check box  checkbox if you don't want to process the same file again. This option is enabled only if On FileCreated option is selected in the Trigger Type. 
12. Select SFTP check box  checkbox if the FTP Server specified in the Host Name is an FTP Server over SSHSSL. 
    1. Select the key manager from the Key Manager drop-down list.

13. Select FTPS check box  checkbox if the FTP Server specified in the Host Name is an FTP Server over TLS/SSL. 

     

      

    1. Select the mode from the FTPS Mode drop-down list. It can be Explicit or Implicit depending on FTP Server you are accessing. 

    2. Select the protection level supported by the FTP Server from the Protection

    Level

    1. Level drop-down list. 

    2. Select Validate Server

     check box to

    1.  checkbox to validate the certificate sent by the FTPS Server against the certificate imported in Keystore.

    2. Select the activity from the Keystore

    Name

    1. Name drop-down list. This option is applicable only if you have selected Validate Server. 

14. Type the name of the file(s) that the FTP event needs to verify in the File Include Criteria. To select the file(s), click Define List. The File Include Criteria List window appears.

    1. Type the name of the file or any criteria in the File Include Criteria, for example, .txt. a*, and so on, and then click Add to List. 

    2. Click Save. 
       
       Image Added
       
       

15. Type the name of the file that the FTP event does not need to verify in the File Exclude Criteria. For example, you have typed *.txt as a value in the File Include Criteria, and you want following two files Gdata.txt and Gdata1.txt file not to be verified by the FTP Event. Then Gdata.txt and Gdata1.txt file name need to be entered separated by a comma in the File Exclude Criteria. You can also use regular expressions to specify more than one file in the File Include Criteria and File Exclude Criteria.  
    
    

    Info
    If more than one file is specified in

    the 

    the File Include Criteria, the process flow will trigger for each file.

    
    

16. Type the path of the file from where FTP events verify the file in the File Base Location field.  
    

    Info

    In File Include Criteria and File Exclude Criteria, you can also give the folder name along with the file name. For example, suppose you have typed C:\Gmdata in the File Base Location field. There are two sub-folders - Purchase and Purchase1 in the Gmdata folder. Now, you don't know whether the file is in Purchase or Purchase1 folder. To handle this scenario, you can define File Include Criteria as defined below:

     

    Purchase/.txt,Purchase1/.txt

    . 
     

    
    You can also use regular expression in the folder name as given below:

     

    
    Pur*/*.

    txt 

    txt

    This path includes both the folders -

     

    Purchase

     and 

    and Purchase1.

17. Provide the date from which FTP event will start triggering in the Event Start Date. The date must be in MM/dd/yyyy format. Click the Calendar icon and to select the required date from the calendar.
18. Select the start time when the event will start triggering from the Time field.
19. Provide the date on which FTP event will stop triggering in the Event Expiry Date. The date must be in MM/dd/yyyy format. Click the Calendar  icon and icon to select the required date from the calendar.
20. Select the expiry time when the event will stop triggering from the Time field.

21. Select the trigger from the Trigger drop-down list. You can select Simple or Cron from the list.

    Info
    By default, Simple is selected as a Trigger type.

    
    

22. Provide the time interval for which FTP event will check for the arrival of any file or modification of existing file in the Polling Frequency. Type the digit in the FrequencyFrequency and select the unit of time (seconds, minutes or , hours, day, etc.) from the Duration.

     

    Info
    We recommended minimum Polling Frequency to be more than 60 seconds.

    
    

23. If you have selected Cron as a Trigger type then define the specific time schedule to trigger. For more information on how to define Cron Expression, click here.
    
    Image Added
    
    
24. Type the time in the File Stable Time for which trigger will wait for the file to become stable and select the duration from the Duration. This is applicable for OnFileCreated and On FileModified Trigger Type. Type 0 to pick up the file without checking its stability (not running MDTM and size commands).  

25. Expand Advanced Properties to view the advanced properties of an FTP Event.
    
    Image Added
    
    

26. Select the Option you want to send email notification for. You would view Duplicate file in this box only if you have clicked the option Don't Process Duplicate Files(Step 911).
27. Type the email id in the Notification Receiver Email-ID(s) (comma separated) to receive error emails related to this FTP event.

28. Select Trigger in Sequence check box to trigger the associated process flow in a sequential manner. If you do not select the Trigger in Sequence check box then the associated process flow will trigger concurrently.

29. The Connector lists the APIs to connect to the FTP Server.
    

    For any new activity, by default Secured Inet Factory is selected. 
    The options of the Connector drop-down list changes as per your selection of the protocols to use to establish the FTP connection. 

    FTP	Native  Secured Inet Factory
    SFTP	J2SCH (VFS)  Secured Inet Factory  J2SSH
    FTPS	J2SCH (VFS)  Secured Inet Factory
    Protocol	Options

    
    

30. Select Verbose check box to create a log file of your FTP activity.

     

    Info

    The Verbose check

    The Verbose check box is enabled only if you select

    the Secure

    the Secure Inet

    Factory option

    Factory option from

    the Connector

    the Connector. When you select

    the Verbose checkbox

    the Verbose checkbox, the log file is created within

    .../<AdeptiaSuiteInstallationfolder>/AdeptiaServer/ServerKernel/Log/

    …ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\logs/Ftplogs folder. Whenever you execute this activity, a separate log file is created with the name <ActivityName_MM-dd-yyyy hh-mm-ss.S>.  where,  ActivityName is the name of the FTP activity for which the log file is created.

     

    For information on Advanced Properties, refer to Changing Advanced Properties. 
     
    For information on event misfire handling, refer to Handling Misfire Event. 
     
    For information on how to enable email error notification, refer to Creating Email Error Notification.

    
    

31.  Select the Project from drop-down list of Project.

32. Click Save.