Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
.CLIENT UPLOAD FILE | ||||||||
Line: 19 to 19 | ||||||||
Description: | ||||||||
Changed: | ||||||||
< < | This subroutine will upload a file from the Client to the server. The first three parameters are required, if any are missing the subroutine will CANCEL. The <convert_flag> is optional. | |||||||
> > | This subroutine will upload a file from the Client to the server. The first three parameters are required, if any are missing the subroutine will CANCEL. The <convert_flag> is optional. If the <dest_file> exists on the server, it will be overwritten without warning (if permissions allow it). Note that <dest_file> must be in a location writeable by user 'appx' (Linux/Unix servers) or the current user (Window servers). | |||||||
Changed: | ||||||||
< < | <status_code> is the code returned to indicate if the transfer was successful (Required). This field must be PASSed with Share "Y" to receive the value. A value of 1 indicates the transfer was not successful and 0 indicates success. If the transfer failed, you can check --- .CLIENT UPLOAD FILE for more information. | |||||||
> > | <status_code> is the code returned to indicate if the transfer was successful (Required). This field must be PASSed with Share "Y" to receive the value. A value of 1 indicates the transfer was not successful and 0 indicates success. If the transfer failed, you can check --- .CLIENT UPLOAD FILE for more information. Note that <status_code> might indicate success and --- .CLIENT UPLOAD FILE might contain a warning message. <status_code> is the final authority on whether the transfer worked or not. | |||||||
Changed: | ||||||||
< < | <source_file> is the path and file on the user's PC (Required). You can refer to macro names in the source, ie, you can use any of the names you see in the [LocalPaths] section of the Desktop Client preferences, just prefix them with a $ and surround them with parentheses, ie, $(userHome). If you PASS this field with Share "Y", then it will contain the expanded path name after the transfer is complete. | |||||||
> > | <source_file> is the path and file on the user's PC (Required). You can refer to macro names in the source, ie, you can use any of the names you see in the [LocalPaths] section of the Desktop Client preferences, just prefix them with a $ and surround them with parentheses, ie, $(userHome). This field can be blank, in which case a dialog box will appear and the user can choose which file to upload. If you PASS this field with Share "Y", then it will contain the path and file name after the transfer is complete. If your field is too short to contain the full path then --- .CLIENT UPLOAD FILE will contain 'Src filename truncated'. | |||||||
<dest_file> is the path and file name on the Appx server the <source_file> should be transferred to (Required). This must be in a location writeable by user 'appx' (Linux/Unix) or the current user (Windows). <convert_flag> indicates if any file conversion is required (Optional). If zero or not passed, then no conversion will be done. A value of 1 means convert the file automatically based on the filename extension. A value of 2 means convert the file automatically based on the contents of the file (ie, it won't convert binary files). A value of 3 means do the conversion regardless of file type. | ||||||||
Changed: | ||||||||
< < | If conversion is requested, this routine will download the file to a temporary location, then copy it to the final location, converting as necessary. The temporary copy will be deleted. The temporary copy is created in the applications 'Tmpdata' folder, same as the working files for a restructure. | |||||||
> > | If conversion is requested, this routine will upload the file to a temporary location, then copy it to the final location, converting as necessary. The temporary copy will be deleted. The temporary copy is created in the applications 'Tmpdata' folder, same as the working files for a restructure. | |||||||
The routine considers the following file extensions to be text files: |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
Added: | ||||||||
> > |
.CLIENT UPLOAD FILEThis subroutine will upload a file from the Client to the server.Usage:PASS <status_code> FIELD SHARE? Y PASS <source_file> FIELD SHARE? N PASS <dest_file> FIELD SHARE? N PASS <convert_flag> FIELD SHARE? N GOSUB --- .CLIENT UPLOAD FILE * check for errors IF --- .CLIENT UPLOAD FILE NE Description:This subroutine will upload a file from the Client to the server. The first three parameters are required, if any are missing the subroutine will CANCEL. The <convert_flag> is optional. <status_code> is the code returned to indicate if the transfer was successful (Required). This field must be PASSed with Share "Y" to receive the value. A value of 1 indicates the transfer was not successful and 0 indicates success. If the transfer failed, you can check --- .CLIENT UPLOAD FILE for more information. <source_file> is the path and file on the user's PC (Required). You can refer to macro names in the source, ie, you can use any of the names you see in the [LocalPaths] section of the Desktop Client preferences, just prefix them with a $ and surround them with parentheses, ie, $(userHome). If you PASS this field with Share "Y", then it will contain the expanded path name after the transfer is complete. <dest_file> is the path and file name on the Appx server the <source_file> should be transferred to (Required). This must be in a location writeable by user 'appx' (Linux/Unix) or the current user (Windows). <convert_flag> indicates if any file conversion is required (Optional). If zero or not passed, then no conversion will be done. A value of 1 means convert the file automatically based on the filename extension. A value of 2 means convert the file automatically based on the contents of the file (ie, it won't convert binary files). A value of 3 means do the conversion regardless of file type. If conversion is requested, this routine will download the file to a temporary location, then copy it to the final location, converting as necessary. The temporary copy will be deleted. The temporary copy is created in the applications 'Tmpdata' folder, same as the working files for a restructure. The routine considers the following file extensions to be text files:
Host Client Source OS OS File Type Conversion -------- ---------- -------------- ------------------------- UNIX UNIX UNIX No conversion needed. UNIX UNIX WINDOWS CR/LF to LF UNIX WINDOWS UNIX LF to CR/LF UNIX WINDOWS WINDOWS No conversion needed. WINDOWS WINDOWS WINDOWS No conversion needed. WINDOWS WINDOWS UNIX LF to CR/LF WINDOWS UNIX WINDOWS CR/LF to LF WINDOWS UNIX UNIX No conversion needed. Comments:Read what other users have said about this page or add your own comments.-- JeanNeron - 2012-02-02 |