System information
General Reference Guide Export Block Descriptors
RG-001-0-EN ver 1.5 eWON® - 20/03/2009 - ©ACT'L sa Page 181
8.3.9 $dtUF [User File]
8.3.9.1 Export content
The User File export returns the content of a file in the User File area (/usr/ directory – or subdirectory).
When the file is exported, the <%#ParamSSI> and <%#TagSSI> Tags are replaced by the actual values.
8.3.9.2 Detailed Example
8.3.9.3 Used Fields
8.3.9.3.1 $uf [User File Name]
This field is the name of the user file that you want to export (source name).
The file name can be preceded by the name of the subdirectory inside the /usr directory:
The complete path can also be specified:
Example:
8.3.9.3.2 $fn [Destination File Name]
This field is used for specifying a file name to the export data (destination name). Usually this file name is used to specify the output of the data,
for example when sending an attachment to an email. In this case, the $fn file name gives the name of the attachment:
When doing a PUTFTP, then $fn does not need to be specified, because the PUTFTP command manages the name of the destination file:
There is one special case: when a user file ($dtUF$fn) is exported and you do not specify the source name ($uf); in that case, the $fn parameter
is used as source and as destination file name.
$dtUF $uf/ufdir/uf1.txt
$dtUF User file
$uf/ufdir/uf1.txt Will export the uf1.txt file located in the /usr/ufdir directory
Fields Value if not specified
Mandatory
$dt Must always precede "UF": dtUF (means Data Type= User File)
$uf
Optional
$fn
$ft Binary
$ct no compression
Table 165: $dtUF - used fields
/myfile.txt
(myfile.txt is in the /usr directory)
/mydir/myfile.txt
(myfile.txt is in the /usr/mydir directory)
Note: The first "/" is optional.
/usr/myfile.txt
(myfile.txt is in the /usr directory)
/usr/mydir/myfile.txt
(myfile.txt is in the /usr/mydir subdirectory)
Note:
The first "/" is mandatory.
Putftp "/test.txt","[$dtUF $uf/myfile.txt]"
PUTFTP "MyFileWithANewName.txt", "[$dtUF $uf/myfile.txt]"