Navigation:  IM Sequencer > Schedule tasks > Steps >

FileCopyMove step

Previous pageReturn to chapter overviewNext page

The FileCopy step enables you to copy a file or files from a source location to a destination location.
 
You need to set a couple of settings before you can use this step type:

 

 

Source filename / pattern

 

The file name that needs to be copied to the destination location, you can also use an "*" to define an file name pattern, for instance
SAPHR_*_FULL.txt will match the following files that are named:
 
SAPHR_10-10-2009_FULL.txt
SAPHR_09-10-2009_FULL.txt
SAPHR_08-10-2009_FULL.txt
SAPHR_09-10-2009_FULL.txt

 

Source directory

 

The directory where the source files are located (according to the filename/pattern).

 

Destination directory

 

The directory where the file(s) will be copied to.

 

Destination file name

 

               Set alternate destination file name
 
               Check this option to define an alternate destination file name, this can be useful when the source file name/pattern results in multiple file.
 
               You can use a few options to renames the file using a datetime or random number. The dynamic example field will help you to see the final results when using these parameters.

 
       Parameter {0} is the sourcefile name without the extension
       Parameter {1} is the extension without the "period"
       Parameter {2} is the current date time. You can use {2: dd-MM-yyyy} to use day, month year. Normal datetime formatting does apply here
       Parameter {3} is a random number between 1 and 9999. You can use leading zeroes to always have 4 numbers for instance {3:0000}.
                       This will lead to 4 zeroes being appended.
 
       More information about the formatting can be read here:
 
       Remove source file
 
       Remove the source file when it is being copied, only the file that is actually being copied will be removed not all files that match the pattern.
 
       Keep source file permissions
 
       When checked the original permissions are copied to the new location, if disabled the permissions available in the target directory are applied on the copied file.

 

Advanced copy options tab

 

Multiple file copy mode
Copies the files that match the file name pattern, you can provide 3 options:
- Copy oldest file only : the oldest file in the source directory that matches the filename pattern will be copied.
- Copy newest file only : the newest file in the source directory that matches the filename pattern will be copied.
- Copy all files : all files in the source directory that matches the filename pattern will be copied.
 
Note: The file "LastWriteTime" property is used to determine the newest/oldest file

 

Remove files from source directory if older than 'X' days
 
Removes the file according to the filename pattern from the source directory if creation date is older than 30 days.
 
Remove files from destination directory if older than 'X' days
 
Removes the file according to the filename pattern from the destination directory if creation date is older than 30 days.
 
Enable source file lock detection
 
Before the actual copy takes place the file will be checked if it is locked, this can be useful when the file is already created but the process creating the file is not yet ready writing the file. To detect the lock the file will be opened for reading, if this fails the file is locked.
 
Enable source file size detection
 
Before the actual copy takes place the file size initial size will be stored, the process will wait 2 seconds and check the file size again, when the size is increasing the process will wait again, until the size no longer changes within 2 seconds.

 

                                File copy\move options

 

Backup options tab

 

Make Backup
 
Check this option if you want to backup the file before it would be overwritten. This only applies if the destination file already exists, when the file does not exist the backup will not be made.
 
       Backup directory
 
       This is the directory is can be "relative" to the destination directory where the backup files will be located or set as an absolute path
 
Remove backup files if older than 'X' days
 
Check this option if you want to remove back upped files in the backup directory when they are older then 'X' days, the file creation date will be used to determine how old the file is.

 

                                Backup options

 

Impersonate options tab

 

Impersonate
 
Check this option if you want to impersonate when you are copying the file. Impersonation can help if the Service Account for the IM Sequencer Service
does not have the appropriate rights to access the file that have to be copied.

 

- Username
 
Username used during impersonation, you can use Domain\Username combination.

 

- Password        
 
Password for specified username.
 
Note: The provided credentials will not be tested during setup, if you provide the wrong credentials the impersonation will fail, impersonation will revert at the end of this step type.
 
- Use remote impersonation

Use this option if the username and password cannot be validated on the current machine. For instance when you want to copy files from or to another computer in another domain or workgroup you should
enable this option to forward the credentials for that remote connection.

 

                                Impersonate options

 

 

 

 

 


Page url: http://www.traxionsolutions.com/imsequencer/help/index.html?filecopysteptype.htm