Lasso Soft Inc. > Home

[File_Copy]

[File_Copy] copies a file or directory from one location to another. Accepts two parameters, the location of the file or directory to be copied and the new location. Optional -FileOverWrite keyword specifies that the destination file should be overwritten if it exists.

The file tags are protected by four different permissions. The user must have permission for all of the following in order to use this tag:
- Permission to use the tag itself.
- Permission to perform the file operation.
- Permission to work in the directory which contains the files.
- The filename extensions of the files which are being worked with must be allowed in Lasso Administration.

  • Syntax
  • Parameters
[File_Copy: File NameDestination File Name]

[File_Copy: File NameDestination File Name, -FileOverwrite]
Required Parameters
File Name The name of the file to be copied.
Destination File Name The name of the destination for the copy.
Optional Parameters
Overwrite Keyword If specified, instructs Lasso to overwrite an existing file at the destination.
Examples

To copy a file from one location to another:

Use the [File_Copy] tag. The following example copies a file named myfile.txt from the root of the Web serving folder into a folder named LogFiles.

The [File_Control] ... [/File_Control] tags are essential so the success of the file operation can be determined using the [File_CurrentError] tag.

<?LassoScript
  File_Control;
    File_Copy: '/myfile.txt', '/LogFiles/myfile.txt';
    Output: (File_CurrentError: -ErrorCode) + ': ' + (File_CurrentError);
  /File_Control;
?>
Result:
0: No Error
Tag Link [File_Copy] Category File
Type Process Data Source Any
Support Preferred Version 3.0
Output Type None Security Tag,File
Implementation Sets Lasso 5.0,LDML3x

Please note that periodically LassoSoft will go through the notes and may incorporate information from them into the documentation. Any submission here gives LassoSoft a non-exclusive license and will be made available in various formats to the Lasso community.

LassoSoft Inc. > Home

 

 

©LassoSoft Inc 2014 | Web Development by Treefrog Inc | PrivacyLegal terms and Shipping | Contact LassoSoft